Просмотр исходного кода

docs(user-scenarios): AI管家聚焦为AI成长教练(删SC-B-03/08),新增真人管家角色09-human-butler.md(SC-H-01~07),场景总数230→235

liaoxg 1 неделя назад
Родитель
Сommit
0986045612
1 измененных файлов с 40 добавлено и 20 удалено
  1. 40 20
      tests/user-scenarios/应用场景总览.md

+ 40 - 20
tests/user-scenarios/应用场景总览.md

@@ -19,8 +19,9 @@
 | 平台运营 | `admin` | 登录统计 / 报告解析中台 / 文章审核 / 配置CRUD / 知识库 / 迁移校验 / 监控 / 报告自学习 / 优惠券活动 / 内容安全队列 / 注销导出工单 / 限流 / 模型 / 精准营养知识库 / **五维配置治理** | 24 |
 | 商品服务商 | `vendor` | 入驻 / 商品 / 订单履约 / 售后 / 解析接入 / 食谱供给 / 合规 | 11 |
 | 跨角色 | `cross` | 测评全链路 / 报告闭环 / 双角色隔离 / 商城履约 / 消息通知 / 代传 / 解绑 / 注销 / 并发 / 会话 / 推送 / **五维隔离·对账·并发** | 21 |
-| 健康管家 | `butler` | 对话咨询/主动提醒/异常预警/报告解读/个性化推荐/健康简报/转接规划师/家庭看板/安全韧性 | 12 |
-| **合计** | | | **230** |
+| AI 成长教练(AI管家) | `butler` | 问题解答(咨询/报告解读/追问)/任务跟踪(提醒/推荐采纳/方案同步/家庭看板)/安全韧性 | 10(空号 03、08) |
+| 真人管家 | `human-butler` | 人工介入/一对一陪跑/多方协调/升级应急/线下对接/AI协同闭环/服务质检 | 7 |
+| **合计** | | | **235** |
 
 ---
 
@@ -107,7 +108,7 @@
 - **SC-P-46 · 激活方案生成任务(生成任务)⭐ 生成任务** — 目标:方案拆出可执行任务。流程:激活 reviewed→active → 生成引导+模板任务 → B 出现启动任务。边界:已激活再激活**不重复生成(幂等靠状态机,CFC 深挖项)**;失败回滚不残半任务。模块:方案激活任务分解。
 - **SC-P-47 · 查看方案下任务列表** — 目标:跟踪执行。流程:方案 → 关联任务列表(状态/进度)。边界:任务增删与方案同步。模块:`GrowthPlanController`。
 - **SC-P-48 · 方案版本/历史** — 目标:回溯方案变更。流程:看方案版本列表 → 对比。边界:版本不可篡改。模块:方案管理。
-- **SC-P-49 · 进入 AI 健康管家对话(入口)⭐** — 目标:从家长端进入健康管家对话。流程:进对话 → `POST /api/ai/health-coach/send` → 多轮上下文。边界:LangGraph 不可用 Fallback;敏感问题不泄露隐私。模块:`AIChatController`;管家完整能力见 `08-butler.md` SC-B-01~12。
+- **SC-P-49 · 进入 AI 健康管家对话(入口)⭐** — 目标:从家长端进入健康管家对话。流程:进对话 → `POST /api/ai/health-coach/send` → 多轮上下文。边界:LangGraph 不可用 Fallback;敏感问题不泄露隐私。模块:`AIChatController`;管家完整能力见 `08-butler.md` SC-B-01~12(空号 03、08);真人管家见 `09-human-butler.md` SC-H-01~07。
 
 ### 业务域 E:成长记录与档案
 
@@ -353,28 +354,44 @@
 
 ---
 
-## 十、健康管家(Butler)应用场景
+## 十、AI 成长教练(AI管家)应用场景
 
-**业务域:对话咨询 / 主动提醒·预警 / 报告解读 / 个性化推荐 / 健康简报 / 连接规划师 / 家庭看板 / 安全韧性**
+**业务域:问题解答(咨询/报告解读/追问) / 任务跟踪(提醒/推荐采纳/方案同步/家庭看板) / 安全韧性(横切)**
 
-- **SC-B-01 · 健康管家对话咨询** — 目标:随时问管家获知识库回答。流程:进对话 → `POST /api/ai/health-coach/send` → 多轮上下文。边界:LangGraph 不可用 Fallback;敏感不泄露。模块:`AIChatController`。家长端入口见 SC-P-49。
-- **SC-B-02 · 主动健康提醒** — 目标:按用药/饮水/作息/测评到期主动提醒。流程:配置→触发→推送。边界:免打扰生效;重复去重;仅本家庭。模块:消息服务 🟡。
-- **SC-B-03 · 异常指标预警** — 目标:五维/报告异常主动预警+建议。流程:越阈值→预警→建议。边界:静默策略;阈值可配;误报可忽略。模块:监控/阈值引擎 🟡。
-- **SC-B-04 · 健康报告智能解读** — 目标:报告翻译人话+五维关联+行动建议。流程:选报告→解读。边界:无报告不解读;不超范围;脱敏。模块:报告解析中台 🟡。
+- **SC-B-01 · 成长咨询对话** — 目标:随时问教练获知识库回答。流程:进对话 → `POST /api/ai/health-coach/send` → 多轮上下文。边界:LangGraph 不可用 Fallback;敏感不泄露。模块:`AIChatController`。家长端入口见 SC-P-49。
+- **SC-B-02 · 主动成长提醒** — 目标:按用药/饮水/作息/测评到期/打卡主动提醒。流程:配置→触发→推送。边界:免打扰生效;重复去重;仅本家庭。模块:消息服务 🟡。
+- **SC-B-04 · 成长报告智能解读** — 目标:报告翻译人话+五维关联+行动建议。流程:选报告→解读。边界:无报告不解读;不超范围;脱敏。模块:报告解析中台 🟡。
 - **SC-B-05 · 敏感问题拦截与隐私保护** — 目标:违规/敏感拒答、隐私不外泄。流程:命中→拒答+合规提示。边界:敏感词拦截;越权查他人拒。模块:内容安全。
 - **SC-B-06 · LangGraph 不可用 Fallback** — 目标:AI 故障仍可用基础能力。流程:不可达→降级规则/模板/FAQ。边界:降级提示;超时熔断;不 500。模块:`AiGateway`。
-- **SC-B-07 · 个性化任务/饮食推荐** — 目标:按五维短板/报告推荐任务心愿饮食。流程:分析→推荐→一键采纳。边界:无报告降级;过敏忌口排除。模块:推荐系统 🟡。
-- **SC-B-08 · 每日/每周健康简报** — 目标:定期家庭健康摘要。流程:聚合→摘要→推送。边界:数据缺失降级;频率可配。模块:聚合 🟡。
-- **SC-B-09 · 管家转接成长规划师** — 目标:识别专业信号引导转接。流程:识别→引导预约/消息→留痕。边界:未绑定提示先绑。模块:预约/消息 🟡。
-- **SC-B-10 · 家庭健康看板(管家聚合视图)** — 目标:一屏聚合全家五维/任务/报告/方案。流程:打开→聚合展示→下钻。边界:仅本家庭;缺失降级。模块:家庭天盘/仪表板 🟡。
+- **SC-B-07 · 个性化任务/饮食推荐与采纳** — 目标:按五维短板/报告推荐任务心愿饮食并一键采纳。流程:分析→推荐→采纳。边界:无报告降级;过敏忌口排除。模块:推荐系统 🟡。
+- **SC-B-09 · 教练转接成长规划师** — 目标:识别专业信号引导转接。流程:识别→引导预约/消息→留痕。边界:未绑定提示先绑。模块:预约/消息 🟡。
+- **SC-B-10 · 家庭成长看板(教练聚合视图)** — 目标:一屏聚合全家五维/任务/报告/方案。流程:打开→聚合展示→下钻。边界:仅本家庭;缺失降级。模块:家庭天盘/仪表板 🟡。
 - **SC-B-11 · 报告细节追问** — 目标:基于报告上下文深入问答。流程:针对细节问→定向答→多轮。边界:超范围提示;脱离上下文回退通用。模块:`AIChatController` 🟡。
-- **SC-B-12 · 同步规划师建议主动服务** — 目标:方案生效后管家主动跟进打卡/进度。流程:同步→节奏推送→停滞提示。边界:未激活不触发;可暂停。模块:成长计划 🟡。
+- **SC-B-12 · 同步规划师建议主动跟进** — 目标:方案生效后教练主动跟进打卡/进度。流程:同步→节奏推送→停滞提示。边界:未激活不触发;可暂停。模块:成长计划 🟡。
 
-**派生用例**:`test-cases/butler.md` TC-B-01~12(待补;本期先定场景 SC-B-01~12)。
+**空号说明**:SC-B-03(异常指标预警)、SC-B-08(每日/每周简报)本轮移出 AI 管家核心范畴,下沉至运营/跨角色能力,不再作为 AI 成长教练职责。
+
+**派生用例**:`test-cases/butler.md` TC-B-01~12(待补;本期先定场景 SC-B-01~12,空号 03、08)。
+
+---
+
+## 十一、真人管家(Human Butler)应用场景
+
+**业务域:人工介入与升级 / 一对一服务与协调 / 资源对接与协同闭环 / 服务质量**
+
+- **SC-H-01 · 接收 AI 升级并人工介入** — 目标:AI 升级工单及时介入不悬空。流程:收单→研判→联系家长/转规划师→留痕。边界:高风险优先应急;超时升级;仅本家庭。模块:工单/客服 🟡。协同 SC-B-09。
+- **SC-H-02 · 一对一家长陪跑** — 目标:1v1 成长陪跑与个性化答疑。流程:建档案→定期回访→随时咨询。边界:不替代规划师;SLA 可配;脱敏。模块:CRM 🟡。
+- **SC-H-03 · 多方沟通协调** — 目标:家长/规划师/孩子信息对齐。流程:收集→同步专业结论→反馈疑虑→闭环。边界:不变更方案;脱敏;争议引导直连。模块:消息协同 🟡。
+- **SC-H-04 · 升级与应急处理** — 目标:投诉/紧急事件/异常有清晰升级路径。流程:分级→一级自处/二级升级→留痕复盘。边界:不代医疗诊断;不丢上下文。模块:工单升级 🟡。
+- **SC-H-05 · 线下资源与活动对接** — 目标:线上方案落线下。流程:匹配→推送预约→回访。边界:仅审核资源;名额实时校验;不强制。模块:活动/资源对接 🟡。
+- **SC-H-06 · 与 AI 管家协同闭环** — 目标:处理完回写闭环并反哺 AI。流程:闭环标记→知识反哺→反馈家长。边界:反哺审核;不泄露隐私;可审计。模块:知识/工单闭环 🟡。协同 SC-B-09/SC-H-01。
+- **SC-H-07 · 服务质检与满意度** — 目标:保障服务一致性。流程:质检→满意度回访→回流改进。边界:不泄露隐私;差评触发复盘。模块:质检/满意度 🟡。
+
+**派生用例**:`test-cases/human-butler.md` TC-H-01~07(待补;本期先定场景 SC-H-01~07)。
 
 ---
 
-## 十一、测试用例划分规则(落地口径)
+## 十二、测试用例划分规则(落地口径)
 
 1. **一级维度 = 角色场景**:每个 `SC-角色-NN` 是测试用例聚类的根节点。
 2. **二级维度 = 流类型**:每个场景派生 3 类用例
@@ -383,7 +400,7 @@
    - 权限流(越权/角色错配/数据隔离)
 3. **编号回链**:用例编号 `TC-角色-NN` 与场景 `SC-角色-NN` 一一对应;深挖项用 `TC-DV-NN` 单独成册。
 4. **优先级映射**(P0 核心闭环优先):
-   - **P0**:SC-P-01/03/10/11/13/20/36/38/40/44/46/49、SC-B-01、SC-T-03/05/07/09/11、SC-X-01/02/03/06
+   - **P0**:SC-P-01/03/10/11/13/20/36/38/40/44/46/49、SC-B-01、SC-H-01、SC-T-03/05/07/09/11、SC-X-01/02/03/06
    - **P1**:SC-P-17/21/23/26/27/31/32/33/34/35/37/39/41/42/43/45/47/52~60、SC-C-02/05/07/09、SC-T-01/02/04/06/08/12/13、SC-A-01/03/08/10、SC-S-02/03/04、SC-X-04/05/07/08/09/12
    - **P2**:其余游客/配置/设置类(SC-G-*、SC-P-02/05/06/08/09/19/50/51/61~66、SC-C-01/03/04/06/08/10~18、SC-T-14~22、SC-A-02/04/05/06/07/09/11~15、SC-S-01/05~08、SC-X-10/11)
    - **新增(本轮 +50)**: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 已纳入;P0 含 SC-P-67 报告代传 / SC-P-76 活动并发名额 / SC-X-16 并发 E2E,其余默认 P1(设置/协议类为 P2)。
@@ -392,7 +409,7 @@
 
 ---
 
-## 十二、覆盖率追溯(场景 → 用例 → 自动化)
+## 十三、覆盖率追溯(场景 → 用例 → 自动化)
 
 | 角色 | 场景数 | 文档化用例(TC) 现状 | 状态 |
 |------|--------|---------------------|------|
@@ -403,8 +420,9 @@
 | 运营 | 24 | 24(TC-A-01~23 + 25~26,空号 24) | ✅ 已覆盖(含五维配置治理 SC-A-25~26) |
 | 服务商 | 11 | 11(TC-S-01~11) | ✅ 已覆盖 SC-S-01~11 |
 | 跨角色 | 21 | 21(TC-X-01~21) | ✅ 已覆盖(含五维隔离/对账/并发 SC-X-19~21) |
-| 健康管家 | 12 | 12(TC-B-01~12,待补) | 🟡 场景已定(SC-B-01~12),用例待补 |
-| **合计** | **230** | **230(正常流)×3 流 = 690** | ✅ 文档化用例已对齐全部 230 个场景(健康管家用例待补) |
+| AI 成长教练(AI管家) | 10 | 10(TC-B-01~12 待补,空号 03、08) | 🟡 场景已定(SC-B-01~12,空号 03、08),用例待补 |
+| 真人管家 | 7 | 7(TC-H-01~07,待补) | 🟡 场景已定(SC-H-01~07),用例待补 |
+| **合计** | **235** | **235(正常流)×3 流 = 705** | ✅ 文档化用例已对齐全部 235 个场景(AI成长教练/真人管家用例待补) |
 
 > 统计口径:文档化用例来自 `../test-cases/*.md` 的 `TC-` 编号去重;自动化来自 `../e2e/**/*.spec.js` 的 `test()` 计数。详见巡检脚本 `run_interface_tests_cron.sh` 的「测试用例完成情况」检查。
 >
@@ -415,3 +433,5 @@
 > **本轮扩展(+17 五维变化专项 · 2026-11-02)**:补齐「五维指标**变化**」专项,场景总数由 201 升至 218。新增 SC-P-87~93(家长·能量变化规则)/ SC-C-24~25(孩子·自身变化)/ SC-T-30~32(规划师·变化录入)/ SC-A-25~26(运营·配置治理)/ SC-X-19~21(跨角色·隔离·对账·并发)。完整用户故事见 `07-five-dimension.md`;用例见 `test-cases/*.md` 的 `TC-P-87~93` 等。本批用例与既有用例统一改造为**具体异常流**(明确故障注入与可判定断言,废除"系统给出明确错误提示而非 500"等模板文案),详见 § 十 优先级映射与 `test-cases` 对应「五维指标变化专项」段。
 
 > **本轮扩展(+12 健康管家角色 · 2026-11-05)**:新增独立角色「健康管家 / butler」,新建 `08-butler.md`,场景 SC-B-01~12(对话咨询/主动提醒/异常预警/报告解读/个性化推荐/健康简报/转接规划师/家庭看板/报告追问/同步规划师建议/敏感拦截/Fallback)。收敛家长端重复的 P-11 与 P-49(P-49 保留为入口引用指向 08-butler.md),场景总数由 218 升至 230。用例 TC-B-01~12 待下轮在 `test-cases/butler.md` 补。
+
+> **本轮修订(2026-11-05 二次 · AI管家聚焦 + 真人管家)**:AI 管家定位由「健康管家」聚焦为「AI 成长教练」,核心职责收敛为「问题解答 + 任务跟踪」,移出弱相关场景 SC-B-03(异常指标预警)、SC-B-08(健康简报),butler 实编降至 10(空号 03、08)。新增独立角色「真人管家 / human-butler」,新建 `09-human-butler.md`,场景 SC-H-01~07(M4/S2/C1)。场景总数 230 → 235。用例 TC-B-/TC-H- 待下轮补。