docs: CI 载体上线收官——功能清单/看板/迭代总结同步

- Gitea Actions runner 部署完成(域名注册 + docker.sock 挂载)
- 工作流零 GitHub 依赖(本实例手动克隆 + apt 装 JDK17),ci.yml #6 全绿 3m18s
- 第一迭代所有工程化项闭环
- 门禁:mkdocs build --strict 通过
This commit is contained in:
2026-09-04 18:18:26 +08:00
parent 8e0e1c5c42
commit 64521bf284
3 changed files with 6 additions and 6 deletions
+1 -1
View File
@@ -79,7 +79,7 @@
| docker compose 最小编排(postgres:18 + 两无状态服务容器) | ✅ | `patbond-api@ab0265c``./deploy/init-secrets.sh``mvnw -DskipTests package``docker compose up -d --build`;完整冒烟实测通过(register→me→refresh→旧 token 重用 40102→internal 401→logout);用法见 `patbond-api/Readme.md` |
| 可执行镜像构建(repackage exec jar、非 root 运行) | ✅ | 同上;顺带修复无 starter-parent 时 package 产物不可执行 |
| 信封严格化(`success` 派生字段不再上线) | ✅ | `patbond-api@8a79971`,信封恰为 `{code, message, data}` |
| CI 载体(自动执行门禁) | 🟡 | `.gitea/workflows/ci.yml` 已提交(`patbond-api@3f6e818`,与本地门禁同命令);**待服务器启用 Gitea Actions 并注册带 Docker 的 act_runner**(前提在文件头注释,需用户操作) |
| CI 载体(自动执行门禁) | | Gitea Actions + act_runner 已上线(ci.yml #6 全绿 3m18s:本实例克隆 + apt JDK17 + mvnw 全量 82 测试含 Testcontainers),零 GitHub 依赖 |
## 针对性测试速查
@@ -13,7 +13,7 @@
| 里程碑 | 完成度 | 备注 |
|---|---|---|
| 认证流程纵切 | ✅ 100% | 注册/登录/me/refresh 轮换/退出/多设备并行/登录锁定,全链路测试通过 |
| 基础设施 | ✅ 100% | Flyway V1/V2、UUID 持久化、统一异常、Docker Compose、Gitea CI 工作流(暂未启用,不阻塞 |
| 基础设施 | ✅ 100% | Flyway V1/V2、UUID 持久化、统一异常、Docker Compose、Gitea CI 已上线(runner 部署完成,全绿 |
| 客户端 | ✅ 100% | 珊瑚橙主题、5 认证组件、登录/注册/Splash 页、网络层、token 管理、埋点模块(3/5 挂接点,允许范围内) |
| 契约与文档 | ✅ 100% | OpenAPI 正式化(真机验证 100% 一致)、ADR-001~008、Git 工作流、功能清单、19 份过程报告 |
@@ -106,7 +106,7 @@
1. **埋点 sessionId 生命周期**(报告 19 遗留 §1):当前 sessionId 只在退出时清空,app 进后台/切前台未监听,无法准确统计会话时长。需引入 `WidgetsBindingObserver` 监听 app 状态。
2. **页面浏览埋点**(报告 19 遗留 §2):`page_viewed` 事件未挂接,需 `RouteObserver` 监听路由变化。
3. **Gitea CI 启用**(功能清单 🟡):工作流与手册已就绪(`.gitea/workflows/ci.yml` + `ci-runner-setup.md`),但服务器 runner 注册失败(Gitea 1.26.4 Actions 已启用但 runner 报 404),暂未定位根因。不影响开发(本地门禁全绿),但缺失自动化验收记录
3. ~~Gitea CI 启用~~**已完成**2026-09-04)——runner 注册(GITEA_INSTANCE_URL 须用域名而非裸 IP)、工作流去 GitHub 依赖(手动克隆本实例 + apt 装 JDK)后 ci.yml #6 全绿 3m18s
### 中优先级(M2 或后续迭代)
@@ -8,7 +8,7 @@
| 状态 | 内容 |
| --- | --- |
| ✅ 第一迭代已完成 | 认证纵切两端(JWT + Flutter 登录)+ 真机联调 E2E + 埋点系统 + Docker Compose 编排 + Git 工作流 + ADR-001~008,后端 82 测试、前端 34 测试 |
| 🔜 下一步 | M2 宠物健康档案(下一迭代主线);M1 完善项:sessionId 生命周期、页面浏览埋点、Gitea CI 启用(可选) |
| 🔜 下一步 | M2 宠物健康档案(下一迭代主线);M1 完善项:sessionId 生命周期、页面浏览埋点 |
| ⚠️ 遗留 | access token 无主动吊销(≤15 分钟窗口)、/internal 为静态密钥、auth_sessions 过期清理默认 30 天、埋点 7 项完善(报告 19 §3 已优先级排序) |
## 已完成(附提交)
@@ -44,7 +44,7 @@
**功能里程碑**
- 认证流程:注册 / 登录 / me / refresh 轮换 / 退出 / 多设备并行 / 登录锁定,全链路测试通过 ✅
- 基础设施:Flyway 迁移(V1 identity/media + V2 product_events)、UUID 持久化、统一异常、Docker Compose 编排、Gitea CI 工作流(暂未启用)
- 基础设施:Flyway 迁移(V1 identity/media + V2 product_events)、UUID 持久化、统一异常、Docker Compose 编排、Gitea Actions CI 已上线
- 客户端:珊瑚橙主题、5 个认证组件、登录/注册/Splash 页、网络层与 token 管理、埋点模块(3 挂接点) ✅
- 契约与文档:OpenAPI 正式化(真机验证 100% 一致)、ADR-001~008、Git 工作流规范、功能清单、19 份过程报告 ✅
@@ -56,7 +56,7 @@
- ✓ 数据库迁移可执行且可回滚
**遗留与下一步**
- M1 完善项:埋点 sessionId 生命周期 / 页面浏览埋点 / Gitea CI runner 启用(可选
- M1 完善项:埋点 sessionId 生命周期 / 页面浏览埋点 / ~~Gitea CI runner 启用~~(已完成
- M2 主线:宠物健康档案(`health_record_action` 埋点挂接点、档案 CRUD、照片管理)
- 后端长期项:access token 黑名单策略、/internal 改 mTLS、清理任务调优