docs: CI 载体上线收官——功能清单/看板/迭代总结同步 ✅
- Gitea Actions runner 部署完成(域名注册 + docker.sock 挂载) - 工作流零 GitHub 依赖(本实例手动克隆 + apt 装 JDK17),ci.yml #6 全绿 3m18s - 第一迭代所有工程化项闭环 - 门禁:mkdocs build --strict 通过
This commit is contained in:
@@ -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、清理任务调优
|
||||
|
||||
|
||||
Reference in New Issue
Block a user