docs(user-scenarios): 新增健康管家独立角色 08-butler.md(SC-B-01~12)，收敛家长端重复 P-11/P-49

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

@@ -19,7 +19,8 @@
 | 平台运营 | `admin` | 登录统计 / 报告解析中台 / 文章审核 / 配置CRUD / 知识库 / 迁移校验 / 监控 / 报告自学习 / 优惠券活动 / 内容安全队列 / 注销导出工单 / 限流 / 模型 / 精准营养知识库 / **五维配置治理** | 24 |
 | 商品服务商 | `vendor` | 入驻 / 商品 / 订单履约 / 售后 / 解析接入 / 食谱供给 / 合规 | 11 |
 | 跨角色 | `cross` | 测评全链路 / 报告闭环 / 双角色隔离 / 商城履约 / 消息通知 / 代传 / 解绑 / 注销 / 并发 / 会话 / 推送 / **五维隔离·对账·并发** | 21 |
-| **合计** | | | **218** |
+| 健康管家 | `butler` | 对话咨询/主动提醒/异常预警/报告解读/个性化推荐/健康简报/转接规划师/家庭看板/安全韧性 | 12 |
+| **合计** | | | **230** |
 
 ---
 
@@ -106,7 +107,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`。
+- **SC-P-49 · 进入 AI 健康管家对话（入口）⭐** — 目标：从家长端进入健康管家对话。流程：进对话 → `POST /api/ai/health-coach/send` → 多轮上下文。边界：LangGraph 不可用 Fallback；敏感问题不泄露隐私。模块：`AIChatController`；管家完整能力见 `08-butler.md` SC-B-01~12。
 
 ### 业务域 E：成长记录与档案
 
@@ -350,7 +351,30 @@
 
 ---
 
-## 十、测试用例划分规则（落地口径）
+---
+
+## 十、健康管家（Butler）应用场景
+
+**业务域：对话咨询 / 主动提醒·预警 / 报告解读 / 个性化推荐 / 健康简报 / 连接规划师 / 家庭看板 / 安全韧性**
+
+- **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-05 · 敏感问题拦截与隐私保护** — 目标：违规/敏感拒答、隐私不外泄。流程：命中→拒答+合规提示。边界：敏感词拦截；越权查他人拒。模块：内容安全。
+- **SC-B-06 · LangGraph 不可用 Fallback** — 目标：AI 故障仍可用基础能力。流程：不可达→降级规则/模板/FAQ。边界：降级提示；超时熔断；不 500。模块：`AiGateway`。
+- **SC-B-07 · 个性化任务/饮食推荐** — 目标：按五维短板/报告推荐任务心愿饮食。流程：分析→推荐→一键采纳。边界：无报告降级；过敏忌口排除。模块：推荐系统 🟡。
+- **SC-B-08 · 每日/每周健康简报** — 目标：定期家庭健康摘要。流程：聚合→摘要→推送。边界：数据缺失降级；频率可配。模块：聚合 🟡。
+- **SC-B-09 · 管家转接成长规划师** — 目标：识别专业信号引导转接。流程：识别→引导预约/消息→留痕。边界：未绑定提示先绑。模块：预约/消息 🟡。
+- **SC-B-10 · 家庭健康看板（管家聚合视图）** — 目标：一屏聚合全家五维/任务/报告/方案。流程：打开→聚合展示→下钻。边界：仅本家庭；缺失降级。模块：家庭天盘/仪表板 🟡。
+- **SC-B-11 · 报告细节追问** — 目标：基于报告上下文深入问答。流程：针对细节问→定向答→多轮。边界：超范围提示；脱离上下文回退通用。模块：`AIChatController` 🟡。
+- **SC-B-12 · 同步规划师建议主动服务** — 目标：方案生效后管家主动跟进打卡/进度。流程：同步→节奏推送→停滞提示。边界：未激活不触发；可暂停。模块：成长计划 🟡。
+
+**派生用例**：`test-cases/butler.md` TC-B-01~12（待补；本期先定场景 SC-B-01~12）。
+
+---
+
+## 十一、测试用例划分规则（落地口径）
 
 1. **一级维度 = 角色场景**：每个 `SC-角色-NN` 是测试用例聚类的根节点。
 2. **二级维度 = 流类型**：每个场景派生 3 类用例
@@ -359,7 +383,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-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-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）。
@@ -368,7 +392,7 @@
 
 ---
 
-## 十一、覆盖率追溯（场景 → 用例 → 自动化）
+## 十二、覆盖率追溯（场景 → 用例 → 自动化）
 
 | 角色 | 场景数 | 文档化用例(TC) 现状 | 状态 |
 |------|--------|---------------------|------|
@@ -379,7 +403,8 @@
 | 运营 | 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） |
-| **合计** | **218** | **218（正常流）×3 流 = 654** | ✅ 文档化用例已对齐全部 218 个场景（每个含正常/异常/权限三类） |
+| 健康管家 | 12 | 12（TC-B-01~12，待补） | 🟡 场景已定（SC-B-01~12），用例待补 |
+| **合计** | **230** | **230（正常流）×3 流 = 690** | ✅ 文档化用例已对齐全部 230 个场景（健康管家用例待补） |
 
 > 统计口径：文档化用例来自 `../test-cases/*.md` 的 `TC-` 编号去重；自动化来自 `../e2e/**/*.spec.js` 的 `test()` 计数。详见巡检脚本 `run_interface_tests_cron.sh` 的「测试用例完成情况」检查。
 >
@@ -388,3 +413,5 @@
 > **本轮扩展（+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，补齐此前"有文档无场景"的真实功能（报告代传 / 家庭天盘 / 精准营养 / 舌诊情绪 / 账号注销·数据导出·解绑 / 活动并发名额 / 消息推送 / 分享 / 多端会话 等），并同步生成异常流与权限流用例，场景总数由 151 升至 201。
 >
 > **本轮扩展（+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` 补。