Эх сурвалжийг харах

docs: 一生一世家庭会员设计方案 v1.1 + 双并行实施计划

- 设计方案全面更新:L2定价¥1,314/月、阶梯推广等级(R0-R4)、P点制消费分润
- 拆分为两个并行实施计划:
  Plan 1: 订阅+推广核心(P0+P1, 12-15天)
  Plan 2: AI+管家+推荐引擎(P0b+P2+P3, 15-20天)
- Plan 2 通过 Stub/Provider 模式与 Plan 1 解耦,可完全并行开发
asus 2 сар өмнө
parent
commit
f71247d6d9

+ 251 - 0
docs/superpowers/plans/2026-07-09-family-membership-ai-butler.md

@@ -0,0 +1,251 @@
+# 浠艾福「一生一世家庭会员」实施计划 — Plan 2:AI+管家+推荐引擎
+
+**版本:** v1.1
+**日期:** 2026-07-09
+**设计文档:** docs/superpowers/specs/2026-07-09-family-membership-design.md
+**并行计划:** docs/superpowers/plans/2026-07-09-family-membership-core.md(订阅+推广核心,可同步开发)
+**总体工作量估算:** 15-20天(管家后端2天 + AI 8-10天 + 管家前端3天 + 推荐引擎2-3天)
+
+---
+
+## 实施总览
+
+本计划覆盖管家工作台、AI健康顾问与推荐引擎。**可与 Plan 1(订阅+推广核心)完全并行开发**,通过 Stub/Provider 模式解耦跨计划依赖:
+
+| 阶段 | 主题 | 核心交付 | 估算人天 | 可并行 |
+|:----:|------|----------|:--------:|:------:|
+| **P0b** | 管家数据库+管理端 | 管家表迁移 + 管家管理页面 | 2天 | ✅ 与 Plan 1 完全并行 |
+| **P2** | AI健康顾问 | LLM对接 + RAG + 健康报告解读 | 8-10天 | ✅ 与 Plan 1 完全并行 |
+| **P3** | 管家工作台 & 推荐引擎 | 管家工作台页面 + 推荐系统 | 5-7天 | 依赖 P0b + P2 |
+
+---
+
+## 并行策略:跨计划依赖的解耦方式
+
+| Plan 2 需要 Plan 1 提供 | 并行期间的 Stub 方案 | 最终集成方式 |
+|------------------------|---------------------|-------------|
+| `getSubscriptionLevel(userId)` → L0/L1/L2 | 先基于 `sys_config` 配置+用户标签做简单判断 | 上线前切换到 Plan 1 的 `MemberSubscriptionService` |
+| 佣金/消费分润数据(管家收入看板) | 前端先展示静态 Mock 数据 | 上线前对接 Plan 1 的 `CommissionService` |
+| 会员折扣价(商品页改造) | 管理端手动标记"会员价",不依赖订阅判断 | 上线前接入 Plan 1 的折扣逻辑 |
+
+> **核心原则**:每个 Plan 在本仓库独立开发,代码提交到同一仓库但不同目录/分支。最终合并时替换 Stub 为真实调用。
+
+---
+
+## P0b:管家后端基础
+
+### P0b.1 数据库迁移
+
+**方式**:通过 `DatabaseInitializer.runMigrations()` 添加
+
+**新表**:
+
+| 表名 | 用途 | 关键字段 |
+|------|------|----------|
+| `butler_assignment` | 管家-家庭绑定 | id, butler_id, family_id, butler_level(初级/中级/高级/特级), assigned_at, status |
+| `butler_evaluation` | 管家考核记录 | id, butler_id, quarter, score, renewal_rate, service_score, ai_coop_rate, response_time, family_count, passed |
+| `butler_revenue_share_log` | 管家分润日志 | id, butler_id, subscription_id, share_amount, share_rate, settled_at |
+
+`sys_config` 新增配置项:
+
+| key | 默认值 | 说明 |
+|-----|:------:|------|
+| `butler.revenue_share.level1` | 3000 | 初级管家分润比例(bps=30%) |
+| `butler.revenue_share.level2` | 4000 | 中级管家分润比例(bps=40%) |
+| `butler.revenue_share.level3` | 4500 | 高级管家分润比例(bps=45%) |
+| `butler.revenue_share.level4` | 5000 | 特级管家分润比例(bps=50%) |
+
+### P0b.2 后端新服务
+
+| 类 | 职责 | Plan 1 依赖 |
+|----|------|:----------:|
+| `ButlerAssignmentService` | 管家-家庭绑定、管家级别分配 | 无(独立) |
+| `ButlerRevenueShareService` | 管家收入分润计算 | **Stub**:先基于配置比例做简单计算,对接 Plan 1 后使用真实订单数据 |
+| `ButlerEvaluationService` | 管家考核定级(季度5维指标评分) | 无(独立) |
+| `AdminButlerService` | 管理端管家审核、级别调整 | 无(独立) |
+
+### P0b.3 管理端页面
+
+| 页面 | 用途 |
+|------|------|
+| `views/admin/ButlerManagement.vue` | 管家管理:列表、审核入驻、级别设定 |
+| `views/admin/ButlerEvaluation.vue` | 考核管理:季度考核结果、晋升/降级操作 |
+| `views/admin/ButlerRevenueConfig.vue` | 分润比例配置:各级别分润比例、续费奖金比例 |
+
+---
+
+## P2:AI健康顾问(独立模块)
+
+**与 Plan 1 的并行策略**:AI模块仅需知道当前用户的 L0/L1/L2 等级用于限流。并行期间先通过 `sys_config` 配置一个临时开关 `ai.rate_limit.stub_enabled=true` + 用户注册时间判断,替代 Plan 1 的订阅服务。上线前切换。
+
+### P2.1 技术架构
+
+```
+┌─────────────────────────────────────────┐
+│  小程序/Web → API Gateway → LLM Service  │
+│                              │           │
+│                   ┌──────────┴──────────┐│
+│                   │  LLM 服务层            ││
+│                   │  ├─ 大模型 API 调用    ││
+│                   │  ├─ RAG 检索增强       ││
+│                   │  └─ 医学知识库(向量库)  ││
+│                   └─────────────────────┘│
+└─────────────────────────────────────────┘
+```
+
+### P2.2 新建模块
+
+| 组件 | 说明 | Plan 1 依赖 |
+|------|------|:----------:|
+| `AiHealthAdvisorService` | AI顾问核心服务,封装 LLM 调用 | 无(独立) |
+| `HealthReportAnalyzer` | 健康报告(体检/菌群/测评)智能解读 | 无(独立) |
+| `SymptomTriageService` | 症状自查与分诊建议 | 无(独立) |
+| `FamilyHealthTrendService` | 家庭健康趋势分析与风险预警 | 无(独立) |
+| `HealthPlanGenerator` | 健康计划生成 | 无(独立) |
+| `MemberLevelProvider`(Stub) | **临时**:从 sys_config + 用户标签推断等级 | 🔄 上线前替换为 Plan 1 的 MemberSubscriptionService |
+
+### P2.3 API端点
+
+| 端点 | 说明 | 认证/限流 |
+|------|------|-----------|
+| `/api/ai/chat` | AI健康问答 | L0每日3次/L1不限/L2不限+深度 |
+| `/api/ai/report/analyze` | 报告解读(上传→解读)| L1+ |
+| `/api/ai/symptom/check` | 症状自查 | L1+ |
+| `/api/ai/plan/generate` | 生成健康计划 | L1+ |
+| `/api/ai/trend/family` | 家庭健康趋势 | L1+ |
+
+### P2.4 限流策略(Stub 版本)
+
+```java
+// AiRateLimitInterceptor — Stub阶段
+// 从 RequestAttribute("memberLevel") 获取等级
+// Stub实现:若 sys_config.ai.rate_limit.stub_enabled=true,
+//   则根据 ai.rate_limit.stub_tier_map 配置的 userId→tier 映射判断
+//   或默认所有已注册7天以上用户按 L1 处理,其余 L0
+// 上线前切换:替换为 Plan 1 的 MemberSubscriptionService.getSubscriptionLevel()
+
+// L0: 每日3次 → 返回带余量的错误提示 + 引导购买
+// L1: 不限 → 正常处理
+// L2: 不限 + 启用深度分析模式(更长上下文/更慢但更精准的模型)
+```
+
+`schema.sql` 新增 stub 配置项:
+
+| key | 默认值 | 说明 |
+|-----|:------:|------|
+| `ai.rate_limit.stub_enabled` | true | 未对接 Plan 1 时开启 stub |
+| `ai.rate_limit.stub_default_tier` | L0 | 新用户默认等级 |
+| `ai.rate_limit.stub_upgrade_days` | 7 | 注册超过7天自动升级为L1(stub) |
+
+### P2.5 LLM 集成清单
+
+- [ ] 选定 LLM 供应商(DeepSeek / 通义千问 / 智谱GLM — 建议国内供应商,合规+延迟低)
+- [ ] 申请 API Key,配置到 `application.yml`(加密存储)
+- [ ] 搭建 RAG 知识库(医学文献+健康指南+菌群知识),使用 pgvector 或 Elasticsearch
+- [ ] 实现 `AiHealthAdvisorService.chat()` 基础流式对话
+- [ ] 实现 `HealthReportAnalyzer.analyzePdf()`:PDF→文本→LLM结构化解读
+- [ ] 实现限流拦截器 `AiRateLimitInterceptor`
+
+---
+
+## P3:管家工作台 & 推荐引擎
+
+### P3.1 管家工作台(cfc-web 内)
+
+| 页面 | 用途 | Plan 1 依赖 |
+|------|------|:----------:|
+| `views/butler/Dashboard.vue` | 管家首页:负责家庭列表、AI标记待处理、今日任务、收入看板 | **部分**:收入看板用 Mock 数据开发,上线前对接 Plan 1 |
+| `views/butler/FamilyDetail.vue` | 家庭详情:成员健康档案、随访记录、AI对话历史 | 无(独立) |
+| `views/butler/FollowUpRecord.vue` | 随访记录:月度随访 SOP 模板、填写、历史 | 无(独立) |
+| `views/butler/RecommendationEdit.vue` | 管家精选推荐编辑 | 无(独立) |
+| `views/butler/MyEarnings.vue` | 收入看板:管理家庭数、分润收入、续费奖金、消费分润汇总 | **Mock**:先展示静态示例数据,上线前对接 Plan 1 佣金系统 |
+| `views/butler/MyEvaluation.vue` | 我的考核:当前季度指标完成进度、历史考核结果 | 无(独立) |
+
+**管家工作台API**:
+
+| 端点 | 说明 | 认证 |
+|------|------|------|
+| `/api/butler/my-families` | 负责家庭列表 | 管家认证 |
+| `/api/butler/family/{id}/detail` | 家庭详情(含健康档案+AI对话历史) | 管家认证 |
+| `/api/butler/follow-up/create` | 创建随访记录 | 管家认证 |
+| `/api/butler/follow-up/list` | 随访记录列表 | 管家认证 |
+| `/api/butler/earnings/summary` | 收入汇总(**Stub**:先返回Mock数据) | 管家认证 |
+| `/api/butler/evaluation/current` | 当前季度考核进度 | 管家认证 |
+
+**后端新增**:
+
+| 类 | 用途 | Plan 1 依赖 |
+|----|------|:----------:|
+| `FollowUpService` | 随访记录 CRUD | 无 |
+| `ButlerDashboardService` | 管家首页数据聚合 | **Stub**:收入部分 |
+| `ButlerController` | 管家专属 API | 无 |
+| `ButlerEarningsProvider`(Stub) | **临时**:返回 Mock 收入数据 | 🔄 上线前替换为 Plan 1 的 CommissionService |
+
+### P3.2 精准推荐引擎
+
+**三步走策略**:
+
+| 步骤 | 内容 | 依赖 | Plan 1 关联 |
+|:----:|------|------|:----------:|
+| **1. 规则推荐**(MVP) | 体质标签匹配+季节规则+简单协同 | 现有标签系统 | 无(独立) |
+| **2. 协同过滤**(V2) | "相似家庭"推荐,基于购买/浏览行为的物品协同过滤 | 用户行为数据积累 | 推荐结果可叠加会员折扣价展示 |
+| **3. LLM语义推荐**(V3) | AI理解自然语言需求→生成推荐+推荐理由 | P2 LLM服务就绪 | 无 |
+
+**推荐新增类**:
+
+| 类 | 用途 |
+|----|------|
+| `RecommendationEngine` | 推荐引擎入口(组合规则+协同+LLM) |
+| `RuleBasedRecommender` | 规则推荐(体质匹配、季节、复购) |
+| `CollaborativeRecommender` | 协同过滤推荐 |
+| `LlmRecommender` | LLM语义推荐 |
+| `RecommendationController` | 推荐 API |
+| `RecommendationFeedbackService` | 推荐反馈(点击/转化追踪) |
+
+---
+
+## 里程碑检查点
+
+| 里程碑 | 验证标准 | 并行阶段 |
+|--------|----------|:--------:|
+| **M0b: 管家可管理** | 管理端创建管家 → 绑定家庭 → 设置级别成功 | P0b 独立验证 |
+| **M5: AI可问答** | L1用户AI问答不限次,L0每日3次后提示引导购买,L2深度分析模式可用(Stub限流) | P2 独立验证 |
+| **M6: 管家可操作** | 管家登录工作台 → 看到分配的家庭 → 创建随访记录 → Mock收入看板 | P3 独立验证 |
+| **M7: 管家可考核** | 季度考核自动计算5维指标 → 可达标晋升/不达标留级 | P3 独立验证 |
+| **M8: 推荐可展示** | 用户首页看到个性化推荐商品/活动/读物 | P3 独立验证 |
+| **M9: 双计划集成** | 替换所有 Stub → Plan 1 订阅等级+佣金数据真实打通 → `mvn clean compile` 通过 | 合并验证 |
+| **质量门** | `mvn clean compile -pl cfc-backend -q` 退出码0;小程序前端无`?.`无CSS Grid | 全阶段 |
+
+---
+
+## 内部依赖关系
+
+```
+P0b (管家数据库) ──────→ P3 (管家工作台)
+                          ↑
+P2 (AI顾问) ─────────────┘ (管家需调AI数据)
+     │
+     └──→ P3.2 推荐V3 (LLM语义推荐)
+```
+
+- P0b 和 P2 **可并行开发**(无共享依赖)
+- P3 **可先于 P2 启动**(前端骨架+Mock数据先行,后端等 P0b 就绪)
+- P3.2 推荐引擎的 V1(规则推荐)可独立开发,V2/V3 延后
+
+---
+
+## 跨计划合并清单(上线前)
+
+| 序号 | Stub/Provider | 替换为 | 涉及文件 |
+|:---:|:-------------|:-------|:---------|
+| 1 | `MemberLevelProvider` | Plan 1 `MemberSubscriptionService.getSubscriptionLevel()` | `AiRateLimitInterceptor` |
+| 2 | `ButlerEarningsProvider` | Plan 1 `CommissionService.getButlerEarnings()` | `ButlerDashboardService` |
+| 3 | 商品页 Mock 会员价 | Plan 1 `SubscriptionBenefitService` | 前端商品组件 |
+| 4 | `ai.rate_limit.stub_enabled` 配置 | 删除 Stub 配置,切换为正式实现 | `sys_config` |
+
+---
+
+## 参考
+
+- 设计文档:`docs/superpowers/specs/2026-07-09-family-membership-design.md`
+- 并行计划:`docs/superpowers/plans/2026-07-09-family-membership-core.md`

+ 207 - 0
docs/superpowers/plans/2026-07-09-family-membership-core.md

@@ -0,0 +1,207 @@
+# 浠艾福「一生一世家庭会员」实施计划 — Plan 1:订阅+推广核心
+
+**版本:** v1.1
+**日期:** 2026-07-09
+**设计文档:** docs/superpowers/specs/2026-07-09-family-membership-design.md
+**姊妹计划:** docs/superpowers/plans/2026-07-09-family-membership-ai-butler.md(AI+管家+推荐)
+**总体工作量估算:** 12-15天(后端7-9天 + 前端5-6天)
+
+---
+
+## 实施总览
+
+本计划覆盖会员订阅与推广体系的核心建设,分为两个阶段:
+
+| 阶段 | 主题 | 核心交付 | 估算人天 |
+|:----:|------|----------|:--------:|
+| **P0** | 会员订阅+推广基础 | 数据库 + 后端 API + 支付对接 + 推广等级体系 | 7-9天 |
+| **P1** | 小程序前端 & 管理端 | 会员中心页面 + 推广中心 + 管理端配置 | 5-6天 |
+
+---
+
+## P0:会员订阅+推广基础(后端核心)
+
+### P0.1 数据库迁移
+
+**方式**:通过 `DatabaseInitializer.runMigrations()` 添加
+
+**新表**:
+
+| 表名 | 用途 | 关键字段 |
+|------|------|----------|
+| `member_subscription` | 家庭订阅记录 | id, family_id, level(L1/L2), status(active/expired/cancelled), start_time, expire_time, payment_id |
+| `member_subscription_order` | 订阅订单 | id, family_id, level, amount, status, payment_type, created_at |
+| `subscription_benefit_log` | 权益使用日志 | id, subscription_id, benefit_code, used_at, detail |
+| `commission_record` | 佣金/分润记录 | id, order_id, referrer_id, referee_id, type(referral/consumption_share), amount, status(pending/settled/cancelled), settle_time |
+| `referral_tree` | 推荐关系树 | id, parent_id, child_id, level(depth), path(materialized path), created_at |
+| `promotion_tier` | 推广等级(R0-R4) | id, user_id, tier(R0利他者/R1传福人/R2聚能师/R3启慧者/R4传承者), team_size_1st_layer, team_size_2nd_layer, team_size_3rd_layer, team_member_count, total_team_earnings, promoted_at, last_change_at |
+| `promotion_tier_change_log` | 等级变更记录 | id, user_id, old_tier, new_tier, reason(qualify/demotion_protect/admin_adjust), changed_at |
+| `product_ppoint` | 产品P点配置 | id, product_id, ppoint(平台利润分), start_date, end_date, created_by |
+
+**现有表改造**:
+
+`users` 表新增字段已存在(referrerId/referralCode/memberLevel),无需重复。
+
+`sys_config` 新增配置项:
+
+| key | 默认值 | 说明 |
+|-----|:------:|------|
+| `subscription.l1.price` | 131400 | 一生一世卡价格(分) |
+| `subscription.l2.price.monthly` | 131400 | 久久一生月费价格(分) |
+| `subscription.l1.upgrade_to_l2` | 按月折算 | L1→L2升级补差价计算(按剩余天数折抵首月) |
+| `subscription.l1.discount_rate` | 8500 | 商品折扣率(bps) |
+| `subscription.l2.discount_rate` | 7000 | 久久一生折扣率(bps) |
+| `subscription.grace_days` | 30 | 到期后数据保留宽限天数 |
+| `promotion.tier.r0.team_1st` | 3 | R0→R1条件:一层团队人数≥3 |
+| `promotion.tier.r1.team_1st` | 10 | R1→R2条件:一层团队人数≥10 |
+| `promotion.tier.r2.team_3rd` | 50 | R2→R3条件:三层团队总人数≥50 |
+| `promotion.tier.r3.team_3rd` | 200 | R3→R4条件:三层团队总人数≥200 |
+| `promotion.commission.r0` | 2000 | R0利他者推荐佣金(bps=20%) |
+| `promotion.commission.r1` | 2200 | R1传福人推荐佣金(bps=22%) |
+| `promotion.commission.r2` | 2600 | R2聚能师推荐佣金(bps=26%) |
+| `promotion.commission.r3` | 3000 | R3启慧者推荐佣金(bps=30%) |
+| `promotion.commission.r4` | 3500 | R4传承者推荐佣金(bps=35%) |
+| `promotion.consumption_share.r0` | 2000 | R0分润率(bps=20%) |
+| `promotion.consumption_share.r1` | 2500 | R1分润率(bps=25%) |
+| `promotion.consumption_share.r2` | 3000 | R2分润率(bps=30%) |
+| `promotion.consumption_share.r3` | 3500 | R3分润率(bps=35%) |
+| `promotion.consumption_share.r4` | 4000 | R4分润率(bps=40%) |
+| `promotion.l2_share_bonus` | 500 | L2会员额外分润加成(bps=5%) |
+| `promotion.tier_check_interval_days` | 7 | 等级考核周期(天) |
+
+### P0.2 后端新服务
+
+| 类 | 职责 |
+|----|------|
+| `MemberSubscriptionService` | 订阅核心逻辑:创建/续费/升级/降级/过期检查 |
+| `SubscriptionBenefitService` | 权益校验:checkBenefit(familyId, benefitCode) |
+| `MemberSubscriptionController` | 订阅API端点 |
+| `SubscriptionExpiryTask` | 定时任务:每日检查过期订阅 |
+| `PromotionTierService` | 推广等级(R0-R4)管理:晋级判定(三层团队人数)、等级有效期、L2加成判定 |
+| `PromotionTierController` | 推广等级API端点 |
+| `PromotionTierCheckTask` | 定时任务:定期检查推广人是否满足升级条件 |
+| `CommissionService` | 佣金/分润计算(基于推广等级的阶梯计算):按tier查佣金率+按tier+产品P点算消费分润 |
+| `ConsumptionShareTask` | 消费分润结算任务:7天冷静期后按P点×等级分润率自动结算 |
+| `ReferralService` | 推荐关系管理:推荐码生成、关系树构建、三层团队人数查询 |
+| `PpointService` | P点管理:按产品查询当前生效P点、Admin调整P点 |
+| `AdminCommissionService` | 管理端佣金/分润管理(审核、手动结算、退款冲正) |
+| `AdminPromotionTierService` | 推广等级管理(手动升降、查看团队结构) |
+| `AdminPpointService` | 产品P点配置管理 |
+
+**API 端点**(统一 @PostMapping):
+
+| 端点 | 说明 | 认证 |
+|------|------|------|
+| `/api/subscription/plans` | 获取订阅方案列表(含权益说明) | 公开 |
+| `/api/subscription/my` | 当前家庭订阅信息 | 需登录 |
+| `/api/subscription/create` | 创建订阅订单(返回支付参数) | 需登录 |
+| `/api/subscription/renew` | 续费(L1年付延续) | 需登录 |
+| `/api/subscription/cancel` | 取消订阅(L2连续包月取消) | 需登录 |
+| `/api/subscription/upgrade` | L1→L2升级(按剩余天数折算抵扣) | 需登录 |
+| `/api/subscription/downgrade` | L2→L1降级(当前月结束后切换) | 需登录 |
+| `/api/subscription/notify` | 支付回调 | 公开(签名验证) |
+| `/api/subscription/benefit/check` | 检查某项权益是否可用 | 需登录 |
+| `/api/promotion/my-tier` | 我的推广等级(R0-R4)详情+晋级进度 | 需登录 |
+| `/api/promotion/tiers` | 所有等级定义及晋级条件 | 公开 |
+| `/api/promotion/tier-history` | 等级变更记录 | 需登录 |
+| `/api/promotion/team-tree` | 我的三层团队树状结构 | 需登录 |
+| `/api/commission/referral-code` | 获取/刷新推荐码 | 需登录 |
+| `/api/commission/my-earnings` | 我的收益汇总(佣金+分润) | 需登录 |
+| `/api/commission/records` | 收益明细列表(分页) | 需登录 |
+| `/api/commission/withdraw` | 提现申请 | 需登录 |
+| `/api/commission/ppoint/products` | 查看各产品当前P点值 | 需登录 |
+| `/api/referral/tree` | 我的推荐关系树 | 需登录 |
+
+### P0.3 定时任务
+
+| 任务 | 频率 | 逻辑 |
+|------|:----:|------|
+| `SubscriptionExpiryTask.checkExpiry()` | 每日 04:00 | 查出 expire_time < now 的订阅,status→expired,更新用户折扣权益 |
+| `SubscriptionExpiryTask.checkGracePeriod()` | 每日 04:30 | 查出 expired 超过 grace_days 的订阅,清理缓存的健康档案 |
+| `PromotionTierCheckTask.checkTiers()` | 每7天 | 扫描所有推广人,按三层团队人数判定是否满足晋级条件。满足即升级,终身不掉级 |
+| `ConsumptionShareTask.settle()` | 每日 | 扫描已过7天冷静期的 commission_record(type=consumption_share),按推广等级对应分润率+P点值自动结算 |
+
+### P0.4 支付集成
+
+- 复用现有 `PaymentOrder` 系统
+- 新增 `payment_type = 'subscription'`(L1年付)
+- 新增 `payment_type = 'subscription_monthly'`(L2连续包月)
+- 支付成功回调 → `MemberSubscriptionService.activateSubscription()`
+- 首次购买自动创建推广人身份(referral_code + 初始化R0等级)
+
+### P0.5 管理端基础页面
+
+**管理端新增页面**:
+
+| 页面 | 用途 |
+|------|------|
+| `views/admin/SubscriptionManagement.vue` | 订阅管理:查看所有订阅、手动激活/取消/退款 |
+| `views/admin/BenefitConfig.vue` | 权益配置:L0/L1/L2 权益开关、折扣率配置 |
+| `views/admin/PromotionTierConfig.vue` | 推广等级配置:R0-R4晋级条件、佣金率、分润率、L2加成 |
+| `views/admin/PromotionTierManagement.vue` | 推广人管理:查看推广人等级、手动调整等级、查看三层团队结构 |
+| `views/admin/CommissionConfig.vue` | 佣金配置:推广佣金率、消费分润率(按等级) |
+| `views/admin/CommissionRecords.vue` | 佣金流水:查看/手动调整/退款冲正 |
+| `views/admin/ProductPpointConfig.vue` | P点配置:各产品P点(平台利润)设置、有效期管理 |
+
+---
+
+## P1:小程序前端 & 管理端
+
+### P1.1 小程序页面
+
+| 页面路径 | 用途 | 说明 |
+|----------|------|------|
+| `pages/membership/index.vue` | 会员中心主页 | 展示当前订阅状态、权益清单、升级入口 |
+| `pages/membership/plans.vue` | 订阅方案对比 | L0/L1/L2 权益对比表 + 购买按钮 |
+| `pages/membership/benefits.vue` | 我的权益 | 已用/可用权益列表 |
+| `pages/promotion/index.vue` | 推广中心主页 | 推广等级(R0-R4)、推荐码、收益概览、晋级进度条 |
+| `pages/promotion/team.vue` | 我的团队 | 三层团队人数统计+树状结构(禁`?.`用`&&`) |
+| `pages/promotion/tiers.vue` | 等级详情 | R0-R4升级条件、各等级权益对比、当前进度 |
+| `pages/promotion/earnings.vue` | 收益明细 | 佣金+消费分润记录列表(分页) |
+| `pages/promotion/ppoints.vue` | 分润商品 | 各产品P点值展示 |
+
+**前端适配注意事项**:
+- 遵循项目规范:Vue 2 Options API,禁 `?.`,禁 CSS Grid,使用 flexbox
+- 设计 Token 体系:`--color-primary: #F97316`(暖橙主色)
+- 与 TabBar "富"维度入口连接
+
+### P1.2 现有前端改造点
+
+| 页面 | 改动 |
+|------|------|
+| 商品详情页 | 一生一世会员显示折扣价(划线原价 + 会员价) |
+| 活动列表 | 会员专属活动打标"👑 一生一世专享" |
+| 课程页面 | L1/L2 会员价显示 |
+| 个人中心 | 增加"一生一世会员"入口和状态展示 + 推广中心入口(含当前推广等级徽标) |
+| "富"Tab页 | 增加推广中心快捷入口、收益概览小部件 |
+
+---
+
+## 里程碑检查点
+
+| 里程碑 | 验证标准 |
+|--------|----------|
+| **M0: 订阅可购买** | `POST /api/subscription/create` → 支付 → 回调 → 订阅激活成功(L1年付+L2连续包月) |
+| **M1: 折扣生效** | L1/L2会员购买商品显示对应折扣价,普通用户显示原价 |
+| **M2: 推广晋级可自动** | 推广人推荐新用户 → 三层团队人数增长 → 自动晋级R0→R1...更新推广等级 |
+| **M3: 佣金按等级结算** | 推广人推荐会员购买 → 按等级对应的佣金率结算(R0 20%/R1 22%/.../R4 35%) |
+| **M4: P点消费分润可追踪** | Admin为商品设P点 → 被推荐人购买商品 → 推荐人 CommissionRecord(type=consumption_share) 按等级+P点创建 |
+| **质量门** | `mvn clean compile -pl cfc-backend -q` 退出码0;小程序前端无`?.`无CSS Grid |
+
+---
+
+## 依赖关系
+
+```
+P0 (数据库+API+支付) ──→ P1 (前端页面+管理端)
+```
+
+- P0 和 P1 可并行(前端可用Mock先开发)
+- Plan 2(AI+管家+推荐)与本计划**完全可并行**,详见该计划的 Stub 解耦策略
+
+---
+
+## 参考
+
+- 设计文档:`docs/superpowers/specs/2026-07-09-family-membership-design.md`
+- 姊妹计划:`docs/superpowers/plans/2026-07-09-family-membership-ai-butler.md`

+ 854 - 0
docs/superpowers/specs/2026-07-09-family-membership-design.md

@@ -0,0 +1,854 @@
+# 浠艾福一生一世家庭会员 — 设计方案
+
+**版本:** v1.1
+**日期:** 2026-07-09
+**状态:** 草案(待审批)
+**定位:** 战略级商业模式重塑 — 从单次交易转向家庭订阅制
+
+---
+
+## 目录
+
+- [1. 战略背景与核心理念](#1-战略背景与核心理念)
+- [2. 会员等级体系](#2-会员等级体系)
+- [3. AI健康顾问](#3-ai健康顾问)
+- [4. 家庭健康管家 — 合伙制体系](#4-家庭健康管家--合伙制体系)
+- [5. 分销与消费分润体系](#5-分销与消费分润体系)
+- [6. 精准推荐引擎](#6-精准推荐引擎)
+- [7. 商业模式测算](#7-商业模式测算)
+- [8. 冷启动策略](#8-冷启动策略)
+- [9. 增长飞轮](#9-增长飞轮)
+- [10. 关键指标与风险](#10-关键指标与风险)
+- [11. 与现有系统的集成关系](#11-与现有系统的集成关系)
+- [12. 附录:设计决策记录](#12-附录设计决策记录)
+
+---
+
+## 1. 战略背景与核心理念
+
+### 1.1 定位
+
+浠艾福「一生一世家庭会员」不是一套简单的会员等级体系,而是**商业模式的战略级重塑**——从"用户单次购买商品/服务"的交易型模式,转向"家庭按年订阅健康管理服务"的订阅制模式。
+
+### 1.2 目标人群
+
+| 维度 | 描述 |
+|------|------|
+| **画像** | 泛家庭人群(普惠型),二三线城市为主 |
+| **家庭年收入** | 15-50万 |
+| **家庭结构** | 1-2个孩子(6-16岁)+ 祖辈同住或近住 |
+| **核心痛点** | 想管好全家健康但没时间/没专业知识;去医院贵且麻烦;不知道什么产品/活动适合自家人 |
+| **决策偏好** | 追求性价比,相信熟人推荐,对"专业+有温度"的服务愿意付费 |
+
+### 1.3 四大核心特色
+
+| # | 特色 | 说明 |
+|:-:|------|------|
+| 1 | **以家庭为单位** | 一次付费覆盖全部家庭成员(家长+子女+祖辈),而非个人会员 |
+| 2 | **健康AI顾问** | 7×24小时AI健康顾问,基于家庭健康档案个性化响应 |
+| 3 | **专业主动健康服务人员** | 每个家庭绑定专属健康管家,主动随访+AI方案审核+情感陪伴 |
+| 4 | **精准产品推荐** | 基于家庭健康画像的AI+人工双通道推荐(商品/活动/读物) |
+
+### 1.4 新旧体系关系
+
+```
+新 · 家庭订阅会员体系(商业层)
+┌─────────────────────────────────────┐
+│  一生一世家庭卡  ¥1,314/年            │
+│  至尊家庭卡      ¥3,314/年            │
+└─────────────────────────────────────┘
+                ↑ 叠加(身份独立,权益叠加)
+┌─────────────────────────────────────┐
+│  原有身份体系(底层身份层)              │
+│  FREE / FAMILY / PROVIDER            │
+│  (原有会员与分销体系继续运行)           │
+└─────────────────────────────────────┘
+```
+
+两种体系**共存而非替代**:
+- 原有 FREE/FAMILY/PROVIDER 作为**底层身份与分销体系**保留
+- 新家庭订阅会员体系作为**商业付费层**叠加其上
+- 用户的身份等级和订阅等级独立判断,权益叠加
+
+---
+
+## 2. 会员等级体系
+
+### 2.1 三阶会员矩阵
+
+| 等级 | 名称 | 付费方式 | 年费折算 | 核心定位 | 目标用户 |
+|:----:|------|:--------:|:--------:|----------|----------|
+| **L0** | 🆓 注册会员 | 免费 | 免费 | 流量漏斗入口 — 体验AI基础能力,培育付费转化 | 所有新注册用户 |
+| **L1** | ❤️ **一生一世** | **¥1,314/年**(年付) | ¥1,314 | 核心付费产品 — 全家AI健康顾问+认证管家+精准推荐 | 有1-2个孩子的家庭,追求性价比 |
+| **L2** | 💎 **久久一生** | **¥1,314/月**(连续包月) | **¥13,140** | 高端升级 — 资深管家+深度AI+专家团+高比例消费分润 | 有更高健康管理需求、追求深度服务+分享收益的家庭 |
+
+### 2.2 权益矩阵
+
+| 权益模块 | L0 注册会员(免费) | ❤️ L1 一生一世(¥1,314/年) | 💎 L2 久久一生(¥1,314/月) |
+|:---------|:-----------------:|:--------------------------:|:--------------------------:|
+| **⭐ 价格** | 免费 | **¥1,314/年** | **¥1,314/月(¥13,140/年)** |
+| **家庭覆盖** | 仅本人 | ✅ 家庭成员上限10人 | ✅ 家庭成员上限15人+祖辈优先 |
+| | | | |
+| **AI健康顾问** | 每日3次问答 | ✅ 标准版·不限次数 | ✅ **深度版**·不限次数+多模态分析+优先响应 |
+| **报告解读** | ❌ | ✅ 基础解读 | ✅ 深度解读+趋势追踪+AI辅助会诊 |
+| **健康计划** | ❌ | ✅ 月度计划 | ✅ 双周计划+实时动态调整 |
+| **家庭健康档案** | ❌ | ✅ 全家人数据聚合 | ✅ 全家人数据+年度健康白皮书 |
+| | | | |
+| **专属管家** | ❌ | ✅ **认证管家(中级)** | ✅ **资深管家(高级/特级)** |
+| **管家来源** | — | 平台认证专业人员 | 高级考核晋级的资深管家 |
+| **管家配比** | — | 1:150 | **1:30** |
+| **服务频率** | ❌ | 月度线上随访(15-20min) | ✅ **双周线上+季度上门** |
+| **响应时间** | — | 工作日<4小时 | ✅ **工作日<1小时** |
+| | | | |
+| **商品折扣** | 原价 | ✅ **8-9折** | ✅ **6-8折** |
+| **课程/活动** | 免费内容 | ✅ 会员价+专属活动 | ✅ **90%免费+VIP座席** |
+| **专家团会诊** | ❌ | ❌ | ✅ **每年4次多学科会诊** |
+| **线下权益** | ❌ | ✅ 优先预约 | ✅ VIP接待+季度上门服务 |
+| | | | |
+| **推荐佣金** | 仅可推荐(无分润) | ✅ **R0-R4阶梯佣金**(按等级20%-35%) | ✅ **R0-R4阶梯佣金**(按等级25%-40%) |
+| **推广等级** | ✅ 可晋级(R0→R4) | ✅ 可晋级+享消费分润 | ✅ 可晋级+L2额外分润加成5% |
+| **消费分润** | ❌ 不可享受 | ✅ **P点×20%-40%**(按等级) | ✅ **P点×20%-40%+5%加成** |
+| **分润计算** | — | 基于产品**P点(平台利润)**,非销售额 | 基于产品P点,享等级加成 |
+| **分润期限** | — | 终身(不掉级) | 终身(不掉级) |
+
+### 2.3 定价逻辑
+
+#### 一生一世 ¥1,314/年
+
+```
+¥1,314/年 = ¥109.5/月 = ¥3.6/天 = 覆盖3-6人 = ¥0.6-1.2/人/天
+```
+
+- **品牌锚点**:「一生一世」——一次付费守护全家健康,情感价值>功能价值
+- **竞争定价**:平安健康¥2,000+/年、京东健康家庭卡¥1,999/年,¥1,314有明显价格优势
+- **情感定价**:1314 = 一生一世,利传播,强记忆
+
+#### 久久一生 ¥1,314/月 = ¥13,140/年
+
+```
+¥1,314/月 = ¥43/天 = 覆盖3-6人 = ¥7-14/人/天
+¥13,140/年 = L1价格的10倍 → 服务深度、管家级别、分润比例全面升级
+```
+
+- **品牌锚点**:「久久一生」——不是一次性的"一生一世",而是月月持续的"长久一生"
+- **定位**:高端深度服务,面向有更强健康管理需求、追求管家深度陪伴+高分享收益的家庭
+- **定价策略**:L1是"让每个家庭都能负担"的普惠价,L2是"想要更好,值得更好"的升级价
+- **连续包月**:按月付费,随用随停(但连续包月享优惠价¥1,314/月)
+
+### 2.4 等级间升降级规则
+
+| 场景 | 规则 |
+|------|------|
+| 新注册 | 自动获得L0注册会员 |
+| 购买L1 | 支付¥1,314 → 立即生效,有效期365天(初级/中级管家服务) |
+| 订阅L2 | 签约连续包月¥1,314/月 → 立即生效,按月自动续费 |
+| L1续费 | 续费享「一生一世」价¥1,314(不涨价承诺) |
+| L2续订 | 连续包月持续有效,可随时取消(取消后当前月结束到期) |
+| L1→L2升级 | 剩余天数折算抵扣L2首月费用 |
+| L2→L1降级 | 当前月结束后转L1年付 |
+| L1到期不续 | 降级为L0(保留健康档案30天) |
+| L2取消订阅 | 当前月结束后降级为L0(保留健康档案30天) |
+
+> **说明**:原体系的 FREE→FAMILY 消费自动升级路径(旧版累计消费¥1,314门槛)**继续保留**作为旧 FAMILY 身份的获取方式。新订阅体系的「一生一世」仅通过付费购买获得。两个体系独立运行,用户可能同时持有旧 FAMILY 身份 + 新一生一世订阅。
+
+---
+
+## 3. AI健康顾问
+
+### 3.1 三阶能力架构
+
+```
+┌────────────────────────────────────┐
+│  L2 深度分析模式                     │
+│  多模态报告解读 + AI辅助专家会诊      │
+└────────────────────────────────────┘
+┌────────────────────────────────────┐
+│  L1 核心能力(7×24不限次)           │
+│  智能问答 + 报告解读 + 症状自查      │
+│  家庭趋势 + 健康计划 + 用药提醒      │
+└────────────────────────────────────┘
+┌────────────────────────────────────┐
+│  L0 体验(每日3次)                  │
+│  通用健康百科 + 社区内容推荐          │
+└────────────────────────────────────┘
+```
+
+### 3.2 L1 核心能力清单
+
+| 能力模块 | 功能说明 | 技术依赖 |
+|----------|----------|----------|
+| **7×24智能问答** | 基于家庭健康档案个性化回复,支持文字/语音 | LLM + RAG + 知识库 |
+| **报告智能解读** | 体检/菌群/测评报告AI解读,生成通俗化建议 | OCR + LLM + 医学知识库 |
+| **症状自查** | 症状描述→分诊建议(观察/居家/就医) | 症状库 + 分诊决策树 |
+| **家庭健康趋势** | 全家人健康数据聚合分析,趋势图+风险预警 | 时序分析 + 异常检测 |
+| **健康计划生成** | 基于体质/目标自动生成周/月健康计划 | 推荐算法 + 知识图谱 |
+| **用药提醒** | 家庭成员用药提醒+药物相互作用检查 | 药品数据库 |
+| **人机协同标记** | AI自动识别需管家介入的场景并推送 | 规则引擎 + 异常检测 |
+
+---
+
+## 4. 家庭健康管家 — 合伙制体系
+
+### 4.1 核心理念
+
+管家不是平台雇员,而是**平台合伙人**。平台搭建基础设施(AI+系统+用户),管家提供有温度的专业服务,双方按贡献分配收入。
+
+```
+                ┌─────────────────────────────────┐
+                │         平台提供                   │
+                │  AI顾问 + 技术系统 + 用户流量       │
+                │  + 品牌 + 合规 + 培训体系           │
+                └─────────────────────────────────┘
+                            ║ 合作
+                ┌─────────────────────────────────┐
+                │         管家提供                   │
+                │  专业服务 + 时间投入 + 情感关系      │
+                │  + 自有客户资源 + 口碑传播           │
+                └─────────────────────────────────┘
+                            ║ 收入分润
+                ┌─────────────────────────────────┐
+                │    会员费按比例分配                 │
+                │    平台 : 管家 = 根据级别配置        │
+                └─────────────────────────────────┘
+```
+
+### 4.2 谁能成为管家
+
+平台已有的专业人员经额外培训认证后均可成为管家:
+
+| 来源 | 现有角色 | 优势 |
+|------|----------|------|
+| **成长规划师** (已有) | `teacher` | 已有客户关系,懂平台业务 |
+| **营养师** (已有) | 精准营养服务 | 专业健康知识,与AI互补 |
+| **心理咨询师** | `consultant` | 沟通能力强,适合管家角色 |
+| **活动规划师** | `activity_provider` | 组织能力强,懂本地资源 |
+| **商品供应商** | `supplier` | 有客户网络,推广动力强 |
+| **外部专业人士** | 新招募 | 健康管理师/护士/社区医生 |
+
+### 4.3 管家成长体系
+
+```
+                        ┌────────────────────┐
+                        │  特级管家            │
+                        │  可服务L2 久久一生   │
+                        │  必须:年续费>85%    │
+                        │  + 服务50+家庭       │
+                        └────────────────────┘
+                        ┌────────────────────┐
+              晋升考核   │  高级管家            │
+               ──────── │  可服务L1+L2        │
+                        │  必须:年续费>75%    │
+                        │  + 服务20+家庭       │
+                        └────────────────────┘
+                        ┌────────────────────┐
+                        │  中级管家            │
+                        │  可服务L1 一生一世   │
+                        │  必须:年续费>65%    │
+                        │  + 服务5+家庭+3个月  │
+                        └────────────────────┘
+                        ┌────────────────────┐
+               培训认证  │  初级管家            │
+               ──────── │  可服务L1(带教期)   │
+                        │  完成培训+模拟考核    │
+                        └────────────────────┘
+                        ┌────────────────────┐
+              资质审核  │  管家候选人           │
+                        │  平台专业资质审核通过   │
+                        └────────────────────┘
+```
+
+**管家级别与会员等级映射**:
+
+| 管家级别 | 可服务会员等级 | 分润比例(会员费) | 说明 |
+|:--------:|:------------:|:-----------------:|------|
+| 初级管家(见习) | L0(导流)、L1 一生一世 | 30% | 带教期,由中级管家带教 |
+| 中级管家 | **L1 一生一世(¥1,314/年)** | **40%** | L1的标配管家,负责10-50个家庭 |
+| 高级管家 | L1 + **L2 久久一生(¥1,314/月)** | **45%** | L2的标配管家,负责5-20个高端家庭 |
+| 特级管家 | **L2 久久一生(¥1,314/月)**+ 定制 | **50%** | L2的高配管家,负责3-10个顶级家庭,可自主定价 |
+
+> 分润比例含:基础服务费 + 续费奖金 + 被推荐家庭消费分润。管家的最终年收入 = L1会员数×1,314×分润比例 + L2会员数×13,140×分润比例 + 续费奖金 + 消费分润。
+
+### 4.4 管家培训认证体系
+
+| 阶段 | 内容 | 时长 | 考核方式 |
+|:----:|------|:----:|----------|
+| **T1 资质审核** | 专业背景验证、无违规记录、服务意识评估 | 1周 | 材料审核+线上面试 |
+| **T2 基础培训** | 平台价值观、AI工作台操作、会员体系、沟通SOP | 2周 | 笔试≥80分 |
+| **T3 专业培训** | 健康管理基础、风险识别、急救常识、心理学沟通技巧 | 2周 | 情景模拟考核 |
+| **T4 跟岗实习** | 跟随中级以上管家服务3个家庭,完成10次随访 | 1个月 | 带教管家评分≥85 |
+| **T5 认证答辩** | 案例答辩+服务演示 | 1天 | 评审团通过 |
+| **T6 持续教育** | 每月2次案例分享会、季度新知识培训 | 持续 | 参与率>80% |
+
+### 4.5 管家考核定级机制
+
+| 指标 | 权重 | 初级→中级 | 中级→高级 | 高级→特级 |
+|:----:|:----:|:---------:|:---------:|:---------:|
+| **家庭续费率** | 35% | ≥65% | ≥75% | ≥85% |
+| **服务家庭数** | 20% | ≥5 | ≥20 | ≥50 |
+| **服务评分(用户评价)** | 25% | ≥4.2/5 | ≥4.5/5 | ≥4.8/5 |
+| **AI协同完成率** | 10% | ≥80% | ≥85% | ≥90% |
+| **响应速度(工作日)** | 10% | <4h | <2h | <1h |
+| **从业时长** | — | ≥3个月 | ≥1年 | ≥2年 |
+
+**考核频率**:每季度一次,达标晋升,不达标留级观察(连续2季度不达标降级)
+
+### 4.6 管家月度服务SOP
+
+```
+第1周 → 主动随访(电话/微信15-20min)
+  ├─ 了解家庭成员近况
+  ├─ AI推送的注意事项沟通
+  └─ 收集下一阶段需求
+第2周 → AI方案审核与个性化调整
+  ├─ 查看AI生成的健康建议
+  ├─ 根据对这家人的了解做调整
+  └─ 确认推送
+第3周 → 数据检查 + 指标异常筛查 + 主动干预
+  ├─ 查看AI标记的异常指标
+  ├─ 主动联系家庭成员关怀
+  └─ 必要时协调专家资源
+第4周 → 月度复盘(健康报告 + 下月计划)
+  ├─ 生成月度健康报告
+  ├─ 与家庭成员沟通进展
+  └─ 制定下月健康计划
+持续 → 日常AI协同
+  ├─ AI标记→管家响应→问题闭环
+  └─ 紧急情况即时联系
+```
+
+### 4.7 管家收入模型
+
+管家的收入不是工资,而是**服务收入分成**:
+
+| 收入项 | 来源 | 计算方式 |
+|--------|------|----------|
+| **基础服务分润** | 所管家庭会员费 | 会员费 × 管家分润比例 |
+| **续费奖金** | 所管家庭续费 | 续费会员费 × 额外5%奖金 |
+| **消费分润** | 所管家庭平台消费 | 消费金额 × 2%(平台承担) |
+| **推荐佣金** | 推荐新管家或会员 | 参照分销体系 |
+| **晋升津贴** | 晋升为培训师/管家长 | 固定津贴 |
+
+**收入模拟——中级管家(服务L1 ¥1,314/年)**:
+
+| 阶段 | 管理家庭数 | 月收入估算 | 年收入估算 |
+|:----:|:---------:|:----------:|:----------:|
+| 起步期 | 20家 | ¥1,314×20×40%/12 + 消费分润 ≈ ¥900-1,200 | ¥1.1-1.4万 |
+| 成长期 | 50家 | ¥1,314×50×40%/12 + 续费奖金 + 消费分润 ≈ ¥2,600-3,500 | ¥3.1-4.2万 |
+| 成熟期 | 100家 | ¥1,314×100×40%/12 + 续费奖金 + 消费分润 ≈ ¥5,600-7,500 | ¥6.7-9万 |
+
+**收入模拟——高级/特级管家(服务L2 ¥1,314/月=¥13,140/年)**:
+
+| 管家级别 | 管理家庭数 | 月收入估算 | 年收入估算 |
+|:-------:|:---------:|:----------:|:----------:|
+| 高级管家(切入期) | 5家L2 + 20家L1 | (¥13,140×5×45% + ¥1,314×20×45%)/12 + 消费分润 ≈ ¥3,400-4,200 | ¥4.1-5.0万 |
+| 高级管家(成熟期) | 15家L2 + 30家L1 | (¥13,140×15×45% + ¥1,314×30×45%)/12 + 续费奖金 ≈ ¥10,900-13,500 | ¥13-16万 |
+| 特级管家(精品服务) | 10家L2(1:30配比) | ¥13,140×10×50%/12 + 消费分润 + 续费奖金 ≈ ¥6,600-8,800 | ¥7.9-10.6万 |
+
+> **核心差异**:同样管理10个家庭,中级管家(全部L1)年收入≈¥1.1-1.4万,特级管家(全部L2)年收入≈¥7.9-10.6万——**升级为健康管家的职业吸引力远超传统岗位收入**。
+
+### 4.8 人机协作流程(不变)
+
+```
+用户请求 → AI拦截层(85-90%闭环)
+   ├─ 常见问答 → 直接回复
+   ├─ 报告解读 → 生成解读+可视化
+   ├─ 推荐请求 → 生成推荐列表
+   └─ 风险信号 → 自动标记并通知管家
+       ↓ (10-15% 需人介入)
+   管家处理层
+   ├─ AI方案审核与调整
+   ├─ 复杂健康问题研判
+   ├─ 情绪/心理类问题深度沟通
+   └─ 专家团会诊发起
+       ↓ (2-3% 超出范围)
+   专家团会诊层
+   ├─ 多学科会诊
+   ├─ 转诊建议
+   └─ 疑难案例特批
+```
+
+---
+
+## 5. 分销与消费分润体系
+
+### 5.1 核心理念
+
+四层设计原则:
+
+```
+         算团队看三层         分润只一层
+    ┌─────────────────┐ ┌─────────────────┐
+    │ 你→A→B→C 都算    │ │ 谁直接推荐    │
+    │ 你的团队人数,     │ │ 谁拿分润      │
+    │ 帮你提升等级      │ │ 不往下层抽成  │
+    └─────────────────┘ └─────────────────┘
+    ┌─────────────────┐ ┌─────────────────┐
+    │ P点制            │ │ 终身不掉级      │
+    │ 消费分润基于      │ │ 等级基于累计    │
+    │ 产品利润(非售价)  │ │ 历史最高核算    │
+    └─────────────────┘ └─────────────────┘
+```
+
+- **成人达己**:帮团队成员发展,团队壮大你升级,但他们的收益归他们
+- **P点制**:每个产品给一个P点(=平台利润额),分润 = P点之和 × 等级分润率,平台可持续
+- **终身不掉级**:基于历史累计团队人数,到达某等级永不降级
+
+### 5.2 团队结构与核心规则
+
+```
+                     你(推广人)
+                  /    |    \
+               A      B      C    ← 你的直接推荐(算你团队)
+             /  \    /      / \
+            D    E  F      G   H  ← 他们推荐(也算你团队)
+           /             / \
+          I             J   K     ← 他们的推荐(也算你团队)
+                                   ← 第4层及以下不计算
+      
+例子:你推荐3人,他们各自又推了人…
+    团队总人数 = 你 + 你直接推荐(3人) + 二层(5人) + 三层(3人) = 11人
+    → 达到 R1 传福人(≥10人)
+    
+分润分配:A买产品 → 你拿(你直接推荐)
+          D买产品 → A拿(A是D的直接推荐人)
+          I买产品 → D拿(D是I的直接推荐人)
+```
+
+| 规则 | 说明 |
+|:----|------|
+| **算团队算三层** | 你的团队人数 = 你直接推荐的一级 + 一级推荐的人 + 他们推荐的人(三级内所有付费会员) |
+| **分润分一层** | 谁直接推荐的会员产生消费,佣金/分润就给谁,不往上级抽水 |
+| **等级≥阈值即晋升** | 累计团队人数 ≥ 等级阈值即自动晋升,不限精确匹配 |
+| **终身不掉级** | 等级绑定推广人最高历史记录,永不回退 |
+| **L0可推广** | L0也能推荐会员拿佣金、晋级,但消费分润仅限L1/L2会员 |
+
+### 5.3 阶梯推广等级体系
+
+等级名称以浠艾福 **五维能量** 哲学命名,寓意推广者从利他→传福→聚能→启慧→传承的成长旅程:
+
+| 等级 | 五维 | 累计团队≥ | 推荐佣金(L1推荐) | 推荐佣金(L2推荐) | 消费分润(P点) | 额外权益 |
+|:----:|:----:|:---------:|:----------------:|:----------------:|:-------------:|----------|
+| **R0 利他者** | 💧 富 | 0 | 20%(¥262.8) | 25%(¥328.5) | P×**20%** | 基础推广工具 |
+| **R1 传福人** | 🌿 行 | ≥10 | 23%(¥302.2) | 28%(¥367.9) | P×**25%** | 专属二维码+数据看板 |
+| **R2 聚能师** | 🌏 身 | ≥50 | 26%(¥341.6) | 32%(¥420.5) | P×**30%** | +季度推广奖金池 |
+| **R3 启慧者** | ⚔️ 智 | ≥200 | 30%(¥394.2) | 36%(¥473.0) | P×**35%** | +季度家庭旅游名额 |
+| **R4 传承者** | 🔥 心 | ≥500 | 35%(¥459.9) | 40%(¥525.6) | P×**40%** | +年度平台分红 |
+
+> 推荐佣金基于**首月/首年会员费**计算(L1=¥1,314/年, L2=¥1,314/首月)。
+> 等级名称的递进:**利他起心 → 传福于行 → 聚能于身 → 启慧于智 → 传承于心**,契合五维能量相生。
+
+#### 等级评定机制
+
+```java
+// 实时评定,无需手动申请
+function evaluateTier(promoterId) {
+    int teamSize = referralService.countTeam3Levels(promoterId);
+    // teamSize >= 500 → R4
+    // teamSize >= 200 → R3  
+    // teamSize >= 50  → R2
+    // teamSize >= 10  → R1
+    // else            → R0
+    
+    int currentMax = userDao.getMaxReferralTier(promoterId);
+    int newTier = calculateTier(teamSize);
+    
+    if (newTier > currentMax) {
+        userDao.setMaxReferralTier(promoterId, newTier);
+        // 触发升级通知、庆祝弹窗
+    }
+    // 低于最高等级:不降级,沿用历史最高等级
+}
+```
+
+### 5.4 推荐佣金(一次性)
+
+**各等级推荐佣金表**(基于推广人的等级确定费率):
+
+| 推广人等级 | 被推荐人购买L1(¥1,314/年) | 被推荐人订阅L2(¥1,314/月) |
+|:---------:|:------------------------:|:------------------------:|
+| R0 利他者 | 20%(¥262.8) | 25%(¥328.5) |
+| R1 传福人 | 23%(¥302.2) | 28%(¥367.9) |
+| R2 聚能师 | 26%(¥341.6) | 32%(¥420.5) |
+| R3 启慧者 | 30%(¥394.2) | 36%(¥473.0) |
+| R4 传承者 | 35%(¥459.9) | 40%(¥525.6) |
+
+> 注意:推荐佣金仅看"推荐人是谁"(一层),不看被推荐人在团队中的层级。
+> 你直接推荐的人购买,你拿你的等级对应的佣金。
+
+### 5.5 消费分润——P点制(持续性)
+
+#### 什么是P点
+
+每个产品/服务由平台运营设置一个 **P点(Profit Point)**,代表平台在该产品上的**利润额**。
+
+| 产品 | 售价 | 平台成本 | 平台利润 | P点 | 说明 |
+|:----|:----:|:--------:|:--------:|:---:|------|
+| 精选营养品A | ¥200 | ¥120 | ¥80 | **80** | P点 = 平台实际利润 |
+| 亲子课程B | ¥300 | ¥100 | ¥200 | **200** | P点 = 平台实际利润 |
+| 健康测评C | ¥500 | ¥250 | ¥250 | **250** | 平台可自主调控 |
+| 活动报名D | ¥100 | ¥50 | ¥50 | **50** | |
+
+> **P点的意义**:平台利润越高→P点越高→推广人分润越高→更多人推广→销量越高→平台利润越高。**正向飞轮**。
+
+#### 分润计算
+
+```
+被推荐人当月购买了 [产品甲(P=80) + 服务乙(P=350) + 课程丙(P=150)]
+            ↓
+P点总和 = 80 + 350 + 150 = 580
+            ↓
+推广人等级(例:R2 聚能师,分润率=30%)
+            ↓
+消费分润 = 580 × 30% = ¥174
+```
+
+#### 各等级分润率
+
+| 推广人等级 | 消费分润率(P点×) | 举例(月均P=500) |
+|:---------:|:-----------------:|:----------------:|
+| R0 利他者 | P×**20%** | ¥100/月 |
+| R1 传福人 | P×**25%** | ¥125/月 |
+| R2 聚能师 | P×**30%** | ¥150/月 |
+| R3 启慧者 | P×**35%** | ¥175/月 |
+| R4 传承者 | P×**40%** | ¥200/月 |
+
+> **关键规则**:
+> - 分润从订单**支付成功且确认收货**后开始计算
+> - 被推荐人退款则对应分润取消(退货的P点从当月减去)
+> - 分润**不设期限**,只要推荐关系存在且被推荐人持续消费,分润持续
+> - 仅 **直接推荐** 的会员产生分润,间接推荐不产生分润
+> - 推荐人须为 **L1/L2会员** 才能获得消费分润(L0仅可获推荐佣金并晋级)
+> - L2会员可以在同等级上额外获得 **5%加成**(例如R1传福人+L2 → 25%+5%=30%),体现L2身份优势
+
+### 5.6 分润结算流程
+
+```
+用户B在平台消费(商品/活动/课程/服务)
+    │
+    ▼
+订单支付成功 → 确认收货(商品类)
+    │
+    ▼
+CommissionService.calculateConsumptionShare(order)
+    ├── 查询B的referrerId → 推荐人A(仅看直接推荐)
+    ├── 查询A的推广等级(maxReferralTier)
+    ├── 查询A的会员等级(L1/L2)
+    ├── 计算P点总和:order.items.sum(P)
+    ├── 计算分润率:tierRate + (L2会员 ? 5% : 0%)
+    └── 分润金额 = P点总和 × 分润率
+    │
+    ▼
+创建CommissionRecord(
+    type='consumption_share',
+    p_total=580,
+    share_rate=30%,
+    amount=174,
+    status='pending'(7天退货冷静期)
+)
+    │
+    ▼
+7天后自动结算 → status='settled' → 分润进入可提现余额
+```
+
+### 5.7 终身不掉级机制
+
+```
+┌────────────────────────────────────────────────┐
+│                  推广等级成长路径                  │
+│                                                    │
+│  R0利他者 → R1传福人 → R2聚能师 → R3启慧者 → R4传承者 │
+│        ↓        ↓        ↓        ↓        ↓       │
+│      10人      50人     200人     500人   最高等级    │
+│                                                    │
+│   ╔═══════════════════════════════════════════════╗  │
+│   ║        终身不掉级:只升不降,永不回退         ║  │
+│   ╚═══════════════════════════════════════════════╝  │
+└────────────────────────────────────────────────┘
+```
+
+**规则细节**:
+
+| 场景 | 累计团队人数 | 等级影响 |
+|:----|:-----------:|:--------:|
+| 达到R2(50人)后继续增长 | 80人 | 保持R2,距离R3(200人)更近 |
+| 达到R2后部分下线取消会员 | 降至40人 | **不降级**,仍为R2 |
+| 达到R3(200人)后全部流失 | 0人 | **不降级**,仍为R3 |
+| 达到R4(500人) | — | **永久传承者**,永不降级 |
+
+**代码逻辑**:
+```java
+// 获取推广人当前使用的等级(只读历史最高)
+public int getEffectiveTier(int promoterId) {
+    return userDao.getMaxReferralTier(promoterId); // 永远返回历史最高
+}
+
+// 评估是否可升级
+public void evaluateAndUpgrade(int promoterId) {
+    int teamSize = countTeam3Levels(promoterId);
+    int newTier = tierTable.getTier(teamSize); // ≥阈值即晋升
+    int currentMax = userDao.getMaxReferralTier(promoterId);
+    if (newTier > currentMax) {
+        userDao.setMaxReferralTier(promoterId, newTier);
+        notifyUpgrade(promoterId, newTier);
+    }
+}
+```
+
+### 5.8 与现有佣金体系的关系
+
+| 维度 | 原有体系(继续保留) | 新增阶梯分润体系 |
+|:----:|--------------------|-----------------|
+| 佣金类型 | 推荐商品佣金 | **阶梯推荐佣金 + P点消费分润** |
+| 推荐结构 | 平级 | **三层算团队+一层分润** |
+| 等级 | 无 | **R0-R4 五级阶梯(五维命名)** |
+| 分润基数 | 商品售价 | **产品P点(平台利润)** |
+| 分润期限 | 一次性 | **持续终身(不掉级)** |
+| 分润对象 | 推荐人(不限等级) | **仅L1/L2会员可享消费分润** |
+
+### 5.9 分润收益模拟
+
+**场景一:R0利他者→R4传承者的晋级旅程**:
+
+| 阶段 | 等级 | 直接推荐人数 | 团队3层总人数 | 月均P点总和 | 月消费分润 |
+|:---:|:----:|:----------:|:------------:|:----------:|:----------:|
+| 刚加入 | R0利他者 | 0 | 0 | ¥0(仅佣金) | ¥0 |
+| 分享给3个好友 | R0利他者 | 3 | 3+ | ¥600 | ¥600×20%=¥120 |
+| 好友也分享,团队≥10 | **R1传福人** | 5 | 10 | ¥1,500 | ¥1,500×25%=**¥375** |
+| 持续扩展,团队≥50 | **R2聚能师** | 15 | 50 | ¥5,000 | ¥5,000×30%=**¥1,500** |
+| 深度裂变,团队≥200 | **R3启慧者** | 40 | 200 | ¥20,000 | ¥20,000×35%=**¥7,000** |
+| 超级推广者,团队≥500 | **R4传承者** | 80 | 500 | ¥50,000 | ¥50,000×40%=**¥20,000** |
+
+**场景二:同样推荐50人直接下线,不同等级的收益差异**:
+
+| 等级 | 推荐佣金(一次性) | 年消费分润(人均消费¥2,000,平均P=¥800/人) | 年总收益 |
+|:---:|:-----------------:|:------------------------------------------:|:--------:|
+| R0利他者 | 50×¥262.8=¥13,140 | 50×¥800×20%=¥8,000 | **¥21,140** |
+| R1传福人 | 50×¥302.2=¥15,110 | 50×¥800×25%=¥10,000 | **¥25,110** |
+| R2聚能师 | 50×¥341.6=¥17,080 | 50×¥800×30%=¥12,000 | **¥29,080** |
+| R3启慧者 | 50×¥394.2=¥19,710 | 50×¥800×35%=¥14,000 | **¥33,710** |
+| R4传承者 | 50×¥459.9=¥22,995 | 50×¥800×40%=¥16,000 | **¥38,995** |
+
+> 等级提升的本质:**同样的人脉,更高的收益**。从R0到R4,同样50个直接朋友,收益提升**84%**。
+
+## 6. 精准推荐引擎
+
+### 6.1 架构
+
+```
+输入层(家庭健康画像)
+  静态档案(年龄/性别/体质/病史)
+  动态行为(浏览/购买/参与记录)
+  实时数据(AI问答/打卡/报告)
+  家庭关系(谁为谁买/谁影响谁)
+        ↓
+推荐引擎层
+  ① 规则引擎:体质→标签匹配、年龄/性别→适龄内容、季节/节气→应季推荐
+  ② 协同过滤:"相似家庭还买了/参加了..."
+  ③ LLM语义推荐:理解自然语言需求→生成个性化推荐理由
+        ↓
+双通道输出
+  通道A:AI自动推荐(日常/高频/实时)→ 首页推荐、消息推送、凑单推荐
+  通道B:管家精选推荐(月度/深度/人工校验)→ 管家随访推荐、月度报告附推荐
+```
+
+### 6.2 三类推荐
+
+| 推荐类型 | 核心逻辑 | 会员价策略 |
+|----------|----------|------------|
+| **📦 产品推荐** | 体质匹配、季节变换、行为补全、AI问询触发、家庭角色识别、复购提醒 | L1: 8-9折 / L2: 6-8折 |
+| **🎯 活动推荐** | 家庭健康目标匹配、位置+年龄+档期 | L1: 会员价 / L2: 90%免费 |
+| **📚 读物推荐** | 家长读物(家庭阶段匹配)、儿童读物(年龄+认知水平)、健康科普(指标异常匹配)、家庭共读 | L1: 免费 / L2: 精选书单 |
+
+### 6.3 冷启动推荐策略
+
+| 阶段 | 用户状态 | 推荐策略 |
+|:----:|----------|----------|
+| T0 | 刚注册 | 通用推荐+热门榜单+地理推荐 |
+| T1 | 完成首次健康报告 | 基于体质标签+健康目标的精准推荐 |
+| T2 | 使用7天+ | 加入行为数据协同过滤 |
+| T3 | 使用30天+ | 全量推荐(规则+协同+LLM语义) |
+| T4 | 使用90天+ | 加入季节+复购周期+家庭关系复杂推荐 |
+
+### 6.4 推荐效果指标
+
+| 指标 | 目标 |
+|:----:|:----:|
+| 点击率(CTR) | >15% |
+| 转化率(CVR) | >5% |
+| 推荐营收占比 | >30% |
+| 用户满意度 | >4.2/5 |
+
+---
+
+## 7. 商业模式测算
+
+### 7.1 核心结构性变化
+
+与 v1.0 设计相比,本方案有三个结构性变化,显著改变成本模型:
+
+| 变化 | 旧模型 | 新模型 | 影响 |
+|:----:|--------|--------|------|
+| **管家成本** | 固定工资(人力成本刚性) | **合伙分润(收入比例分成)** | 管家成本随收入浮动,无固定人力负担 |
+| **消费分润** | 无 | **P点制阶梯分润**(基于产品利润×等级分润率) | 成本与平台利润挂钩,可持续性更强 |
+| **推广体系** | 无等级平佣 | **R0-R4阶梯推广+三层算团队+终身不掉级** | 推广动力随等级递增,裂变效率持续增强 |
+
+### 7.2 L1 一生一世(¥1,314/年)单家庭年单位经济模型
+
+| 项目 | 金额(年) | 占比 |
+|:----:|:----------:|:----:|
+| **会员费营收** | **¥1,314** | 100% |
+| **支出** | | |
+| 管家分润(平均40%,含续费奖金) | ¥526 | 40% |
+| AI基础设施(LLM API/向量数据库/OCR) | ¥120 | 9% |
+| 内容/课程成本 | ¥80 | 6% |
+| 商品折扣成本(年均消费¥2,000×折扣) | ¥100 | 8% |
+| 消费分润成本(P点制·平均25%分润率) | ¥150 | 11% |
+| 平台运营/技术 | ¥80 | 6% |
+| 营销/获客(推荐佣金+推广) | ¥50 | 4% |
+| 管理/其他 | ¥50 | 4% |
+| **平台总支出** | **¥1,156** | **88%** |
+| **平台毛利润** | **¥158** | **12%** |
+
+> 消费分润成本估算:被推荐人年均消费¥2,000×40%平均利润率=¥800P点,推广人平均等级R1传福人分润率25%,¥800×25%=¥200/年,按50%推广人占比加权得¥100/年,预留上行空间取¥150。随着推广人等级升高比例同步增长,但平台利润也因销量增长而增厚。
+
+### 7.3 L2 久久一生(¥1,314/月=¥13,140/年)单家庭年单位经济模型
+
+| 项目 | 金额(年) | 占比 |
+|:----:|:----------:|:----:|
+| **会员费营收** | **¥13,140** | 100% |
+| **支出** | | |
+| 管家分润(高级管家45%,含续费奖金) | ¥5,913 | 45% |
+| AI基础设施(深度分析模式+优先响应) | ¥800 | 6% |
+| 内容/课程成本 | ¥400 | 3% |
+| 商品折扣成本(年均消费¥5,000×折扣承担) | ¥750 | 6% |
+| 消费分润成本(P点制·平均32%分润率) | ¥640 | 5% |
+| 专家团会诊成本(每年4次) | ¥500 | 4% |
+| 平台运营/技术 | ¥300 | 2% |
+| 营销/获客 | ¥150 | 1% |
+| 管理/其他 | ¥100 | 1% |
+| **平台总支出** | **¥9,553** | **73%** |
+| **平台毛利润** | **¥3,587** | **27%** |
+
+> L2消费分润成本估算:被推荐人年均消费¥5,000×40%平均利润率=¥2,000P点,推广人平均等级R2+R3分润率约30%+L2加成5%=35%,¥2,000×35%=¥700/年,预留上行空间取¥640。
+
+### 7.4 产品组合测算
+
+假设用户结构:L1占85%,L2占15%(即每100个会员中85个一生一世+15个久久一生)
+
+| 指标 | 数值 |
+|:----:|:------:|
+| 加权平均客单价 | ¥1,314×85% + ¥13,140×15% = **¥3,088** |
+| 加权平均利润率 | 12%×85% + 27%×15% = **14.25%** |
+| 单客户LTV(按3年、70%续费率) | ¥3,088 × (1 + 0.7 + 0.7²) × 14.25% ≈ **¥1,065** |
+
+> L1利润率从16%调整至12%(消费分润成本升至11%),L2利润率从28%微调至27%。整体加权利润率14.25%,低于旧模型的17.8%,但消费分润成本与平台利润同步浮动(按P点比例),规模化后利润率可持续提升。
+
+### 7.5 规模化测算
+
+| 家庭数 | 总营收 | 平台毛利 | 利润率 | 说明 |
+|:-----:|:------:|:--------:|:------:|------|
+| 1万 | ¥1,314万×85% + ¥13,140万×15% = **¥3,088万** | ¥185万 | 6% | 冷启动,管家网络+P点体系未成熟 |
+| 5万 | **¥1.54亿** | ¥2,000万 | 13% | 越过盈亏平衡点 |
+| **10万** | **¥3.09亿** | **¥4,400万** | **14%** | **规模效应显现** |
+| 30万 | ¥9.26亿 | ¥1.48亿 | 16% | AI边际成本递减 |
+| 50万 | ¥15.4亿 | ¥2.77亿 | 18% | 成熟期 |
+
+> 相比旧模型(10万家毛利¥5,500万/18%),P点制下毛利降低至¥4,400万/14%。但P点制有两个优势:(1)消费分润成本与平台利润同步浮动,不会出现"销售额增长但平台赔钱"的结构性风险;(2)推广人等级越高分润越多,但平台也因团队规模增长获得更多营收,利益一致性更强。
+
+> 合伙制下没有固定人力成本,利润率随规模增长更为平滑且可持续。管家分润随收入浮动,平台在经济下行期也不会承担固定人力风险。
+
+---
+
+## 8. 冷启动策略
+
+| 阶段 | 时间 | 目标 | 核心策略 |
+|:----:|:----:|:----:|----------|
+| **P0 种子期** | 1-2月 | 500家庭 | 现有用户限时特惠¥999开通;老带新奖励加码 |
+| **P1 验证期** | 3-6月 | 5,000家庭 | AI健康顾问7天免费体验;招募30名管家打磨SOP;体检机构/社区合作导流 |
+| **P2 增长期** | 7-12月 | 5万+家庭 | 二级分销全面启动;邀请里程碑(3/5/10人);标杆家庭案例传播;区域化管家扩张 |
+
+---
+
+## 9. 增长飞轮
+
+```
+L0免费用户 → AI体验(每日3次问答,感受价值)
+    ↓
+购买一生一世卡 ¥1,314/年(解锁全家AI+管家+推广)
+   └── 或订阅久久一生 ¥1,314/月(解锁深度AI+特级管家+高比例分润)
+    ↓
+健康改善 + 管家关系沉淀(续费率>70% → LTV>¥3,700)
+    ↓
+推广裂变(三层算团队·一层分润·终身不掉级)
+   ├── R0利他者:佣金20%+分润P×20%
+   ├── R2聚能师:佣金26%+分润P×30%  
+   └── R4传承者:佣金35%+分润P×40%
+    ↓
+推广等级提升 → 分润比例更高 → 推广动力更强 → 更多新用户
+    ↓
+回到顶部,加速旋转
+```
+
+**四个自增强飞轮**:
+- **AI质量飞轮**:用户多→数据多→AI准→体验好→续费高→用户更多
+- **管家能力飞轮**:家庭多→经验多→SOP熟→服务标准化→满意度高
+- **推荐精准飞轮**:购买多→推荐准→转化高→数据多→推荐更准
+- **推广等级飞轮**:推荐多→团队大→等级高→分润高→动力强→推荐更多
+
+---
+
+## 10. 关键指标与风险
+
+### 10.1 核心KPI
+
+| 类别 | 指标 | 目标值(Y1) |
+|:----:|:----:|:----------:|
+| 增长 | 付费家庭数 | 5万 |
+| 留存 | 次月续费率 | >85% |
+| 留存 | 年续费率 | >70% |
+| 健康 | LTV/CAC | >5x |
+| 深度 | 月均活跃天数 | >12天 |
+| 质量 | NPS | >50 |
+
+### 10.2 风险矩阵
+
+| 风险 | 概率 | 影响 | 缓解策略 |
+|:----:|:----:|:----:|----------|
+| AI回答质量不达标 | 中 | 致命 | 初期人工审核率100%;AI质量评分看板 |
+| 管家招聘跟不上增长 | 高 | 高 | 提前储备;建立"管家学院";上线前完成30人培训 |
+| ¥1,314定价接受度低 | 中 | 高 | 推出季度卡¥399降低门槛;先免费体验AI再付费 |
+| 数据合规风险 | 低 | 致命 | 上线前完成数据合规审计;加密+分级授权 |
+| 竞品跟进 | 中 | 中 | 管家关系是核心壁垒——"人"的关系难以复制 |
+
+---
+
+## 11. 与现有系统的集成关系
+
+| 现有模块 | 集成方式 |
+|---------|----------|
+| **User/FAMILY身份体系** | 家庭订阅会员作为独立身份叠加,不与原有 FREE/FAMILY/PROVIDER 冲突 |
+| **FamilyController** | 订阅会员家庭覆盖能力复用现有家庭管理,上限扩展至10-15人 |
+| **CommissionService** | 分销佣金逻辑复用,一生一世会员购买触发L1/L2佣金结算 |
+| **EnergyService/PointsService** | 会员权益中的积分/能量奖励沿用现有系统 |
+| **ProductController** | 商品查询时叠加会员折扣价逻辑 |
+| **AssessmentOrderController** | 会员专享价/免费权益接入 |
+| **AI模型服务** | 新增AI健康顾问模块,需独立部署LLM服务 |
+| **管家工作台** | 新增管理端模块,供管家查看家庭列表、AI标记、随访记录 |
+
+---
+
+## 12. 附录:设计决策记录
+
+| 决策项 | 选择 | 理由 |
+|--------|------|------|
+| 家庭订阅 vs 个人会员 | 家庭为单位 | 差异化壁垒,覆盖更多成员提升LTV |
+| ¥1,314定价(一生一世L1) | 情感定价+竞争定价 | "一生一世"易传播,相对竞品有明显价格优势 |
+| ¥1,314/月定价(久久一生L2) | 服务升级定价 | 10倍于L1的价格,匹配资深管家+深度AI+专家团+高比例分润 |
+| AI+人融合 vs 纯AI | 人+AI融合 | 管家关系是续费壁垒,AI提升效率降低成本 |
+| L1+L2双等级 vs 单等级 | 双等级 | L1普惠拉量,L2提升ARPU |
+| **推广等级 vs 平级佣金** | **R0-R4阶梯推广** | 三层算团队、一层分润、终身不掉级、五维命名 |
+| **分润基数** | **P点制(平台利润)** | 不按销售额,按利润点,平台可持续性更强 |
+| **分润方式** | **三层算团队+一层分润** | 团队协作提等级,但分润不搞MLM传销 |
+| 合伙人制 vs 雇佣制 | 管家合伙制 | 零固定人力成本,管理规模越大经济模型越好 |
+| 三引擎推荐(规则+协同+LLM) | 混合推荐 | 冷启动靠规则,规模后靠协同+LLM提升精准度 |
+| 与现有会员体系共存 | 叠加不替代 | 保护现有用户权益,降低迁移风险 |