# 用户使用场景(User Scenarios) > 本目录从**真实用户视角**描述产品「怎么被使用」,是 `test-cases/` 的上游输入。 > 每个场景遵循格式:**用户故事(作为 X,我想 Y,以便 Z)→ 前置条件 → 主流程 → 异常/边界 → 关联需求/设计 → 关联用例**。 > **📌 测试用例划分口径(权威)**:测试用例以「**角色场景**」为一级维度组织。先读 [`应用场景总览.md`](./应用场景总览.md)——它按「角色 × 业务域」给出全部 **201 个应用场景**(稳定编号 `SC-角色-NN`,其中本轮新增 SC-G-11~12 / SC-P-67~86 / SC-C-19~23 / SC-T-23~29 / SC-A-16~22 / SC-S-09~11 / SC-X-13~18),并规定每个场景派生 3 类用例(正常流/异常流/权限流)、编号回链与优先级映射。本文 01~06 是各角色的完整叙事细节,总览是上层目录与追溯矩阵。 ## 角色与场景索引 | 文件 | 角色 | 核心场景 | |------|------|----------| | `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 编号。