|
|
@@ -0,0 +1,77 @@
|
|
|
+# CF 分润模型 v2(2026-11-14 修订)— 推荐奖励 & 团队分佣重组
|
|
|
+
|
|
|
+> 基线:`2026-10-24-cf-value-unification-plan.md`(§三 F02-F24、§四 4.4 P 点口径)
|
|
|
+> 状态:**需求已裁决**(廖总 2026-11-14 拍板);增量设计待架构师输出;实现待排期
|
|
|
+
|
|
|
+## 1. 裁决记录(用户拍板 2026-11-14)
|
|
|
+
|
|
|
+用户对分润模型提出重组意见(团队分佣移出毛利、平台抽成固定),主理人归纳待确认项后用户拍板:
|
|
|
+
|
|
|
+| # | 决策项 | 裁决结果 |
|
|
|
+|---|--------|----------|
|
|
|
+| D1 | 团队分润池比例(成本中切给团队的比例 T%)定义层级 | **所属体系配置层**(按所属体系/运营体系维度配置;未配置时回退全局默认 T0) |
|
|
|
+| D2 | 团队分润池内部如何分配 | **沿用 `referral_tree` 层级树 + 销售档位**(与直推档位体系一致的瓜分规则) |
|
|
|
+| D3 | 平台抽成(成交价 10%)与推荐人基数、消费返 CF 的关系 | **抽成单列 + 消费返 CF 维持**(抽成独立入平台账,不缩小推荐人毛利基数;R1 返利照旧) |
|
|
|
+
|
|
|
+> 备注:D1「所属体系」在 CFC 语境对应各小程序/运营体系维度(与多小程序配置 `miniapp_config` 体系相呼应);若此理解有偏差,以用户后续澄清为准。
|
|
|
+
|
|
|
+## 2. 现行模型(v1 摘要,来自 2026-10-24 方案)
|
|
|
+
|
|
|
+- **R1 消费返 CF**(F02):所有订单 `floor(实付)×100CF`,返本人,即时+幂等。
|
|
|
+- **R2 两级销售奖**(F03a 直推 ≤70% + F03b 间推 ≤20%):基数 = 本单 P 点(= 毛利 = 实付分 − purchasePrice×数量,多商品按行占比分摊,亏损 0;非商品订单 = 金额×10%);档位按「团队 8 层内滚动 1 年 P 点累计」(直推)/「自身滚动 1 年 P 点累计」(间推)match 两张档位表;同家庭跳过。
|
|
|
+- **R3 分享注册**(F24):+20CF/人,日限 10。
|
|
|
+- 旧体系(双层佣金/按配置比例)已废弃。
|
|
|
+
|
|
|
+## 3. 新模型(v2)
|
|
|
+
|
|
|
+**核心变化:分钱出口从一条(毛利 P 点)拆为三条独立通道 + 平台保底。**
|
|
|
+
|
|
|
+- **R0 平台抽成(新增)**:`平台抽成 = 成交价 × 10%`,固定单列,独立入平台收益账;**不参与、不影响任何分润基数**;与 R1 消费返 CF 并存(返利是平台给消费者的让利成本,另行列支)。
|
|
|
+- **R1 消费返 CF**:维持 v1 不变。
|
|
|
+- **R2 推荐人体系(直推 ≤70% + 间推 ≤20%)**:基数**仍 = 毛利(售价 − 成本)**,口径与 v1 的 `calcOrderPpoints` 一致;直推/间推档位表、层级树累计规则不变。(注意:v1 中「毛利池」同时隐含团队归属,v2 起毛利只服务推荐人体系。)
|
|
|
+- **R2' 团队分润池(新增)**:`团队池 = 成本 × T%`(T 为 D1 所述体系配置),**从成本中切出**,与毛利完全脱钩;池内按 D2 规则(`referral_tree` 层级树 + 销售档位占比)瓜分给团队成员。
|
|
|
+- **R3 分享注册**:维持不变。
|
|
|
+
|
|
|
+### 3.1 账目示例(商品 A:售价 200 / 成本 100 / 体系 T=30%,假定直推 70% 档 / 间推 20% 档)
|
|
|
+
|
|
|
+| 通道 | 计算 | 金额 | 去向 |
|
|
|
+|------|------|------|------|
|
|
|
+| R0 平台抽成 | 200 × 10% | 20 | 平台收益 |
|
|
|
+| R2 直推销售奖 | (200−100) × 70% | 70 | 直推上线 |
|
|
|
+| R2 间推销售奖 | (200−100) × 20% | 20 | 间推上线 |
|
|
|
+| R2' 团队池 | 100 × 30% | 30 | 团队内按层级+档位再分 |
|
|
|
+| R1 消费返 CF | floor(200) × 100 CF | 200 CF | 消费者本人 |
|
|
|
+| 剩余 | 200 − 20 − 70 − 20 − 30 | 60 | 商家/平台交付成本与利润 |
|
|
|
+
|
|
|
+### 3.2 与 v1 的关键差异
|
|
|
+
|
|
|
+| 维度 | v1 | v2 |
|
|
|
+|------|----|----|
|
|
|
+| 团队分佣来源 | 隐含在毛利池(直推/间推占毛利) | **独立成本池**(成本 × T%),与毛利脱钩 |
|
|
|
+| 平台收益 | 毛利剩余(无固定通道) | **固定 = 成交价 × 10%**,单列、永不参战 |
|
|
|
+| 推荐人基数 | 毛利(P 点) | 毛利(P 点),**不变** |
|
|
|
+| 消费返 CF | 有 | **维持** |
|
|
|
+
|
|
|
+## 4. 影响范围(供架构师细化)
|
|
|
+
|
|
|
+1. **表结构**:
|
|
|
+ - 新增团队池比例配置:体系维度(对应 D1)——候选:商品/品类表加 `team_share_percent`(若兼容体系维度则加体系字段)或独立配置表 `cf_team_share_config`(owner 维度 = 所属体系)
|
|
|
+ - 新增团队池流水:`cf_team_pool`(每单:订单/金额 T%/池金额/分配状态)或复用 `cf_balance_log` 新增 type 标记
|
|
|
+ - `cf_earn_rule` 可登记新规则码(如 F03c 团队池),沿用统一发放/幂等链路
|
|
|
+2. **计算拆分**:`CfCommissionService.settle`(126-146)结算时分叉——①推荐人链路(毛利,原样)②团队池链路(成本×T%,新)③平台抽成(新,独立记账);`calcOrderPpoints`(344-396)毛利口径保留
|
|
|
+3. **配置**:新配置键(如 `cf.team_pool.share_rate` 体系级默认 + `cf.platform.service_rate`=1000bps),进 `service_config` + `CfConfigKeys`
|
|
|
+4. **层级瓜分**:`CfReferralService.matchDirectSalesTier`(134)/ `matchIndirectSalesTier`(149)复用方式设计(瓜分 = 档位占比加权)
|
|
|
+5. **前端展示**:小程序推广页/财富页团队池展示(可后置);后台档位配置(G2 顺带收口)
|
|
|
+
|
|
|
+## 5. 待实现清单(V1 粗分解,架构师细化)
|
|
|
+
|
|
|
+1. 数据库迁移:团队池比例配置(体系维度)+ 配置表/字段 + 流水表(DatabaseInitializer + schema.sql 同步)
|
|
|
+2. 结算链路分叉:`CfCommissionService` 增加团队池计算与平台抽成记账(幂等/同家庭跳过/并发防护沿用现有模式)
|
|
|
+3. 团队池瓜分:层级树快照 + 档位占比加权分配(参照 `materializeReferralTree` 69-97)
|
|
|
+4. 配置端:`CfConfigKeys` + service_config 播种(CfRuleConfig.vue 扩展可选)
|
|
|
+5. 测试:账目示例断言(200/100 例)+ 多商品分摊 + 亏损仓 + 团队池幂等 + 同家庭跳过
|
|
|
+
|
|
|
+## 6. 关联事项
|
|
|
+
|
|
|
+- **与多小程序 P0 的文件交集**:`schema.sql`、`DatabaseInitializer`、`PaymentService`、`UserService` 等为 P0 正在修改文件 → v2 实现须在 P0 合入后另开 worktree/分支(如 `feature/reward-v2`),避免并发冲突。
|
|
|
+- **差距收口顺带**:G1(后台 CfValueManage 读 cf_balance)、G2(档位管理端页)、G4(computeAmount 读档位限额)、G5(F11 里程碑硬编码)不受本模型影响,仍按原 TDD 池排队。
|