|
|
@@ -1,7 +1,7 @@
|
|
|
# CF 分润模型 v2(2026-11-14 修订)— 推荐奖励 & 团队分佣重组
|
|
|
|
|
|
> 基线:`2026-10-24-cf-value-unification-plan.md`(§三 F02-F24、§四 4.4 P 点口径)
|
|
|
-> 状态:**需求已裁决**(廖总 2026-11-14 拍板);增量设计待架构师输出;实现待排期
|
|
|
+> 状态:**需求已裁决 + 口径修订闭环**(2026-11-14 拍板;同日 14:58 用户纠正三处:base=78、R3 移出、通道语义命名);设计修订中(架构师定向修订回传后落盘)
|
|
|
|
|
|
## 1. 裁决记录(用户拍板 2026-11-14)
|
|
|
|
|
|
@@ -11,7 +11,22 @@
|
|
|
|---|--------|----------|
|
|
|
| D1 | 团队分润池比例(成本中切给团队的比例 T%)定义层级 | **所属体系配置层**(按所属体系/运营体系维度配置;未配置时回退全局默认 T0) |
|
|
|
| D2 | 团队分润池内部如何分配 | **沿用 `referral_tree` 层级树 + 销售档位**(与直推档位体系一致的瓜分规则) |
|
|
|
-| D3 | 平台抽成(成交价 10%)与推荐人基数、消费返 CF 的关系 | **抽成单列 + 消费返 CF 维持**(抽成独立入平台账,不缩小推荐人毛利基数;R1 返利照旧) |
|
|
|
+| D3 | 平台抽成(成交价 10%)与推荐人基数、消费返 CF 的关系 | **抽成单列 + 消费返 CF 维持**(抽成独立入平台账) |
|
|
|
+| **D4** | **分润基数口径(2026-11-14 14:58 用户纠正,覆盖 D3 的"不影响基数"表述)** | **base = 实付 − 平台抽成 − 消费返 CF 成本 − 商品成本**;示例 200−20−2−100 = **78 元**。平台抽成与消费返 CF 都是要先扣的成本,不是"不参与基数" |
|
|
|
+| **D5** | **推荐人销售奖基数** | **= 扣减后可分配额 base(78)**,直推/间推档位在 base 上分(78×70%=54.6 / 78×20%=15.6);不再是原始毛利 100 的 70%/20% |
|
|
|
+| **D6** | **分享注册(+20CF/日限10)归属** | **不属于分润体系**,从分润表剔除(独立获客激励,不参与订单分账) |
|
|
|
+| **D7** | **通道命名消歧** | 用户口径中"R2 = 团队分润",与文档原 R2=推荐人销售奖冲突 → 文档正文改用**语义通道名**(平台抽成 / 消费返 CF / 推荐人销售奖 / 团队分润池 / 平台留存),附编号对照表 |
|
|
|
+
|
|
|
+### 1.1 通道语义名与编号对照表
|
|
|
+
|
|
|
+| 用户口径 | 语义通道名 | 说明 |
|
|
|
+|---|---|---|
|
|
|
+| R0 | **平台抽成** | 成交价(实付)× 10%,先扣成本 |
|
|
|
+| R1 | **消费返 CF** | 实付×100 CF 返消费者,先扣成本 |
|
|
|
+| —(毛利可分配部分) | **推荐人销售奖** | 直推 ≤70% + 间推 ≤20%,基数 = base(78) |
|
|
|
+| **R2(用户口径)** | **团队分润池** | 成本 × T%,单独计算、独立于 base |
|
|
|
+| R3 | (非分润) | 分享注册奖励,移出分润体系 |
|
|
|
+| — | **平台留存** | base 分出后 + 成本侧切池后的余额 |
|
|
|
|
|
|
> 备注:D1「所属体系」在 CFC 语境对应各小程序/运营体系维度(与多小程序配置 `miniapp_config` 体系相呼应);若此理解有偏差,以用户后续澄清为准。
|
|
|
|
|
|
@@ -24,33 +39,39 @@
|
|
|
|
|
|
## 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 分享注册**:维持不变。
|
|
|
+- **平台抽成(新增)**:`抽成 = 实付 × 10%`(`cf.platform.take_rate_bps` 默认 1000),独立入平台流水;**先从可分配额中扣除**(是成本,不是"不参与基数")。
|
|
|
+- **消费返 CF**:`floor(实付) × 100 CF`,返本人(F02,维持不变);**同样先从可分配额中扣除**(CF 口径 1 CF = 1 分等值,返 200 CF ≈ 2 元成本)。
|
|
|
+- **推荐人销售奖(直推 ≤70% + 间推 ≤20%)**:基数 = **扣减后可分配额 base**,见 §3.1;档位表、层级树累计、同家庭跳过、即时幂等规则均不变。
|
|
|
+- **团队分润池(新增,用户口径 R2)**:`团队池 = 成本 × T%`(T 为 D1 所述体系配置),**从成本侧切出**,与 base 完全脱钩、单独计算;商家自担成本降为(成本 − 团队池);池内按 D2 规则(`referral_tree` 层级树 + 直推档位权重)瓜分。
|
|
|
+- **分享注册(原 R3)**:已移出分润体系——保留为独立获客激励(+20CF/人、日限 10),**不参与订单分账**。
|
|
|
|
|
|
-### 3.1 账目示例(商品 A:售价 200 / 成本 100 / 体系 T=30%,假定直推 70% 档 / 间推 20% 档)
|
|
|
+### 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 | 商家/平台交付成本与利润 |
|
|
|
+| 顺序 | 通道 | 计算 | 金额 | 去向 |
|
|
|
+|---|---|---|---|---|
|
|
|
+| ① | 平台抽成 | 200 × 10% | **20** | 平台留存 |
|
|
|
+| ② | 消费返 CF | floor(200) × 100 = 200 CF | **200 CF(≈2 元)** | 消费者本人(成本) |
|
|
|
+| ③ | 商品成本 | — | 100 | 成本支出(其中 30 切出为团队池) |
|
|
|
+| — | **推荐人销售奖基数 base** | 200 − 20 − 2 − 100 | **78** | — |
|
|
|
+| ④ | 直推销售奖 | 78 × 70% | **54.6** | 直推上线 |
|
|
|
+| ⑤ | 间推销售奖 | 78 × 20% | **15.6** | 间推上线 |
|
|
|
+| ⑥ | 团队分润池 | 100 × 30% | **30** | 团队成员(成本侧切出,商家自担成本降为 70) |
|
|
|
+| ⑦ | 平台留存 | 200 − 2 − 54.6 − 15.6 − 70 | **57.8** | 平台/商家 |
|
|
|
+| — | ~~分享注册 +20CF~~ | 独立获客激励 | — | **不在订单分账内** |
|
|
|
+
|
|
|
+> 要点:**推荐人基数不是原始毛利 100,是扣减抽成与返 CF 后的 78**;团队池 30 不从 78 扣,而是从成本 100 侧切出。
|
|
|
|
|
|
### 3.2 与 v1 的关键差异
|
|
|
|
|
|
| 维度 | v1 | v2 |
|
|
|
|------|----|----|
|
|
|
-| 团队分佣来源 | 隐含在毛利池(直推/间推占毛利) | **独立成本池**(成本 × T%),与毛利脱钩 |
|
|
|
-| 平台收益 | 毛利剩余(无固定通道) | **固定 = 成交价 × 10%**,单列、永不参战 |
|
|
|
-| 推荐人基数 | 毛利(P 点) | 毛利(P 点),**不变** |
|
|
|
-| 消费返 CF | 有 | **维持** |
|
|
|
+| 团队分佣来源 | 隐含在毛利池 | **独立成本池**(成本 × T%),与 base 脱钩 |
|
|
|
+| 推荐人基数 | 毛利(实付−成本,如 100) | **扣减后可分配额 base**(实付 − 抽成 − 返CF − 成本,如 78) |
|
|
|
+| 平台收益 | 毛利剩余 | **固定抽成 10% + 扣减后留存 57.8** |
|
|
|
+| 消费返 CF | 有 | 维持,且**计入分润前扣减项** |
|
|
|
+| 分享注册奖励 | 列在分润体系内(R3) | **移出分润体系**(独立获客激励) |
|
|
|
|
|
|
## 4. 影响范围(供架构师细化)
|
|
|
|
|
|
@@ -58,7 +79,7 @@
|
|
|
- 新增团队池比例配置:体系维度(对应 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)毛利口径保留
|
|
|
+2. **结算顺序**(`CfCommissionService.settle`,同一事务):① 平台抽成记账 → ② 消费返 CF 发放(F02,已有 earnBuyerCf)→ ③ 计算 base = 实付 − 抽成 − 返CF成本 − 成本 → ④ 推荐人销售奖(base×直推档位% / base×间推档位%;base<0 时按 0,不得为负)→ ⑤ 团队池独立计算(成本×T%)并瓜分。`calcOrderPpoints` 毛利口径**保留作 v1 兼容/审计参照**,新发放以 base 为准。
|
|
|
3. **配置**:新配置键(如 `cf.team_pool.share_rate` 体系级默认 + `cf.platform.service_rate`=1000bps),进 `service_config` + `CfConfigKeys`
|
|
|
4. **层级瓜分**:`CfReferralService.matchDirectSalesTier`(134)/ `matchIndirectSalesTier`(149)复用方式设计(瓜分 = 档位占比加权)
|
|
|
5. **前端展示**:小程序推广页/财富页团队池展示(可后置);后台档位配置(G2 顺带收口)
|
|
|
@@ -69,7 +90,7 @@
|
|
|
2. 结算链路分叉:`CfCommissionService` 增加团队池计算与平台抽成记账(幂等/同家庭跳过/并发防护沿用现有模式)
|
|
|
3. 团队池瓜分:层级树快照 + 档位占比加权分配(参照 `materializeReferralTree` 69-97)
|
|
|
4. 配置端:`CfConfigKeys` + service_config 播种(CfRuleConfig.vue 扩展可选)
|
|
|
-5. 测试:账目示例断言(200/100 例)+ 多商品分摊 + 亏损仓 + 团队池幂等 + 同家庭跳过
|
|
|
+5. 测试:账目示例断言(200/100 例:base=78、直推54.6、间推15.6、池30、抽成20、返CF 200CF、留存57.8)+ 多商品分摊 + 亏损仓(base<0 → R2=0、团队池照发)+ 团队池幂等 + 同家庭跳过 + R3 不参与分账
|
|
|
|
|
|
## 6. 关联事项
|
|
|
|