# 浠艾福（Care Family）黑盒测试方案

> 版本：v1.0（2026-08-24）
> 测试方式：黑盒（仅通过 UI + 接口，不关注内部实现）
> 覆盖角色：游客 / 家长(parent) / 孩子(child) / 成长规划师(teacher) / 平台运营(admin) / 商品服务商(vendor)
> 重点覆盖：双角色体系、五维能量、健康报告→方案→任务主链路、家庭成员与测评闭环

---

## 1. 测试目标与范围

1. 验证 6 类角色各自的**功能入口与权限边界**（进入该进的、进不了不该进的）。
2. 验证核心业务闭环：**报告上传→解析入库→方案生成→审核→激活拆任务→执行打卡→审核统计**。
3. 验证账号/家庭/积分/能量等状态数据在操作前后的正确性。
4. 双角色特殊规则：**家长可切换孩子视角；直接登录的孩子端不能切家长端；规划师可切回家长视角**。

不在本次范围：性能压测、安全性渗透、界面像素级还原。

## 2. 角色-功能访问矩阵

| 功能域 | 游客 | 家长 | 孩子 | 规划师 | 运营 | 服务商 |
|---|:--:|:--:|:--:|:--:|:--:|:--:|
| 注册/登录/微信授权 | ● | ● | ● | ● | ●(密码) | ● |
| 创建/加入家庭、邀请成员 | — | ● | — | ●(绑定) | — | — |
| 家庭成员关系编辑 | — | ● | 只读 | 只读 | — | — |
| 任务创建/下发/审核 | — | ●(下发) | — | ● | — | — |
| 任务执行/小游戏 | — | — | ● | — | — | — |
| 心愿创建/审批/兑换 | ●(浏览) | ●(审批) | ●(创建) | — | — | — |
| 五维能量/健康指数查看 | — | ● | ● | ● | — | — |
| 测评申请/预约/支付 | — | ● | 快照对象 | ●(安排/录入) | ● | — |
| 健康报告上传/解析/查看 | — | ● | ●(查看) | ●(代传/审核) | ●(审核) | — |
| 健康方案生成/审核/激活 | — | ●(生成) | ●(执行) | ●(审核/激活) | ●(管理) | — |
| 饮食推荐 | — | ● | ● | — | — | — |
| AI 对话（LangGraph） | — | ● | ● | ● | — | — |
| 商城购买/订单 | ●(浏览) | ● | — | — | ● | ●(管理) |
| 活动报名 | ●(浏览) | ● | ● | — | ●(审核) | ●(发布) |
| 文章浏览/阅读统计 | ● | ● | ● | ● | ●(发布) | ● |
| 运营管理（数据/审核/迁移） | — | — | — | — | ● | — |
| 个人中心/积分明细/成长档案 | — | ● | ● | ● | — | — |

## 3. 通用前置条件与测试数据

- 环境：测试环境部署最新后端（含种子迁移），管理端 `http://<host>/admin/`，小程序用测试号 + `wechat.test-mode: true`。
- 准备 6 类账号：游客(未登录)、家长 A、孩子 B（A 的子账号）、规划师 T、运营管理员 M、服务商 V。
- 家庭：家庭「测试家庭1」含家长 A + 孩子 B + 爷爷 C，用于关系/评测/方案用例。
- 测试报告 PDF：`data/refs/` 下已有的**募极生物肠道菌群报告**样例文件 1 份（文件名：`530010234-侯.json` 对应报告）。
- 每次用例执行前，通过管理端还原数据（删除新建测试记录或置为草稿）。

---

## 4. 用例明细

### 4.1 游客（未登录）

| 步骤 | 角色 | 功能描述 | 数据输入 | 功能执行结果 |
|---|---|---|---|---|
| T-01 | 游客 | 打开小程序首页 | 无 | 显示引流首页，未自动进入任何业务页，可看到登录/注册按钮 |
| T-02 | 游客 | 微信一键登录 | 授权微信昵称/头像 | 登录成功生成账号，角色默认 parent，跳转角色首页 |
| T-03 | 游客 | 手机号+验证码登录 | 手机号 13800000001 + 验证码 | 验证码校验通过后登录成功；错误验证码提示失败且不产生会话 |
| T-04 | 游客 | 访问需登录页面（如家庭/任务） | 无 token | 被拦截跳转登录页，登录后回到原页面 |
| T-05 | 游客 | 浏览商城与文章 | 打开商城主页/文章列表 | 可见商品与文章列表；点击购买/详情需要登录时被拦截 |

### 4.2 家长（parent）

| 步骤 | 角色 | 功能描述 | 数据输入 | 功能执行结果 |
|---|---|---|---|---|
| P-01 | 家长 | 创建家庭 | 家庭名称「测试家庭1」 | 家庭创建成功，生成唯一邀请码/二维码，角色变为家庭管理员 |
| P-02 | 家长 | 邀请成员（二维码/邀请码） | 分享邀请码/二维码给爷爷 C | C 扫码加入家庭，家庭成员列表出现 C |
| P-03 | 家长 | 添加家庭成员资料 | 姓名/关系(爷爷)/生日/性别 | 成员卡片正确显示；关系标签可选（RelationshipPicker） |
| P-04 | 家长 | 编辑家庭关系图 | 修改 C 的关系为「外公」 | 关系图节点与关系标签同步更新 |
| P-05 | 家长 | 创建任务并下发给孩子 | 标题「睡前阅读」/成员 B/积分 10/频率每日 | 任务出现在孩子任务列表，状态待执行 |
| P-06 | 家长 | 审批孩子任务 | 任务「玩1小时游戏」点击通过 | 通过后孩子积分 +N 并有流水；驳回则任务退回 |
| P-07 | 家长 | 审批心愿 | 孩子心愿「买乐高」 | 通过→扣相应积分、进入兑换；驳回→心愿失效 |
| P-08 | 家长 | 查看家庭五维能量/健康指数 | 进入身维度首页 | 显示家庭健康指数与五维能量分配，数值合理（总和=100%） |
| P-09 | 家长 | 申请测评（完整订单） | 选择孩子 B + 测评类型 + 规划师 T + 支付 | 生成测评订单：已支付→待安排→已预约状态流转正确 |
| P-10 | 家长 | 上传健康报告 PDF | 募极生物菌群 PDF | 上传即自动解析入库；无法识别的 PDF 提示「请确认是募极生物肠道菌群报告」 |
| P-11 | 家长 | 查看报告详情 | 打开报告列表→菌群报告 | 显示菌群健康分/平衡/多样性、菌种明细、疾病风险 |
| P-12 | 家长 | 查看饮食推荐 | 打开「身→饮食推荐」 | 按菌群报告生成食材推荐指数，展示可吃/慎吃食物列表 |
| P-13 | 家长 | 生成 AI 健康方案 | 选孩子 B + 目标「基于菌群检测报告的个性化健康管理方案」 | AI 生成 overview + 营养/饮食/运动三板块；可逐板块重新生成/确认 |
| P-14 | 家长 | 保存/提交方案 | 提交方案 | 方案保存成功，进入「已提交（待规划师审核）」或按配置直接发布 |
| P-15 | 家长 | 切换孩子视角 | 个人中心→切换视角→选择孩子 B | 界面切换为孩子端界面；可再切回家长端（需密码） |
| P-16 | 家长 | 购买会员/套餐 | 支付「健康启航计划体验包」 | 支付成功后解锁方案生成等付费功能；未购买时点击生成提示购买 |
| P-17 | 家长 | 查看积分流水/成长档案 | 个人中心→积分/成长记录 | 积分流水与孩子成长记录展示一致，时间格式 yyyy-MM-dd HH:mm:ss |
| P-18 | 家长 | AI 对话（健康管家） | 提问「孩子便秘吃什么」 | 返回基于知识库的回答，可含产品/任务推荐 |

### 4.3 孩子（child）

| 步骤 | 角色 | 功能描述 | 数据输入 | 功能执行结果 |
|---|---|---|---|---|
| C-01 | 孩子 | 登录孩子端 | 孩子 B 独立登录 | 直接进入孩子端首页，**不出现切换家长入口** |
| C-02 | 孩子 | 执行任务 | 打开待执行任务「睡前阅读」→ 提交完成 | 任务状态待家长审核；完成动作写入记录 |
| C-03 | 孩子 | 玩小游戏 | 打开舒尔特方格并完成 | 得分按规则计算，积分/能量发放到账，成绩入榜 |
| C-04 | 孩子 | 创建心愿 | 心愿名称「乐高机器人」+ 积分 | 心愿进入家长待审批列表 |
| C-05 | 孩子 | 兑换通过的心愿 | 家长已通过后操作兑换 | 兑换成功，积分扣减正确 |
| C-06 | 孩子 | 查看自己的五维能量 | 进入自己的能量页 | 显示个人能量值；执行任务后能量有增量 |
| C-07 | 孩子 | 查看健康报告（只读） | 打开家长上传的报告 | 可见报告内容，但无编辑/删除入口 |
| C-08 | 孩子 | 执行方案任务并打卡 | 打开方案生成的「舒尔特方格训练」打卡 | 打卡成功，方案进度 completedDays +1 |
| C-09 | 孩子 | 查看勋章墙 | 打开勋章墙 | 显示已获得/未获得勋章及进度 |

### 4.4 成长规划师（teacher）

| 步骤 | 角色 | 功能描述 | 数据输入 | 功能执行结果 |
|---|---|---|---|---|
| TCH-01 | 规划师 | 规划师密码登录 | 手机号 + 密码 | 进入规划师端首页（仪表板）；可切换回家长视角 |
| TCH-02 | 规划师 | 绑定测试家庭 | 输入家庭邀请码 | 家庭出现在「我的家庭」列表，可见成员 |
| TCH-03 | 规划师 | 代上传客户报告 | 上传募极生物菌群 PDF + 选择孩子 | 三阶段：上传→解析预览→确认入库，报告进入孩子档案 |
| TCH-04 | 规划师 | 审核报告草稿 | 打开审核队列草稿（如 id=28）→ 确认 | 草稿确认入库，健康报告列表可见 |
| TCH-05 | 规划师 | 查看待审核方案列表 | 打开方案管理页 | 列表正常渲染（generated/reviewed/active 状态），无白屏 |
| TCH-06 | 规划师 | 批准方案 | 方案 A 点击「批准」 | 状态 generated→reviewed |
| TCH-07 | 规划师 | 激活方案（任务分解） | 已审核方案点击「激活」 | 弹确认「激活后将生成任务」；激活后状态 reviewed→active，生成引导任务+模板任务 |
| TCH-08 | 规划师 | 重复激活同一方案 | 对已激活方案再次激活 | 返回状态异常提示，**不重复生成任务**（幂等） |
| TCH-09 | 规划师 | 家庭任务审核 | 打开家庭任务列表→审核孩子提交的任务 | 通过→孩子得积分；驳回→任务退回重做 |
| TCH-10 | 规划师 | 录入测评结果 | 打开测评订单→录入孩子各维度得分 | 保存后结果可见；触发规则引擎自动生成方案（generated） |
| TCH-11 | 规划师 | 查看成长计划列表 | 打开「成长计划」页 | 页面正常加载显示自己创建的计划（childName/状态/时间） |
| TCH-12 | 规划师 | 创建套餐 | 创建「专注力提升套餐」含任务项 | 套餐上架前提交审核；审核通过后可被市场购买 |

### 4.5 平台运营（admin）

| 步骤 | 角色 | 功能描述 | 数据输入 | 功能执行结果 |
|---|---|---|---|---|
| A-01 | 运营 | 管理端密码登录 | admin 手机号+密码 | 登录进入 Dashboard，看板统计加载成功 |
| A-02 | 运营 | 全局任务统计 | 打开任务统计页 | 显示任务总量/完成率等，数值与库内一致 |
| A-03 | 运营 | 方案管理（全部家庭） | 打开方案管理页，不筛家庭 | 列出全部方案（含 source/进度/审核时间），可筛选状态 |
| A-04 | 运营 | 激活方案 | 对 reviewed 方案点击激活 | 生成任务成功，提示成功 |
| A-05 | 运营 | 报告解析中台：类型列表 | 打开报告解析中台 | 类型列表返回 ≥1 条（gut_flora 菌群检测已注册） |
| A-06 | 运营 | 注册新报告类型 | 类型ID/显示名/解析路径/threshold | 保存成功，列表可见；重复注册同 typeId 被拒绝 |
| A-07 | 运营 | 未知报告聚类审核 | 打开未知报告聚类 | 聚类列表可见；可查看聚类下上传；可自学习生成类型 |
| A-08 | 运营 | 文章发布 | 创建文章→提交审核→通过 | 创建 1s 内返回成功（无超时）；审核通过后 C 端可见 |
| A-09 | 运营 | 创建文章标题去重 | 同标题重复创建 | 第二次创建被拦截（标题已存在） |
| A-10 | 运营 | 关系类型管理 CRUD | 新增/编辑/停用关系类型 | 操作成功，家长端关系选择器同步生效 |
| A-11 | 运营 | 创建勋章 | 名称/图标/触发条件/门槛 | 保存成功返回 200（badgeId 自动生成），列表可见 |
| A-12 | 运营 | 供应商管理 | 新增供应商（昵称/手机号/真实姓名） | 保存成功，列表显示 name=昵称；同手机号重复保存被拒或覆盖可控 |
| A-13 | 运营 | 活动提交审核/撤回 | 对草稿活动提交审核→通过→撤回→退回草稿 | 状态流转正确；已发布活动可撤回、退回草稿重新编辑 |
| A-14 | 运营 | 知识库管理 | 删除知识条目 | 删除成功返回 200，列表移除，无 500 |
| A-15 | 运营 | 数据迁移 | 执行 sfms→cfc 迁移 | 迁移接口返回成功，关键业务表数据量更新 |
| A-16 | 运营 | 全局参数校验抽查 | 各管理页接口传空/错类型字段 | 返回 400 + 具体字段提示（不再裸 500「服务器内部错误」） |

### 4.6 商品服务商（vendor）

| 步骤 | 角色 | 功能描述 | 数据输入 | 功能执行结果 |
|---|---|---|---|---|
| S-01 | 服务商 | 服务商入驻申请 | 资质材料/联系方式/服务品类 | 申请提交进入运营审核 |
| S-02 | 服务商 | 商品管理 | 新增商品（名称/价格/库存/分类） | 商品在商城可见；入库存单字段校验错误时给 400 提示 |
| S-03 | 服务商 | 订单处理 | 查看新订单→发货/核销 | 订单状态流转正确，客户可见物流/核销码 |

### 4.7 主链路端到端（跨角色，周五演示脚本）

| 步骤 | 角色 | 功能描述 | 数据输入 | 功能执行结果 |
|---|---|---|---|---|
| E2E-01 | 规划师 | 代上传菌群报告 | 募极生物 PDF + 孩子 B | 报告自动解析入库，7 维健康评分刷新 |
| E2E-02 | 规划师 | 完成报告审核入库 | 草稿确认/直接入库 | `/api/health/report/list` 可查到该报告 |
| E2E-03 | 家长 | 生成 AI 健康方案 | 孩子 B + 默认目标 | 方案生成成功并保存 |
| E2E-04 | 规划师 | 按规则生成方案（DAN 链路） | 录入测评结果→确认上传 | 自动生成 status=generated 方案 |
| E2E-05 | 规划师 | 批准+激活方案 | 方案点击批准→激活 | 孩子 B 名下出现「方案启动」引导任务 + 模板任务 |
| E2E-06 | 孩子 | 打卡执行方案任务 | 完成任务并提交 | 任务待审核，方案进度 +1 |
| E2E-07 | 规划师 | 审核任务通过 | 审核通过 | 孩子积分到账，流水可见 |
| E2E-08 | 运营 | 查询全局统计 | 打开统计页 | 任务总量/完成数含本次演示数据 |

---

## 5. 回归重点（近期修复项复测）

| 复测项 | 复测步骤要点 | 预期 |
|---|---|---|
| 方案管理页白屏 | 运营/规划师进入方案管理页 | 页面正常渲染，函数不报未定义 |
| 成长计划页 | 规划师打开成长计划页 | 列表有数据，不再 400 |
| 勋章创建 | 管理端创建勋章 | 200 成功 |
| 供应商创建 | 新手机号保存 | 200 成功且字段映射正确 |
| 活动提交审核/撤回 | 草稿→提交→通过→撤回→退回草稿 | 全流程无 500 |
| 知识库删除 | 删除 id=1 | 200 成功 |
| 文章创建/编辑 | 长文（8000字）创建+更新 | 接口 1s 内返回，无超时无重复文章 |
| 接口参数校验 | 各管理接口传空 body | 400 + 字段提示，非 500 |

## 6. 通过标准

1. 所有 P0 级用例（主链路 E2E、方案管理、报告上传）100% 通过。
2. 其余用例通过率 ≥ 95%，未通过项均有明确缺陷描述与可复现步骤。
3. 修复项复测（第 5 节）全部通过。