测评 / 组织测评 / 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 入口参数都能顺着接。