归属:契约补建计划 P0「测评-方案」· 生成 2026-11-06 22:30 数据源:sc-key-map.md(origin/cfclub,236 全量登记)· 端点核对:cfc-backend controller 源码(origin/cfclub 工作树)
家长「测评 → 方案 → 任务」核心主线,是全产品最高频链路;本批 43 个 SC 均无合法能力键(台账「对应能力键」列全为 —),需先定契约才能 --add-task 入池。
覆盖四段:DAN 测评(下单/支付/额度/预约/录入/结果)→ AI 方案(生成/重生成/编辑/确认/发布/版本)→ 规划师侧(审核/激活/编辑/归档/套餐项)→ 孩子执行(打卡进度/通知/五维增长),外加 3 个跨角色全链路。
| SC | 角色 | 场景标题 | 建议能力键 | 契约接口范围 | 依赖 Controller |
|---|---|---|---|---|---|
| SC-P-33 | 家长 | 购买测评套餐/下单 | dan.assessment.orderCreate | /api/package/order/create、/api/package/price、/api/guide/guide-packages | PackagePurchaseController、GuideController |
| SC-P-34 | 家长 | 测评订单支付 | dan.assessment.orderPay | /api/payment/wechat/create、/api/payment/order/status/{orderNo} | PaymentController |
| SC-P-35 | 家长 | 获得测评额度 | dan.assessment.quotaAcquire | /api/dan-assessment/points-config、/api/dan-assessment/family/enable | DanAssessmentController |
| SC-P-36 | 家长 | 创建预约(消耗额度)⭐ | dan.assessment.appointmentCreate | /api/dan-assessment/appointment/create | DanAssessmentController |
| SC-P-37 | 家长 | 查看预约状态 | dan.assessment.appointmentView | /api/dan-assessment/appointment/user | DanAssessmentController |
| SC-P-38 | 家长 | 取消预约(越权校验) | dan.assessment.appointmentCancel | /api/dan-assessment/appointment/cancel | DanAssessmentController |
| SC-P-32 | 家长 | 选择规划师 | guide.parent.selectPlanner | /api/package/available-guides、/api/guide/parent-invite/accept | PackagePurchaseController、GuideController |
| SC-P-58 | 家长 | 购买会员/套餐 | membership.parent.purchase | /api/membership/*、/api/package/order/create | MembershipController、PackagePurchaseController |
| SC-P-74 | 家长 | 解绑/重新分配规划师 | guide.parent.unbind | /api/guide/families/unbind、/api/guide/families/bound-families | GuideFamilyTaskController |
| SC-P-40 | 家长 | 生成 AI 方案(一键生成)⭐ | plan.parent.generate | /api/health/plan/generate | HealthPlanController |
| SC-P-41 | 家长 | 方案分板块重生成 | plan.parent.regenerateSection | /api/health/plan/regenerate-section | HealthPlanController |
| SC-P-42 | 家长 | 方案编辑/调整 | plan.parent.edit | /api/health/plan/save | HealthPlanController |
| SC-P-43 | 家长 | 查看生成的方案 | plan.parent.view | /api/health/plan/detail、/api/health/plan/list | HealthPlanController |
| SC-P-44 | 家长 | 确认方案(送审/家长确认)⭐ | plan.parent.confirm | /api/health/plan/confirm、/api/health/plan/pending-review/approve | HealthPlanController |
| SC-P-45 | 家长 | 方案直接发布 | plan.parent.publish | /api/health/plan/confirm、/api/orchestration/flow/publish | HealthPlanController、OrchestrationController |
| SC-P-46 | 家长 | 激活方案生成任务(生成任务)⭐ | plan.parent.activateTasks | /api/health/plan/tasks、/api/orchestration/execution/start | HealthPlanController、OrchestrationController |
| SC-P-47 | 家长 | 查看方案下任务列表 | plan.parent.taskList | /api/health/plan/tasks | HealthPlanController |
| SC-P-48 | 家长 | 方案版本/历史 | plan.parent.history | /api/health/plan/detail、/api/health/plan/pending-review/list | HealthPlanController |
| SC-P-81 | 家长 | 方案/任务草稿保存与恢复 | plan.parent.draft | /api/health/plan/save、/api/orchestration/flow/save | HealthPlanController、OrchestrationController |
| SC-T-01 | 成长规划师 | 规划师登录 + 切回家长 | auth.guide.login | /api/guide/register、/api/guide/application/submit(+ token 切换) | GuideManagementController |
| SC-T-04 | 成长规划师 | 方案审核列表 + 批准 | plan.guide.reviewList | /api/guide/families/{familyId}/plans/pending、/{planId}/approve | GuidePlanReviewController |
| SC-T-05 | 成长规划师 | 激活方案拆任务(幂等)⭐ | plan.guide.activateTask | /api/guide/plans/activate、/api/guide/plans/detail | PlanReviewController |
| SC-T-07 | 成长规划师 | 录入测评结果触发方案 ⭐ | dan.assessment.recordComplete | /api/dan-assessment/record/create、/api/dan-assessment/record/complete | DanAssessmentController |
| SC-T-09 | 成长规划师 | 测评预约确认(状态守卫) | dan.assessment.appointmentConfirm | /api/dan-assessment/appointment/confirm | DanAssessmentController |
| SC-T-10 | 成长规划师 | 测评预约完成/未到 | dan.assessment.appointmentComplete | /api/dan-assessment/appointment/complete | DanAssessmentController |
| SC-T-13 | 成长规划师 | 规划师视角数据隔离 | guide.family.dataIsolation | /api/data-permission/*、/api/guide/families/my-families | DataPermissionController、GuideFamilyQueryController |
| SC-T-14 | 成长规划师 | 方案编辑(规划师侧) | plan.guide.edit | /api/guide/families/{familyId}/plans/{planId}/update | GuidePlanReviewController |
| SC-T-15 | 成长规划师 | 套餐任务项管理 | plan.guide.taskItemManage | /api/guide/training-plans/items/、/api/packages/ | TrainingPlanController、TaskTemplatePackageController |
| SC-T-22 | 成长规划师 | 方案归档 | plan.guide.archive | /api/orchestration/flow/archive | OrchestrationController |
| SC-T-25 | 成长规划师 | 舌诊/情绪测评录入(规划师) | dan.assessment.tongueEmotionInput | /api/guide/assessment/family/{familyId}、/api/mind/emotion/* | GuideAssessmentController、MindController |
| SC-T-26 | 成长规划师 | 精准营养方案制定 | plan.guide.nutritionPlan | /api/nutrition/profile、/api/nutritionist/* | UserNutritionProfileController、NutritionistController |
| SC-T-27 | 成长规划师 | 家庭天盘解读(规划师) | plan.guide.tianpanReading | /api/tianpan/* | TianpanController |
| SC-T-28 | 成长规划师 | AI 方案内容安全复核 | plan.guide.contentSafeReview | /api/content/*、/api/guide/plans/review | ContentFilterController、PlanReviewController |
| SC-T-30 | 成长规划师 | 测评录入触发五维维度变化 | dan.assessment.triggerFiveDim | /api/dan-assessment/record/complete + 五维引擎 | DanAssessmentController + dimension 线 |
| SC-C-08 | 孩子 | 方案打卡进度 | task.child.checkinProgress | /api/daily/checkin/list、/api/health/plan/tasks | DailyCheckinController、HealthPlanController |
| SC-C-19 | 孩子 | 查看家人/规划师消息通知 | notification.child.list | /api/notification/list、/api/notification/read | UserNotificationController |
| SC-C-25 | 孩子 | 方案任务打卡触发五维增长 | task.child.checkinTriggerFiveDim | /api/daily/checkin/create + 五维引擎 | DailyCheckinController + dimension 线 |
| SC-B-09 | AI成长教练 | 教练转接成长规划师 | coach.handoff.planner | LangGraph 转接 graph、/api/guide/parent-invite/generate | cfc-langgraph、GuideController |
| SC-B-12 | AI成长教练 | 同步规划师建议主动跟进 | coach.followup.syncPlanner | LangGraph 跟进 graph、/api/guide/messages/send | cfc-langgraph、TeacherMessageController |
| SC-H-02 | 真人管家 | 一对一家长陪跑 | butler.parent.accompany | 无既有 Controller(人工服务流程,需新建服务记录/工单契约) | butler 域(待建) |
| SC-X-01 | 跨角色 | 测评全链路 ⭐ | dan.assessment.closedLoop | 下单→支付→额度→预约→录入→结果 全链路 | 全链路 |
| SC-X-06 | 跨角色 | 方案激活执行闭环 | plan.closedLoop.activateExecute | 方案确认→激活→拆任务→执行 全链路 | 全链路 |
| SC-X-09 | 跨角色 | AI 方案送审闭环 | plan.closedLoop.reviewRoundTrip | 生成→送审→规划师批/驳→重生成 全链路 | 全链路 |
测评(12)
dan.assessment.orderCreatedan.assessment.orderPaydan.assessment.quotaAcquiredan.assessment.appointmentCreatedan.assessment.appointmentViewdan.assessment.appointmentCanceldan.assessment.appointmentConfirmdan.assessment.appointmentCompletedan.assessment.recordCompletedan.assessment.tongueEmotionInputdan.assessment.triggerFiveDimdan.assessment.closedLoop方案(21)
plan.parent.generateplan.parent.regenerateSectionplan.parent.editplan.parent.viewplan.parent.confirmplan.parent.publishplan.parent.activateTasksplan.parent.taskListplan.parent.historyplan.parent.draftplan.guide.reviewListplan.guide.activateTaskplan.guide.editplan.guide.taskItemManageplan.guide.archiveplan.guide.nutritionPlanplan.guide.tianpanReadingplan.guide.contentSafeReviewplan.closedLoop.activateExecuteplan.closedLoop.reviewRoundTrip规划师绑定 / 会员(5)
guide.parent.selectPlannerguide.parent.unbindguide.family.dataIsolationmembership.parent.purchaseauth.guide.login孩子执行 / 通知(3)
task.child.checkinProgresstask.child.checkinTriggerFiveDimnotification.child.listAI 教练 / 真人管家(3)
coach.handoff.plannercoach.followup.syncPlannerbutler.parent.accompanyDanAssessmentController(预约 create/confirm/complete/cancel/user、record/create+complete、points-config、family/enable)+ PackagePurchaseController(order/create)+ PaymentController(wechat/create、order/status)。重点写清「额度扣减」与「预约状态机」(待确认→已确认→已完成/未到/已取消)。HealthPlanController(generate/regenerate-section/save/confirm/list/detail/tasks/pending-review/*)+ OrchestrationController(flow/save|publish|archive、execution/start)。重点写清「家长确认 vs 规划师审核」双通道与幂等激活。GuidePlanReviewController、PlanReviewController(activate)、TrainingPlanController(items/*)、GuideFamilyTaskController(unbind)、GuideFamilyQueryController(my-families)、DataPermissionController。重点写清规划师数据隔离边界。DailyCheckinController(list/create)、UserNotificationController、LangGraph 转接/跟进 graph、butler 服务记录(新建契约)。origin/cfclub → 逐组记录 sha(一组一 sha,便于分级 --design)。--add-task <key> --requirement "SC-xxx:<场景标题>(tests/user-scenarios/应用场景总览.md)" --design <契约 sha>。
--design 必须标注「契约已在 origin/cfclub;实现若在 feature 分支须显式说明、不得假定包路径」。nutrition 线、天盘走 tianpan 线,二者均非「方案」域原生能力,契约需在各自 Controller 补齐后由 plan 侧聚合,建议拆分独立任务、不并入 plan.guide 单键。