归属:契约补建计划 P0「成长规划师域」· 生成 2026-11-07 08:35 数据源:sc-key-map.md(origin/cfclub,O-8 归一后 241 全量登记)· 端点核对:cfc-backend controller 源码(origin/cfclub 工作树) 前置:O-7 裁决(主理人 2026-11-06 23:59 最终确认)契约补建工作流正式生效——契约核对 = 文档核对 + 端点比对(防假 RED),产出契约文档后转测试侧补契约 JUnit + 三类流证据,渐进而非全量。
成长规划师(role=teacher)双角色:可登录规划师端,也可切回家长视角。本批 32 个 SC(SC-T-01~32)覆盖绑定/代传/方案审核/激活拆任务/任务审核/预约状态机/报告解析/数据隔离/导出/五维录入。台账「对应能力键」列全为 —。按 O-7 裁决:产出契约文档后转测试侧,不建伪实现任务。
| SC | 场景标题 | 候选端点载体(origin/cfclub 工作树) | 初核 |
|---|---|---|---|
| SC-T-01 | 规划师登录 + 切回家长 | AuthController /api/auth/*(switchRole);family.parent.switchRole 已 DONE |
✅ |
| SC-T-02 | 绑定测试家庭 | GuideFamilyController /api/guide/families/*;/api/guide/bind;TeacherFamilyBindingController /api/family/teacher-bindings/* |
✅ |
| SC-T-03 | 代传报告 + 确认入库 ⭐ | HealthReportController /api/health/report/*(upload/parse/confirm,B-2 批次已覆盖同链) |
✅ |
| SC-T-04 | 方案审核列表 + 批准 | ReviewController /api/review/*;AdminReviewCenterController /api/admin/review-center/* |
✅ |
| SC-T-05 | 激活方案拆任务(幂等)⭐ | GrowthPlanController /api/growth/plan/*(activate);PlanActivationController |
✅ |
| SC-T-06 | 家庭任务审核 | GuideFamilyTaskController /api/guide/families/*(review/batchReview) |
✅ |
| SC-T-07 | 录入测评结果触发方案 ⭐ | DanAssessmentController /api/dan-assessment/*(result 录入) |
✅ |
| SC-T-08 | 成长计划 / 套餐创建 | GuideTrainingPlanController /api/guide/training-plans/*;GrowthPlanController |
✅ |
| SC-T-09 | 测评预约确认(状态守卫) | AssessmentAppointmentController /api/assessment/appointment/* |
✅ |
| SC-T-10 | 测评预约完成/未到 | 同上(状态流转) | ✅ |
| SC-T-11 | DAN 报告上传与解析 | DanReportController /api/dan-report/*;DanAssessmentController |
✅ |
| SC-T-12 | DAN 八类报告查看 | DanAssessmentController /api/dan-assessment/result |
✅ |
| SC-T-13 | 规划师视角数据隔离 | GuideFamilyQueryController /api/guide/*;JwtInterceptor 角色 + 家庭绑定校验 |
✅ |
| SC-T-14 | 方案编辑(规划师侧) | GrowthPlanController(update);/api/health-plan/* |
✅ |
| SC-T-15 | 套餐任务项管理 | GuideTrainingPlanController 任务项 CRUD |
✅ |
| SC-T-16 | 客户健康总览 | GuideFamilyQueryController overview;GuideFamilyTaskController overview |
✅ |
| SC-T-17 | 成长计划进度跟踪 | GrowthPlanController(进度);GuideFamilyTaskController |
✅ |
| SC-T-18 | 批量任务下发 | GuideFamilyTaskController(batch*) |
✅ |
| SC-T-19 | 消息推送客户 | GuideMessageController /api/guide/messages/*;NotificationController |
✅ |
| SC-T-20 | 退出/切换账号 | AuthController(logout / switchRole) |
✅ |
| SC-T-21 | 报告对比分析 | AssessmentCompareController /api/assessment/compare/* |
✅ |
| SC-T-22 | 方案归档 | GrowthPlanController(archive);/api/health-plan/* |
✅ |
| SC-T-23 | 报告代传(规划师代客户传)⭐ | HealthReportController(代传入口,B-2 同链) |
✅ |
| SC-T-24 | 解绑/重分配客户家庭 | GuideFamilyTaskController(unbind);TeacherFamilyBindingController |
✅ |
| SC-T-25 | 舌诊/情绪测评录入(规划师) | EmotionCheckinController /api/mind/checkin/*;舌诊录入端点 |
⚠ 待核实 |
| SC-T-26 | 精准营养方案制定 | NutritionController /api/nutrition/*;DietRecommendationController |
✅ |
| SC-T-27 | 家庭天盘解读(规划师) | FamilyOverviewController(天盘聚合);/api/admin/family* |
⚠ 待核实 |
| SC-T-28 | AI 方案内容安全复核 | ReviewController(AI 方案送审);内容安全审核链 |
✅ |
| SC-T-29 | 客户档案数据导出(合规) | 导出端点(须核实);/api/admin/org/member 导出 |
⚠ 待核实 |
| SC-T-30 | 测评录入触发五维维度变化 | ManualDimensionScoreController /api/family/manual-score/*;EnergyController 归因 |
✅ |
| SC-T-31 | 手动维度打分覆盖/调整 | ManualDimensionScoreController |
✅ |
| SC-T-32 | 五维自评录入与变化 | FiveDimensionSelfCheckController /api/family/self-check/* |
✅ |
⚠ 标注项:会话须实测定位,不得假定包路径;端点缺失 → 记入契约文档「实现缺口」段回传研发侧。
teacher.login.switch(SC-T-01 / T-20)teacher.family.bind(SC-T-02 / T-24)teacher.report.proxy(SC-T-03 / T-23)teacher.plan.review(SC-T-04 / T-28)teacher.plan.activate(SC-T-05)teacher.task.review(SC-T-06 / T-18)teacher.assessment.record(SC-T-07 / T-11 / T-12)teacher.plan.create(SC-T-08 / T-14 / T-15 / T-22)teacher.appointment.guard(SC-T-09 / T-10)teacher.data.isolation(SC-T-13)teacher.family.overview(SC-T-16 / T-17 / T-21 / T-27)teacher.message.push(SC-T-19)teacher.mind.record(SC-T-25)teacher.nutrition.plan(SC-T-26)teacher.export(SC-T-29)teacher.dimension.score(SC-T-30 / T-31 / T-32)注:建议映射非最终契约键;定稿须对齐 API_REFERENCE 与派生用例,避免与
guide.*/family.parent.*/energy.*既有键冲突。
API_REFERENCE.md 增补「成长规划师域」段落 + docs/superpowers/specs/2026-11-07-planner-zone-contract.md + 端点核验表回填 → 单文件精确提交 push origin/cfclub。sc-key-map.md 逐 SC 登记「已跑通」。