Ver Fonte

docs(spec): 推荐人&团队分润体系设计 v0.2(按主理人3点修订:①团队邀请参考家庭邀请 ②推荐人沿用CF值/团队货币直接分佣 ③星级量化定义+团队奖)

Agnes Agent há 1 semana atrás
pai
commit
a7cbe807bd
1 ficheiros alterados com 265 adições e 207 exclusões
  1. 265 207
      docs/superpowers/specs/2026-11-07-referral-team-profit-sharing.md

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

@@ -1,22 +1,23 @@
-# 推荐人分润 & 团队分润双体系设计(真金白银利润分账)
+# 推荐人分润 & 团队分润双体系设计
 
-> **版本**:v0.1(设计稿,待主理人拍板后转开发)
+> **版本**:v0.2(按主理人 3 点意见修订,待评审)
 > **日期**:2026-11-07
 > **作者**:研发负责人
 > **状态**:🟡 待评审
+> **修订**:① 团队邀请参考家庭邀请(区分已加入/未加入平台);② 推荐人体系**沿用 CF 值**(现有 F03a/F03b),团队体系**新增货币直接分佣**;③ 补星级量化定义 + 团队奖。
 
 ---
 
 ## 0. TL;DR
 
-本次设计在**现有 CF 值统一账本(F02 / F03a / F03b)之外**,新增一套**真金白银(货币)利润分账体系**,用于把「平台留存的销售利润」分给**推荐人**与**平台服务团队(规划师/测评师等)**。两体系**相互独立**,按固定比例切分同一块利润池:
+本次设计**保持推荐人体系沿用现有 CF 值账本(F02 / F03a / F03b)**,仅**新增一套真金白银(货币)的团队分润体系**,用于把「平台留存的销售利润」分给**平台服务团队(规划师/测评师等)**:
 
-- **推荐人分润体系**:被推荐人消费时,分**平台留存利润的 70%**;内部再按「直接推荐人 / 间接推荐人 / 平台团队奖池 / 深层分红池」四路分配。
-- **团队分润体系**:团队成员(规划师/测评师等平台人员)产生服务收入时,给其上级团队分润,分**平台留存利润的 30%**;按「8 份制 + 一星至六星」分配。
+- **推荐人分润体系**:被推荐人消费时的推荐人分润**仍以 CF 值(平台积分)发放**——沿用现有 `CfCommissionService` 的 F03a 直接销售奖(≤70%)+ F03b 间接销售奖(≤20%),**不新增货币账本**。
+- **团队分润体系(本次新增)**:团队成员(规划师/测评师等平台人员)产生服务收入时,分**平台留存利润的 30%**,以**货币直接分佣**;内部按「8 份制 + 一星至六星」分配,另设**团队奖**(团队服务业绩越好拿得越多)。
 
 **核心原则(用户拍板)**:两个体系都支持**下级超越上级、多劳多得**——级别与比例均按**滚动业绩动态计算**,业绩涨则级别/份额涨,业绩跌则降,不固化层级绑定。
 
-> ⚠️ **与 CF 值体系边界**:CF 值(平台积分,1 元=100 CF)是**积分奖励**,走 `cf_balance` 账本;本设计是**货币分润**,走独立账本。两者并行不冲突。CF 值固定成本(消费额 1%)作为平台固定支出从利润池中先行扣除(见 §2)。
+> ⚠️ **与 CF 值体系边界**:CF 值(平台积分,1 元=100 CF)是**积分奖励**,走 `cf_balance` 账本;团队分润是**货币**,走独立账本。两者并行不冲突。CF 值固定成本(消费额 1%)作为平台固定支出从利润池中先行扣除(见 §2)。
 
 ---
 
@@ -33,13 +34,17 @@
 | `supply_system.platform_profit_rate`(平台留利 %) | 已有(供应链) | ⚠️ 参考 |
 | `service_config`(CF 通用配置中心) | 已有 | ✅ 配置载体 |
 | `commission_records` / `service_settlements` | 已有 | ⚠️ 只读历史/服务结算 |
+| `distribution_systems`(虚拟团队)+ `distribution_relations`(成员树) | 已有,含 `owner_id` 结算对象 + `profit_rate` | ✅ **团队载体(直接复用)** |
+| `DistributionService.generateInviteCode/findByInviteCode/registerByInviteCode/addRelation` | 已有团队邀请码 + 入团 | ✅ 团队邀请复用 |
+| `FamilyInviteController`(家庭邀请:token→小程序码→落地页→绑定) | 已有成熟模式 | ✅ **团队邀请参照实现** |
 | 旧货币佣金 `CommissionService.settle/settleTwoLevel`、`CommissionDistService.distribute` | 已废弃(@Deprecated / 410 Gone) | ❌ 不复用 |
 
 **关键结论**:
 1. 现有体系已把「货币佣金」**收口为 CF 值积分**(F02 消费人返 + F03a/F03b 两级销售奖),但那是**积分**,不是**现金分润**。用户本次要求的是**现金利润分账**。
-2. 平台留存利润的**成本载体已具备**:商品用 `products.purchase_price`;**服务(咨询/测评)尚无独立成本价字段**,需扩展(见 §6.4)。
-3. 团队规模/等级的旧机制(`cf_rate_tier`、`promotion_tier` R0-R4)**已废弃**,本次「一星至六星」为**全新等级模型**,不复用旧表,新建表(见 §6)。
-4. 推荐树、滚动一年 P 点统计、档位匹配模式均可直接复用,作为「多劳多得」动态计算的数据底座。
+2. 平台留存利润的**成本载体已具备**:商品用 `products.purchase_price`;**服务(咨询/测评)尚无独立成本价字段**,需扩展(见 §7.5)。
+3. 团队规模/等级的旧机制(`cf_rate_tier`、`promotion_tier` R0-R4)**已废弃**,本次「一星至六星」为**全新等级模型**,不复用旧表,新建表(见 §7)。
+4. **虚拟团队机制已存在**(`distribution_systems` + `distribution_relations`,含唯一负责人 `owner_id` 结算口径 T37/C2)——**团队载体直接复用**,团队邀请复用其邀请码,仅需补场景 A 推荐人绑定钩子与落地页(见 §5)。
+5. 推荐树、滚动一年 P 点统计、档位匹配模式均可直接复用,作为「多劳多得」动态计算的数据底座。
 
 ---
 
@@ -57,8 +62,8 @@
        ├─ 平台运营成本 10%        = 20 元   (平台留利,不可分)
        ├─ CF 值固定成本 1%         = 10 元   (消费者消费额 1% 的 CF 值奖励,固定支出)
        └─ 可分配利润池 D = 170 元  = P × (100% - 10% - 1%)
-            ├─ 推荐人体系 R = D × 70% = 119 元
-            └─ 团队体系   T = D × 30% = 51 元
+            ├─ 推荐人体系 R = D × 70% = 119 元 → **以 CF 值发放**(沿用 F03a/F03b,预算参照)
+            └─ 团队体系 T = D × 30% = 51 元 → **货币直接分佣(本次新增)**
 ```
 
 > **保本校验**:平台至少卖到保本线才不亏。
@@ -76,11 +81,13 @@
 | 平台运营 `O` | `round(P × cfg_platform_ops_rate)` | 默认 10% |
 | CF 值成本 `F` | `round(S × cfg_cf_cost_rate)` | 默认 1%(消费额口径) |
 | 可分配池 `D` | `P - O - F` | `D ≤ 0` 则不触发分润(保本线以下) |
-| 推荐人体系 `R` | `round(D × cfg_referral_share)` | 默认 70% |
-| 团队体系 `T` | `round(D × cfg_team_share)` | 默认 30% |
+| 推荐人体系 `R` | `round(D × cfg_referral_share)` | 默认 70% → **CF 值**(沿用 F03a/F03b,预算参照) |
+| 团队体系 `T` | `round(D × cfg_team_share)` | 默认 30% → **货币直接分佣(新增)** |
 
 > `R + T = D`。所有比率入 `service_config`(见 §6.6),允许平台按商品/服务类型单独覆盖。
 
+> ⚠️ **v0.2 口径修订**:`R`(70%)不再设计独立的货币推荐人账本——推荐人分润沿用现有 CF 值体系(F03a 直接销售奖 ≤70%、F03b 间接销售奖 ≤20%,按推荐人团队/自身滚动一年 P 点档位发放,见 §3)。**本次设计增量 = 团队体系 `T`(30%)的货币直接分佣(§4)+ 团队邀请(§5)**。
+
 ### 2.2 触发条件
 
 - `D > 0` 才进入分润流程;`D ≤ 0`(售价低于保本线)则整单不产生推荐人/团队分润,仅记录。
@@ -88,193 +95,227 @@
 
 ---
 
-## 3. 推荐人分润体系(体系一,占可分配池 70%)
-
-### 3.1 内部四路分配
-
-推荐人体系总额 `R`(示例 119 元)内部拆成**四路**,比例默认值如下(全部可配):
-
-```
-R = 119 元
- ├─ ① 直接推荐人(L1)   default 60%,上限 70%
- ├─ ② 间接推荐人(L2)   default 10%,上限 10%
- ├─ ③ 平台团队奖池        default 20%(固定留存,转入团队普惠/平台团队基金)
- └─ ④ 深层分红池          default 10%(保底,给推荐层级 > 3 的所有人)
-```
-
-> **数学校验(对照用户原文)**:用户例「170×70%×70%=93.3」——按 `R=119`,直接上限 70% 应为 `119×70%=83.3`(用户笔误为 93.3,已按自洽口径校正,比例均可配,最终以主理人拍板为准)。间接 `119×10%=11.9` 与用户一致。团队奖池 `119×20%=23.8`。
-
-**「最多拿」语义 = 动态档位上限**(见 3.2),未满档部分自动归入④深层分红池,保证四路恒等于 `R`,不超发。
-
-### 3.2 直接推荐人(L1)—— 动态档位,多劳多得
+## 3. 推荐人分润体系(体系一,占可分配池 70% —— 沿用 CF 值,不新增货币账本)
 
-**比例不是固定 70%,而是按直接推荐人的滚动业绩分档**(这是「下级超越上级」的第一抓手):
+> **v0.2 修订(主理人意见②)**:推荐人体系**仍用 CF 值**,即**沿用现有 `CfCommissionService` 的 F03a 直接销售奖 + F03b 间接销售奖**(`cf_balance` 账本,积分),**不另设货币分账**。`R = D×70%` 仅作为平台对推荐人分润成本(CF 值发行成本)的**预算参照上限**,实际发放量仍按 F03a/F03b 档位比例计算。
 
-| 档位 | 条件(直接推荐人「团队 8 层内滚动一年累计 P 点」) | L1 比例 |
-|:----:|--------------------------------------------------|:------:|
-| D1 | < 5,000 | 50% |
-| D2 | 5,000 – 19,999 | 55% |
-| D3 | 20,000 – 49,999 | 60%(默认) |
-| D4 | 50,000 – 99,999 | 65% |
-| D5 | ≥ 100,000 | **70%(上限)** |
+### 3.1 现有实现(直接复用,不改)
 
-- **数据源**:直接复用 `CfReferralService.getTeamAnnualPpoints(referrerId, 8)`(滚动一年,团队 8 层)。
-- **动态性**:业绩涨 → 档位涨 → 比例涨;业绩跌(滚动窗口滑出)→ 自动降档。**天然支持下级超越上级**:下级团队业绩超过上级时,下级 L1 比例可高于上级,体现多劳多得。
-- 档位阈值表存 `service_config`(`referral.l1_tiers` JSON),允许平台运营调整。
+| 项 | 现有实现 | 说明 |
+|----|---------|------|
+| 消费人返 CF | F02(`CfEarnDispatchService.earnConsumeCf`) | 1 元 = 100 CF,按实付金额 |
+| 直接销售奖 | **F03a**(`CfCommissionService`,rule=F03a) | 基数=本单 P 点;比例按推荐人**团队 8 层内滚动一年累计 P 点**档位,**上限 70%** |
+| 间接销售奖 | **F03b**(`CfCommissionService`,rule=F03b) | 基数=本单 P 点;比例按推荐人**自身滚动一年累计消费 P 点**档位,**上限 20%** |
+| 档位表 | `cf_direct_sales_tier` / `cf_indirect_sales_tier` | 比例与金额由 `cf_earn_rule` 公式驱动 |
+| 同家庭互推 | D5:跳过同家庭,向上上溯 | 最多两级(L1+L2) |
+| 幂等 | `cf_balance_log` 唯一键 | 重复回调不重复发放 |
 
-### 3.3 间接推荐人(L2)—— 动态档位,多劳多得
-
-按间接推荐人**自身滚动一年累计消费 P 点**分档(数据源 `CfReferralService.getSelfAnnualPpoints`),上限 10%:
-
-| 档位 | 条件(自身滚动一年 P 点) | L2 比例 |
-|:----:|------------------------|:------:|
-| I1 | < 2,000 | 0% |
-| I2 | 2,000 – 9,999 | 5% |
-| I3 | ≥ 10,000 | **10%(上限)** |
-
-> L2 为 0% 时(间接推荐人不活跃),其份额自动并入④深层分红池,鼓励激活深层网络。
-
-### 3.4 深层分红池(④)—— 推荐层级 > 3 的所有人
-
-**资格**:订单推荐链上 `referral_tree.level >= 4`(即超过 3 层的所有上游推荐人)。
-
-**分配规则**(用户口径,按贡献而非人头):
-- 池内金额 `B`(= R 剩余,默认 10%,保底)。
-- 每个合格推荐人 `u` 的权重:
-
-```
-w(u) = ( 个人月消费占比 × 70% ) + ( 团队月消费占比 × 30% )
-个人月消费占比   = u 本月在平台消费额 / 全平台本月消费总额
-团队月消费占比   = u 团队(8 层内)本月消费额 / 全平台所有团队本月消费总额
-```
+> **与用户最初口径的对照**:用户初稿「直接最多拿 70%、间接最多拿 10%」——现有 F03a 上限 70% 已一致;**F03b 现有上限 20% 高于用户初稿的 10%**。主理人意见②「推荐人体系还是用 CF 值」即接受现有 F03a/F03b;如仍想按初稿收窄 F03b 至 10%,仅需调整 `cf_indirect_sales_tier` 档位配置(不改代码),已列入 §10 待拍板第 10 项。
 
-- `u` 应得 = `B × w(u) / Σw`(归一化)。
-- **意义**:把超出两级销售奖的**深层推荐人**也纳入分红,且**按真实消费/团队贡献**分配,而非层级人头——既不构成「三级计酬」,又鼓励做大团队消费。这是「下级超越上级、多劳多得」的第二抓手。
+### 3.2 数学校验(对照用户原文)
 
-> **注意(合规)**:④分红池按**消费占比**而非层级固定比例分配,属平台对贡献者的分红激励,非层级计酬。仍需法务确认(见 §9 合规红线)。
+- 用户例「170×70%×70%=93.3」——按 `R=119`,直接上限 70% 应为 `119×70%=83.3`(用户笔误为 93.3,已按自洽口径校正,比例可配)。
+- 间接 `119×10%=11.9` 与用户一致(若按现有 F03b 上限 20% 则为 `119×20%=23.8`)。
+- **说明**:这些是「CF 值折现金额」口径(1 元=100 CF),用于预算参照;实际 CF 值发放走 F03a/F03b 档位。
 
-### 3.5 推荐人体系完整流程
+### 3.3 流程(沿用现有,无新增)
 
 ```
 订单支付成功
   │
   ▼
-计算 D、R(§2.1)
-  │
-  ├─ 查买家 referral_tree 全链(level 1..n)
-  ├─ 跳过同家庭(D5 规则:同家庭互推不返,向上上溯)
-  │
-  ├─ L1 = 第 1 个非同家庭推荐人 → 按其团队年度 P 点档位拿 ③(上限70%)
-  ├─ L2 = 第 2 个非同家庭推荐人 → 按其自身年度 P 点档位拿 ②(上限10%)
-  ├─ 平台团队奖池 ③ = R × 20%(固定)
-  └─ 分红池 ④ = R - ①实发 - ②实发 - ③(≥保底)
-         │
-         ▼
-     按 §3.4 权重分给 level≥4 的合格推荐人
+CfCommissionService.settle / settleReferrerOnly
+  ├─ 消费人返 CF(F02)
+  ├─ 本单 P 点基数(§4.4 折算)
+  ├─ 上溯前两级非同家庭推荐人(D5)
+  │    ├─ L1 → F03a(团队 8 层滚动一年 P 点档位,≤70%)
+  │    └─ L2 → F03b(自身滚动一年 P 点档位,≤20%)
+  └─ 发放走 cf_balance + cf_balance_log(幂等)
   │
   ▼
-落库:referral_profit_record(逐人逐单,幂等 ref_type+ref_id)
+(本设计不动此链路;仅记录 D/R 供团队体系预算参照)
 ```
 
----
+> **本设计对推荐人体系的唯一改动 = 记录 `profit_pool_order.referral_share_cent`(预算参照),不改变 F03a/F03b 发放逻辑。**
 
-## 4. 团队分润体系(体系二,占可分配池 30%)
+## 4. 团队分润体系(体系二,占可分配池 30% —— 货币直接分佣,本次新增)
 
 ### 4.1 概念
 
 团队分润分的是**平台留存利润的 30%**(示例 `T = 51` 元),面向**平台服务团队人员**(规划师/测评师等)——即:平台人员产生服务收入时,给其**上级团队成员**分润,鼓励团队带教与裂变。
 
-**核心机制**:
-- **8 份制**:团队佣金池 `T` 固定切成 **8 份**(示例每份 `51/8 = 6.375 ≈ 6.38` 元)。
-- **星级(一星至六星)**:每个团队成员按**滚动业绩**评星,星级决定其**最多拿 6 份**中的份额(1★=1份 … 6★=6份)。
-- **触发门槛**:团队**年度滚动总服务业绩**达到该团队**单独设定的阈值**时,该团队才进入本次分红(每团队阈值独立配置)。
+> **v0.2 修订(主理人意见②)**:团队采用**直接分佣(货币)**——这是本设计唯一的真金白银账本。
+
+**核心机制**(三块):
+- **8 份分佣池**:`T` 中默认 **70%** 切成 **8 份**(示例 `51×70%=35.7`,每份 `4.46` 元),按星级分给服务链上的成员。
+- **团队奖池**:`T` 中默认 **30%**(示例 `51×30%=15.3` 元),按**团队整体年度服务业绩档位**发放(团队服务越好拿得越多)——见 §4.4。
+- **触发门槛**:团队**年度滚动总服务业绩**达到该团队**单独设定的门槛**时,该团队才进入本次分红(每团队阈值独立配置)。
+
+### 4.2 8 份分佣(对照用户示例)
 
-### 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 星成员自服务 → `51×6/8 = 38.25`;其引荐人 1 星 → `51×1/8 = 6.38`;引荐人的引荐人(不论星级)→ `51×1/8 = 6.37`(剩余,因 8 份已分完)。
+> **⚠️ 口径说明**:用户原文「51×6/8=38.25」是按 **51 全部进 8 份池** 的口径计算。v0.2 因新增**团队奖池(30%)**,8 份池变更为 `T×70%`。若主理人希望保持「51 全进 8 份」、团队奖另外追加,可配置 `team_profit.eight_share_ratio=100%`。**两种取数均可用,由配置驱动,算法不变**。
 
-> **分配链路(自上而下)**:服务提供者本人 → 其引荐人(上级) → 引荐人的引荐人(上上级),**最多三层**,共 8 份封顶:
-> - **第 1 层(服务者本人)**:按本人星级拿 `星级份数`(1★=1份…6★=6份)。
-> - **第 2 层(引荐人)**:按引荐人星级拿 `星级份数`(1★=1份…最多 6 份,但受 8 份总额约束)。
-> - **第 3 层(引荐人的引荐人)**:拿**剩余份额**(8 - 前两层已分),不论星级,封顶 1 份的语义(用户「只能拿剩下的」)。
+**分配链路(自上而下)**:服务提供者本人 → 其引荐人(上级) → 引荐人的引荐人(上上级),**最多三层**,共 8 份封顶:
 
-**一般化规则**:
 ```
 剩余份数 = 8
 第1层(服务者本人) 分得 min(本人星级, 剩余);剩余 -= 已分
 第2层(引荐人)     分得 min(引荐人星级, 剩余);剩余 -= 已分
 第3层(再上级)     分得 剩余(封顶为剩余全部)
 ```
-- 若某层无对应人员(如服务者无引荐人),则该层份额**回流**(并入团队奖池或平台,见 §4.4)。
-- 金额 = `T × 份数 / 8`。
 
-### 4.3 星级定义(多劳多得 + 下级超越上级的第三抓手)
+- 若某层无对应人员(如服务者无引荐人),则该层份额**回流**团队奖池(§4.4)或平台,不私发。
+- 金额 = `8份池 × 份数 / 8`。
 
-**星级**由**滚动加权业绩分**决定,每自然月/季度重评:
+### 4.3 星级定义(用户意见③:量化口径,多劳多得 + 下级超越上级)
+
+**星级 = 本人近 12 个月(滚动)加权业绩分的档位映射**,数据源全部来自**平台既有流水表**,无主观打分之项:
 
 ```
-业绩分 = 直接服务收入 × 50%
-       + 团队服务收入 × 40%(仅统计「能拿到推荐奖」的服务订单,防止空转)
-       + 推荐用户平台消费收入 × 10%
+业绩分 Score = 直接服务收入(元) × 50%
+             + 团队服务收入(元) × 40%(仅统计「能拿到 F03a 推荐奖」的服务订单,防止空转)
+             + 推荐用户平台消费收入(元) × 10%
 ```
 
-| 星级 | 业绩分门槛(示例,可配) |
-|:----:|------------------------|
-| 一星 | ≥ 0 |
-| 二星 | ≥ 5,000 |
-| 三星 | ≥ 20,000 |
-| 四星 | ≥ 50,000 |
-| 五星 | ≥ 100,000 |
-| 六星 | ≥ 200,000 |
+| 变量 | 定义 | 数据源(现成) |
+|------|------|---------------|
+| 直接服务收入 | 本人作为服务提供者(规划师/测评师)滚动一年实际获得的服务费 | `service_settlements.provider_id=本人 AND status='settled'` |
+| 团队服务收入 | 本人团队(`referral_tree` 8 层内"**同为平台服务人员**"子集)滚动一年服务费,且**该服务订单实际发放了 F03a** | `service_settlements` × `cf_balance_log(ref_type='F03a')` 交集 |
+| 推荐用户平台消费收入 | 被本人`referral_tree`直接/间接推荐的非团队用户,滚动一年平台消费额(售价口径) | `ppoint_consumption_log`(或 `product_orders` 实付) |
+
+**星级↔档位映射**(默认值,可配 `team_profit.star_tiers`):
+
+| 星级 | 业绩分门槛(示例) | 8 份分佣可拿份数 |
+|:----:|:------------------:|:----------------:|
+| 一星 | ≥ 0(入团即一星) | 1 |
+| 二星 | ≥ 5,000 | 2 |
+| 三星 | ≥ 20,000 | 3 |
+| 四星 | ≥ 50,000 | 4 |
+| 五星 | ≥ 100,000 | 5 |
+| 六星 | ≥ 200,000 | **6(最多)** |
+
+**重评机制**:
+- **周期**:每月 1 日 00:30 定时重评(`team_star_snapshot` 落快照),或按订单支付时**实时计算**(推荐:订单结算时实时算,避免月快照滞后)。
+- **升降规则**:滚动窗口滑出 → 业绩分自然下降 → 星级自动降;业绩涨 → 星级自动升。**不保留历史级别、不固化**。
+- **快照锁定**:一笔订单的分配以**支付成功时刻**该成员的星级为准(写入 `team_share_record` 快照),后续星级变动不影响已结算历史。
 
-> **下级超越上级**:星级按业绩滚动计算,**不绑定层级**。下级业绩好 → 可评 6 星 → 自服务拿 6 份;其上级业绩差 → 只评 1 星 → 引荐人只拿 1 份。**下级拿的可以超过上级**,体现多劳多得。
+> **下级超越上级(用户核心原则)**:星级按当期滚动业绩计算,与层级身份无关。下级业绩好 → 6 星 → 自服务拿 6 份;上级业绩差 → 1 星 → 引荐人只拿 1 份。**下级拿的可以超过上级**。
 
-### 4.4 团队门槛与团队归属
+### 4.4 团队奖(用户意见③:团队服务好也要拿得多)
 
-- **团队**:以「平台服务人员(规划师/测评师)」为根节点的**服务团队**,团队成员=其服务推荐链(`referral_tree` 8 层内)中**同为平台服务人员**的子集。
-- **触发门槛**:`team_share_threshold`(每团队独立配置,默认由平台运营设置;也可按团队规模动态给)。
-- **团队年度滚动总服务业绩**:该团队所有成员(含本人)**滚动一年**(按服务订单时间)的服务收入合计,数据源 `service_settlements`(或新表 `service_revenue_log`)。
-- **回流规则**:某层无对应人员/未达门槛时,份额回流至**平台团队奖池**(③)用于普惠或下一周期滚动,不私发。
+**团队奖池**:`A = T × cfg_team_award_rate`(默认 30%,示例 15.3 元/单计提)。
 
-### 4.5 团队体系完整流程
+**分配逻辑**:按「该服务订单所属团队的**年度滚动总服务业绩**」分档,业绩越好、团队奖倍数越高:
+
+| 档位 | 团队年度滚动总服务业绩(可配) | 团队奖发放比例 |
+|:----:|:-----------------------------:|:--------------:|
+| TA0 | < 团队门槛 | 0%(不进入分红,回流平台) |
+| TA1 | 门槛 ~ 门槛×2 | 50% |
+| TA2 | 门槛×2 ~ 门槛×4 | 80% |
+| TA3 | ≥ 门槛×4 | **100%** |
+
+**归属**:团队奖发放给**该团队负责人**(`distribution_systems.owner_id` 优先,无则团队根节点),由其统筹分配(与现有分销 T37/C2 口径一致:「平台只向体系唯一负责人整体结算,团队内部分配平台不负责」)。如需平台代分(按成员星级比例),可配 `team_profit.award_distribute=owner|pro_rata`,默认 `owner`。
+
+**数学校验(示例)**:51 元中团队奖 15.3 元——团队业绩达 TA3 档 → 负责人得 15.3 元;未达门槛 → 回流平台。
+
+### 4.5 团队门槛与团队归属
+
+- **团队**:以「平台服务人员(规划师/测评师)」为根的**分销服务团队**(复用 `distribution_systems` + `distribution_relations` 虚拟团队机制),团队成员 = 团队树内**同为平台服务人员**的成员。
+- **触发门槛**:`distribution_systems.profit_rate ≈ 团队门槛`(每团队独立配置;或 `team_profit.team_threshold` JSON 按 teamId 设定)。
+- **团队年度滚动总服务业绩**:该团队所有成员(含负责人)**滚动一年**服务收入合计,数据源 `service_settlements`。
+- **回流规则**:未达门槛 / 某层无人 / 8 份未分完 → 回流**平台团队奖励基金**(管理端可查看),用于下期普惠或平台留存,不私发。
+
+### 4.6 团队体系完整流程
 
 ```
-服务订单完成(服务提供者 X 收入确认)
+服务订单完成(服务提供者 X 收入确认,D > 0)
   │
   ▼
-计算 T(§2.1)
+计算 T(§2.1)、8份池 = T×70%、团队奖池 = T×30%
   │
-  ├─ 取 X 所属服务团队(X 为根的服务链)
+  ├─ 取 X 所属服务团队(distribution_system)
   ├─ 校验团队年度滚动总服务业绩 ≥ 团队门槛?
-  │     └─ 否 → 本次不进入团队分红,份额回流平台团队奖池
-  ├─ 评 X 星级(§4.3)→ 份数
-  ├─ 评 X 引荐人星级 → 份数
-  ├─ 评 X 引荐人的引荐人 → 剩余份额
+  │     └─ 否 → 8 份池与团队奖全部回流平台奖励基金
   │
-  ▼
-落库:team_share_record(逐单逐人,幂等 ref_type+ref_id)
+  ├─【8 份池】
+  │    ├─ 实时算 X 星级(§4.3)→ 份数
+  │    ├─ 实时算 X 引荐人星级 → 份数
+  │    ├─ 第3层(引荐人的引荐人)→ 剩余份额
+  │    └─ 落 team_share_record(逐单逐人,幂等)
+  │
+  └─【团队奖池】
+       ├─ 按团队年度业绩分档(§4.4)→ 发放比例
+       └─ 发放给团队负责人(owner_id/根)→ 落 team_award_record(幂等)
 ```
 
 ---
 
-## 5. 「下级超越上级、多劳多得」机制汇总
+## 5. 团队邀请(用户意见①:参考家庭邀请实现)
+
+> 团队邀请**复用家庭邀请的成熟模式**(`FamilyInviteController`:生成 token/邀请码 → 小程序码 → 落地页校验 → 绑定关系),复用现有分销邀请码(`DistributionService.generateInviteCode` 已生成 8 位码)。关键差异 = **按被邀请人是否已加入平台分流**:
+
+### 5.1 两种场景分流
+
+| 场景 | 被邀请人状态 | 建立的关系 | 说明 |
+|:----:|------------|-----------|------|
+| A | **未加入平台**(从未注册) | **推荐人关系 + 团队关系** | 注册时同时绑定 `user.referrerId`(可拿 F03a/F03b)+ 加入团队树(`distribution_relations`) |
+| B | **已加入平台**(老用户) | **仅团队关系** | 只加入团队树(`distribution_relations`),**不改变既有推荐人关系** |
+
+### 5.2 流程设计
+
+```
+团队负责人/成员生成邀请
+  ├─ POST /api/team-invite/generate  → 返回 inviteCode + 小程序码(wxacode, 落地页)
+  └─ 复用现有 distribution 邀请码(relation.invite_code),落地页 scenes 带 code=
+
+被邀请人扫码 → 落地页(新增 pages/team-invite/join 或复用 pages/invite/join)
+  ├─ 未登录 → 微信登录(注册)
+  │     └─ 场景 A:注册成功 → 同时执行
+  │          ① user.referrerId = 邀请人(+ referral_tree 物化)
+  │          ② distribution_relations 插入(system_id, parent=邀请人, depth=邀请人depth+1)
+  ├─ 已登录 → 校验本人是否已在平台
+  │     └─ 场景 B:仅执行②(幂等:已在团队则提示/跳过)
+  └─ 已在该团队 → 提示「您已在团队中」
+
+校验与审批(参考家庭邀请):
+  ├─ 校验:POST /api/team-invite/validate → 返回 团队名/邀请人/团队业绩 预览
+  └─ 审批:团队负责人可在管理端查看成员申请/加入记录(可选,默认邀请即入)
+```
+
+### 5.3 现有可复用资产(已核查)
+
+| 资产 | 现状 | 复用方式 |
+|------|------|---------|
+| `DistributionService.generateInviteCode` | 已为团队成员生成 8 位邀请码 | 直接复用 |
+| `DistributionService.findByInviteCode` | 已按邀请码查 relation | 校验用 |
+| `DistributionService.registerByInviteCode` | 已支持**新用户**按邀请码入团 | 场景 A 在此基础上补推荐人绑定 |
+| `DistributionService.addRelation` | 已支持按 parentId 加入团队 | 场景 B 直接复用 |
+| `CommissionService.bindReferral` + `CfReferralService.materializeReferralTree` | 推荐关系绑定 + 树物化 | 场景 A 补调用 |
+| 家庭邀请落地页 + wxacode | `pages/invite/join` | 参照新建团队邀请页 |
+
+> **结论**:团队邀请**无需新表**(复用 `distribution_relations.invite_code`),新增工作量 = ① 场景 A 注册链路补「推荐人绑定」钩子;② 落地页/小程序码(参照家庭邀请);③ 场景 B 幂等入团接口。已列入 §12 落地计划 T1/T2。
+
+---
+
+## 6. 「下级超越上级、多劳多得」机制汇总(v0.2)
 
 | # | 抓手 | 体系 | 机制 | 效果 |
 |:-:|------|:----:|------|------|
-| 1 | L1 动态档位 | 推荐人 | 按团队年度 P 点分档(50%→70%) | 下级团队业绩高 → 比例超上级 |
-| 2 | L2 动态档位 | 推荐人 | 按自身年度 P 点分档(0%→10%) | 不活跃者 0%,份额让渡 |
-| 3 | 分红池按贡献 | 推荐人 | 按个人/团队消费占比分配 | 深层贡献者多劳多得,非人头 |
-| 4 | 星级滚动重评 | 团队 | 业绩分 50/40/10 加权评 1-6 星 | 下级业绩好可评 6 星,超上级 |
-| 5 | 8 份制封顶 | 团队 | 按星级份数,最多 6 份 | 层级固定但份额动态 |
-| 6 | 滚动窗口滑出 | 两者 | 业绩下跌自动降档/降星 | 不躺在历史功劳簿上 |
+| 1 | F03a/F03b 动态档位 | 推荐人(CF值) | 按团队/自身年度 P 点分档(原有) | 业绩涨比例涨 |
+| 2 | 星级滚动重评 | 团队 | 业绩分 50/40/10 加权评 1-6 星 | 下级业绩好可评 6 星,超上级 |
+| 3 | 8 份制封顶 | 团队 | 按星级份数,最多 6 份 | 层级身份不固化 |
+| 4 | **团队奖按业绩分档** | 团队 | 团队年度业绩越好、团队奖发越多 | 团队整体多劳多得 |
+| 5 | 滚动窗口滑出 | 两者 | 业绩下跌自动降档/降星 | 不躺在历史功劳簿上 |
 
-> **共同底层**:所有比例/星级都从**滚动业绩**(`ppoint_consumption_log` / 服务收入)实时计算,**不固化层级绑定**。这就是「下级超越上级」的本质——不是靠层级身份,而是靠当期真实贡献。
+> **共同底层**:所有星级/比例/团队奖都从**滚动业绩**(`service_settlements` / `ppoint_consumption_log` / `cf_balance_log`)实时计算,**不固化层级绑定**。「下级超越上级」的本质 = 靠当期真实贡献,不靠层级身份。
 
 ---
 
-## 6. 数据模型与配置
+## 7. 数据模型与配置
 
-### 6.1 新表:`profit_pool_order`(每单利润池计算明细,幂等)
+### 7.1 新表:`profit_pool_order`(每单利润池计算明细,幂等)
 
 ```sql
 CREATE TABLE profit_pool_order (
@@ -288,8 +329,10 @@ CREATE TABLE profit_pool_order (
   ops_cent INT NOT NULL COMMENT '平台运营O(分)',
   cf_cost_cent INT NOT NULL COMMENT 'CF值成本F(分)',
   pool_cent INT NOT NULL COMMENT '可分配池D(分)',
-  referral_share_cent INT NOT NULL COMMENT '推荐人体系R(分)',
-  team_share_cent INT NOT NULL COMMENT '团队体系T(分)',
+  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%)',
   status VARCHAR(16) NOT NULL DEFAULT 'pending' COMMENT 'pending/settled/cancelled',
   created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
   settled_at DATETIME,
@@ -297,27 +340,11 @@ CREATE TABLE profit_pool_order (
 ) COMMENT='单笔订单利润池计算明细';
 ```
 
-### 6.2 新表:`referral_profit_record`(推荐人分润流水)
+### 7.2 复用(不新建):推荐人分润流水
 
-```sql
-CREATE TABLE referral_profit_record (
-  id BIGINT PRIMARY KEY AUTO_INCREMENT,
-  order_id BIGINT NOT NULL,
-  order_type VARCHAR(32) NOT NULL,
-  pool_id BIGINT NOT NULL COMMENT '关联profit_pool_order.id',
-  referrer_user_id BIGINT NOT NULL COMMENT '获得分润的推荐人',
-  level INT NOT NULL COMMENT '1=L1直接 2=L2间接 4+=深层分红池',
-  share_cent INT NOT NULL COMMENT '分润金额(分)',
-  rule_code VARCHAR(20) COMMENT 'L1D1..L1D5 / L2I1..L2I3 / POOL',
-  rate_percent INT COMMENT '实际比例(%)',
-  status VARCHAR(16) DEFAULT 'pending' COMMENT 'pending/settled/cancelled',
-  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-  UNIQUE KEY uk_order_ref (order_id, referrer_user_id, level),
-  KEY idx_referrer (referrer_user_id)
-) COMMENT='推荐人分润流水(货币)';
-```
+推荐人体系走 CF 值,**沿用现有 `cf_balance_log`(ref_type=F03a/F03b)**,不新建货币流水表。
 
-### 6.3 新表:`team_share_record`(团队分润流水)
+### 7.3 新表:`team_share_record`(8 份分佣流水,货币)
 
 ```sql
 CREATE TABLE team_share_record (
@@ -328,17 +355,36 @@ CREATE TABLE team_share_record (
   provider_user_id BIGINT NOT NULL COMMENT '服务提供者(规划师/测评师)',
   recipient_user_id BIGINT NOT NULL COMMENT '获得分润的团队成员',
   layer INT NOT NULL COMMENT '1=服务者本人 2=引荐人 3=引荐人的引荐人',
-  star_level INT COMMENT '该成员当前星级(1-6)',
+  star_level INT COMMENT '该成员当期星级快照(1-6)',
   shares INT NOT NULL COMMENT '分得份数(0-8)',
   share_cent INT NOT NULL COMMENT '分润金额(分)',
   status VARCHAR(16) DEFAULT 'pending' COMMENT 'pending/settled/cancelled',
   created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
   UNIQUE KEY uk_order_rec (order_id, recipient_user_id, layer),
   KEY idx_recipient (recipient_user_id)
-) COMMENT='团队分润流水(货币)';
+) COMMENT='团队8份分佣流水(货币)';
 ```
 
-### 6.4 扩展:服务成本价载体
+### 7.4 新表:`team_award_record`(团队奖流水,货币)
+
+```sql
+CREATE TABLE team_award_record (
+  id BIGINT PRIMARY KEY AUTO_INCREMENT,
+  order_id BIGINT NOT NULL,
+  order_type VARCHAR(32) NOT NULL,
+  pool_id BIGINT NOT NULL,
+  team_id BIGINT NOT NULL COMMENT 'distribution_systems.id',
+  owner_user_id BIGINT NOT NULL COMMENT '团队负责人(owner_id/根)',
+  tier VARCHAR(8) NOT NULL COMMENT 'TA0/TA1/TA2/TA3',
+  award_cent INT NOT NULL COMMENT '团队奖金额(分)',
+  status VARCHAR(16) DEFAULT 'pending' COMMENT 'pending/settled/cancelled',
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE KEY uk_order_team (order_id, team_id),
+  KEY idx_owner (owner_user_id)
+) COMMENT='团队奖流水(货币)';
+```
+
+### 7.5 扩展:服务成本价载体
 
 商品已有 `products.purchase_price`。**服务(咨询/测评)**需要成本价字段。建议新增表:
 
@@ -354,7 +400,7 @@ CREATE TABLE service_cost_config (
 ) COMMENT='平台服务成本价配置(货币分润成本载体)';
 ```
 
-### 6.5 新表:`team_star_snapshot`(星级与业绩分快照,重评用)
+### 7.6 新表:`team_star_snapshot`(星级与业绩分快照,重评用)
 
 ```sql
 CREATE TABLE team_star_snapshot (
@@ -370,37 +416,41 @@ CREATE TABLE team_star_snapshot (
 ) COMMENT='团队成员星级月度快照';
 ```
 
-### 6.6 配置项(全部入 `service_config`,`group_key='referral_profit'` / `'team_profit'`)
+### 7.7 团队邀请(不新建表)
+
+复用 `distribution_relations.invite_code` + 现有分销服务(§5.3),参照家庭邀请模式新增落地页与场景 A 绑定钩子即可。
+
+### 7.8 配置项(全部入 `service_config`,`group_key='team_profit'`)
 
 | config_key | 默认值 | 说明 |
 |-----------|:------:|------|
 | `referral_profit.ops_rate` | 10% | 平台运营成本占 P 比例 |
 | `referral_profit.cf_cost_rate` | 1% | CF 值成本占 S 比例 |
-| `referral_profit.referral_share` | 70% | 推荐人体系占 D 比例 |
-| `referral_profit.team_share` | 30% | 团队体系占 D 比例 |
-| `referral_profit.l1_tiers` | JSON | L1 动态档位表(D1-D5) |
-| `referral_profit.l2_tiers` | JSON | L2 动态档位表(I1-I3) |
-| `referral_profit.team_award_rate` | 20% | ③平台团队奖池占 R 比例 |
-| `referral_profit.pool_min_rate` | 10% | ④深层分红池占 R 保底比例 |
-| `referral_profit.pool_weight` | 70/30 | 分红池个人/团队消费权重 |
-| `team_profit.star_tiers` | JSON | 星级业绩分门槛表 |
-| `team_profit.team_threshold` | JSON | 各服务团队年度业绩阈值(teamId→金额) |
+| `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.star_tiers` | JSON | 星级业绩分门槛表(6 档) |
+| `team_profit.team_threshold` | JSON | 各服务团队年度业绩门槛(teamId→金额) |
 | `team_profit.share_total` | 8 | 8 份制分母 |
+| `team_profit.award_tiers` | JSON | 团队奖分档(TA0-TA3 门槛与比例) |
+| `team_profit.award_distribute` | owner | 团队奖归属:owner=负责人统筹 / pro_rata=按成员星级 |
+| `team_profit.star_weight` | 50/40/10 | 星级业绩分权重 |
 
 ---
 
-## 7. 结算周期与状态机
+## 8. 结算周期与状态机
 
-### 7.1 状态机(推荐人体系 / 团队体系共用)
+### 8.1 状态机(团队货币分润)
 
 ```
 订单支付成功
    │
    ▼
-profit_pool_order(status=pending)  ← 计算 D/R/T,幂等(order_type+order_id 唯一)
+profit_pool_order(status=pending)  ← 计算 D/T/8份池/团队奖(幂等)
    │
    ▼
-生成 referral_profit_record / team_share_record (status=pending)
+生成 team_share_record / team_award_record (status=pending)
    │
    ├── 冷静期(7 天,与退款窗口对齐)
    │       订单退款 → 全部 status=cancelled,金额回流平台
@@ -409,65 +459,73 @@ profit_pool_order(status=pending)  ← 计算 D/R/T,幂等(order_type+order_
 冷静期满 → 定时任务批量置 status=settled,入「可提现余额」(货币账本)
    │
    ▼
-用户申请提现 → 后台审核 → 打款(复用现有 withdrawal 流程)
+团队负责人/成员申请提现 → 后台审核 → 打款(复用现有 withdrawal 流程)
 ```
 
-### 7.2 冷静期与退款
+> 推荐人体系(CF 值)结算逻辑**不变**(现有 F-2 幂等账本)。
+
+### 8.2 冷静期与退款
 
-- 订单支付后 7 天内退款:对应分润记录全部 `cancelled`,资金不发放。
+- 订单支付后 7 天内退款:对应团队分润记录全部 `cancelled`,资金不发放。
 - 7 天后自动 `settled`,进入可提现余额。
-- 提现:复用 `withdrawal_requests` + 后台审核(`/api/admin/commission/*` 管理端模式)。
+- 提现:复用 `withdrawal_requests` + 后台审核(type 标识分润来源 `team_share` / `team_award`)。
 
-### 7.3 幂等与重试
+### 8.3 幂等与重试
 
-- 唯一键:`profit_pool_order(uk_order)`、`referral_profit_record(uk_order_ref)`、`team_share_record(uk_order_rec)` —— 重复回调不重复发放。
+- 唯一键:`profit_pool_order(uk_order)`、`team_share_record(uk_order_rec)`、`team_award_record(uk_order_team)` —— 重复回调不重复发放。
 - 分润计算失败重试:按唯一键 upsert,先删旧记录再重建(或 INSERT IGNORE + 对账)。
 
 ---
 
-## 8. 边界情况
+## 9. 边界情况
 
 | # | 场景 | 处理 |
 |:-:|------|------|
-| 1 | 买家无推荐人 | ①L1/L2 无人 → 份额入③团队奖池;分红池照发(若有深层) |
-| 2 | 同家庭互推(D5) | 跳过同家庭推荐人,向上上溯(复用现有规则) |
+| 1 | 买家无推荐人 | 推荐人 CF 值不发放(现有逻辑);团队分润独立照常 |
+| 2 | 同家庭互推(D5) | 推荐人向上上溯(复用现有规则);团队关系与家庭无耦合 |
 | 3 | `D ≤ 0`(低于保本线) | 整单不分润,仅落 profit_pool_order 供统计 |
-| 4 | 服务提供者无上级/无团队 | 团队体系该层无人 → 份额回流平台团队奖池 |
-| 5 | 团队未达年度业绩门槛 | 本次不进入团队分红,份额回流 |
-| 6 | 同一商品既有商品属性又有服务属性 | 按订单类型路由(product→purchase_price;service→service_cost_config) |
+| 4 | 服务提供者无上级/无团队 | 团队体系该层无人 → 份额回流平台奖励基金 |
+| 5 | 团队未达年度业绩门槛 | 本次不进入团队分红(8 份 + 团队奖均回流) |
+| 6 | 服务者与引荐人同团队但星级低 | 按星级各拿各的份数,不因层级压份 |
 | 7 | 退款跨冷静期 | 已 settled 的退款需冲正(负数记录或 cancelled + 余额扣减) |
-| 8 | 星级/档位重评时间点 | 以**支付成功时刻**的档位/星级为准(快照),避免回溯争议 |
+| 8 | 星级/档位重评时间点 | 以**支付成功时刻**的星级/档位为准(快照),避免回溯争议 |
+| 9 | 已加入平台的老用户扫团队邀请码 | **只建团队关系**,不覆盖推荐人关系(§5.1 场景 B) |
+| 10 | 未注册用户扫团队邀请码 | 注册时建立推荐人关系 + 团队关系(§5.1 场景 A),两次幂等 |
 
 ---
 
-## 9. 合规红线(⚠ 重要)
+## 10. 合规红线(⚠ 重要)
 
-1. **三级计酬红线**:推荐人体系 L1/L2 固定层仅到二级;深层分红池按**消费占比**分配(非层级提成),从机制上避免「三级以上按人头/层级计酬」。**上线前须法务确认**(对应既有挂起项「分佣机制过法务」)。
-2. **不设入门费**:本设计不涉及任何「交钱入会」准入,纯消费业绩驱动。
+1. **三级计酬红线**:推荐人体系(CF 值)L1/L2 固定两级;团队 8 份分佣**按星级/业绩动态分配且最多涉及 3 层服务链**。**上线前须法务确认**(对应既有挂起项「分佣机制过法务」)。
+2. **不设入门费**:本设计不涉及任何「交钱入会」准入,纯服务业绩驱动。
 3. **成本价设置须真实**:`service_cost_config`/`purchase_price` 由平台运营真实填写,不得虚增以制造「高额返利」假象。
+4. **团队奖归属透明**:团队奖由负责人统筹时,需在团队内**明示分配规则**(平台只负责发到负责人一级);`pro_rata` 模式则平台按星级代分,两种模式须在协议中写明。
 
 ---
 
-## 10. 待主理人拍板事项
+## 11. 待主理人拍板事项(v0.2 更新)
 
 | # | 事项 | 建议 |
 |:-:|------|------|
-| 1 | 用户示例中「170×70%×70%=93.3」校正确认为 83.3(119×70%);或按「R 内四路 70/10/20 + 分红另计」重算 | 采纳 83.3 校正口径,比例可配 |
-| 2 | L1 是否从固定 70% 改为动态档位(50%→70%) | **建议:动态**(多劳多得,用户原则) |
-| 3 | 分红池个人/团队消费权重 70/30 的统计口径(本月=自然月?) | 自然月,入配置 |
-| 4 | 星级重评周期(月度/季度) | 建议月度 |
+| 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) |
+| 3 | 团队奖归属:负责人统筹(owner)还是平台按星级代分(pro_rata) | 建议 owner(与现有 T37/C2 结算口径一致) |
+| 4 | 星级重评周期(订单实时 vs 月度快照) | 建议**订单支付时实时计算** + 月度快照供展示 |
 | 5 | 8 份制中第 3 层是否永远 1 份封顶 | 是(用户口径「只能拿剩下的」) |
-| 6 | 团队年度业绩阈值初始值(各团队单独定) | 平台运营配置,先给默认 |
-| 7 | 分润金额提现走既有 `withdrawal_requests` 还是独立账本 | 建议复用,type 标识分润来源 |
+| 6 | 团队年度业绩门槛初始值(各团队单独定) | 平台运营配置,先给默认 |
+| 7 | 分润金额提现走既有 `withdrawal_requests` 还是独立账本 | 建议复用,type 区分 `team_share/team_award` |
 | 8 | 服务成本价表首批服务类型(planner_consult/assessor_dan/...) | 由运营维护 |
 | 9 | 保本线口径:用户示例「至少卖 820」为简化口径(800+20);精确口径含 CF 值 1% 时 ≈809 | 建议采用精确口径 |
+| 10 | F03b 现有上限 20%(CF 值间接销售奖)是否收窄至用户初稿的 10% | 默认不动(沿用 CF 值现状);如需收窄仅改档位配置 |
+| 11 | 团队邀请落地页:独立新页 vs 复用 `pages/invite/join` | 建议独立页(团队场景信息不同) |
 
 ---
 
-## 11. 落地建议(后续派发)
+## 12. 落地建议(后续派发)
 
-1. **P0 后端**:建表(§6)+ `ProfitPoolService`(§2 计算)+ `ReferralProfitService`(§3)+ `TeamProfitService`(§4)+ 配置读取。
-2. **P0 集成**:6 个订单服务支付成功钩子接入 `ProfitPoolService.settle()`(复用现有 `CfCommissionService.settle` 调用点,同点位并行调用)。
-3. **P1 定时任务**:冷静期结算、月度星级重评、月度分红池结算、退款冲正。
-4. **P2 管理端**:成本价配置、档位/星级配置、团队阈值配置、分润流水查询与提现审核(复用现有管理端佣金模式)。
-5. **P3 用户端**:推荐人/团队分润账单、星级展示、提现入口。
+1. **T1 团队邀请(P0)**:场景 A 注册链路补推荐人绑定钩子 + 场景 B 幂等入团接口 + 落地页/小程序码(参照家庭邀请)。
+2. **T2 后端分润(P0)**:建表(§7.1/7.3/7.4/7.5)+ `ProfitPoolService`(§2 计算)+ `TeamProfitService`(§4 8 份 + 团队奖)+ 配置读取。
+3. **T3 集成(P0)**:6 个订单服务支付成功钩子接入 `ProfitPoolService.settle()`(复用现有 `CfCommissionService.settle` 调用点,同点位并行调用)。
+4. **T4 定时任务(P1)**:冷静期结算、月度星级重评、退款冲正。
+5. **T5 管理端(P2)**:成本价/星级档位/团队门槛/团队奖分档配置 + 分润流水查询与提现审核(复用现有管理端佣金模式)。
+6. **T6 用户端(P3)**:团队成员分润账单、星级展示、团队邀请入口、提现入口。