OpenMind

真实数据联调收口清单

这页专门用来区分 reserve 演示链路和真实 Supabase 写库链路，避免后续联调时口径打架。

当前我们的主产品链路已经能跑，但还存在两种模式： reserve / demo 和 real data。接下来真正要验收试点时，就要逐步把主产品部分切到真实 Supabase。

推荐顺序：先从第 1 周验收总览确认自己是在看结构验收还是看真实联调，再回工作台看承接；如果某条链还没接住，就从这里进入专项校验。

先看上线前最终核对清单看最终联调总地图先回工作台看承接先回第 1 周验收总览返回 Admin 查看开放平台联调页校验测评真实写库查看 C2 入职机会验收台跑 C2 执行清单跑 C2 角色自检看 C2 样本补齐记 C2 实跑结果校验教练真实写库校验内容执行真实写库校验机会判断真实写库校验资产页真实回流

最后一轮建议顺序

如果现在已经进入上线前收口，先按这 3 步走，再回下面的真实联调细项，不容易漏。

先收个人测评真实写库

先确认测评提交、报告回读、工作台承接都已经进入真实回流，再往下走。

看个人测评报告 / API 验收

再收 Org-OS reserve API

确认组织测评当前的 reserve API、Lead_ID 和 handoff 参数已经稳定，不和个人主链抢节奏。

看 Org-OS reserve API

最后收开放平台三步联调

等前两条线稳住后，再核 questions → submit → report 的对外交付，不并行乱验。

看开放平台三步联调顺序

回到总地图再看一遍

如果这页已经看到细项有点散，先回总地图和 Coach v2.3 总映射，会更容易判断当前这轮真实联调到底在收哪条链。

看最终联调总地图看 OpenMind Coach v2.3 总映射

5 条主链实时状态

这块直接汇总测评、教练、内容执行、机会判断、资产 5 条链当前还在演示承接、已经开始部分回流，还是已经进入真实回流。

演示承接

测评主链

测评主链还没点亮真实写库

当前还没有读到已保存的测评会话或心智档案，说明这条链路大概率还停留在演示态或本地预览。

待回流 · assessment_sessions 有最新记录待回流 · mindset_profiles 已生成档案

再看专项校验

演示承接

AI 教练

AI 教练还没有登录态可写库

当前没有认证用户，教练接口会自动回退 reserve，不会读写真实 `coach_sessions`。

待回流 · `/api/coach/chat` 能创建真实会话待回流 · `/api/coach/sessions` 能读到真实会话

再看专项校验

演示承接

内容执行主链

内容执行还没有登录态可写库

当前没有认证用户，内容执行可以继续演示，但不会稳定写入 `content_assets / sales_assets / user_activities / analytics_events`。

待回流 · `content_assets` 已保存第一篇真实内容待回流 · 转销售素材后已沉淀到 `sales_assets`

再看专项校验

演示承接

机会判断主链

机会判断还没有登录态可写库

当前没有认证用户，机会判断可以继续演示，但不会稳定写入 `sales_*` 相关真实表。

待回流 · `sales_leads` 已写入第一条真实线索待回流 · `sales_judgments` 已生成第一份真实判断

再看专项校验

演示承接

资产承接

资产页还没有登录态可回读

当前没有认证用户，资产页可以继续演示，但不会稳定回读真实内容资产、销售资产和转换记录。

待回流 · `content_assets` 已有真实内容资产待回流 · `sales_assets` 已有真实销售资产

再看专项校验

最傻瓜 3 步

如果你下一步要真的接 Supabase，就先照这 3 步做，不用一开始看完整文档。

先复制 `.env.example`

在 `next-mvp/` 目录里复制一份 `.env.local`，后面所有真实联调都从这一步开始。

cp next-mvp/.env.example next-mvp/.env.local

再填 4 个关键值

把 `NEXT_PUBLIC_SUPABASE_URL`、`NEXT_PUBLIC_SUPABASE_ANON_KEY`、`SUPABASE_SERVICE_ROLE_KEY`、`NEXT_PUBLIC_APP_URL` 填进去。前 3 个去 Supabase 项目设置里找，最后一个本地先填 `http://localhost:3000`。

打开 next-mvp/.env.local 逐项粘贴

最后重启本地项目

保存 `.env.local` 后，停掉当前 `npm run dev`，再重新启动一次，让新环境变量生效。

PATH="/Users/eva/Desktop/web/.local/node-v20.18.0-darwin-x64/bin:$PATH" npm run dev

环境变量

先把下面这些配齐，不然页面只能停留在演示态或 reserve 态。

NEXT_PUBLIC_SUPABASE_URL

Supabase 后台 → Project Settings → API → Project URL

NEXT_PUBLIC_SUPABASE_ANON_KEY

Supabase 后台 → Project Settings → API → Project API keys → anon / public

SUPABASE_SERVICE_ROLE_KEY

Supabase 后台 → Project Settings → API → Project API keys → service_role

NEXT_PUBLIC_APP_URL

本地先直接填 `http://localhost:3000`

Migration 顺序

这两份 migration 建议按顺序执行，不要跳。

1next-mvp/supabase/migrations/20260328_000001_init_mvp.sql
2next-mvp/supabase/migrations/20260328_000002_assessment_api_platform_reserve.sql
3next-mvp/supabase/migrations/20260329_000003_prediction_analytics.sql

最小真实联调顺序

建议每次只按这一条主链验证，避免同时查太多模块把问题搅在一起。

1注册 / 登录是否正常
2完成一次测评并检查 `assessment_sessions / mindset_profiles`
3保存一篇内容并检查 `content_assets`
4展开或点击一条预测推荐并检查 `analytics_events`
5转一条销售素材并检查 `sales_assets`
6录入线索并检查 `sales_leads`
7生成判断并检查 `sales_judgments / sales_actions`
8打开 `/app` 与 `/app/assets` 看真实统计是否回流

照着做就行

如果你后面真的要接真实 Supabase，就按下面这 10 条一条条做，不需要自己再拼顺序。

1在 Supabase 后台找到 `Project URL / anon public key / service_role key`

2复制 `next-mvp/.env.example` 成 `next-mvp/.env.local`

3把 4 个关键环境变量填进 `.env.local`

4停掉当前本地 dev 服务

5重新执行 `npm run dev` 让环境变量生效

6按顺序在 Supabase SQL Editor 执行 3 份 migration

7打开 `/admin/real-data` 确认顶部不再提示缺环境变量

8完成一次注册 / 登录 / 测评

9再看 `/admin/assessment-real` 是否开始出现 `已回流`

10最后再跑内容执行、机会判断、资产页的真实回流检查

Reserve 与真实写库的边界

后面联调时，遇到问题先判断自己走的是哪条链。

开放平台 `/api/open/*`

当前 reserve：当前主要是 reserve 结构化联调，支持 demo key、日志、Webhook、限流模拟。

目标真实：后续再接真实 `api_keys / api_logs / webhooks` 表与外发。

主产品 `/app/*`

当前 reserve：未配 Supabase 时会自动回退到演示承接，方便本地展示。

目标真实：配好 `.env.local` 并执行 migration 后，主链会逐步走真实写库。

测评 / 内容执行 / 机会判断

当前 reserve：页面可演示，部分数据可先本地生成或回退。

目标真实：目标是联通 `assessment_sessions / content_assets / sales_*` 真表。