cfc/docs/tdd/dev/test-requests.md

研发 → 测试 请求通道（正式通道）

纪律：本台账条目由开发/研发角色写入，push 到远端才算送达测试； 测试处理完后在本文件追加「回复」段并置状态，再 push。 与状态机解耦：本文件不改变 state.json 的 stage，阶段推进仍由 --mark-* + git 真理证据驱动。 编号规则：TR-* 单调递增，不复用、不跳号。

编号	关联键/对象	类型	描述	经办	登记时间	状态
TR-1	guide.trainingPlan.getPlanDetail	用例缺失	能力键已于 2026-11-04 02:47 手动入池为 RED（manual_entry: true），但全仓 src/test/ 下无任何 getPlanDetail 引用（grep -rln "getPlanDetail" cfc-backend/src/test/ 无匹配），即 RED 契约测试尚未落地，阶段无法从 RED 推进。请测试侧补契约级单测。详见下方「TR-1 详情」。	开发（研发负责人1）	2026-11-04 04:30	已回复

---

TR-1 详情：请求补写 getPlanDetail 契约级 RED 测试

1. 背景与阻塞性质

• 状态机键：guide.trainingPlan.getPlanDetail，当前阶段 RED。
• 实现已存在且已推送远端：cfc-backend/src/main/java/com/etotem/cfc/controller/guide/TrainingPlanController.java （实现引入于 0af81d688，随 origin/cfclub 可读）。
• 阻塞点：按 TDD 角色隔离，RED 测试用例属测试角色职责，研发侧不代写；因此该键虽已有可用实现，仍卡在 RED 等待测试侧补单测。

2. 前置阻塞已解除（研发侧本轮已闭环）

测试负责人 2026-11-04 02:16 汇报中上报的后端编译回归（dfc78e9d3 为 CfBalanceController 5 个方法新增 @RequestAttribute currentMemberId 形参， 但 CfBalanceControllerTest 仍以旧签名直接调用，导致 mvn test-compile BUILD FAILURE，阻断全部后端单测）， 已由研发侧修复并推送：

• 修复提交：c9f9ec948 — fix(test): 同步 CfBalanceControllerTest 到 dfc78e9d3 新签名（currentMemberId 形参），解除后端全量单测编译回归
• 目标分支：cfclub（data_ref = origin/cfclub），已推送 ✅
• 验证：mvn -o -B test-compile → BUILD SUCCESS；定向跑 4 个契约测试类 → Tests run: 29, Failures: 0, Errors: 0, Skipped: 0 + BUILD SUCCESS

即：当前后端单测已可正常编译执行，测试侧补 RED 的环境前提已具备。

3. 待测端点契约（供测试侧直接建用例）

项	内容
能力键	guide.trainingPlan.getPlanDetail
端点	POST /api/guide/training-plans/detail
请求体	{"planId": <Long>}（Map<String,Object>，经 ParamUtils.getLong 解析）
成功响应	Result.success({plan, items})，code=200，data 为 LinkedHashMap，含 plan（TrainingPlan）与 items（List<TrainingPlanItem>）两个键
参数缺失	planId 为 null → Result.error("planId不能为空")
方案不存在	planId 有效但查无方案 → Result.error("方案不存在")
调用链	trainingPlanService.getPlanById(planId) → trainingPlanService.getPlanItems(planId)

4. 建议覆盖的用例点（测试侧自决，非研发指令）

1. 正常路径：planId 有效 → code=200，data.plan 非空、data.items 为数组。
2. 参数缺失：planId 缺省 / null / 非数字 → 返回「planId不能为空」（ParamUtils 语义：null/空串/非数字均视为未传）。
3. 方案不存在：mock getPlanById 返回 null → 返回「方案不存在」。
4. 空项目列表：getPlanItems 返回空集合 → data.items 为空数组而非 null。
5. HTTP 方法契约：GET 应 405（本仓接口统一 @PostMapping）。
6. 鉴权缺口观察（请测试侧一并记录缺陷，不必断言为绿灯）：该 handler 在控制器层未读取 @RequestAttribute("role")， 也未列入 JwtInterceptor 的 LOGIN_REQUIRED_PATHS（对照同文件 getPlanList 既有测试的同类观察记录）， 因此「规划师角色约束」名义成立但实际任何已认证角色（乃至匿名 userId=-1）均可到达 handler，属潜在越权缺口。 请按「缺陷观察」记录并回写研发侧，本轮研发侧不改实现（越权修复涉及鉴权面收敛，另案处理）。

5. 测试写法参考（沿用同包既有风格，不复制实现代码）

参考同目录既有 RED 契约测试 cfc-backend/src/test/java/com/etotem/cfc/controller/guide/TrainingPlanControllerGetPlanListTest.java （能力键 guide.trainingPlan.getPlanList，已 DONE）：

• MockMvc standalone 模式 + Mockito mock TrainingPlanService，无 Spring 上下文 / 无 DB；
• 通过 ReflectionTestUtils.setField(controller, "trainingPlanService", ...) 注入；
• 断言用 jsonPath + status()。

6. 交付与阶段推进约定

• 测试侧写完 RED 并 push 后，研发侧将执行 POST /api/session（能力键 guide.trainingPlan.getPlanDetail）→ --mark-yellow ... --commit <sha> 置 YELLOW；
• 随后由测试角色执行 --mark-green 完成闭环（研发侧无权代置 GREEN）。

---

回复区（由测试角色追加）

待测试填写。回复后请将对应 TR-* 状态置为「已回复」或「已关闭」并 push。

编号	回复人	回复时间	回复内容	状态变更
TR-1	测试负责人（自动化 6255181e，本会话）	2026-11-04 10:10	契约级单测已落地并实跑通过：新增 cfc-backend/src/test/java/com/etotem/cfc/controller/guide/TrainingPlanControllerGetPlanDetailTest.java，8 个用例（正常路径 / planId 缺失·null·空串·非数字 / 方案不存在 / 空 items 数组 / GET→405），standalone MockMvc + Mockito，风格与 TrainingPlanControllerGetPlanListTest 一致。离线实跑 mvn -o test -Dtest=TrainingPlanControllerGetPlanDetailTest → Tests run: 8, Failures: 0, Errors: 0 ✅；并入全量纯单元测套件复跑（155 类 / 1087 用例 / 通过 1044 / 失败 25 / 错误 18，与既有基线逐类一致 + 新增 8 例全绿）。鉴权缺口观察已按第 6 点记录为缺陷观察并另立台账 B-9（见 docs/tdd/test/blockers.md），未断言为红灯。P0 编译回归修复 c9f9ec948 已由本轮全量套件编译通过实证，测试台账 B-8 已置「已解除」。RED 提交即将随本回复一并 push；请研发侧随后对本键执行 --mark-yellow --commit 0af81d688（实现已在远端），测试侧将复验后 --mark-green 收口。	待测试处理 → 已回复
TR-2	dimension.registry.getTree	用例缺失	能力键已手动入池为 RED（manual_entry: true，2026-11-04 21:53），但全仓 src/test/ 下无任何 DimensionRegistryController 契约测试（`git ls-tree origin/cfclub	grep -i DimensionRegistry仅实现类，无*Test），即 RED 契约测试尚未落地，阶段无法从 RED 推进。实现**已推送远端**（57e162242已入origin/cfclub，controller/admin/DimensionRegistryController.java#tree`）。请测试侧补契约级单测。详见「TR-2 详情」。

---

TR-2 详情：请求补写 dimension.registry.getTree 契约级 RED 测试

1. 背景与阻塞性质

• 状态机键：dimension.registry.getTree，当前阶段 RED（S-cfc-7）。
• 实现已存在且已推送远端：cfc-backend/src/main/java/com/etotem/cfc/controller/admin/DimensionRegistryController.java （实现引入于 57e162242，已合入 origin/cfclub；对应 DimensionRegistryService#getTree）。
• 阻塞点：按 TDD 角色隔离，RED 测试用例属测试角色职责，研发侧不代写；该键虽有实现，仍卡在 RED 等待测试侧补单测。

2. 待测端点契约（供测试侧直接建用例）

项	内容
能力键	dimension.registry.getTree
端点	GET /api/dimension-registry/tree?sourceSystem=<可选>（本仓虽统一 @PostMapping，但 DimensionRegistryController 设计文档 §5.1 明确为 @GetMapping，按设计契约执行）
参数	sourceSystem 可选（null/空 → 全量树）
成功响应	Result<List<DimensionNode>>，code=200，data 为维度树节点列表（含 code/name/nodeKind/children）
调用链	dimensionRegistryService.getTree(sourceSystem)

3. 建议覆盖的用例点（测试侧自决，非研发指令）

1. 正常路径：sourceSystem 缺省 → code=200，data 非空且每节点含 code/name。
2. 按源过滤：传 sourceSystem → 仅返回该源节点（或空列表）。
3. 空库：mock getTree 返回空列表 → data 为空数组而非 null。
4. HTTP 方法契约：POST 应 405（设计文档 §5.1 为 @GetMapping）。

4. 测试写法参考

沿用既有契约测试风格（如 DimensionAdminControllerTest）：MockMvc standalone 模式 + Mockito mock DimensionRegistryService，无 Spring 上下文 / 无 DB；ReflectionTestUtils.setField 注入；断言 jsonPath + status()。

5. 交付与阶段推进约定

• 测试侧写完 RED 并 push 后，研发侧将 --mark-yellow --commit 57e162242（实现已在远端）置 YELLOW；随后测试角色 --mark-green 收口。

---

---

TR-3：请测试侧为本轮 4 个 SC 场景派生并实际执行三类用例（研发 → 测试）

编号	关联键/对象	类型	描述	经办	登记时间	状态
TR-3	auth.guest.wechatLogin / auth.guest.jwtGuard / family.parent.switchRole / task.parent.createTask	用例缺失 + 复验	研发本轮按 DEV_GOAL_user_scenarios.md 建立并派发 4 个场景打通任务（S-cfc-9~12，对应 SC-G-02 微信授权登录 / SC-G-06 越权接口拦截 / SC-P-03 双角色切换 / SC-P-10 创建任务下发），均带需求+设计双锚点、独立 feature 分支与独立目录。请测试侧：① 对照 tests/user-scenarios/应用场景总览.md 与 tests/test-cases/*.md，为这 4 个 SC 各补齐【正常流 / 异常流 / 权限流】三类用例（不修改原始场景与用例文件，新增脚本/报告入独立分支）；② 会话产出后独立复验并回写 docs/tdd/test/automation-status.md 执行状态；③ 只有三类用例有实际执行证据 + 实现与用例已推 origin/cfclub + --clean-check 0，才计入场景覆盖矩阵「已跑通」。注意：cfc-backend/pom.xml:28 有 <skipTests>true</skipTests>，任何 mvn test 必须显式 -DskipTests=false，否则假绿	研发负责人（闭环巡检轮）	2026-11-05 05:47	待测试处理

TR-3 研发进展回执（研发负责人1，2026-11-05 06:20）

编号	回复方	回复时间	回复内容	状态
TR-3	研发负责人1（自动化 ce26ad68）	2026-11-05 06:20	SC-G-02 / SC-G-06 会话产出已合入 origin/cfclub：merge 3aebf9b16（SC-G-02 契约测试+权限流测试+e2e 用例+执行证据报告，源自 feat/sc-g-02-wechat-login）＋ merge 73e2f194e（SC-G-06 越权拦截实现+契约测试+执行报告，源自 feat/sc-g-06-jwt-guard）；合并树 mvn -o -B test-compile BUILD SUCCESS（2041 主源+208 测试源）。S-cfc-10 auth.guest.jwtGuard 已补登 YELLOW（commit 73e2f194e）。测试侧可直接基于主干对两场景派生/复验三类用例；S-cfc-11/12 会话仍在推进，产出后同样合入	待测试处理（evidence 已就绪）