|
|
@@ -0,0 +1,52 @@
|
|
|
+# S-cfc-407 - cf.teamshare.weightedShare TDD 使绿回报(编排侧核验证据)
|
|
|
+
|
|
|
+**能力键**: `cf.teamshare.weightedShare`(单元 team.share,设计 T05)
|
|
|
+**任务号**: S-cfc-407
|
|
|
+**状态**: 实现已在远端,本会话完成核验;**未产生新 commit,无 push**。
|
|
|
+**Worktree**: `.worktrees/task_S-cfc-407`(分支 `task/S-cfc-407`,基线 `origin/cfclub` @ `de3aa5e2e`)
|
|
|
+**日期**: 2026-11-16
|
|
|
+
|
|
|
+## 一、派发与现状核查(git 真理)
|
|
|
+
|
|
|
+1. 红契约测试 `cfc-backend/src/test/java/com/etotem/cfc/unit/TeamShareWeightedContractTest.java`
|
|
|
+ 已在 `origin/cfclub` 链上(基线 `de3aa5e2e` 可编译运行)。
|
|
|
+2. 派发描述"测试红、实现未落"与远端现状不符:远端已存在完整的 S-cfc-407 实现提交
|
|
|
+ `cb811d57d`(`origin/task/S-cfc-407` HEAD,作者 Agnes Agent,2026-11-16 03:03),
|
|
|
+ 并经 `origin/merge/S-cfc-407`(`0cbcc594e`)推送,但**该 merge 至今未并入 `origin/cfclub`
|
|
|
+ (cfclub 主线未包含 S-cfc-407 提交)**。
|
|
|
+3. `origin/cfclub` 上 `CfCommissionService` 现状:
|
|
|
+ - 已有:`RULE_TEAM_POOL = "F03c"`(S-cfc-406)、`calcDistributableBase`(S-cfc-405)、
|
|
|
+ `settleTeamPool`(S-cfc-406)、`TeamShareConfigService`;
|
|
|
+ - 缺失(本键 T05 契约):`allocateTeamPoolShareByWeight`、`distributeTeamPool(...)`、
|
|
|
+ 实体 `CfTeamPoolShare`、`CfTeamPoolShareMapper`。
|
|
|
+ - 即 cfclub 基线 12 例中 7 红,与 S-cfc-408 报告(`docs/tdd/impl-2026-11-16-S-cfc-408-rewardv2-dispatchF03c.md`
|
|
|
+ "范围外提示")一致。
|
|
|
+4. 远端 `cb811d57d` 实现范围(5 文件,+353):
|
|
|
+ - `CfCommissionService`:`allocateTeamPoolShareByWeight(int[], int)`(纯加权瓜分,
|
|
|
+ 末位吸收尾差守恒,totalW≤0 返回空列表不私发)+ `distributeTeamPool(...)`
|
|
|
+ (层级树取成员 → 档位权重(F03a 同口径)→ 加权瓜分 → `earnByRule(memberId,"F03c",poolId,{amount})`
|
|
|
+ + `cf_team_pool_share` 幂等落库(uk_pool_member)→ 池状态 share_issued / unclaimed);
|
|
|
+ - `CfTeamPoolShare` / `CfTeamPoolShareMapper` 新增;`CfTeamPoolOrder` / `CfTeamPoolOrderMapper`
|
|
|
+ 与 cb811d57d 版本对齐;`CfTeamPoolOrder` 增 `settledAt` 字段。
|
|
|
+
|
|
|
+## 二、核验结果(测试侧 git 真理可复核)
|
|
|
+
|
|
|
+| 验证项 | 命令(cfc-backend 单模块) | 结果 |
|
|
|
+|---|---|---|
|
|
|
+| RED 复现 | `mvn -q -Dtest=TeamShareWeightedContractTest test` @ `de3aa5e2e` | **12 例 7 失败**(缺 `allocateTeamPoolShareByWeight`/`distributeTeamPool`/`CfTeamPoolShare`/schema 断言) |
|
|
|
+| GREEN | 同上 @ `cb811d57d` | **Tests run: 12, Failures: 0, Errors: 0**(surefire 报告已留存) |
|
|
|
+| 兄弟链回归 | `mvn -q -Dtest='TeamPoolCreateContractTest,CfRewardV2DispatchF03cContractTest,CfRewardV2MigrateConfigContractTest'` @ `cb811d57d` | F03c 发放 9/9、migrateConfig 8/8 绿;TeamPoolCreate 13 例中 4 失败 —— 为 **cb811d57d 基线偏旧**(其祖先链缺 S-cfc-405/406 的 `calcDistributableBase`/`settleTeamPool`/`TeamShareConfigService`)导致,**非本键回归**;在 cfclub 基线 `de3aa5e2e` 该 13/13 全绿 |
|
|
|
+
|
|
|
+## 三、给编排侧的建议
|
|
|
+
|
|
|
+- `cb811d57d`(task/S-cfc-407)已具备使绿条件(12/12),但停留在独立分支。
|
|
|
+ 建议合并进 cfclub 时**以 cfclub 为基线重做三方合并**(勿直接 push `origin/merge/S-cfc-407`
|
|
|
+ 的 `0cbcc594e`——其父节点是旧 cfclub,会把 cfclub 19 个提交从主线"摘除",
|
|
|
+ 已实测验证:`cb811d57d` 基线上 TeamPoolCreateContractTest 由 13/13 退化到 9/13 即证据)。
|
|
|
+- 本键实现未改测试断言/删用例(`git diff` 测试目录为空)。
|
|
|
+
|
|
|
+## 四、暴露的缺陷
|
|
|
+
|
|
|
+- 无本键阻断性缺陷。
|
|
|
+- 范围外提示:`TeamPoolCreateContractTest` 对 `cb811d57d` 旧基线的 4 失败属基线偏旧,
|
|
|
+ cfclub 当前基线不受影响,不在本键处理范围。
|