cfc/tests/user-scenarios

用户使用场景（User Scenarios）

本目录从真实用户视角描述产品「怎么被使用」，是 test-cases/ 的上游输入。 每个场景遵循格式：用户故事（作为 X，我想 Y，以便 Z）→ 前置条件 → 主流程 → 异常/边界 → 关联需求/设计 → 关联用例。

📌 测试用例划分口径（权威）：测试用例以「角色场景」为一级维度组织。先读 应用场景总览.md——它按「角色 × 业务域」给出全部 218 个应用场景（稳定编号 SC-角色-NN：游客 12 / 家长 93 / 孩子 25 / 规划师 32 / 运营 24 / 服务商 11 / 跨角色 21，其中含 2026-11-02 新增五维变化专项 +17：SC-P-87~93 / SC-C-24~25 / SC-T-30~32 / SC-A-25~26 / SC-X-19~21），并规定每个场景派生 3 类用例（正常流/异常流/权限流）、编号回链与优先级映射。本文 01~06 是各角色的完整叙事细节（2026-11-03 已按 SC 编号全量补齐，每个场景标注 （SC-角色-NN） 回链），总览是上层目录与追溯矩阵。

角色与场景索引

文件	角色	核心场景（SC 编号范围）
01-guest.md	游客	SC-G-01~12：首次进入、微信/手机登录、邀请注册、越权拦截、环境/测试模式/隐私/非微信兜底
02-parent.md	家长	SC-P-01~93：创建/邀请家庭、成员关系编辑、双角色切换、任务/心愿、五维能量、测评订单、健康报告、AI 方案/对话、饮食食谱、商城/会员、联系人、设置/隐私、报告代传、天盘、营养/舌诊、注销/导出、多孩子/规划师切换、活动/优惠券、消息/搜索/反馈/分享/多端/排行（含五维专项 P-87~93）
03-child.md	孩子	SC-C-01~23：孩子端登录、任务/小游戏、心愿、能量/报告只读、方案打卡、勋章/成长/消息/档案/舌诊/商城/反馈/退出/绑定（五维专项 C-24~25 见 07）
04-teacher.md	成长规划师	SC-T-01~29/30~32：登录/切换、绑定/解绑、代传/审核/激活、测评录入/DAN、成长计划/套餐、任务/消息/对比/归档/舌诊/营养/天盘/内容安全/导出（五维专项 T-30~32 见 07）
05-admin.md	平台运营	SC-A-01~22, SC-A-25~26（空号 23/24）：登录/看板、报告解析中台、文章审核、关系/勋章/供应商/活动/知识库/迁移/参数/知识库/监控/审计/GDPR/限流/模型/营养库/优惠券/内容安全/五维配置治理（A-25~26 见 07）
06-vendor.md	商品服务商	SC-S-01~11：入驻/商品/订单/核销/库存/售后/活动/结算/解析中台/营养数据/合规导出
07-five-dimension.md	全角色（五维变化）	ED-1~17：任务/打卡/小游戏/测评/报告/手动/自评/心愿/日上限/权重/跨角色隔离·对账·并发（对应 P-87~93/C-24~25/T-30~32/A-25~26/X-19~21）

---

维护记录

日期	动作	影响文件
2026-11-03	叙事层全量补齐（各角色 SC 01~06 全覆盖）、admin 五维编号统一 SC-A-25/26、vendor TC-S-09 编号对齐、README/总览同步	01~06、07、应用场景总览、test-cases/vendor、README

编写依据

• 需求/设计：AGENTS.md（双角色、五维能量、测评订单、四级地址、多数据源、LangGraph 统一 AI、报告解析、文章审核、饮食推荐、家庭邀请二维码、关系类型 CRUD）。
• 接口：docs/superpowers/api/API_REFERENCE.md（统一 POST、Result<T>、JWT、@RequestAttribute("role") 校验、已废弃接口清单）。
• 实现：后端各 *Controller.java、小程序 cfc-frontend/pages/*、LangGraph 服务（端口 9000）。

阅读与维护约定

• 场景是「人话」，用例是「机器/QA 可执行步骤」；一个场景可派生多条用例（正常流 + 异常流 + 权限流）。
• 涉及双角色切换的场景必须显式写出边界：家长↔孩子视角可切；孩子端不能切回家长；规划师可切回家长。
• 新增场景请同步在 test-cases/ 对应角色文件补充用例，并在文末「关联用例」回填 TC 编号。