cfc/tests/user-scenarios/README.md

用户使用场景（User Scenarios）

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

角色与场景索引

文件	角色	核心场景
01-guest.md	游客	首次进入、微信/手机登录、邀请注册加入家庭、越权拦截、浏览商城文章
02-parent.md	家长	创建/邀请家庭、成员与关系编辑、双角色切换、任务/心愿、五维能量、测评订单、健康报告主链路、AI 方案与对话、购买会员
03-child.md	孩子	孩子端登录（无家长入口）、执行任务/小游戏、心愿、查看能量与报告（只读）、方案打卡、勋章墙
04-teacher.md	成长规划师	密码登录、绑定家庭、代传报告、审核方案、激活拆任务（幂等）、录入测评、成长计划、创建套餐
05-admin.md	平台运营	管理端登录、全局统计、报告解析中台、文章发布审核、关系类型/勋章/供应商/活动/知识库、数据迁移、参数校验
06-vendor.md	商品服务商	入驻申请、商品管理、订单处理（发货/核销）

编写依据

• 需求/设计：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 编号。