|
|
@@ -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)**:团队成员分润账单、星级展示、团队邀请入口、提现入口。
|