Просмотр исходного кода

docs(tdd): S-cfc-407 cf.teamshare.weightedShare 编排侧核验回报——实现已在 origin/task/S-cfc-407(cb811d57d),12/12 使绿验证完成,未并入 cfclub,建议以 cfclub 为基线重合并(勿直推旧 merge 0cbcc594e)

Administrator 10 часов назад
Родитель
Сommit
dff1b36b7e
1 измененных файлов с 52 добавлено и 0 удалено
  1. 52 0
      docs/tdd/S-cfc-407-weightedShare-report.md

+ 52 - 0
docs/tdd/S-cfc-407-weightedShare-report.md

@@ -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 当前基线不受影响,不在本键处理范围。