docs(distribution): v2参数锁定 — tarunner日限/团队5人上限/超级会员暂缓/sys_config全量

docs/distribution-model-v2.md

@@ -1,13 +1,13 @@
 # 分销体系重构设计 v2
-> 从两级分销 → 一级分销 + 能量师团队分红
-> 状态：Draft，待用户确认佣金比例
+> 从两级分销 → 一级分销 + 能量师团队分红 + tarunner 运营官
+> 状态：v1.0 参数已确认，待编码实现
 
 ---
 
 ## 一、设计目标
 
 1. **简化层级**：取消二级佣金（A的下级B再推荐C，A不再拿C的佣金）
-2. **扩大分销主体**：所有付费用户（C端/家庭套餐/超级会员）均可发展下级
+2. **扩大分销主体**：所有付费用户（C端/家庭套餐/超级会员）均可发展下级，系统运营官（tarunner）有每日邀请上限
 3. **能量师团队制**：能量师组建团队，享受团队销售利润分红
 4. **合规性**：一级分销 + 团队分红（非直推计酬），符合《禁止传销条例》
 
@@ -15,19 +15,21 @@
 
 ## 二、新角色与分销权限
 
-| 角色 | 年费 | 可发展下级 | 一级佣金 | 团队分红 | 数据库标记 |
-|------|------|-----------|---------|---------|-----------|
-| 普通用户 | ¥0 | ❌ | — | — | `vipType=NULL` |
-| C端会员 | ¥131 | ✅ | 有 | ❌ | `vipType='annual'` |
-| 家庭套餐 | ¥686 | ✅ | 有 | ❌ | `vipType='family_plan'` |
-| 超级会员 | ¥1,314 | ✅ | 有 | ❌ | `vipType='super_annual'`（暂缓） |
-| 能量师 | ¥1,314+ | ✅ | 有 | ✅ | `vipType='practitioner'` |
+| 角色 | 年费 | 可发展下级 | 一级佣金 | 团队分红 | 数据库标记 | 每日邀请上限 |
+|------|------|-----------|---------|---------|-----------|------------|
+| 普通用户 | ¥0 | ❌ | — | — | `vipType=NULL` | — |
+| C端会员 | ¥131 | ✅ | 有 | ❌ | `vipType='annual'` | 默认受限，按需放开 |
+| 家庭套餐 | ¥686 | ✅ | 有 | ❌ | `vipType='family_plan'` | 默认受限，按需放开 |
+| 超级会员 | ¥1,314 | ✅ | 有 | ❌ | `vipType='super_annual'`（暂缓） | 默认受限，按需放开 |
+| 能量师 | ¥1,314+ | ✅ | 有 | ✅ | `vipType='practitioner'` | 默认开放 |
+| 系统运营官 | — | ✅ | 有 | ❌ | `role='tarunner'` | 按配置 |
 
 **核心规则：**
 - 只有付费用户可以发展下级（免费用户不行）
 - 一级佣金 = 直接推荐的人购买时，推荐人获得的佣金
 - 团队分红 = 能量师从其团队（直接下级）的总销售额中获得额外分红
 - 同一用户最多只有一个上级（关系锁定，不可变更）
+- tarunner 默认日限模式，通过 sys_config.allow_tarunner 按需放开上限
 
 ---
 
@@ -213,13 +215,16 @@ CREATE TABLE `team_bonus_monthly` (
 ```sql
 -- 一级分销佣金比例
 INSERT INTO sys_config (`key`, `value`, `desc`, `value_type`) VALUES
-('commission.level1.rate_annual',    '1500', 'C端会员一级佣金万分比（1500=15%）', 'percent'),
-('commission.level1.rate_family',    '1800', '家庭套餐一级佣金万分比（1800=18%）', 'percent'),
-('commission.level1.rate_super',     '2000', '超级会员一级佣金万分比（2000=20%）', 'percent'),
+('commission.level1.rate_annual', '1500', 'C端会员一级佣金万分比（1500=15%）', 'percent'),
+('commission.level1.rate_family', '1800', '家庭套餐一级佣金万分比（1800=18%）', 'percent'),
+('commission.level1.rate_super', '2000', '超级会员一级佣金万分比（2000=20%）', 'percent'),
 ('commission.level1.rate_practitioner', '2000', '能量师一级佣金万分比（2000=20%）', 'percent'),
-('commission.team_bonus.rate',       '500',  '团队月度分红万分比（500=5%）', 'percent'),
+('commission.team_bonus.rate', '500', '团队月度分红万分比（500=5%）', 'percent'),
 ('commission.team_bonus.min_payout', '5000', '团队分红最低发放金额（分，¥50）', 'amount'),
-('commission.team_bonus.settlement_day', '1', '月度分红结算日（每月第几天）', 'number');
+('commission.team_bonus.settlement_day', '1', '月度分红结算日（每月第几天）', 'number'),
+-- tarunner（系统运营官）每日邀请上限
+('tarunner.invite_daily_limit', '50', 'tarunner 每日邀请人数上限（0=不限制）', 'number'),
+('system.allow_tarunner', 'false', '是否允许 tarunner 申请/入驻（默认关闭，按需放开）', 'boolean');
 ```
 
 ### 6.4 推荐关系表
@@ -269,10 +274,23 @@ INSERT INTO sys_config (`key`, `value`, `desc`, `value_type`) VALUES
 
 ---
 
-## 九、待确认事项
+## 九、已确认决策快照（v1.0）
 
-1. **佣金比例**：一级佣金 15%/18%/20% 是否合适？团队分红 5% 是否合理？
-2. **团队分红基数**：是否包含推广码带来的所有购买（C端/家庭/能量师）？还是只算能量师购买？
-3. **C端会员推广家庭套餐**：C端会员推荐朋友买家庭套餐，C端会员能否拿一级佣金？（方案：可以）
-4. **能量师团队是否包含其他能量师**：能量师A的下级B也成为能量师，B的销售是否计入A的团队？（方案：是，直接下级全部计入）
-5. **超级会员暂缓**：超级会员的一级佣金比例和团队分红是否和能量师相同？（建议不同，待上线时定）
+| 决策项 | 结论 | 落地位置 |
+|--------|------|---------|
+| 佣金比例（一级） | C端15% / 家庭18% / 能量师20% | sys_config `commission.level1.*` |
+| 团队分红比例 | 5%（月度直接下级销售额） | sys_config `commission.team_bonus.rate` |
+| 团队规模上限 | 直接下级 **5人**，之后按负载放开 | 代码硬上限 + 配置化预留 |
+| tarunner 邀请策略 | **选项A**：默认日限，按需放开 | sys_config `tarunner.invite_daily_limit` + `system.allow_tarunner` |
+| 超级会员上线节奏 | 暂缓，v1.0 不包含 | 文档标记「暂缓」，不投入开发 |
+| 升级路径 | 全部含在当前版本，不分拆 v1.1 | 实现清单归一到 v1.0 |
+| 团队分红基数 | 所有购买事件（C端/家庭/能量师）均计入 | `team_bonus_monthly` 聚合逻辑 |
+
+---
+
+## 十、v1.0 交付后仍开放的议题
+
+1. tarunner 日限放开阈值（预估流量达到 X 时提升）  
+2. 团队 5 人上限解除后的扩容触发条件  
+3. 超级会员上线时的权益定价与佣金比例确认  
+4. 年度汇算清缴结果回填与用户通知流程（税务）