Agnes Agent
2cc7e3aadb
docs(需求): 成就成长睡眠打卡需求变更 + SC-P-94~96/SC-C-26/SC-A-27 场景入表
|
6 päivää sitten | |
|---|---|---|
| .. | ||
| 01-guest.md | 1 viikko sitten | |
| 02-parent.md | 1 viikko sitten | |
| 03-child.md | 1 viikko sitten | |
| 04-teacher.md | 1 viikko sitten | |
| 05-admin.md | 1 viikko sitten | |
| 06-vendor.md | 1 viikko sitten | |
| 07-five-dimension.md | 1 viikko sitten | |
| 08-butler.md | 1 viikko sitten | |
| 09-human-butler.md | 1 viikko sitten | |
| README.md | 1 viikko sitten | |
| 应用场景总览.md | 6 päivää sitten | |
README.md
用户使用场景（User Scenarios）
本目录从真实用户视角描述产品「怎么被使用」，是
test-cases/的上游输入。 每个场景遵循格式：用户故事（作为 X，我想 Y，以便 Z）→ 前置条件 → 主流程 → 异常/边界 → 关联需求/设计 → 关联用例。📌 测试用例划分口径（权威）：测试用例以「角色场景」为一级维度组织。先读
应用场景总览.md——它按「角色 × 业务域」给出全部 236 个应用场景（稳定编号SC-角色-NN：游客 12 / 家长 93 / 孩子 25 / 规划师 32 / 运营 24 / 服务商 11 / 跨角色 22 / AI 成长教练 10（空号 03、08）/ 真人管家 7，其中含 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~07 是各角色的完整叙事细节（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） |
08-butler.md |
AI 成长教练（AI管家） | SC-B-01~12（空号 03、08）：问题解答（咨询/报告解读/追问）/任务跟踪（提醒/推荐采纳/方案同步/家庭看板）/安全韧性 |
09-human-butler.md |
真人管家 | SC-H-01~07：人工介入/一对一陪跑/多方协调/升级应急/线下对接/AI协同闭环/服务质检 |
维护记录
| 日期 | 动作 | 影响文件 |
|---|---|---|
| 2026-11-03 | 叙事层全量补齐（各角色 SC 01~06 全覆盖）、admin 五维编号统一 SC-A-25/26、vendor TC-S-09 编号对齐、README/总览同步 | 01~06、07、应用场景总览、test-cases/vendor、README |
| 2026-11-05 | 新增健康管家独立角色 08-butler.md（SC-B-01~12），收敛家长端重复 P-11/P-49（P-49 保留入口引用）；总览新增管家段+矩阵+覆盖率表，README 索引/计数同步；场景总数 218→230 | 08-butler.md、02-parent.md、应用场景总览、README |
| 2026-11-05（二次） | AI 管家聚焦为「AI 成长教练」（删 SC-B-03/08，实编 10）；新增真人管家独立角色 09-human-butler.md（SC-H-01~07）；总览矩阵/章节/覆盖率/README 索引同步；场景总数 230→235 | 08-butler.md、09-human-butler.md、02-parent.md、应用场景总览、README |
| 2026-11-05（三次） | 新增跨角色场景 SC-X-22「CF 值获取预估（全局 UI 规范）」：凡是平台发放 CF 值（打卡/购买/分润等）的操作入口，操作前展示「本操作预计 +N CF」；总览矩阵/覆盖率/合计（235→236）、README 索引同步；受影响产出点场景（SC-P-77/P-86/T-6 等）补 CF 预估规则引用 | 应用场景总览、README、02-parent.md、04-teacher.md |
| 2026-11-05（四次） | 明确 CF 值与五维能量（ED-1~17）不同源、独立记账、互不换算：SC-X-22 删除「⚠ 待确认」，改为口径边界条款（能量变动入口不展示 +N CF，同操作分别展示不得合并数字）；五维专项段补「与 CF 值的边界」说明。仅口径澄清，场景总数不变（236） | 应用场景总览、README |
| 2026-11-05（五次） | 补齐 TC-B-01~12（空号 03、08，实编 10）与 TC-H-01~07 三流用例：新增 test-cases/butler.md（30 条）、test-cases/human-butler.md（21 条）；全仓用例 716→767；场景总数不变（236） | test-cases/butler.md、test-cases/human-butler.md、test-cases/README、08-butler.md、09-human-butler.md、应用场景总览、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 编号。