planner-zone-kickoff-20261107.md 6.5 KB

成长规划师批次 · 开工包(32 SC)

归属:契约补建计划 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/* ✅

⚠ 标注项:会话须实测定位,不得假定包路径;端点缺失 → 记入契约文档「实现缺口」段回传研发侧。

建议能力键(契约定稿后按 O-2 方案 A 映射)

  • 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.* 既有键冲突。

待办(O-7 授权节奏)

  1. 契约核对会话(本批 local-45278)产出契约文档:API_REFERENCE.md 增补「成长规划师域」段落 + docs/superpowers/specs/2026-11-07-planner-zone-contract.md + 端点核验表回填 → 单文件精确提交 push origin/cfclub。
  2. 产出后研发负责人登记 TR-13 转测试侧补契约 JUnit + 三类流证据(重点:SC-T-13 数据隔离权限流 / SC-T-05 幂等 / SC-T-09 状态守卫)。
  3. 证据入库 + 干净提交后按 sc-key-map.md 逐 SC 登记「已跑通」。