Bläddra i källkod

docs(tdd): S-cfc-328 child.wish.manage 实现验证报告 - 实现已存在测试全绿(12/12 契约 + 合计 60/60,无需代码改动)

能力键 child.wish.manage(SC-C-04 提心愿 / SC-P-13/14/88 心愿闭环):
origin/cfclub 实现已完整落地(WishController /api/wishes 6 契约端点 @PostMapping +
WishService 状态机 draft→active→pending_exchange→approved→exchanging→fulfilled,
spendForMember refType=wish_exchange 幂等扣 CF;EnergyController /deduct-for-wish),
ChildWishManageContractTest 12/12 GREEN(S-cfc-214 契约登记 7af657b12),
关联链 WishFlowScP13ContractTest 15/15 + WishServiceTest 4/4 + WishControllerTest 29/29。
本提交仅 docs 无代码变更,按『实现已存在,测试意外全绿』惯例登记收尾,交编排侧归档。
Sisyphus Agent 2 dagar sedan
förälder
incheckning
5f326855fb
1 ändrade filer med 50 tillägg och 0 borttagningar
  1. 50 0
      docs/tdd/impl-2026-11-14-S-cfc-328-child-wish-manage.md

+ 50 - 0
docs/tdd/impl-2026-11-14-S-cfc-328-child-wish-manage.md

@@ -0,0 +1,50 @@
+# S-cfc-328 - child.wish.manage 实现验证报告 (2026-11-14)
+
+**能力键**: `child.wish.manage`
+**任务号**: S-cfc-328(TDD 实现使绿派发;SC-C-04 提心愿 / SC-P-13 心愿创建-审批-兑换闭环 / SC-P-14 驳回·失效处理 / SC-P-88 兑换扣五维·CF)
+**状态**: TDD-GREEN(实现已存在,测试已通过,无需 src/main 改动)
+**状态机流转**: RED -> GREEN(通过本验证提交转登记收尾)
+
+## 验证摘要
+
+1. **契约测试**: `ChildWishManageContractTest`(12 cases,测试侧 S-cfc-214 `7af657b12` 登记推送 origin,实测全绿转测试登记)在 `origin/cfclub` HEAD 上已通过 **12/12 Green**。
+2. **实现校验**: 能力链已在 `origin/cfclub` 完整落地——
+   - `WishController` `/api/wishes`:6 个契约端点全部 `@PostMapping`:`/create`(createWish 按角色分流 child/parent/teacher/admin)、`/{id}/set-price`、`/{id}/reject`、`/{id}/exchange`、`/{id}/approve-exchange`、`/{id}/fulfill`(另含 /confirm /cancel /list /pending 等扩展端点);
+   - `WishService` 状态机:`createByChild`(不能登录成员提心愿 draft)→ `setPrice`(家长定价 draft→active)→ `requestExchange`(active→pending_exchange,余额读统一账本 `cf_balance`)→ `approveExchange`(pending_exchange→approved,`spendForMember` refType=wish_exchange、refId=心愿 ID 幂等扣 CF;拒绝回退 active)→ `markFulfilled`(approved→exchanging)→ `confirmReceived`(exchanging→fulfilled);`rejectWish`(仅 draft→rejected + rejectCount 自增)、`cancelWish`;
+   - `EnergyController` `/api/energy` `POST /deduct-for-wish` + `EnergyService.deductForWish`(扣 action 维度能量,余额不足返回 false、非正金额抛 IllegalArgumentException)。
+3. **测试结果**: 0 失败 → 31 通过(目标类 12 + 关联链 WishFlowScP13ContractTest 15 + WishServiceTest 4),另 WishControllerTest 29/29(@SpringBootTest 集成,对测试库实跑),合计 60/60 全绿,BUILD SUCCESS。
+
+## 结论
+
+该能力键的实现已存在于 `origin/cfclub`(S-cfc-214 契约登记时即实测全绿,与 S-cfc-309 / S-cfc-156/175「实现已存在,测试意外全绿」先例一致),**无需代码修改**即可使红单测全绿。本提交作为闭环验证产物(docs 仅),标记任务已完成、交编排侧转测试登记收尾。
+
+## 暴露的缺陷
+
+无(实现现状与 `ChildWishManageContractTest` 断言清单——正常流/边界流/权限流三类——全部吻合;本键为编排侧对已落地能力的重复派发,溯源见 S-cfc-214 契约登记与 `WishFlowScP13ContractTest` 既有覆盖)。
+
+---
+
+## 实现会话实跑复核(2026-11-14,派发会话,任务 S-cfc-328)
+
+**基准**: `origin/cfclub` @ `dc04a6b4c`(worktree `task_S-cfc-328`,分支 `task/S-cfc-328`)
+
+**复核命令**(`.worktrees/task_S-cfc-328/cfc-backend`,单模块,未触碰测试/未改实现):
+```
+mvn -Dtest="ChildWishManageContractTest,WishFlowScP13ContractTest,WishServiceTest" test
+```
+
+**实测结果**:
+```
+[INFO] Tests run: 4, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.service.WishServiceTest
+[INFO] Tests run: 12, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.ChildWishManageContractTest
+[INFO] Tests run: 15, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.WishFlowScP13ContractTest
+[INFO] Tests run: 31, Failures: 0, Errors: 0, Skipped: 0
+[INFO] BUILD SUCCESS
+```
+
+**附**: `WishControllerTest`(@SpringBootTest 集成层,对测试库 192.168.16.251)独立实跑 **29/29** 通过(Tests run: 29, Failures: 0, Errors: 0)。
+
+**复核结论**: `ChildWishManageContractTest` 12 用例全绿(失败数 0 → 通过数 12),覆盖 SC-C-04 提心愿端点契约(6 端点 + /deduct-for-wish)、WishService 三类流(正常/边界/权限)、EnergyService.deductForWish 扣减行为与参数契约。实现已完整落地于 `origin/cfclub`,本键无需 src/main 改动即可闭环。改动文件仅本验证报告(docs),无测试/实现变更,符合「最小闭环、不扩散」。
+
+**改动文件**:
+- `docs/tdd/impl-2026-11-14-S-cfc-328-child-wish-manage.md`(本报告)