report-closedloop-kickoff-20261106.md 4.8 KB

报告闭环批次 · 开工包(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. 巡检派发 → 实现/测试 → 三类流证据 → 台账标已跑通。
  5. 前置/风险

    • SC-B-04/B-11 依赖 LangGraph 报告解读 graph(本地 9000 服务),契约在 cfc-langgraph。
    • SC-X-02/10/13 是跨角色全链路,需多角色协作,放本批最后。
    • SC-P-91 依赖五维引擎(dimension/energy 线),与本批解耦,可并行。