# 用户使用场景(User Scenarios) > 本目录从**真实用户视角**描述产品「怎么被使用」,是 `test-cases/` 的上游输入。 > 每个场景遵循格式:**用户故事(作为 X,我想 Y,以便 Z)→ 前置条件 → 主流程 → 异常/边界 → 关联需求/设计 → 关联用例**。 > **📌 测试用例划分口径(权威)**:测试用例以「**角色场景**」为一级维度组织。先读 [`应用场景总览.md`](./应用场景总览.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`、JWT、`@RequestAttribute("role")` 校验、已废弃接口清单)。 - 实现:后端各 `*Controller.java`、小程序 `cfc-frontend/pages/*`、LangGraph 服务(端口 9000)。 ## 阅读与维护约定 - 场景是「人话」,用例是「机器/QA 可执行步骤」;一个场景可派生多条用例(正常流 + 异常流 + 权限流)。 - 涉及**双角色切换**的场景必须显式写出边界:家长↔孩子视角可切;**孩子端不能切回家长**;规划师可切回家长。 - 新增场景请同步在 `test-cases/` 对应角色文件补充用例,并在文末「关联用例」回填 TC 编号。