# CI / 持续回归能力缺口推进记录(2026-11-05 05:45 轮)
> 依据:`docs/tdd/orchestration/DEV_GOAL_user_scenarios.md` §四.5「CI 接入是必选项,每轮至少推进一项 CI/持续回归能力缺口」。
> 本轮为**发现 / 跟踪**性质,不创建、不修改任何原始测试文件与场景文件;`docs/tdd/` 共享文档入库,`.tdd/` 本地私有禁推。
---
## 一、本轮推进项(1 项,可核验)
**推进项:CI runner 前置能力实测 + 场景回归门禁规格落地(草案由「待核实」推进到「已实测 + 可执行清单」)。**
前几轮(04:22 / 04:48 / 05:02)均记录「`docs/tdd/ci/gitlab-ci.draft.yml` 已就绪未启用,启用前置待人工核实 runner 具备 JDK8/Maven/node22/网络」,未做实测。本轮在编排机(Windows / WorkBuddy 会话)上完成真实命令实测,把「未知」变成「有证据」。
| 前置能力 | 草案要求 | 本轮实测结果 | 结论 |
|---|---|---|---|
| JDK | JDK8(`/d/jdk1.8.0_25` 等价) | `openjdk version "21.0.11" 2026-04-21 LTS`(temurin21-jdk) | ⚠ 编排机为 JDK21,**非 JDK8**;后端 Spring Boot 2.7.18 / Java 8 目标,需 runner 侧另备 JDK8 |
| Maven | Maven | `Apache Maven 3.9.14` | ✅ 具备 |
| Node | node22 | `v22.22.2` | ✅ 具备 |
| npm | npm | `10.9.7` | ✅ 具备 |
| Python | — | `3.13.14` | ✅ 具备(pytest 侧) |
| 假绿坑 | `mvn test` 静默跳测 | `cfc-backend/pom.xml` 第 28 行 `true` 复核确认 | 🔴 CI 后端 job 必须显式 `-DskipTests=false`,草案已含该参数 |
| CI 入口 | 需根目录 `.gitlab-ci.yml` | 根目录 `.gitlab-ci.yml` / `.github/workflows/` / `Jenkinsfile` **均不存在**;仅 `docs/tdd/ci/gitlab-ci.draft.yml` 存在 | ⚠ 仍未启用(`when: manual` 草案),**不擅自复制到根目录**:runner 侧 JDK8 与网络能力未核实,且草案头部明确标注「请勿直接改名」 |
**实测命令**(本轮 05:44 真实执行):`java -version` / `mvn -v` / `node -v` / `npm -v` / `python -c` 读 pom / `ls` 查 CI 入口。
---
## 二、场景回归门禁规格(本轮新增,供主理人裁决后启用)
> 目标口径:218 个 `SC-角色-NN` 全部端到端跑通;「跑通」三判据见 `DEV_GOAL_user_scenarios.md`。
> CI 只是**持续保持**手段,不替代「三类用例实际执行证据」。
| 门禁层 | 触发 | 校验内容 | 产物 / 证据 |
|---|---|---|---|
| G0 编译门禁 | 每次 push | `mvn test-compile -DskipTests=false`(覆盖 pom 第 28 行假绿) | surefire/编译日志 |
| G1 契约与单测 | 每次 push | 后端 `@Test`、pytest、Playwright e2e 分层跑;任一真实失败即红 | junit XML / pytest 报告 / Playwright report |
| G2 场景三类用例 | 每轮闭环 | 每个 SC 的**正常流 / 异常流 / 权限流**各至少 1 条实际执行记录 | `docs/tdd/test/automation-run-*.md` + 脚本报告 |
| G3 覆盖矩阵 | 每轮汇报 | 218 SC 累计已跑通 / 失败 / 阻塞 / 未跟踪,逐条注明证据 sha | `report-dev-*.md` 场景覆盖矩阵 |
| G4 推送证据 | 每轮汇报 | `git merge-base --is-ancestor origin/cfclub` 核验实现与用例已推远端 | git 命令输出 |
**启用前置(仍需主理人核实,本轮不越权执行)**:
1. 确认 CI 平台为 GitLab(remote 属 GitLab 系);
2. runner 侧具备 JDK8 + Maven + node22 + 可拉依赖网络(编排机实测 JDK21,**不能据此推断 runner 具备 JDK8**);
3. 核实后把 `docs/tdd/ci/gitlab-ci.draft.yml` 复制为根目录 `.gitlab-ci.yml`,保留 `when: manual` 先手动跑通,再改自动;
4. 后端 job 保持 `-DskipTests=false`,避免假绿。
---
## 三、当前 CI 状态(如实)
- 脚本级自动化**仍未接入 CI**(无根目录 CI 入口);`docs/tdd/test/automation-status.md`「〇、CI/流水线接入状态」持续标注未接入。
- 本轮仅推进「前置能力实测 + 门禁规格」这一项缺口;**不宣称 CI 已启用、不宣称任何 SC 已跑通**。
- 本轮 4 个 SC 任务(SC-G-02 / SC-G-06 / SC-P-03 / SC-P-10)已派发到独立 feature 分支,其用例执行证据须由会话产出并 push 后,方可计入场景覆盖矩阵。
---
## 二·二、13:30 轮推进项(2026-11-05,1 项可核验)
**推进项:场景回归门禁(G2/G3)口径 218 → 236 同步 + SC-X-22 纳入必测清单。**
场景基线当日演进三轮(13:00 轮后 origin 新增 4 提交):218 → 230(08-butler SC-B-01~12)→ 235(09-human-butler SC-H-01~07)→ 236(SC-X-22 CF 值获取预估)。据此更新 G2/G3 门禁断言:
| 门禁层 | 更新前 | 更新后(本轮) |
|---|---|---|
| G2 场景三类用例 | 218 SC 每 SC 正常/异常/权限各 ≥1 条执行记录 | **236 SC**(新增 AI 成长教练 10 / 真人管家 7 / 跨角色 SC-X-22 1);SC-B/SC-H 场景已定用例待补(TC-B/TC-H),SC-X-22 为 P0 必测(TC-X-22 待补) |
| G3 覆盖矩阵 | 218 累计已跑通/失败/阻塞/未跟踪 | **236** 口径;`sc-key-map.md` 已同步 236 并作为计数来源 |
**如实声明**:CI 入口仍未启用(根目录无 `.gitlab-ci.yml`,`when: manual` 草案不擅动);runner JDK8 能力仍待主理人核实(编排机实测 JDK21,不能推断 runner)。本轮仅完成门禁规格口径同步,**不宣称 CI 已启用、不宣称任何新 SC 已跑通**。SC-X-22 设计契约与 TC-X-22 用例齐备后,由研发侧以 G0~G4 门禁上线承接持续回归(见 O-4/TR-4)。
---
## 二·三、15:30 轮推进项(2026-11-05,2 项可核验)
**推进项 1:G0/G1 本地回归资产已具备可复用命令(测试侧连续第 6 轮证据)。**
- 契约复验:8 类 71 例(68 绿 / 3 红,3 红全为 P-2 MapContract 口径,与 10:45 轮完全一致,非新回归)——测试负责人 13:58 轮记录已推 origin/cfclub(`8b75d5eb2`)。
- 编译回归:`testCompile` 216 源 0 错(B-10 连续第 6 轮无复发)。
- 结论:G0(`mvn test-compile -DskipTests=false`)+ G1(契约复验脚本)已具备**本地可重复执行**的稳定命令与证据链,CI 接入时可直接复用这两条命令作为 job 步骤,无需重新发明。
**推进项 2:G2/G3 口径与用例池同步(测试侧已补齐三场景用例,全仓 729 → 767)。**
- 新增用例(已推 origin/cfclub,`merge-base --is-ancestor` 全部核验通过):AI 成长教练 TC-B 30 条(`93e8f0b67`)、真人管家 TC-H 21 条(`172066bdc`)、SC-X-22 CF 预估专项四例(TC-X-22 / -E / -E2 / -P,`80cd3b0a8` / `413553900`);用例索引 660→711→716→767(`3ac5f7990`)。
- 可执行规格:TC-B-06(`853745a7a`)、TC-H-01(`3da3b2696`)已落地并标注(`9d23c727d` / `6f93f6fea`)。
- 更新 G2/G3 断言:**SC-B / SC-H / SC-X-22 用例已齐备待执行证据**;G2 必测清单增补 SC-X-22(P0)。
**如实声明**:CI 入口仍未启用(根目录无 `.gitlab-ci.yml`,`when: manual` 草案不擅动);runner JDK8 能力仍待主理人核实(编排机实测 JDK21,不能推断 runner)。本轮仅推进「本地回归资产复用 + 用例池同步」两项缺口,**不宣称 CI 已启用、不宣称任何新 SC 已跑通**。SC-X-22 设计契约已派发(lan-248 会话 `ses_e555b9c11ffe5Hh4iBjU5dOcb4`,`axonhub/deepseek`),契约合入 origin/cfclub 后 G0~G4 方有实现可承接持续回归(见 O-4)。
## 二·四、17:05 轮推进项(2026-11-05,1 项可核验)
**推进项:SC-X-22 实现已合入主线(G2/G3 门禁前置资产就绪)。**
- 实现会话(lan-248 `ses_e554b5f26f`,`axonhub/deepseek`,16:37 `outcome=succeeded`)产出 `feat/sc-x22-impl`(`957e59bb2`),含:`RewardRuleService`(新建)、`RewardEstimateController`(新建)、`RewardDisplayVO`/`RewardEstimateRequest`/`RewardEstimateVO`(新建)、`TaskController`/`ProductController`/`GuideFamilyTaskController` 产出点挂载、`GrowthTask`/`Task`/`ProductDTO` 字段扩展、`JwtInterceptor` 公开路径登记。
- 研发侧提取 **12 个 Java 文件(7M+5A,无删除)** 单提交合入 origin/cfclub:**`f14e46f84`**(`merge-base --is-ancestor` 已核验,PUSH_CONFIRMED)。未整支合并(分支基于 `594705507` 落后主线 4 提交,整支会删除 16:25/16:45/16:55 三份汇报并回退 cfc-web 构建文件)。
- 门禁口径更新:**G2 中 SC-X-22 从「实现缺失」→「实现已就绪」**;仍缺 ① TC-X-22 四例三类流**实际执行证据**(用例已合入 `80cd3b0a8`/`413553900` 但未执行)② JUnit 契约测试(RED,S-cfc-16 尚未 mark-red)。G3 矩阵 SC-X-22 维持「未跑通」,转正计入口径同 O-3。
**如实声明**:CI 入口仍未启用(根目录无 `.gitlab-ci.yml`,`when: manual` 草案不擅动);runner JDK8 能力仍待主理人核实(编排机实测 JDK21,不能推断 runner)。本轮推进「SC-X-22 实现入主线」一项缺口,**不宣称 CI 已启用、不宣称 SC-X-22 已跑通**(缺判据①③)。契约偏差疑点:`/api/reward/estimate` 被置于 JwtInterceptor PUBLIC_PATHS(契约 §7 语义为「必须登录」),实测 Controller 对 userId=null 自返 401 行为等价,已登记 TR-5 请测试侧按 TC-X-22-P 第 1 步验证。
## 二·五、09:35 轮推进项(2026-11-06,1 项登记)
**登记项:S-cfc-17/S-cfc-18 RED 契约测试在途(B-2/B-3 处理转入研发闭环)。**
- B-2(admin.auth.login,空 body/未授权返回 500 应为 401/403)与 B-3(health.report.upload,缺 MIME/扩展名/内容校验)于 0859 轮入池为 RED 并派发:S-cfc-17→lan-248、S-cfc-18→local-45278。
- 09:22 发现 S-cfc-17 会话(lan-248 `ses_e5191fc28`)空产出 `failed`(flash-free 模型未响应);09:33 以实测档位 `axonhub/deepseek` 复用会话重派,`--confirm` 确认正文 26 字 + 工具调用 2 次,正常执行中。
- 预期:两 RED 的契约级 JUnit(AdminAuthControllerLoginTest / HealthReportControllerUploadTest 类)合入 origin/cfclub 后,将成为既有 107 例契约池的新增成员,B-2/B-3 由「测试台账待研发」转为「研发闭环中」。
**如实声明**:CI 入口仍未启用(根目录无 `.gitlab-ci.yml`,`when: manual` 草案不擅动);runner JDK8 能力仍待主理人核实(编排机实测 JDK21,不能推断 runner)。本轮仅登记 RED 在途状态,**不宣称 CI 已启用、不宣称 S-cfc-17/18 已跑通**(缺三类流执行证据 + mark-green)。
## 二·六、O-4 裁决同步(2026-11-06,主理人拍板)
**场景总数口径 218 → 236**(正式裁决落地,详见 `docs/tdd/orchestration/DEV_GOAL_user_scenarios.md` §4.2)。
- **G2(SC 必测清单/完成判据)**:完成判据由「218/218 SC 跑通」改为「**236/236 SC 跑通**」;必测 SC 范围含新增的 AI 成长教练 SC-B 10、真人管家 SC-H 7、跨角色 SC-X-22(契约/JUnit 已合入,待三类流执行证据 + mark-green)。
- **G3(必测矩阵)**:SC-X-22 在 G3 必填行维持「未跑通」;SC-B / SC-H 若测试侧有执行证据可转正(按方案 C,转测试侧补三类流)。
- **如实声明**:本裁决仅调整口径,不影响既有契约测试资产与实现提交 sha(f14e46f84 / 2869d0e8e / 6141c43a2 等全部 IN CHAIN);后续汇报「场景覆盖矩阵」基数均从 218 改为 236。
## 二·七、18:00 轮推进项(2026-11-06,CI 管线文件已真实落地)
**推进项:最小 CI 管线 `.gitlab-ci.yml` 已合入 origin/cfclub**(`5783bb294`,16:2x)——CI 入口从「草案未启用」转为「管线文件在库、首跑待触发」。
- **落地内容**:根目录 `.gitlab-ci.yml` 三 job:`backend-g0-compile`(`mvn test-compile -DskipTests=false`,覆盖 pom.xml:28 假绿坑)/ `frontend-jest`(cfc-frontend 14 suites 296 例)/ `cfc-web-jest`(12 suites 90 例);`when: manual` 首跑开关,`MAVEN_OPTS=-Dmaven.repo.local=.m2/repository` + cache 段。
- **命令实测**:commit 5783bb294 自述三项命令均本机实测通过(G0 BUILD SUCCESS 2046+231 源;jest 296+90 全绿)。
- **合并核验**:`5783bb294` `git merge-base --is-ancestor origin/cfclub` **✓ IN CHAIN**(2026-11-06 18:0x 复核)。
- **门禁口径更新**:G0 后端编译 + 前端/管理端 jest 从「本地可复用命令」升级为「CI 管线中已固化的 job 脚本」,`--clean-check`/契约复验仍为本地轮次承载。
**剩余缺口(不宣称流水线已启用、不宣称任何 SC 已跑通):**
1. `when: manual` → 需主理人核实 runner JDK8 能力后改 `when: on_success`(或删行走默认自动)方可自动触发;
2. 契约复验 159 例未并入 backend job(P-2 MapContract 3 红未拍板,并入即 CI 必红);
3. first-run 实测证据(GitLab 平台跑通 3-job 截图/日志)待首次手动触发后补齐。
**如实声明**:本轮仅推进「CI 管线文件落地」一项缺口,**不宣称 CI 自动触发已生效、不宣称 SC 转正新增**;4 RED 键(task.history.view/growth.history.view/sleep.config.tags/achievement.grid.fiveCol)契约测试与实现均在 origin/cfclub(4adb7895c/a73cfa4e2/f11062b42/7ca946b32 全 IN CHAIN),红/绿判定与 mark-red 属测试侧职责,账本滞后待测试侧复跑登记。
## 二·八、23:20 轮推进项(2026-11-06,契约补建工作流首批契约核对已派发)
- **B-1/B-2 开工包契约核对任务已派发**:B-1(测评-方案 43 SC/44 键,lan-248 `ses_e4e91dc01ffe8dj0qyl4mBZsd2`)+ B-2(报告闭环 23 SC/19 键,lan-204 `ses_e4e91234bffeqRDdDQ5MqtdhPy`),均 axonhub/deepseek 绕 429 黑窗,`--confirm` 已确认正常执行(工具调用 1 次 / 正文 27 字+工具调用 1 次)。
- **核实结论(防假 RED 前置)**:B-1 契约接口范围 54 端点 + B-2 端点与 origin/cfclub 359 Controller / 1940 映射端点比对**缺失 0** → 66 SC 接口全部已实现,**无真实现缺口**,契约补建 = 文档核对 + 测试侧补契约 JUnit/三类流证据,不建研发实现型 RED(防假 RED)。
- **G1(契约回归资产扩容前置)**:B-1/B-2 契约核对产出将作为既有契约池(15 类/176 例)的新增成员候选,待测试侧补 JUnit 后并入 backend-g0-compile job;当前 backend job 仍受 P-2 MapContract 3 红未拍板限制,**不并入红例**。
- **如实声明**:本轮派发的是契约**核对/补文档**任务(开工包步骤 1),非实现、非测试;不宣称 CI 自动触发生效、不宣称任何 SC 转正;B-29~B-33(测试侧 23:10 登记)不在本轮研发处置范围(B-29 归研发负责人1,B-30/B-32/B-33 归测试侧度量/工具链,B-31 待主理人定夺凭据轮换)。
## 二·九、01:10 轮推进项(2026-11-07,任务-激励 22 SC 开工包合入 + 契约核对派发)
- **任务-激励 22 SC 开工包已合入 origin/cfclub**:`docs/tdd/orchestration/task-incentive-kickoff-20261107.md`(commit **`ce8c4b4b7`**,2026-11-07 01:0x,单文件 hash-object 入库,diff --name-status=1A 无删除,`git merge-base --is-ancestor` ✓)。
- **接口范围端点核验(防假 RED 前置)**:开工包 22 个 SC 引用 18 个类级端点(/api/tasks、/api/wishes、/api/badges、/api/daily/checkin、/api/daily-task、/api/growth-task、/api/points/exchange、/api/packages、/api/task/reminder-config、/api/game、/api/market、/api/activity、/api/food/recommendation、/api/meal、/api/attribution、/api/energy、/api/admin/challenge-score-config、/api/admin/task/reminder-config)在 origin/cfclub controller 源码中**全部存在(18/18 命中,0 缺失)** → 任务-激励批次接口**已 100% 实现,无真实现缺口**,契约补建 = 文档核对 + 测试侧补契约 JUnit/三类流证据,**不建研发实现型 RED**(防假 RED,延续 O-7 授权)。
- **契约核对任务已派发(开工包步骤 1,文档层非假 RED)**:C-1(A 组任务/心愿/勋章,lan-248 `ses_e4e26bef2ffeh84RRCBpLCnk6z`)+ C-2(B 组积分/能量/运营/活动,lan-204 `ses_e4e261541ffeuFWK05kGun8uGd`),均 `axonhub/deepseek` 绕 429 黑窗,`--confirm` 已确认正常执行(A 组正文 78 字/工具调用 2 次;B 组正文 50 字/工具调用 1 次)。
- **G1(契约回归资产扩容前置)**:任务-激励契约核对产出将作为既有契约池(15 类/176 例)新增成员候选,待测试侧补 JUnit 后并入 backend-g0-compile job;当前 backend job 仍受 P-2 MapContract 3 红未拍板限制,**不并入红例**。
- **下一 P0 批次端点预核(滚动铺路)**:商城-会员 18 SC(MembershipController /api/membership、CouponController /api/coupon、CouponGiftController /api/coupon/gift、product/ProductController /api/product、product/ProductOrderController 等)+ 家庭-成员 15 SC(family/FamilyController /api/family、FamilyMembersController、FamilyInviteController、guide/GuideController /api/guide 等)核心端点预核**均在 origin/cfclub 存在**,可作下批开工包滚动依据。
- **如实声明**:本轮派发的是契约**核对/补文档**任务(开工包步骤 1),非实现、非测试;不宣称 CI 自动触发生效、不宣称任何 SC 转正(场景覆盖维持 5/236);O-8(sc-key-map 236→241 归一)待主理人确认,未在 O-8 裁决前擅改台账基线。
## 二·十、01:16 轮推进项(2026-11-08,CI 治理资产复核 + 假 RED 识别)
- **CI 治理资产复核(IN CHAIN ✓)**:`4adfccf8a`(B-39,pom.xml:28 `skipTests` 假绿修复)+ `180aebcb0`(B-40,`.gitlab-ci.yml` 两级硬门禁改造:test-blocking 必过 / integration 白名单)+ `5783bb294`(最小管线三 job,when:manual)——全部 `git merge-base --is-ancestor origin/cfclub` ✓。CI 治理能力有效,可防「假绿 / 软门禁」两类回归信号失真。
- **假 RED 识别(防假 RED 前置延伸)**:`family.signature.*` 5 键(S-cfc-50~54)契约实现 `e35ca7186` 已在链 → 本轮登记 TR-18 转测试侧补三类流证据,**不派研发实现型任务**(避免额度恢复后误派已实现键)。
- **缺口(不宣称已启用)**:① 入口仍 `when: manual`(runner JDK8 能力待主理人核实后改 on_success);② 契约复验例未并入 backend job(P-2 MapContract 3 红未拍板);③ first-run 平台证据待补;④ 22 RED(invite 5 + team 10)为真缺口待实现,落地后可作下一批 G1 回归资产候选。
- **如实声明**:本轮无派发、无 CI 文件改动;推进记录仅登记治理资产复核与假 RED 识别,不宣称 CI 自动触发生效、不宣称任何 SC 转正(场景覆盖维持 15/241)。