소스 검색

docs(分润): 推荐人&团队分润双体系设计 v0.3 — 团队奖池从T中切20%(8份池=T×80%)

按主理人拍板修订:8份分佣池 T×70%→T×80%、团队奖池 T×30%→T×20%,
同步数学示例(40.8/每份5.1/6星30.6/团队奖10.2)与配置默认值、待拍板#2标记已拍板。
Agnes Agent 5 일 전
부모
커밋
0c57bbd49d
1개의 변경된 파일과 16개의 추가작업 그리고 16개의 파일을 삭제
  1. 16 16
      docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md

+ 16 - 16
docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md

@@ -1,10 +1,10 @@
 # 推荐人分润 & 团队分润双体系设计
 
-> **版本**:v0.2(按主理人 3 点意见修订,待评审)
+> **版本**:v0.3(按主理人最新拍板「团队奖从 T 中切 20%」修订,待评审)
 > **日期**:2026-11-07
 > **作者**:研发负责人
 > **状态**:🟡 待评审
-> **修订**:① 团队邀请参考家庭邀请(区分已加入/未加入平台);② 推荐人体系**沿用 CF 值**(现有 F03a/F03b),团队体系**新增货币直接分佣**;③ 补星级量化定义 + 团队奖。
+> **修订**:v0.2:① 团队邀请参考家庭邀请(区分已加入/未加入平台);② 推荐人体系**沿用 CF 值**(现有 F03a/F03b),团队体系**新增货币直接分佣**;③ 补星级量化定义 + 团队奖。v0.3:团队奖池从 T 中切 **20%**(8 份池 = T×80%)。
 
 ---
 
@@ -13,7 +13,7 @@
 本次设计**保持推荐人体系沿用现有 CF 值账本(F02 / F03a / F03b)**,仅**新增一套真金白银(货币)的团队分润体系**,用于把「平台留存的销售利润」分给**平台服务团队(规划师/测评师等)**:
 
 - **推荐人分润体系**:被推荐人消费时的推荐人分润**仍以 CF 值(平台积分)发放**——沿用现有 `CfCommissionService` 的 F03a 直接销售奖(≤70%)+ F03b 间接销售奖(≤20%),**不新增货币账本**。
-- **团队分润体系(本次新增)**:团队成员(规划师/测评师等平台人员)产生服务收入时,分**平台留存利润的 30%**,以**货币直接分佣**;内部按「8 份制 + 一星至六星」分配,另设**团队奖**(团队服务业绩越好拿得越多)。
+- **团队分润体系(本次新增)**:团队成员(规划师/测评师等平台人员)产生服务收入时,分**平台留存利润的 30%**,以**货币直接分佣**;其中 **80% 作 8 份制分佣池**(按一星至六星分配)、**20% 作团队奖池**(团队服务业绩越好拿得越多)。
 
 **核心原则(用户拍板)**:两个体系都支持**下级超越上级、多劳多得**——级别与比例均按**滚动业绩动态计算**,业绩涨则级别/份额涨,业绩跌则降,不固化层级绑定。
 
@@ -147,15 +147,15 @@ CfCommissionService.settle / settleReferrerOnly
 > **v0.2 修订(主理人意见②)**:团队采用**直接分佣(货币)**——这是本设计唯一的真金白银账本。
 
 **核心机制**(三块):
-- **8 份分佣池**:`T` 中默认 **70%** 切成 **8 份**(示例 `51×70%=35.7`,每份 `4.46` 元),按星级分给服务链上的成员。
-- **团队奖池**:`T` 中默认 **30%**(示例 `51×30%=15.3` 元),按**团队整体年度服务业绩档位**发放(团队服务越好拿得越多)——见 §4.4。
+- **8 份分佣池**:`T` 中默认 **80%** 切成 **8 份**(示例 `51×80%=40.8`,每份 `5.1` 元),按星级分给服务链上的成员。
+- **团队奖池**:`T` 中默认 **20%**(示例 `51×20%=10.2` 元),按**团队整体年度服务业绩档位**发放(团队服务越好拿得越多)——见 §4.4。
 - **触发门槛**:团队**年度滚动总服务业绩**达到该团队**单独设定的门槛**时,该团队才进入本次分红(每团队阈值独立配置)。
 
 ### 4.2 8 份分佣(对照用户示例)
 
-用户示例:6 星成员自服务 → `8份池35.7×6/8=26.78`;其引荐人 1 星 → `35.7×1/8=4.46`;引荐人的引荐人(不论星级)→ `35.7×1/8=4.46`(剩余,因 8 份已分完)。
+用户示例:6 星成员自服务 → `8份池40.8×6/8=30.6`;其引荐人 1 星 → `40.8×1/8=5.1`;引荐人的引荐人(不论星级)→ `40.8×1/8=5.1`(剩余,因 8 份已分完)。
 
-> **⚠️ 口径说明**:用户原文「51×6/8=38.25」是按 **51 全部进 8 份池** 的口径计算。v0.2 因新增**团队奖池(30%)**,8 份池变更为 `T×70%`。若主理人希望保持「51 全进 8 份」、团队奖另外追加,可配置 `team_profit.eight_share_ratio=100%`。**两种取数均可用,由配置驱动,算法不变**。
+> **⚠️ 口径说明**:用户原文「51×6/8=38.25」是按 **51 全部进 8 份池** 的口径计算。v0.3 按主理人拍板「团队奖从 T 中切 20%」,8 份池为 `T×80%`、团队奖池为 `T×20%`。若主理人希望保持「51 全进 8 份」、团队奖另外追加,可配置 `team_profit.eight_share_ratio=100%`。**两种取数均可用,由配置驱动,算法不变**。
 
 **分配链路(自上而下)**:服务提供者本人 → 其引荐人(上级) → 引荐人的引荐人(上上级),**最多三层**,共 8 份封顶:
 
@@ -205,7 +205,7 @@ CfCommissionService.settle / settleReferrerOnly
 
 ### 4.4 团队奖(用户意见③:团队服务好也要拿得多)
 
-**团队奖池**:`A = T × cfg_team_award_rate`(默认 30%,示例 15.3 元/单计提)。
+**团队奖池**:`A = T × cfg_team_award_rate`(默认 20%,示例 10.2 元/单计提)。
 
 **分配逻辑**:按「该服务订单所属团队的**年度滚动总服务业绩**」分档,业绩越好、团队奖倍数越高:
 
@@ -218,7 +218,7 @@ CfCommissionService.settle / settleReferrerOnly
 
 **归属**:团队奖发放给**该团队负责人**(`distribution_systems.owner_id` 优先,无则团队根节点),由其统筹分配(与现有分销 T37/C2 口径一致:「平台只向体系唯一负责人整体结算,团队内部分配平台不负责」)。如需平台代分(按成员星级比例),可配 `team_profit.award_distribute=owner|pro_rata`,默认 `owner`。
 
-**数学校验(示例)**:51 元中团队奖 15.3 元——团队业绩达 TA3 档 → 负责人得 15.3 元;未达门槛 → 回流平台。
+**数学校验(示例)**:51 元中团队奖 10.2 元——团队业绩达 TA3 档 → 负责人得 10.2 元;未达门槛 → 回流平台。
 
 ### 4.5 团队门槛与团队归属
 
@@ -233,7 +233,7 @@ CfCommissionService.settle / settleReferrerOnly
 服务订单完成(服务提供者 X 收入确认,D > 0)
   │
   ▼
-计算 T(§2.1)、8份池 = T×70%、团队奖池 = T×30%
+计算 T(§2.1)、8份池 = T×80%、团队奖池 = T×20%
   │
   ├─ 取 X 所属服务团队(distribution_system)
   ├─ 校验团队年度滚动总服务业绩 ≥ 团队门槛?
@@ -331,8 +331,8 @@ CREATE TABLE profit_pool_order (
   pool_cent INT NOT NULL COMMENT '可分配池D(分)',
   referral_share_cent INT NOT NULL COMMENT '推荐人体系R(分,CF值预算参照)',
   team_share_cent INT NOT NULL COMMENT '团队体系T(分,货币)',
-  team_eight_share_cent INT NOT NULL COMMENT '8份分佣池(分,默认T×70%)',
-  team_award_cent INT NOT NULL COMMENT '团队奖池(分,默认T×30%)',
+  team_eight_share_cent INT NOT NULL COMMENT '8份分佣池(分,默认T×80%)',
+  team_award_cent INT NOT NULL COMMENT '团队奖池(分,默认T×20%)',
   status VARCHAR(16) NOT NULL DEFAULT 'pending' COMMENT 'pending/settled/cancelled',
   created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
   settled_at DATETIME,
@@ -428,8 +428,8 @@ CREATE TABLE team_star_snapshot (
 | `referral_profit.cf_cost_rate` | 1% | CF 值成本占 S 比例 |
 | `referral_profit.referral_share` | 70% | 推荐人体系占 D 比例(CF 值预算参照) |
 | `referral_profit.team_share` | 30% | 团队体系占 D 比例(货币) |
-| `team_profit.eight_share_ratio` | 70% | 8 份分佣池占 T 比例 |
-| `team_profit.team_award_ratio` | 30% | 团队奖池占 T 比例(用户初稿口径:0% → 8份池=100%T) |
+| `team_profit.eight_share_ratio` | 80% | 8 份分佣池占 T 比例 |
+| `team_profit.team_award_ratio` | 20% | 团队奖池占 T 比例(用户初稿口径:0% → 8份池=100%T) |
 | `team_profit.star_tiers` | JSON | 星级业绩分门槛表(6 档) |
 | `team_profit.team_threshold` | JSON | 各服务团队年度业绩门槛(teamId→金额) |
 | `team_profit.share_total` | 8 | 8 份制分母 |
@@ -503,12 +503,12 @@ profit_pool_order(status=pending)  ← 计算 D/T/8份池/团队奖(幂等)
 
 ---
 
-## 11. 待主理人拍板事项(v0.2 更新)
+## 11. 待主理人拍板事项(v0.3 更新)
 
 | # | 事项 | 建议 |
 |:-:|------|------|
 | 1 | 用户示例「170×70%×70%=93.3」校正确认为 83.3(119×70%) | 采纳 83.3 校正口径(CF 值折算口径,非货币) |
-| 2 | **团队奖是否从 T 中切 30%**(8份池=T×70%)还是「51 全进 8 份、团队奖另行追加」 | 默认 70/30 拆分(配置可调为 100/0) |
+| 2 | **团队奖从 T 中切 20%**(8份池=T×80%)——主理人已拍板 | ✅ 已拍板:80/20 拆分(配置可调为 100/0) |
 | 3 | 团队奖归属:负责人统筹(owner)还是平台按星级代分(pro_rata) | 建议 owner(与现有 T37/C2 结算口径一致) |
 | 4 | 星级重评周期(订单实时 vs 月度快照) | 建议**订单支付时实时计算** + 月度快照供展示 |
 | 5 | 8 份制中第 3 层是否永远 1 份封顶 | 是(用户口径「只能拿剩下的」) |