|
@@ -0,0 +1,61 @@
|
|
|
|
|
+# S-cfc-408 - cf.rewardv2.dispatchF03c 实现使绿验证报告 (2026-11-16)
|
|
|
|
|
+
|
|
|
|
|
+**能力键**: `cf.rewardv2.dispatchF03c`
|
|
|
|
|
+**任务号**: S-cfc-408(TDD 实现使绿派发)
|
|
|
|
|
+**状态**: TDD-GREEN(契约测试 9/9 全绿;实现已在链,无需 src/main 改动 —— **O-22 豁免**,同 S-cfc-309 / S-cfc-328 / S-cfc-330 先例)
|
|
|
|
|
+**状态机流转**: RED(契约) -> RED(实测全绿) -> GREEN(经本验证提交转测试侧 mark-green 收尾)
|
|
|
|
|
+
|
|
|
|
|
+## 验证摘要
|
|
|
|
|
+
|
|
|
|
|
+1. **契约测试**: `CfRewardV2DispatchF03cContractTest`(`cfc-backend/src/test/java/com/etotem/cfc/unit/`,9 cases,测试侧登记 commit `10c1fd724` "RED 契约测试 cf.rewardv2.dispatchF03c" 已推送 origin/cfclub)在 `origin/cfclub` HEAD(`bc3a72cfa`)实测 **9/9 Green**。
|
|
|
|
|
+2. **实现校验**: 能力链已在 `origin/cfclub` 完整落地,三部分来源均在链(`git merge-base --is-ancestor` 逐条核验 ✓):
|
|
|
|
|
+
|
|
|
|
|
+ | 契约断言 | 实现落点 | 来源 commit |
|
|
|
|
|
+ |----------|----------|-------------|
|
|
|
|
|
+ | 正常流-1:`CfCommissionService.RULE_TEAM_POOL = "F03c"`(§3.1 团队分润池规则码登记锚点) | `CfCommissionService` 第 89-90 行 `public static final String RULE_TEAM_POOL = "F03c"` | `ae2196a31`(S-cfc-406 团队池建池) |
|
|
|
|
|
+ | 正常流-2:F03c 规则种子契约(`code=F03c`、`category=consume`、`rule_type=per_item`、`dedup_ref_type=F03c`、`sort_order=25`、`params_json.source=cf_team_pool_share.share_cent`、`note=amount=每人分得CF,按池金额1分=1CF`) | `DatabaseInitializer.CF_EARN_RULE_SEEDS` 第 14883-14887 行 F03c 行,`seedCfEarnRules()` 播入(§3.3) | `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(ruleCode, ctx)` 读 `ctx.amount`;`refTypeOf(rule)` 取 `dedup_ref_type=F03c`;`earnInternal` 幂等键取 `refType(+refId=poolId)`(既有多规则消费返佣通用链路 F-3b1/F02/F03a/F03b 复用) | 既有实现(本键未改动) |
|
|
|
|
|
+ | 边界流-2/3/4:三道闸(会员等级日限 / 累计上限 / 冷却期)对 F03c 生效,命中即跳过并写 `type=skip`、`amount=0` 的 F03c 流水(可追溯) | `CfBalanceServiceImpl.earnByRule` 三道闸:`resolveDailyLimit+countTodayEarn`(日限,reason 含「日限」)/ `countEarnLogs` 累计次数(reason 含「累计上限」)/ `findLastEarnLog` 冷却间隔(reason 含「冷却期」);命中统一 `writeSkipLog`(`TYPE_SKIP="skip"`、`amount=0`、`refType=F03c`、`refId=poolId`) | 既有实现(本键未改动) |
|
|
|
|
|
+ | 边界流-5:per_item 缺 `ctx.amount/qty` 抛 `IllegalArgumentException` | `perItemAmount` 兜底 `throw new IllegalArgumentException("规则 " + ruleCode + " 缺少发放数量上下文(amount / qty)")` | 既有实现(本键未改动) |
|
|
|
|
|
+ | 权限流:F03c 团队池发放入库为结算内部数据链路,无用户权限维度 | 不适用(测试恒真断言) | — |
|
|
|
|
|
+
|
|
|
|
|
+3. **测试结果**: 目标类 **9/9**(`CfRewardV2DispatchF03cContractTest`);同链复验 `TeamPoolCreateContractTest` 13/13(cf.teamshare.createPool)+ `CfRewardV2MigrateConfigContractTest` 8/8(cf.rewardv2.migrateConfig)全绿。合计 **30/30**(目标键相关链)。
|
|
|
|
|
+
|
|
|
|
|
+## 结论
|
|
|
|
|
+
|
|
|
|
|
+`cf.rewardv2.dispatchF03c` 契约测试在基线即全绿:T06 三块实现(F03c 规则码常量 / F03c 种子 / `earnByRule` per_item 发放 + 三道闸)已由前序任务(T01 `948ff0a77`、团队池建池 `ae2196a31`)及既有 F-3b1 消费返佣通用链路完整落地于 `origin/cfclub`。**无需任何 src/main 改动**即可使红单测全部转绿(9/9)。本提交为 docs-only 闭环验证证据,交编排侧转测试侧 mark-green 收尾。
|
|
|
|
|
+
|
|
|
|
|
+## 暴露的缺陷
|
|
|
|
|
+
|
|
|
|
|
+无本键阻断性缺陷。
|
|
|
|
|
+
|
|
|
|
|
+**范围外提示(非本键,未处理,交编排侧)**:同链兄弟契约测试 `TeamShareWeightedContractTest`(能力键 `cf.teamshare.weightedShare` / T05,任务编排键 `cf.rewardv2.f03c.dispatch` 之外的另一键)在基线 **12 例中 7 红**——断言 `CfCommissionService#allocateTeamPoolShareByWeight` / `distributeTeamPool(...)` 与实体 `CfTeamPoolShare`(§2.3 加权瓜分)尚未实现。该键与本键(T06 发放入库)无实现依赖(F03c 发放已由 `earnByRule` 通用入口满足),**不扩散修复**,应在该能力键自身的实现任务内使绿。
|
|
|
|
|
+
|
|
|
|
|
+---
|
|
|
|
|
+
|
|
|
|
|
+## 复核过程(2026-11-16,派发会话 · 任务 S-cfc-408)
|
|
|
|
|
+
|
|
|
|
|
+**基准**: `origin/cfclub` @ `bc3a72cfa`(worktree `.worktrees/task_S-cfc-408`,分支 `task/S-cfc-408`,自 `origin/cfclub` 新建,无工作区改动)
|
|
|
|
|
+
|
|
|
|
|
+**复核命令**(cfc-backend 单模块,未触碰测试/未改实现):
|
|
|
|
|
+```
|
|
|
|
|
+mvn -q -Dtest=CfRewardV2DispatchF03cContractTest -DfailIfNoTests=false test
|
|
|
|
|
+mvn -q -Dtest='CfRewardV2DispatchF03cContractTest,TeamPoolCreateContractTest,TeamShareWeightedContractTest,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
|
|
|
|
|
+Tests run: 8, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.CfRewardV2MigrateConfigContractTest
|
|
|
|
|
+Tests run: 12, Failures: 7, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.TeamShareWeightedContractTest ← 另一键 cf.teamshare.weightedShare/T05,7 红预留给该键自身任务
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+**链上核验**:
|
|
|
|
|
+```
|
|
|
|
|
+git merge-base --is-ancestor 10c1fd724 HEAD → 0(契约测试登记已在链)
|
|
|
|
|
+git merge-base --is-ancestor 948ff0a77 HEAD → 0(F03c 种子 T01 实现已在链)
|
|
|
|
|
+git merge-base --is-ancestor ae2196a31 HEAD → 0(RULE_TEAM_POOL 常量实现已在链)
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+**纪律复核**: 本会话 0 处 src/main 变更、0 处测试断言/用例改动(遵守「禁止改测试」;按测试 javadoc「若能编译通过、能运行、断言失败(红)」与任务约定,实测全绿时交编排侧核实能力键状态、不私改实现)。
|