docs(分润): v0.4 新增星级透明化与成长可视化(§4.3.1)

四大支柱闭环(看得见→算得清→够得着→有反馈)：
①实时星级看板(当前星级/三维构成/距下一档差距/12月轨迹)
②差距→行动换算(直接250分次/团队200分次/推荐10分百元,三条路径按省力排序)
③月度星级简报(升/降/持平+行动建议,每月1日重评后推送)
④星级权益可见(徽章/培训优先/带教领队资格)
新增接口 POST /api/team-star/my-view；落地 T7看板T8简报；待拍板#13。

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

@@ -1,10 +1,10 @@
 # 推荐人分润 & 团队分润双体系设计
 
-> **版本**：v0.3（按主理人最新拍板「团队奖从 T 中切 20%」修订，待评审）
+> **版本**：v0.4（新增「星级透明化与成长可视化」机制，待评审）
 > **日期**：2026-11-07
 > **作者**：研发负责人
 > **状态**：🟡 待评审
-> **修订**：v0.2：① 团队邀请参考家庭邀请（区分已加入/未加入平台）；② 推荐人体系**沿用 CF 值**（现有 F03a/F03b），团队体系**新增货币直接分佣**；③ 补星级量化定义 + 团队奖。v0.3：团队奖池从 T 中切 **20%**（8 份池 = T×80%）。
+> **修订**：v0.2：① 团队邀请参考家庭邀请（区分已加入/未加入平台）；② 推荐人体系**沿用 CF 值**（现有 F03a/F03b），团队体系**新增货币直接分佣**；③ 补星级量化定义 + 团队奖。v0.3：团队奖池从 T 中切 **20%**（8 份池 = T×80%）。v0.4：星级档位按真实价格校准（0/8千/2.5万/7万/14万/25万）+ **星级透明化与成长可视化**（实时看板 / 差距换算 / 月度简报 / 权益可见，见 §4.3.1）。
 
 ---
 
@@ -205,6 +205,48 @@ CfCommissionService.settle / settleReferrerOnly
 
 > **下级超越上级（用户核心原则）**：星级按当期滚动业绩计算，与层级身份无关。下级业绩好 → 6 星 → 自服务拿 6 份；上级业绩差 → 1 星 → 引荐人只拿 1 份。**下级拿的可以超过上级**。
 
+### 4.3.1 星级透明化与成长可视化（主理人意见④：让每个成员清楚知道如何达到级别）
+
+> **设计原则**：星级**绝不能只是被动算出的一个数字**。每个成员必须能**随时看见自己当前星级、离下一档还差多少、怎么做才能达标**，并把「分数差距」翻译成「可执行的行动」。否则成员不知如何努力，激励失效。
+
+**四大支柱（闭环：看得见 → 算得清 → 够得着 → 有反馈）**：
+
+**① 实时星级看板（用户端小程序「我的星级」页）**
+- 当前星级（大字）+ 业绩分总分 + 距下一星差距（如「距四星还差 12,000 分」）。
+- 三维构成条：直接服务 / 团队服务 / 推荐消费三条进度条，各自贡献分与占比（如 50,000 / 20,000 / 2,000 = 72,000）。
+- 滚动窗口说明：统计期「近 12 个月」（如 2025-11-08 ~ 2026-11-07）。
+- 星级轨迹：近 12 个月星级曲线（读 `team_star_snapshot` 月度快照），直观看到升降与稳定性。
+
+**② 差距→行动换算（核心：把分数翻译成动作）**
+- 换算率（¥500/次咨询基准，可配 `team_profit.star_conversion`）：直接服务 1 次 = 250 分；团队服务 1 次 = 200 分；推荐消费 ¥100 = 10 分。
+- 看板展示 3 条达标路径，按「最容易够到」排序：
+
+| 路径 | 换算率 | 还差 12,000 分示例 |
+|------|-------|-------------------|
+| A 直接服务 | 250 分/次 | 再 48 次 1对1 咨询 |
+| B 团队带教 | 200 分/次 | 再 60 次带教服务 |
+| C 推荐消费 | 10 分/百元 | 再 ¥120,000 推荐消费 |
+
+- 成员自选路径，看板提示「哪条最省力」，真正**为此努力**。
+
+**③ 月度星级简报（主动推送，每月 1 日重评后）**
+- 升星：恭喜 + 新星级 + 解锁分佣份数 + 权益（微信订阅消息）。
+- 降星：提示 + 原因（滚动窗口滑出）+ 需补多少分回原级。
+- 持平：距下一星差多少 + 本月行动建议（复用②换算）。
+- 数据源：`team_star_snapshot` 本月 vs 上月对比。
+
+**④ 星级权益可见（让星级「有用」，不只数字）**
+- 除分佣份数外，星级绑定**可感知权益**：星级徽章（团队页展示）、培训/专家课优先、带教与领队资格、年度表彰。
+- 每个星级页展示「本档权益 / 下一档权益 / 达成条件」，让成员看到升星的实际回报。
+
+**数据与接口**：
+- 复用 `team_star_snapshot`（月度）+ 实时聚合（§4.3 重评逻辑抽为可查询组件，`StarScoreCalculator`）。
+- 新增接口：`POST /api/team-star/my-view` → 当前星级 / 总分 / 三维构成 / 距下一档差距 / 三条换算路径 / 近 12 月轨迹。
+- 新增推送：每月 1 日 00:30 重评后发星级简报（复用微信订阅消息模板）。
+- 可选缓存：`team_star_view` 只读快照（避免每次实时聚合），默认实时查（数据量小）。
+
+> **🎯 落地效果**：成员打开小程序即知「我在哪、还差多少、怎么冲上去」；平台不再需要人工宣导星级规则，规则自动透明、路径自动可视、差距自动换算——这才是「多劳多得」能被成员主动争取的前提。
+
 ### 4.4 团队奖（用户意见③：团队服务好也要拿得多）
 
 **团队奖池**：`A = T × cfg_team_award_rate`（默认 20%，示例 10.2 元/单计提）。
@@ -521,6 +563,7 @@ profit_pool_order(status=pending)  ← 计算 D/T/8份池/团队奖（幂等）
 | 10 | F03b 现有上限 20%（CF 值间接销售奖）是否收窄至用户初稿的 10% | 默认不动（沿用 CF 值现状）；如需收窄仅改档位配置 |
 | 11 | 团队邀请落地页：独立新页 vs 复用 `pages/invite/join` | 建议独立页（团队场景信息不同） |
 | 12 | **星级档位推荐值（0 / 8千 / 2.5万 / 7万 / 14万 / 25万）**：已按真实价格校准（¥500/次咨询基准），六星=顶流团队长级（单靠个人直接服务不可达） | 采纳推荐值；业务起步期体量小可整体下调 50%（配置可调） |
+| 13 | **星级透明化范围**：实时看板 + 差距换算 + 月度简报 + 权益可见（§4.3.1）是否全做 | 建议全做（P1：看板+换算必做；P2：简报+权益） |
 
 ---
 
@@ -532,3 +575,5 @@ profit_pool_order(status=pending)  ← 计算 D/T/8份池/团队奖（幂等）
 4. **T4 定时任务（P1）**：冷静期结算、月度星级重评、退款冲正。
 5. **T5 管理端（P2）**：成本价/星级档位/团队门槛/团队奖分档配置 + 分润流水查询与提现审核（复用现有管理端佣金模式）。
 6. **T6 用户端（P3）**：团队成员分润账单、星级展示、团队邀请入口、提现入口。
+7. **T7 星级看板与换算（P1）**：`POST /api/team-star/my-view` + 小程序「我的星级」页（当前星级/三维构成/距下一档差距/三条换算路径/近 12 月轨迹）——§4.3.1 ①②。
+8. **T8 星级简报推送（P2）**：每月 1 日重评后发微信订阅消息（升/降/持平 + 行动建议）——§4.3.1 ③④。