From 64521bf284761b37112fe19e2d39021785a2b0e7 Mon Sep 17 00:00:00 2001 From: Lixi20 Date: Fri, 4 Sep 2026 18:18:26 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20CI=20=E8=BD=BD=E4=BD=93=E4=B8=8A?= =?UTF-8?q?=E7=BA=BF=E6=94=B6=E5=AE=98=E2=80=94=E2=80=94=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E6=B8=85=E5=8D=95/=E7=9C=8B=E6=9D=BF/=E8=BF=AD=E4=BB=A3?= =?UTF-8?q?=E6=80=BB=E7=BB=93=E5=90=8C=E6=AD=A5=20=E2=9C=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Gitea Actions runner 部署完成（域名注册 + docker.sock 挂载） - 工作流零 GitHub 依赖（本实例手动克隆 + apt 装 JDK17），ci.yml #6 全绿 3m18s - 第一迭代所有工程化项闭环 - 门禁：mkdocs build --strict 通过 --- docs/development/feature-checklist.md | 2 +- .../iterations/iteration-1/20-iteration-1-summary.md | 4 ++-- docs/development/iterations/iteration-1/index.md | 6 +++--- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/development/feature-checklist.md b/docs/development/feature-checklist.md index 80064ae..b83917b 100644 --- a/docs/development/feature-checklist.md +++ b/docs/development/feature-checklist.md @@ -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 依赖 | ## 针对性测试速查 diff --git a/docs/development/iterations/iteration-1/20-iteration-1-summary.md b/docs/development/iterations/iteration-1/20-iteration-1-summary.md index b6ce6f4..1eb5807 100644 --- a/docs/development/iterations/iteration-1/20-iteration-1-summary.md +++ b/docs/development/iterations/iteration-1/20-iteration-1-summary.md @@ -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 或后续迭代） diff --git a/docs/development/iterations/iteration-1/index.md b/docs/development/iterations/iteration-1/index.md index 6717147..4e92f87 100644 --- a/docs/development/iterations/iteration-1/index.md +++ b/docs/development/iterations/iteration-1/index.md @@ -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、清理任务调优