Răsfoiți Sursa

docs(tdd): S-cfc-408 cf.rewardv2.dispatchF03c 三验全绿 -- baseline 9/9 at 0acc8f222 (含 S-cfc-407 合入,impl in chain), docs-only evidence

E2E Test Bot 23 ore în urmă
părinte
comite
6e3530387d

+ 54 - 1
docs/tdd/impl-2026-11-16-S-cfc-408-rewardv2-dispatchF03c.md

@@ -90,4 +90,57 @@ git merge-base --is-ancestor ae2196a31 HEAD  → 0(RULE_TEAM_POOL 常量实现
 git merge-base --is-ancestor 325b2ae32 HEAD  → 0(S-cfc-410 团队池账目链路已在链)
 ```
 
-**结论(复派)**: `cf.rewardv2.dispatchF03c` 全部契约断言(正常流-1/2/3、边界流-1~5、权限流 N/A)在 `origin/cfclub` HEAD `b08d823e8` 实测 **9/9 全绿**,与首轮验证(`bc3a72cfa`)一致。实现由链上前序任务(S-cfc-401 T01 F03c 种子、S-cfc-406 RULE_TEAM_POOL 常量、S-cfc-410、及既有 F-3b1 消费返佣通用 `earnByRule` per_item + 三道闸)完整承载。**本键无待实现缺口,src/main 零改动**;复派闭环以本复核证据(docs-only)交编排侧转测试侧 mark-green。
+**结论(复派)**: `cf.rewardv2.dispatchF03c` 全部契约断言(正常流-1/2/3、边界流-1~5、权限流 N/A)在 `origin/cfclub` HEAD `b08d823e8` 实测 **9/9 全绿**,与首轮验证(`bc3a72cfa`)一致。实现由链上前序任务(S-cfc-401 T01 F03c 种子、S-cfc-406 RULE_TEAM_POOL 常量、S-cfc-410、及既有 F-3b1 消费返佣通用 `earnByRule` per_item + 三道闸)完整承载。**本键无待实现缺口,src/main 零改动**;复派闭环以本复核证据(docs-only)交编排侧转测试侧 mark-green。
+
+---
+
+## 复核过程(2026-11-16 三次派发 · 任务 S-cfc-408 三验——当前基线 `0acc8f222`,含 S-cfc-407 weightedShare 合入)
+
+**背景**: S-cfc-408 第三次被派发「实现使绿」。派发前提「测试红、实现未落」经 git 真理核对再次过期:契约测试登记 commit `10c1fd724` 与全部实现来源均在链,且本键链上新增兄弟任务 S-cfc-407(`0acc8f222`,团队池层级树加权瓜分)已合入基线——对 F03c 发放契约无破坏(F03c 发放走 `earnByRule` 通用入口,与加权瓜分的池内账目无实现依赖叠加)。本次对最新基线做全量重验,未做任何 src/main 改动。
+
+**基准**: `origin/cfclub` @ `0acc8f222`(worktree `.worktrees/task_S-cfc-408`,分支 `task/S-cfc-408`,自 `origin/cfclub` reset --hard 同步,工作区干净)
+
+**复核命令**(cfc-backend 单模块,未触碰测试/未改实现):
+```
+mvn -q -Dtest=CfRewardV2DispatchF03cContractTest -DfailIfNoTests=false test
+mvn -q -Dtest='CfRewardV2DispatchF03cContractTest,TeamPoolCreateContractTest,CfRewardV2MigrateConfigContractTest' -DfailIfNoTests=false test
+```
+
+**实测结果**(surefire reports,当前基线):
+```
+Tests run: 9, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.CfRewardV2DispatchF03cContractTest    ← 本键目标,9/9 GREEN(独立运行与链上复核各一次,一致)
+Tests run: 13, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.TeamPoolCreateContractTest             ← cf.teamshare.createPool 同链复验
+Tests run: 8,  Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.CfRewardV2MigrateConfigContractTest    ← cf.rewardv2.migrateConfig 同链复验
+```
+合计 **30/30**(目标键 + 同链两键),全绿。
+
+**链上核验**(当前基线):
+```
+git rev-parse --short HEAD                       → 0acc8f222
+git merge-base --is-ancestor 10c1fd724 HEAD      → 0(契约测试登记已在链)
+git diff 10c1fd724 HEAD -- cfc-backend/src/test/.../CfRewardV2DispatchF03cContractTest.java → 空(测试文件自登记以来从未被改过,测试侧 git 真理可复核)
+git merge-base --is-ancestor 948ff0a77 HEAD      → 0(F03c 种子 T01 实现已在链,S-cfc-401)
+git merge-base --is-ancestor ae2196a31 HEAD      → 0(RULE_TEAM_POOL 常量实现已在链,S-cfc-406)
+git merge-base --is-ancestor 0acc8f222 (HEAD)    → 0(S-cfc-407 weightedShare 合入后基线)
+```
+
+**实现现状定位**(本键契约断言 → 实现落点,均在链):
+| 契约断言 | 实现落点 | 来源 |
+|----------|----------|------|
+| 正常流-1:`CfCommissionService.RULE_TEAM_POOL = "F03c"` | `CfCommissionService.java:94` | `ae2196a31`(S-cfc-406) |
+| 正常流-2:F03c 种子契约(consume/per_item/dedup=F03c/sort=25/params 源 share_cent、note 1分=1CF) | `DatabaseInitializer.CF_EARN_RULE_SEEDS` F03c 行 + `seedCfEarnRules()` | `948ff0a77`(S-cfc-401 T01) |
+| 正常流-3 / 边界流-1:`earnByRule(memberId,"F03c",poolId,{amount})` per_item 按 `ctx.amount` 直入(1 分 = 1 CF),流水 ref_type=F03c、ref_id=poolId | `CfBalanceServiceImpl.earnByRule` → `computeAmount` per_item → `perItemAmount` 读 `ctx.amount`;`refTypeOf` 取 dedup_ref_type;幂等 refType+refId | 既有通用链路(F-3b1 消费返佣) |
+| 边界流-2/3/4:三道闸(会员等级日限/累计上限/冷却期)命中跳过并写 `type=skip`、`amount=0` 的 F03c 流水 | `CfBalanceServiceImpl` 三道闸 + `writeSkipLog`(`TYPE_SKIP="skip"`、amount=0、refType=F03c、refId=poolId) | 既有通用链路 |
+| 边界流-5:per_item 缺 ctx.amount/qty 抛 `IllegalArgumentException` | `perItemAmount` 兜底 throw | 既有通用链路 |
+
+**TDD 时间线核对**(RED 契约测试先于核心实现登记,非"测试尾随实现"):
+```
+948ff0a77  11-15 20:56  F03c 种子落地(S-cfc-401 T01,部分实现先期在链)
+10c1fd724  11-15 21:24  RED 契约测试登记(此时缺少 RULE_TEAM_POOL 常量 → 真红)
+ae2196a31  11-16 04:30  RULE_TEAM_POOL 常量落地(S-cfc-406,补齐锚点 → 转绿)
+0acc8f222  11-16 07:27  当前基线(S-cfc-407 合入后,F03c 契约仍 9/9 绿)
+```
+
+**纪律复核**: 本会话 0 处 src/main 变更、0 处测试断言/用例改动(遵守「禁止改测试」);worktree 自 `origin/cfclub` reset --hard 同步后重跑,未引入任何工作区垃圾文件。
+
+**结论(三验)**: `cf.rewardv2.dispatchF03c` 在最新基线 `0acc8f222`(含 S-cfc-407 合入)实测 **9/9 全绿**(30/30 含同链复验)。**本键无待实现缺口,src/main 零改动**;三次独立验证券同。本复核证据(docs-only)交编排侧转测试侧 mark-green 收尾。