# 报告闭环批次 · 开工包(23 SC) > 归属:契约补建计划 P0「报告闭环」· 生成 2026-11-06 22:11 ## 批次定位 家长高频入口(报告上传/解析/趋势),且已有 health.report.* 契约链(upload/createReport YELLOW),本批补全剩余 + 跨角色闭环。 ## SC 明细 | SC | 角色 | 场景标题 | 建议能力键 | 契约接口范围 | 依赖 Controller | |---|---|---|---|---|---| | SC-A-02 | 平台运营 | 报告解析中台(类型/聚类) | admin.reportParse.typeList | /api/admin/report-parser/*、/api/admin/report-parse/* | ReportParserAdminController/ReportParseAdminController | | SC-A-16 | 平台运营 | 报告解析自学习/未知类型标注 | admin.reportParse.selfLearn | /api/admin/report-parser/fingerprints/* | ReportParserAdminController | | SC-B-04 | AI成长教练 | 成长报告智能解读 | coach.growthReport.interpret | LangGraph 报告解读 graph | cfc-langgraph | | SC-B-11 | AI成长教练 | 报告细节追问 | coach.growthReport.ask | LangGraph 追问 graph | cfc-langgraph | | SC-C-06 | 孩子 | 查看能量与报告(只读) | health.report.view | /api/health/report/* | HealthReportController | | SC-C-07 | 孩子 | 查看 DAN 测评报告 | dan.assessment.viewReport | /api/assessment/* 详情 | AssessmentController | | SC-P-24 | 家长 | 多报告管理/对比 | health.report.compare | /api/health/report/compare | HealthReportController | | SC-P-25 | 家长 | 报告趋势查看 | health.report.trend | /api/health/report/trend | HealthReportController | | SC-P-26 | 家长 | 基于报告饮食推荐 | health.report.dietRecommend | /api/health/report/diet | HealthReportController+饮食推荐 | | SC-P-39 | 家长 | 查看测评结果(DAN 报告) | dan.assessment.viewResult | /api/assessment/result/* | AssessmentController | | SC-P-67 | 家长 | 报告代传(家长替孩子/他人代传) | health.report.proxyUpload | /api/health/report/proxy-upload | HealthReportController | | SC-P-82 | 家长 | 全局搜索(报告/方案/任务/商品) | misc.globalSearch | /api/search/global | SearchController | | SC-P-84 | 家长 | 分享报告/方案给家人或规划师 | health.report.share | /api/health/report/share | HealthReportController | | SC-P-91 | 家长 | 健康报告入库刷新五维评分 | health.report.refreshFiveDim | /api/health/report/refresh-dim | HealthReportController+五维引擎 | | SC-S-09 | 商品服务商 | 报告解析服务接入(对接解析中台) | provider.reportParse.connect | /api/provider/report-parse/connect | ProviderController | | SC-T-03 | 成长规划师 | 代传报告 + 确认入库(上传报告) | health.report.proxyUpload | /api/health/report/proxy-upload | HealthReportController | | SC-T-11 | 成长规划师 | DAN 报告上传与解析 | dan.assessment.uploadReport | /api/assessment/upload | AssessmentController | | SC-T-12 | 成长规划师 | DAN 八类报告查看 | dan.assessment.viewReport | /api/assessment/report/* | AssessmentController | | SC-T-21 | 成长规划师 | 报告对比分析 | health.report.compare | /api/health/report/compare | HealthReportController | | SC-T-23 | 成长规划师 | 报告代传(规划师代客户传) | health.report.proxyUpload | /api/health/report/proxy-upload | HealthReportController | | SC-X-02 | 跨角色 | 报告闭环 | health.report.closedLoop | 报告上传→解析→入库→查看全链路 | 全链路 | | SC-X-10 | 跨角色 | 报告对比趋势闭环 | health.report.trendClosedLoop | 多报告对比→趋势→重算 | 全链路 | | SC-X-13 | 跨角色 | 报告代传跨角色闭环 | health.report.proxyClosedLoop | 家长/规划师代传→归属校验 | 全链路 | ## 建议能力键去重 - `admin.reportParse.selfLearn` - `admin.reportParse.typeList` - `coach.growthReport.ask` - `coach.growthReport.interpret` - `dan.assessment.uploadReport` - `dan.assessment.viewReport` - `dan.assessment.viewResult` - `health.report.closedLoop` - `health.report.compare` - `health.report.dietRecommend` - `health.report.proxyClosedLoop` - `health.report.proxyUpload` - `health.report.refreshFiveDim` - `health.report.share` - `health.report.trend` - `health.report.trendClosedLoop` - `health.report.view` - `misc.globalSearch` - `provider.reportParse.connect` ## 开工步骤 1. 定契约:核对上述接口路径/请求响应契约(API_REFERENCE.md,缺则补接口文档)。 2. 契约合入 origin/cfclub → 记录 sha。 3. 映射能力键:--add-task --requirement --design 。 4. 巡检派发 → 实现/测试 → 三类流证据 → 台账标已跑通。 ## 前置/风险 - SC-B-04/B-11 依赖 LangGraph 报告解读 graph(本地 9000 服务),契约在 cfc-langgraph。 - SC-X-02/10/13 是跨角色全链路,需多角色协作,放本批最后。 - SC-P-91 依赖五维引擎(dimension/energy 线),与本批解耦,可并行。