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

docs(plans): 需求变更提交单 CF-CR-2026-11-14-01(分润模型 v2:七项裁决闭环 + T01-T08 任务登记 + P0 前置门禁)

Agnes Agent 4 дней назад
Родитель
Сommit
5e4589b2d3
1 измененных файлов с 65 добавлено и 0 удалено
  1. 65 0
      docs/superpowers/plans/2026-11-14-cf-reward-v2-change-submission.md

+ 65 - 0
docs/superpowers/plans/2026-11-14-cf-reward-v2-change-submission.md

@@ -0,0 +1,65 @@
+# 需求变更提交单 CF-CR-2026-11-14-01|CF 分润模型 v2
+
+> 状态:**已提交**(需求文档 + 设计文档均已入库 origin/cfclub)
+> 提出人/裁决人:廖总 | 提交日:2026-11-14 | 关联基线:`2026-10-24-cf-value-unification-plan.md`
+
+## 1. 变更主题
+
+推荐奖励 **R2 两级销售奖** 分润出口重组:团队分佣从「毛利 P 点」移出,改从「商品成本」按所属体系比例独立切池;新增平台抽成 R0(成交价 10% 固定单列)。推荐人体系(直推 ≤70% / 间推 ≤20%)基数维持毛利口径不变。
+
+## 2. 变更背景(用户三问分析结论摘要)
+
+| 问题 | 结论 |
+|------|------|
+| ① 现行推荐奖励规则 | 2026-10-24 方案收口:R1 消费返 CF / R2 直推≤70%+间推≤20% / R3 分享注册+20CF 日限10;旧双层佣金体系已废弃 |
+| ② 各商品 P 点 | 毛利口径 = 实付分 − 成本×数量(多商品按行分摊,亏损 0);非商品 = 金额×10%;旧配置 product_ppoint/category_ppoint 已脱钩 |
+| ③ CF 值获取与层级显示 | 24 条规则统一走 CfBalanceService.earnByRule;小程序 team.vue 有层级树;后台无层级树、CfValueManage 读旧账(G1) |
+
+## 3. 七项裁决(全部闭环,2026-11-14)
+
+| # | 裁决项 | 结果 | 落位 |
+|---|--------|------|------|
+| 1 | 团队池比例 T 定义层级 | **所属体系配置**(GLOBAL/SYSTEM/MINIAPP 三作用域表 `cf_team_share_config`,优先级 MINIAPP>SYSTEM>GLOBAL>代码兜底 3000bps) | 设计 §2.1 |
+| 2 | 团队池内部分配 | **referral_tree 层级树 + 直推档位权重瓜分**(权重数据源与 F03a 同源) | 设计 §5 |
+| 3 | 平台抽成 | **成交价 10% 单列**(`cf_platform_revenue_log`),不影响推荐人基数;消费返 CF 维持 | 设计 §2.4 |
+| 4 | 旧 ProfitPoolService 处置 | **彻底废弃**:删 5 处调用点+TeamProfitCronTask+TeamProfitAdminController+3 服务类;4 张旧表归档只读 | 设计 §3.4/T07 |
+| 5 | 非商品订单团队池 | **进池**:非商品成本 = 实付 × `cf.team_pool.non_goods_cost_rate`(默认 50%) | 设计 §1.3 |
+| 6 | 亏损仓团队池 | **照常发**(on_loss=payout) | 设计 §1.4 |
+| 7 | 平台抽成基数 | **实付价**(paidAmountCent) | 设计 §1.1 |
+
+## 4. 提交产物(已入库 origin/cfclub)
+
+| 文档 | commit | 说明 |
+|------|--------|------|
+| `2026-11-14-cf-reward-model-v2.md` | `dc04a6b4c` | 需求正本:裁决记录 + 账目公式 + 影响范围 |
+| `2026-11-14-cf-reward-model-v2-design.md` | `fdf5b1df8` → `0183c49be` | 架构师增量设计定稿(4 新表迁移 462-465 + F03c + T01-T08 + 12 测试用例) |
+| `2026-11-14-cf-reward-v2-change-submission.md` | 本次提交 | 变更提交单(追溯凭证) |
+
+## 5. 开发任务登记(T01-T08,待 P0 合入后入 TDD 池)
+
+> 派发溯源约定:`--requirement=2026-11-14-cf-reward-model-v2.md`、`--design=2026-11-14-cf-reward-model-v2-design.md`;实现基线须含 P0 合入后的 cfclub。
+
+| 任务 | 内容 | 能力键(候选) | P0 文件交集 |
+|------|------|----------------|-------------|
+| T01 | 4 新表迁移 + F03c 种子 + 6 配置键播种 | cf.rewardv2.config.migrate / .seed | ★★ DatabaseInitializer/schema.sql |
+| T02 | TeamShareConfigService 三作用域解析 | cf.teamshare.config.resolve / .priority | 无 |
+| T03 | R0 平台抽成记账 | cf.rewardv2.r0.platform-take / .idempotent | 无 |
+| T04 | 团队池建池 + settle 分叉 | cf.teamshare.pool.create / .idempotent | ★ PaymentService(仅依赖引用) |
+| T05 | 层级树瓜分 + 尾差守恒 + 同家庭跳过 | cf.teamshare.share.weighted / .family-skip / .remainder | 无 |
+| T06 | F03c 规则接入 earnByRule | cf.rewardv2.f03c.dispatch | 无 |
+| T07 | 旧 ProfitPoolService 废弃清理 | cf.rewardv2.legacy.remove / .archive | ★ PaymentService 等 5 调用点 |
+| T08 | E2E + 测试矩阵(12 用例含 200/100 账目示例) | cf.rewardv2.e2e.example-200-100 等 | ★ PaymentServiceORDRoutingTest |
+
+## 6. 排期与门禁
+
+1. **前置**:多小程序 P0(feature/multiapp-config)合入 cfclub——T01/T04/T07/T08 与 P0 文件级交集,禁止并行改 schema.sql/DatabaseInitializer/PaymentService。
+2. **入池**:P0 合入后由研发负责人自动化或主理人 `tdd_orchestrate.py --add-task` 批量入池(带 §5 溯源)。
+3. **实现**:另开 `feature/reward-v2` worktree,按 T01→T08 顺序,隔离派发(禁 reset --hard 等既有纪律)。
+4. **顺序硬约束**:T07(旧体系废弃)须先于新团队池启用,避免"毛利池团队奖 + 成本池团队池"双发。
+5. **门禁**:`mvn compile` + T08 E2E 全绿 + `--clean-check` + 全量单文件旁路入库。
+
+## 7. 关联事项
+
+- 差距收口(G1 后台 CfValueManage 读 cf_balance / G2 档位管理端页 / G4 / G5)**不受本模型影响**,仍按原 TDD 队列排队。
+- 单位口径备忘:R2/R2' 以 CF 发放(1 分=1CF 参照),R0 货币分入平台表,财务对账按类型区分。
+- 管理端团队池比例配置页(cf_team_share_config CRUD)不在本单范围(可后续 P1 增补,与 G2 档位配置页合并排期)。