# 用户使用场景(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`、JWT、`@RequestAttribute("role")` 校验、已废弃接口清单)。 - 实现:后端各 `*Controller.java`、小程序 `cfc-frontend/pages/*`、LangGraph 服务(端口 9000)。 ## 阅读与维护约定 - 场景是「人话」,用例是「机器/QA 可执行步骤」;一个场景可派生多条用例(正常流 + 异常流 + 权限流)。 - 涉及**双角色切换**的场景必须显式写出边界:家长↔孩子视角可切;**孩子端不能切回家长**;规划师可切回家长。 - 新增场景请同步在 `test-cases/` 对应角色文件补充用例,并在文末「关联用例」回填 TC 编号。