当前还没进入真实联调

这页现在先帮我们区分哪些链路仍在演示承接、哪些已经开始部分回流。等 Supabase 环境变量配好后,再按这里的顺序去跑真实写库。

当前缺少:

NEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_SUPABASE_ANON_KEY

真实数据联调收口清单

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

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

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

最后一轮建议顺序

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

1

先收个人测评真实写库

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

看个人测评报告 / API 验收
2

再收 Org-OS reserve API

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

看 Org-OS reserve API
3

最后收开放平台三步联调

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

看开放平台三步联调顺序

回到总地图再看一遍

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

5 条主链实时状态

这块直接汇总测评、教练、文帮、销帮、资产 5 条链当前还在演示承接、已经开始部分回流,还是已经进入真实回流。

演示承接

测评主链

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

当前还没配置 Supabase 环境变量,所以测评会先停留在本地预览 / 演示承接,不会去读写真实测评表。

待回流 · assessment_sessions 有最新记录待回流 · mindset_profiles 已生成档案
再看专项校验
演示承接

AI 教练

AI 教练会话链还停留在 reserve

当前还没有 Supabase 环境,因此 `/api/coach/*` 只会返回 reserve 结果,不会稳定写入 `coach_sessions`。

待回流 · `/api/coach/chat` 能创建真实会话待回流 · `/api/coach/sessions` 能读到真实会话
再看专项校验
演示承接

文帮主链

文帮主链还停留在演示承接

当前还没有 Supabase 环境,因此文帮的保存、转销售素材和预测推荐埋点都还无法开始真实回流。

待回流 · `content_assets` 已保存第一篇真实内容待回流 · 转销售素材后已沉淀到 `sales_assets`
再看专项校验
演示承接

销帮主链

销帮主链还停留在演示承接

当前还没有 Supabase 环境,因此销帮的线索、判断、推进动作和销售资产都无法稳定写入真实表。

待回流 · `sales_leads` 已写入第一条真实线索待回流 · `sales_judgments` 已生成第一份真实判断
再看专项校验
演示承接

资产承接

资产承接链还停留在演示承接

当前还没有 Supabase 环境,因此资产页看到的内容、销售素材和转换记录都无法稳定回读真实数据。

待回流 · `content_assets` 已有真实内容资产待回流 · `sales_assets` 已有真实销售资产
再看专项校验

最傻瓜 3 步

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

1

先复制 `.env.example`

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

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

再填 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 逐项粘贴
3

最后重启本地项目

保存 `.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 建议按顺序执行,不要跳。

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

最小真实联调顺序

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

  1. 1注册 / 登录是否正常
  2. 2完成一次测评并检查 `assessment_sessions / mindset_profiles`
  3. 3保存一篇内容并检查 `content_assets`
  4. 4展开或点击一条预测推荐并检查 `analytics_events`
  5. 5转一条销售素材并检查 `sales_assets`
  6. 6录入线索并检查 `sales_leads`
  7. 7生成判断并检查 `sales_judgments / sales_actions`
  8. 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_*` 真表。