|
|
@@ -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`(本报告)
|