测评 / 组织测评 / API 平台验收总览
这页把 1–6 周里最关键的 3 条 API 验收线放到一起:个人测评真实写库、开放平台 reserve 联调、Org-OS reserve API。先从这页进,不容易混。
当前执行边界
个人测评继续优先核真实写库;开放平台继续按 reserve 主链联调;组织测评当前先核 Org-OS reserve API,等正式 Aggregation Engine 再切到真实聚合写库。
如果要先回总图
如果已经开始看 API 验收细项,先回最终联调总地图和 Coach v2.3 总映射,再决定当前是在收 Assessment、Diagnosis、开放平台还是 Coach,会更稳。
个人测评真实写库
真实校验 · /app/assess → /app/assess/report
真实回流优先
先核真实提交、真实回读、工作台承接这 3 个点,不把前台能打开误判成已经写库完成。
1确认真实完成一次测评提交,页面提示已经变成“已写入工作台”。
2确认 `assessment_sessions` 最近一条 version / created_at 已刷新。
3确认 `mindset_profiles` 已能回读到公开摘要与 readinessScore。
开放平台 reserve 联调
reserve 联调 · /api/open/questions → /api/open/submit → /api/open/report/[reportId]
reserve 结构优先
先按 questions → submit → report 三步走通,再核 headers、错误返回和 report 结构,不要反过来查。
1确认 questions 已按版本返回题量、题干、选项与常见错误示例。
2确认 submit 已返回 `scores + report_id`,并能顺着继续读 report。
3确认 report 已带推荐版本、公开 follow-up 与 PDF 入口说明。
组织测评 Org-OS reserve API
reserve 联调 · /api/org-os?mode=* / POST /api/org-os
reserve 结构优先
当前先核 reserve API 的结构、Lead_ID、risk state 与 handoff 参数,不和正式聚合写库混着验。
1确认 `mode=checkup / invite / dashboard / report / consult / flow` 等 GET 模式都能回出 reserve 结构。
2确认 `POST /api/org-os` 的 `quick_check_submit` 已返回 `leadId / state / answered / source`。
3确认 Org-OS 到 AI 教练的 reserve / suggestions / sessions / real 入口参数都能顺着接。