04-teacher.md 16 KB

用户使用场景 · 成长规划师(Teacher, role=teacher)

来源:AGENTS.md(成长规划师 role=teacher、可切回家长视角、测评订单、报告审核、方案激活拆任务、成长计划、套餐)、API_REFERENCE.md、cfc-frontend/pages/teacher/*、黑盒方案 TCH-01~TCH-12。 关联用例:test-cases/teacher.md(TC-T-01~TC-T-32,含五维变化专项 TC-T-30~32)。


场景 T-1:规划师登录并可切回家长视角

用户故事:作为成长规划师,我想用账号登录工作台,并在需要时切回我自己的家长视角。

  • 角色:规划师(role=teacher)
  • 前置条件:已分配规划师账号(手机号 + 密码)。
  • 主流程
    1. 规划师端密码登录 → 进入仪表板首页。
    2. 可切换回家长视角(自身家庭)。
  • 异常/边界:规划师视角仅见其绑定家庭;不可越权访问无关家庭数据。
  • 关联需求/设计:AuthController(登录/切换角色);规划师可切回家长视角(双角色)。
  • 关联用例:TC-T-01

场景 T-2:绑定测试家庭

用户故事:作为规划师,我想绑定客户家庭,以便代管其报告与方案。

  • 角色:规划师
  • 前置条件:家长已生成家庭邀请码。
  • 主流程
    1. 输入家庭邀请码 → 绑定。
    2. 家庭出现在「我的家庭」列表,可见成员与数据。
  • 异常/边界:无效/已失效邀请码 → 提示失败;重复绑定幂等。
  • 关联需求/设计:FamilyInviteController 绑定;规划师绑定家庭特性。
  • 关联用例:TC-T-02

场景 T-3:代上传客户报告并确认入库

用户故事:作为规划师,我想帮不擅长操作的客户上传菌群报告,并确认解析入库。

  • 角色:规划师
  • 前置条件:已绑定家庭与孩子 B。
  • 主流程
    1. 上传募极生物菌群 PDF + 选择孩子 B。
    2. 三阶段:上传 → 解析预览 → 确认入库。
    3. 报告进入孩子档案,健康列表可见。
  • 异常/边界:识别失败进入草稿/未知聚类;确认前可取消不入库。
  • 关联需求/设计:健康报告上传与解析;规划师代传/审核。
  • 关联用例:TC-T-03, TC-T-04

场景 T-4:方案审核列表与批准

用户故事:作为规划师,我想审核家长生成的方案并批准,以便进入激活。

  • 角色:规划师
  • 前置条件:家长已提交方案(status=generated)。
  • 主流程
    1. 打开方案管理页 → 列表渲染(generated/reviewed/active 状态,无白屏)。
    2. 对方案 A 点「批准」→ 状态 generated→reviewed。
  • 异常/边界:列表接口参数错误(如原 400)已修复;空列表正常展示。
  • 关联需求/设计:方案管理(规划师/运营共用);状态机 generated→reviewed→active。
  • 关联用例:TC-T-05, TC-T-06

场景 T-5:激活方案并拆任务(含幂等)

用户故事:作为规划师,我想激活方案自动拆出引导+模板任务,且重复激活不重复生成。

  • 角色:规划师
  • 前置条件:方案已 reviewed。
  • 主流程
    1. 点「激活」→ 弹确认「激活后将生成任务」。
    2. 激活后状态 reviewed→active,生成引导任务 + 模板任务。孩子 B 出现方案启动任务。
    3. 对已激活方案再次激活 → 返回状态异常提示,不重复生成任务(幂等)。
  • 异常/边界:激活失败回滚不残留半任务;幂等靠状态机守护。
  • 关联需求/设计:方案激活任务分解;幂等约束(黑盒回归项)。
  • 关联用例:TC-T-07, TC-T-08

场景 T-6:家庭任务审核

用户故事:作为规划师,我想审核孩子提交的任务,通过给分、驳回重做。

  • 角色:规划师
  • 前置条件:孩子已提交任务。
  • 主流程
    1. 打开家庭任务列表 → 审核提交。
    2. 通过 → 孩子得积分;驳回 → 任务退回重做。
  • 异常/边界:越权审核非绑定家庭任务被拒;重复审核幂等。
  • CF 值预估:审核通过发分为平台 CF 值产出点,任务项入口须按 SC-X-22 展示「本操作预计 +N CF」。
  • 关联需求/设计:TaskController 审核;积分发放。
  • 关联用例:TC-T-09

场景 T-7:录入测评结果并触发方案生成

用户故事:作为规划师,我想录入孩子各维度测评得分,以便规则引擎自动生成方案。

  • 角色:规划师
  • 前置条件:家长已支付测评订单(待安排→已预约)。
  • 主流程
    1. 打开测评订单 → 录入孩子各维度得分。
    2. 保存 → 结果可见;触发规则引擎自动生成方案(status=generated)。
    3. (DAN 链路)录入测评结果 → 确认上传 → 自动生成 generated 方案。
  • 异常/边界:必填维度缺失 → 校验拦截;重复录入覆盖而非新增。
  • 关联需求/设计:AssessmentAppointmentController(confirm/录入);DanAssessmentController DAN 全链路;规则引擎。
  • 关联用例:TC-T-10, E2E-04

场景 T-8:查看/创建成长计划与套餐

用户故事:作为规划师,我想管理客户成长计划,并上架专注力提升套餐供市场购买。

  • 角色:规划师
  • 前置条件:已绑定家庭。
  • 主流程
    1. 打开「成长计划」页 → 列表显示自己创建的计划(childName/状态/时间)。
    2. 创建「专注力提升套餐」含任务项 → 提交审核。
    3. 审核通过后套餐上架,可被市场购买。
  • 异常/边界:套餐任务项为空 → 校验拦截;未审核不可购买。
  • 关联需求/设计:GrowthPlanController /api/growth/plan、GuidePackageController /api/guide/packages。
  • 关联用例:TC-T-11, TC-T-12

场景 T-9:测评预约确认(状态守卫)(SC-T-09)

用户故事:作为规划师,我想确认孩子到约,以便预约进入已确认态。

  • 角色:规划师
  • 前置条件:家长已创建预约(待确认态)。
  • 主流程
    1. 打开预约 → 确认(待确认→已确认)。
  • 异常/边界:越状态确认需校验(如已取消/已完成不可确认);非本家庭预约不可确认(403)。
  • 关联需求/设计:AssessmentAppointmentController。
  • 关联用例:TC-T-09

场景 T-10:测评预约完成/未到(SC-T-10)

用户故事:作为规划师,我想闭环预约(完成/未到),以便记录服务结果。

  • 角色:规划师
  • 前置条件:预约已确认。
  • 主流程
    1. 完成测评 → 预约置已完成。
    2. 孩子未到 → 预约置未到。
  • 异常/边界:状态机合法流转(已确认→已完成/未到);非法跳转拦截。
  • 关联需求/设计:AssessmentAppointmentController。
  • 关联用例:TC-T-10

场景 T-11:DAN 报告上传与解析(SC-T-11)

用户故事:作为规划师,我想上传 DAN 报告并解析,以便生成测评方案。

  • 角色:规划师
  • 前置条件:已有 DAN 报告文件。
  • 主流程
    1. 上传 DAN 报告 → 解析 blocks(category 键)→ 预览。
    2. 确认 → 生成方案。
  • 异常/边界:解析失败回退人工录入;category 缺失标注;重复上传幂等。
  • 关联需求/设计:DanReportParseService / DanReportUpload。
  • 关联用例:TC-T-11

场景 T-12:DAN 八类报告查看(SC-T-12)

用户故事:作为规划师,我想审阅孩子八类测评结果,以便专业解读。

  • 角色:规划师
  • 前置条件:已有解析结果。
  • 主流程
    1. 打开结果页 → mind/wisdom/cognition/behavior/career/campus/adolescent/learning 分屏。
  • 异常/边界:量纲标注正确;结果未录入不展示。
  • 关联需求/设计:DanAssessmentResultDTO。
  • 关联用例:TC-T-12

场景 T-13:规划师视角数据隔离(SC-T-13)

用户故事:作为规划师,我想仅见绑定家庭数据,以便合规服务客户。

  • 角色:规划师
  • 前置条件:已绑定若干家庭。
  • 主流程
    1. 访问家庭/成员/报告列表 → 仅显示绑定家庭。
  • 异常/边界:非绑定家庭 403;越权调接口拒。
  • 关联需求/设计:控制器内 role 检查。
  • 关联用例:TC-T-13

场景 T-14:方案编辑(规划师侧)(SC-T-14)

用户故事:作为规划师,我想专业调整客户方案,以便提升方案质量。

  • 角色:规划师
  • 前置条件:方案存在(generated/reviewed)。
  • 主流程
    1. 编辑方案板块/任务项 → 保存。
  • 异常/边界:编辑后状态标记已改;非绑定家庭 403。
  • 关联需求/设计:方案管理。
  • 关联用例:TC-T-14

场景 T-15:套餐任务项管理(SC-T-15)

用户故事:作为规划师,我想维护套餐任务项,以便套餐内容更新。

  • 角色:规划师
  • 前置条件:已创建套餐。
  • 主流程
    1. 增删套餐任务项 → 保存 → 重算。
  • 异常/边界:空套餐拦截上架;任务项为空校验。
  • 关联需求/设计:GuidePackageController。
  • 关联用例:TC-T-15

场景 T-16:客户健康总览(SC-T-16)

用户故事:作为规划师,我想一眼看客户状态,以便快速判断服务重点。

  • 角色:规划师
  • 前置条件:已绑定家庭且成员有数据。
  • 主流程
    1. 打开家庭仪表板 → 能量/报告/方案汇总。
  • 异常/边界:数据缺失降级展示;仅绑定家庭可见。
  • 关联需求/设计:仪表板。
  • 关联用例:TC-T-16

场景 T-17:成长计划进度跟踪(SC-T-17)

用户故事:作为规划师,我想跟踪客户计划执行进度,以便适时干预。

  • 角色:规划师
  • 前置条件:计划已激活且有任务。
  • 主流程
    1. 打开计划 → 看任务完成度/进度。
  • 异常/边界:进度计算准确;无任务空态。
  • 关联需求/设计:GrowthPlanController。
  • 关联用例:TC-T-17

场景 T-18:批量任务下发(SC-T-18)

用户故事:作为规划师,我想对多孩批量子发任务,以便提升管理效率。

  • 角色:规划师
  • 前置条件:绑定家庭有多个成员。
  • 主流程
    1. 选多成员 → 批量建任务 → 各成员收到。
  • 异常/边界:部分失败不影响其他(事务边界正确);重复下发幂等。
  • 关联需求/设计:TaskController。
  • 关联用例:TC-T-18

场景 T-19:消息推送客户(SC-T-19)

用户故事:作为规划师,我想发消息/提醒客户,以便触达安排。

  • 角色:规划师
  • 前置条件:绑定家庭客户。
  • 主流程
    1. 发消息/提醒 → 客户收到 → 可标记已读。
  • 异常/边界:免打扰设置生效;越权推送拒。
  • 关联需求/设计:消息服务。
  • 关联用例:TC-T-19

场景 T-20:退出/切换账号(SC-T-20)

用户故事:作为规划师,我想安全退出/切换账号,以便换号工作。

  • 角色:规划师
  • 前置条件:已登录。
  • 主流程
    1. 退出 → 清 token/缓存 → 回登录页。
  • 异常/边界:退出后缓存清除;访问受保护接口 401。
  • 关联需求/设计:AuthController。
  • 关联用例:TC-T-20

场景 T-21:报告对比分析(SC-T-21)

用户故事:作为规划师,我想对比客户多份报告,以便看变化趋势。

  • 角色:规划师
  • 前置条件:客户有多份同类型报告。
  • 主流程
    1. 选多份报告 → 对比 → 差异标注。
  • 异常/边界:报告类型一致才可比对;类型不一致拦截。
  • 关联需求/设计:报告管理。
  • 关联用例:TC-T-21

场景 T-22:方案归档(SC-T-22)

用户故事:作为规划师,我想归档结束的方案,以便留档。

  • 角色:规划师
  • 前置条件:方案已完成/终止。
  • 主流程
    1. 方案完成 → 归档。
  • 异常/边界:归档后只读不可改。
  • 关联需求/设计:方案管理。
  • 关联用例:TC-T-22

场景 T-23:报告代传(规划师代客户传)(SC-T-23)

用户故事:作为规划师,我想代客户上传健康报告,以便无原件客户也能解析。

  • 角色:规划师
  • 前置条件:已绑定客户家庭;持有报告 PDF。
  • 主流程
    1. 上传 PDF + 选孩子 → 解析 → 关联孩子档案。
  • 异常/边界:非绑定家庭拒;识别失败进草稿;确认前可取消。
  • 关联需求/设计:报告代传/report-proxy。
  • 关联用例:TC-T-23

场景 T-24:解绑/重分配客户家庭(SC-T-24)

用户故事:作为规划师,我想解绑/重绑客户家庭,以便组织调整。

  • 角色:规划师
  • 前置条件:已有绑定家庭。
  • 主流程
    1. 解绑 → 处理在途方案/预约 → 重绑新家庭。
  • 异常/边界:在途方案/预约未处理拦截;非绑定家庭不可操作。
  • 关联需求/设计:规划师绑定。
  • 关联用例:TC-T-24

场景 T-25:舌诊/情绪测评录入(规划师)(SC-T-25)

用户故事:作为规划师,我想录入舌诊/情绪识别结果,以便辅助评估。

  • 角色:规划师
  • 前置条件:有舌诊照片。
  • 主流程
    1. 上传/录入 → 识别 → 关联报告。
  • 异常/边界:识别失败回退人工录入;图片模糊拒绝。
  • 关联需求/设计:舌诊情绪识别。
  • 关联用例:TC-T-25

场景 T-26:精准营养方案制定(规划师)(SC-T-26)

用户故事:作为规划师,我想基于客户营养目标制定方案,以便科学指导。

  • 角色:规划师
  • 前置条件:客户设定了营养目标(或由规划师设定)。
  • 主流程
    1. 设目标(热量/宏量营养素)→ 生成方案 → 关联食谱。
  • 异常/边界:目标非法(负/超上限)拦截。
  • 关联需求/设计:精准营养。
  • 关联用例:TC-T-26

场景 T-27:家庭天盘解读(规划师)(SC-T-27)

用户故事:作为规划师,我想打开客户家庭天盘并解读,以便提供全家整体建议。

  • 角色:规划师
  • 前置条件:已绑定家庭。
  • 主流程
    1. 打开天盘 → 聚合展示成员能量/报告/方案 → 解读。
  • 异常/边界:仅绑定家庭可见;数据缺失降级。
  • 关联需求/设计:家庭天盘。
  • 关联用例:TC-T-27

场景 T-28:AI 方案内容安全复核(SC-T-28)

用户故事:作为规划师,我想复核 AI 生成方案的内容安全,以便合规交付。

  • 角色:规划师
  • 前置条件:AI 方案已生成。
  • 主流程
    1. AI 生成 → 敏感词/合规检查 → 放行/驳回。
  • 异常/边界:命中敏感词即拦截;驳回带原因。
  • 关联需求/设计:内容安全。
  • 关联用例:TC-T-28

场景 T-29:客户档案数据导出(合规)(SC-T-29)

用户故事:作为规划师,我想导出客户数据(授权内),以便合规留存/迁移。

  • 角色:规划师
  • 前置条件:有授权。
  • 主流程
    1. 申请导出 → 生成加密包 → 下载。
  • 异常/边界:授权/脱敏校验;越权导出拒;频次限制。
  • 关联需求/设计:数据导出(GDPR)。
  • 关联用例:TC-T-29

注:SC-T-30(测评录入触发五维变化)/ SC-T-31(手动维度打分覆盖)/ SC-T-32(五维自评录入)属「五维指标变化专项」,完整叙事见 07-five-dimension.md(ED 专项),对应用例 TC-T-30~32 见 test-cases/teacher.md 对应专项段。