docs: 补充分支与环境口径

This commit is contained in:
2026-11-08 17:58:29 +08:00
parent 726730c3c9
commit c419ffd814
2 changed files with 28 additions and 0 deletions
+17
View File
@@ -39,6 +39,23 @@
- 认证:Sa-Token,token 放请求头 `satoken`(不用 Cookie)
- 只使用学习会话相关端点,**不碰 `review/*`**
## 分支与发布
与 `lpt-be` / `lpt-fe` / `lpt-ai` 同规则:**一个分支对一个环境**(本仓库没有服务端部署,环境差异落在“默认 API 地址”上)。
| 分支 | 环境 | 默认 API 地址 |
|------|------|----------------|
| `dev` | 开发 | `https://lpt-dev.cat-shark.xyz/api` |
| `master` | 生产 | `https://lpt.cat-shark.xyz/api` |
- 两个分支的代码**只允许差 `ApiClient.DEFAULT_BASE_URL` 这一行**(其余全部一致)。改这一行时必须确认自己在哪个分支上,改完只提本分支。
- 不要跨分支合并:`dev` 的功能要上生产时,只把常规代码改动同步过去,并保持 master 的默认地址不变。
- 构建在 Gitea 手动触发 `.gitea/workflows/build.yml`(dev/prod 二选一),不需要签本地环境:
1. 校验「分支 ↔ 环境」(从 dev 发 prod 直接被拒);
2. 校验代码里的 `DEFAULT_BASE_URL` 是否与本环境一致,不一致直接失败;
3. 容器内构建 APK(`ci/Dockerfile` 固定 JDK 17 / cmdline-tools / android-36),产物归档为 Actions artifact 并打印 sha256。
- APK 不入 Git(`.gitignore` 已忽略 `*.apk`),分发走 Actions artifact。
## 提交规范
同 meta 仓库:简短中文,格式 `类型: 简述`,例如 `feat: 新增悬浮窗碎片录入`。