|
|
@@ -0,0 +1,118 @@
|
|
|
+# 浠艾福功能分析定义表（按会员等级）
|
|
|
+
|
|
|
+> 版本：v1.0 ｜ 日期：2026-08-16 ｜ 分支：cfclub
|
|
|
+> 用途：对系统提供的功能进行分析定义，描述每个功能针对不同用户等级的前置关卡
|
|
|
+
|
|
|
+## 一、用户等级映射
|
|
|
+
|
|
|
+| 前端展示名 | levelCode | 说明 |
|
|
|
+|-----------|-----------|------|
|
|
|
+| 免费用户 | `FREE` | 未开通会员（默认） |
|
|
|
+| 家庭会员 | `BASIC` | 已开通基础会员 |
|
|
|
+| 高级家庭会员 | `PROFESSIONAL` / `ENTERPRISE` | 专业/企业级会员 |
|
|
|
+
|
|
|
+> 权益对比表定义见 `cfc-frontend/pages/membership/index.vue`（compareData），
|
|
|
+> 实体见 `cfc-backend/.../entity/FamilyMembership.java`（FREE/BASIC/PROFESSIONAL/ENTERPRISE）。
|
|
|
+
|
|
|
+## 二、前置关卡体系（双维度）
|
|
|
+
|
|
|
+功能解锁由两个正交维度共同决定：
|
|
|
+
|
|
|
+1. **旅程阶段（journey_stage 0-7）**：决定"能不能看到下一步"——A/B/C 三类用户旅程状态机
|
|
|
+ - C类：0已选问题域 → 1已看流程 → 2调研已提交 → 3已购买 → 4试剂盒已发/样本已收 → 5报告已出 → 6方案已确认/任务已生成 → 7任务完成/CF已发
|
|
|
+ - A类简化：0已选A → 1已购测评/检测 → 2报告已出 → 3方案确认 → 4任务完成
|
|
|
+ - B类简化：0已选B → 1问卷已答（此后按结果定向展示内容）
|
|
|
+2. **会员等级**：决定"能不能执行方案任务"——免费用户到"方案确认/任务生成"被会员门槛拦截（付费转化点）
|
|
|
+
|
|
|
+## 三、功能分析定义表
|
|
|
+
|
|
|
+### 3.1 认证与意图（所有用户通用入口）
|
|
|
+
|
|
|
+| 功能 | 功能定义 | 免费用户 | 家庭会员 | 高级家庭会员 |
|
|
|
+|------|---------|:--------:|:--------:|:------------:|
|
|
|
+| 微信/手机登录 | 授权登录 + JWT 签发 | ✅ 直接 | ✅ 直接 | ✅ 直接 |
|
|
|
+| 首次意图选择 | 登录后强制选 A/B/C 类 | ✅ 登录后必选 | ✅ 登录后必选 | ✅ 登录后必选 |
|
|
|
+| 角色切换 | 家长↔孩子视角切换 | ✅ | ✅ | ✅ |
|
|
|
+| 首页旅程卡 | 按 stage 展示进度+下一步 | ✅ | ✅ | ✅ |
|
|
|
+
|
|
|
+> 规划师（teacher）角色不弹意图选择层（服务商非 C 类客户）。
|
|
|
+
|
|
|
+### 3.2 A类旅程（目标明确型）
|
|
|
+
|
|
|
+| 功能 | 功能定义 | 免费用户 | 家庭会员 | 高级家庭会员 |
|
|
|
+|------|---------|:--------:|:--------:|:------------:|
|
|
|
+| 测评/检测选购 | 直接购买 DAN测评/菌群检测 | ✅ 可直接买 | ✅ 可直接买 | ✅ 可直接买+专属价 |
|
|
|
+| 报告上传/解析 | PDF→解析→确认 | ✅ | ✅ | ✅ |
|
|
|
+| 方案确认+生成任务 | 报告后生成方案任务（memberOnly） | ❌ 需开通会员 | ✅ | ✅ |
|
|
|
+| 方案任务执行 | 执行 memberOnly 任务 | ❌ 被拦截（提示开通） | ✅ | ✅ + 优先审核 |
|
|
|
+| 完成回馈 CF | 任务全完成奖励家庭池 | —（无方案任务） | ✅ | ✅ |
|
|
|
+
|
|
|
+### 3.3 B类旅程（观望型）
|
|
|
+
|
|
|
+| 功能 | 功能定义 | 免费用户 | 家庭会员 | 高级家庭会员 |
|
|
|
+|------|---------|:--------:|:--------:|:------------:|
|
|
|
+| 轻问卷 | 5-8 题快速问卷 | ✅ | ✅ | ✅ |
|
|
|
+| 定向内容推荐 | 按 resultTags 过滤科普内容 | ✅ | ✅ | ✅ |
|
|
|
+| 成长报告 | 成长档案输出 | 月度 | 每周+深度 | 每日+深度+专家解读 |
|
|
|
+
|
|
|
+### 3.4 C类旅程（问题导向型，当前主线）
|
|
|
+
|
|
|
+| 功能 | 功能定义 | 免费用户 | 家庭会员 | 高级家庭会员 |
|
|
|
+|------|---------|:--------:|:--------:|:------------:|
|
|
|
+| 问题域选择 | 减肥/睡眠/便秘 三选一 | ✅ stage=0 | ✅ | ✅ |
|
|
|
+| 流程介绍 | 7 步服务流程说明 | ✅ stage=1 | ✅ | ✅ |
|
|
|
+| 专项调研 | 问题域专项问卷（resultTags） | ✅ stage=2 | ✅ | ✅ |
|
|
|
+| 套餐匹配/详情 | 推荐套餐列表/详情 | ✅ 可浏览 | ✅ | ✅ |
|
|
|
+| 套餐购买 | 下单支付（含试剂盒） | ✅ 可购买 | ✅ 会员折扣 | ✅ 会员折扣 |
|
|
|
+| 物流跟踪 | 试剂盒寄送/样本寄回状态 | ✅ | ✅ | ✅ |
|
|
|
+| 报告完成通知 | 报告解析完成→站内通知 | ✅ | ✅ | ✅ |
|
|
|
+| 方案确认+任务生成 | 确认方案→生成任务 | ❌ 需开通会员 | ✅ | ✅ |
|
|
|
+| 任务执行 | 执行问题域任务 | ❌ 被拦截 | ✅ 不限量 | ✅ 不限量+优先审核 |
|
|
|
+| 完成奖励 CF | 全部完成→家庭池 CF 值 | — | ✅ | ✅ |
|
|
|
+
|
|
|
+### 3.5 通用功能（等级差异明显）
|
|
|
+
|
|
|
+| 功能 | 功能定义 | 免费用户 | 家庭会员 | 高级家庭会员 |
|
|
|
+|------|---------|:--------:|:--------:|:------------:|
|
|
|
+| 自建任务 | 自己创建自己完成（免费） | ✅ 每日5个 | ✅ 不限量 | ✅ 不限量+优先审核 |
|
|
|
+| 家庭管理 | 成员/关系管理 | 基础功能 | 全部功能 | 全部功能+优先响应 |
|
|
|
+| 商城购物 | 商品/服务购买 | 普通价格 | 会员折扣 | 会员折扣 |
|
|
|
+| 推荐佣金 | 分享赚佣金 | ❌ 不可参与 | ✅ 可参与 | ✅ 可参与 |
|
|
|
+| 专属活动 | 活动报名 | 部分参与 | 全部参与 | 优先参与 |
|
|
|
+| 管家服务 | 专属管家 | ❌ | ❌ | ✅ 每周一次 |
|
|
|
+| 心愿/奖励 | 心愿审批兑换 | ✅ | ✅ | ✅ |
|
|
|
+| 五维能量沙盘 | 家庭五维能量展示 | ✅ | ✅ | ✅ |
|
|
|
+
|
|
|
+### 3.6 触达与运营
|
|
|
+
|
|
|
+| 功能 | 功能定义 | 免费用户 | 家庭会员 | 高级家庭会员 |
|
|
|
+|------|---------|:--------:|:--------:|:------------:|
|
|
|
+| 站内通知 | 用户级定向通知（报告/奖励） | ✅ 被动接收 | ✅ | ✅ |
|
|
|
+| 首页动态 | 公告+通知入 FamilyFeed | ✅ | ✅ | ✅ |
|
|
|
+| 五通道推送 | in_app 内置 + 短信/微信/公众号/电话 | ✅ in_app | ✅ 全通道可选 | ✅ 全通道可选 |
|
|
|
+
|
|
|
+## 四、管理端（运营配置，独立于会员等级）
|
|
|
+
|
|
|
+| 功能 | 功能定义 | 前置关卡 |
|
|
|
+|------|---------|---------|
|
|
|
+| 问题域管理 | 问题域 CRUD + 流程/问卷/套餐/CF值绑定 | 管理员登录 |
|
|
|
+| 通知模板管理 | 各类型通知文案 + 通道多选配置 | 管理员登录 |
|
|
|
+| 套餐/商品/审核 | 套餐、商品、活动、入驻审核 | 管理员登录 |
|
|
|
+| 物流管理 | 试剂盒发货/样本签收状态更新 | 管理员登录（套餐已售出） |
|
|
|
+
|
|
|
+## 五、核心结论
|
|
|
+
|
|
|
+1. **旅程 stage 决定可见性**：用户只能看到当前 stage 可达的下一步，无关功能不展示。
|
|
|
+2. **会员等级决定执行权**：免费用户可走通"报告已出"之前的全部环节；"方案确认/任务生成/方案任务执行"三处是会员门槛拦截点。
|
|
|
+3. **免费用户留存钩子**：自建任务免费（每日5个）+ 测评/套餐可购买，保证免费体验完整。
|
|
|
+4. **高级会员差异化**：优先审核、优先响应、管家服务、每日深度报告——服务型溢价点。
|
|
|
+
|
|
|
+## 六、相关代码位置
|
|
|
+
|
|
|
+| 内容 | 位置 |
|
|
|
+|------|------|
|
|
|
+| 会员实体 | `cfc-backend/.../entity/FamilyMembership.java` |
|
|
|
+| 会员接口 | `MembershipController`（upgrade/trial/my/can-use/benefits） |
|
|
|
+| 权益对比页 | `cfc-frontend/pages/membership/index.vue` |
|
|
|
+| 旅程状态机 | `.omo/plans/cfc-redesign-progressive-unlock.md` §3.2 |
|
|
|
+| 会员任务校验 | `TaskController` complete/accept（memberOnly） |
|
E2E Test Bot