merge onboarding (一) first-consult-free + relation into staging (issue #95)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LutgzyJqNhPpZy1nFsJtN3

docs/BUG_HISTORY.md

@@ -19253,3 +19253,19 @@
 - 相关记录：无
 - 复发自：无
 - 修复版本：本提交
+
+## BUG-1421 | 新账户第一次提问就被兑换窗拦住
+
+- 状态：resolved
+- 首次发现：2026-10-22
+- 最近更新：2026-10-23
+- 影响面：已登录、点数为 0、没有会员的新账户。第一次正式提问发不出去，直接打开兑换窗。
+- 用户现象：建完档之后，还没问成任何问题，输入框就已经按「没有点数」处理，发送时弹出兑换。
+- 触发条件：账户点数默认是 0，发送前只看「点数用完且没有会员」。
+- 根因：没有「每个账户一次、由服务端记账」的首问。前端和预扣都把 0 点当成必须先付费。
+- 修复：服务端在同一笔预扣里判断这一次是否还免费。标准档这一问不扣点；选了更贵的模型只扣高出标准档的差价。回答完成才算用掉。停止、失败或寒暄都把这一次还回来。账户接口只多给一个 `firstConsultFree`。前端在它为真时不拦这一问。老账户里已经有过一次完成的正式咨询，迁移时记为已用过。
+- 验证：`frontend/tests/database-onboarding-journey.test.ts`（0 点首问、并发只有一条免费、取消和寒暄后仍可用、高档只扣差价、已有正式咨询的老账户不再免费）。`frontend/tests/onboarding-journey-data.test.ts`。
+- 防复发：数据库测试里，没有公布标准档价格时仍按传入的点数预扣，避免把所有咨询都变成免费；并发两条时只有一条成功且余额仍是 0。
+- 相关记录：任务书 `TASK-onboarding-journey-20261022.md` T1。issue #95。T3、T4 的现象不在本条。
+- 复发自：无
+- 修复版本：分支 `codex/onboarding-1-data-20261022`。

docs/tasks/PROGRESS-onboarding-1-data-20261022.md

@@ -0,0 +1,52 @@
+# PROGRESS · 新用户启程（一）数据层（2026-10-22）
+
+Issue #95。只做 T1 首问免费和 T2 引导状态、人物关系。T3–T7 不做。
+
+## 基线
+
+- 开工时 `origin/staging` = `dfa9acaf05089dbb94ee8afe34c1d5626ffb1b23`（任务书写的 `c1aa72fcb` 已过期）。
+- BUG-1420 已被「Bug 历史去重」占用。本轮首问免费记 **BUG-1421**。
+
+## 做了什么
+
+- 迁移 `20261022190000_onboarding_first_consult_and_relation.sql`：账户上记下首问是否用过、当前占用的请求、引导状态；别人的档案增加关系。只加列和约束，不删废列。
+- 预扣在同一笔事务里占用免费额度。回答完成才记为已用。取消或寒暄把占用还回去，不记成已用。
+- 账户接口增加 `firstConsultFree`。前端发送前和输入框占位，在它为真时不再当「没有点数」。
+- 已登录接口读写引导状态。只接受清单关闭时间、看过的提示、进过星盘页。提示 id 只收任务书 T6 那八个。未登录 401。写入用当前登录的人，不读请求体里的用户 id。
+- 档案的添加和编辑（档案页和星盘页编辑别人）加「TA 是你的」。本人不出现这项。空关系显示「其他」。
+
+## 红线 3 怎么选
+
+选了 **只扣差价**。免费覆盖的是已经公布的 `chat.standard` / `standard` 价格。传入的价格更高时，只扣多出来的部分。这样标准档仍是 0 点，更贵的模型也不会整问白送。
+
+没有公布中的标准档价格时，**不免费**，仍按传入的点数扣。现有计费测试没有这条价格，因此不会被误改成免费。
+
+会员已经包住这一问时，不占用免费额度，留给还没有会员的那一次。合盘报告会话不占用这份额度。
+
+0 点流水不能写进点数流水（现有约束不允许金额为 0）。记在用量台账上，后台「资金来源」显示「首问免费」；差价大于 0 时显示「首问免费（差价 N 点）」。筛选里原来对不上的 complimentary 换成「首问免费」。
+
+## 老账户
+
+只把「已经有过一条完成的、且不是寒暄的咨询」标成用过。只有寒暄的账户仍然有这一次。迁移结束时跑一遍，测试可以再跑同一函数。
+
+## 本人与关系
+
+本人档案行已经被现有约束拒绝写入（`chart_subject_self_mirror_retired`）。关系只存在别人的行上。本人界面仍只标「本人」。
+
+## 自测
+
+| 检查 | 命令 | 结果 |
+| --- | --- | --- |
+| 类型 | `frontend\node_modules\.bin\tsc --noEmit -p frontend` | 通过，0 错 |
+| lint | `frontend` 下 `npm run lint` | 0 error（原有 warning 未动） |
+| 定向测试 | `node node_modules/tsx/dist/cli.mjs --test` 跑了本轮改到的测试文件 | 通过 |
+| 数据库 | `frontend` 下 `npm run test:db` | 91 项，通过 77，失败 14，取消 0。其中 13 条失败与 `tools/agent-loop/windows-known-failures.txt` 同名。多出的一条是校正遥测，见下方 |
+
+未跑前端全量 `npm test` 和 Python 快速门（本轮不改 Python）。
+
+全套里多出的失败是「rectification telemetry: server-only write, dedupe, retention, aggregate-only admin read, account cascade」。迁移进程退出码 1，报错只有 database migration failed，用时约 10 秒，容器日志没有 SQL 错误。同一轮里本单自己的数据库测试通过。这条遥测单独再跑：通过 1，失败 0。没有把它写进已知失败清单。
+
+## 偏离
+
+- 任务书 BUG 起点 1420 已占用，顺延为 1421。
+- 没有单独造一套会员夹具去测「会员不占免费额度」；规则写在预扣函数里：来源是会员时不写入占用。

docs/tasks/README.md

@@ -40,7 +40,7 @@
 | `TASK-rectification-explicit-open-20261023.md` | — | **明说要校正只回一句话（issue #103）**：找会话直接读一张对服务角色撤权的表、必然失败被吞（真正进行中的也续不上）；`candidate_accepted` 被算作进行中挡住入口和提议卡；兜底只给一句话。产品选 C；只改入口口径、经 RPC 找会话、删兜底，不改共享状态集合、不动表 | 待执行（循环） | 分支 `codex/rectification-explicit-open-20261023` |
 | `TASK-chart-table-span-20261023.md` | — | **星盘页本命 / 月亮行星表挤进左栏（issue #102）**：#87 给表包了 `ChartSymbolHelp` 后跨栏规则失配；根因修法是 `VedicLayout` 用固定整行容器承载表格，跨栏只认容器；加结构断言防复发 | 待执行（循环） | 分支 `codex/chart-table-span-20261023` |
 | `TASK-ui-kit-migration-20261023.md` | — | **界面统一换成组件库**：shadcn base-nova（补 `shadcn/tailwind.css`）· Lucide · Motion · react-resizable-panels · dnd-kit · Zustand；lint 拦手写控件（白名单只减不增）；对话旁星盘面板；会话、档案拖动排序（动表）；长相不变。产品 2026-10-23 拍板 D1～D8；8 个 issue（K0～K7）串行，取代全站动效 #98 #100 #101 | 待领取（循环） | 原型 https://claude.ai/artifact/PGnWsjHhu38KJseEfEMNWG |
-| `TASK-onboarding-journey-20261022.md` | — | **新用户启程**：建档加「先看谁的盘」（自己 / 帮别人看，本人资料可后补）、人物关系字段、首问免费（服务端原子）、起步三问、启程清单（七项从数据推导，收费项标价，老用户可见）、八条一次性提示（含星盘四页签）、启程流程专用动效。产品 2026-10-22 拍板 D1～D6；动表经产品同意进循环，拆四个 issue 串行。BUG-1420 起 | 待领取（循环） | 原型 https://claude.ai/artifact/PcTwMVb9RD611R3qStxv3U |
+| `TASK-onboarding-journey-20261022.md` | `PROGRESS-onboarding-1-data-20261022.md` | **新用户启程**：建档加「先看谁的盘」（自己 / 帮别人看，本人资料可后补）、人物关系字段、首问免费（服务端原子）、起步三问、启程清单（七项从数据推导，收费项标价，老用户可见）、八条一次性提示（含星盘四页签）、启程流程专用动效。产品 2026-10-22 拍板 D1～D6；动表经产品同意进循环，拆四个 issue 串行。BUG-1420 已被文档去重占用，本轮首问免费记 BUG-1421。（一）T1+T2 在 `codex/onboarding-1-data-20261022` | （一）已合入 staging；（二）（三）（四）待领取 | 原型 https://claude.ai/artifact/PcTwMVb9RD611R3qStxv3U |
 | `TASK-site-motion-20261022.md` | — | **全站动效**：换页按侧栏方向滑入、选中块跟随、页签、盘型切换星体移宫、换人、翻日期、列表补位、弹窗从触发处长出、抽屉、顶部提示、点数滚动、中英交叉淡入；重写 DESIGN §6（推翻 180 ms 上限与 Spatial Instant），不引动画库，先验证 View Transitions。产品 2026-10-22 拍板；三个 issue，排在启程（三）之后、启程（四）之前；**2026-10-23 被 ui-kit-migration 取代** | 已取代 | 原型 https://claude.ai/artifact/7u9goivnmTNSGTNWNeVMQd |
 | `TASK-rectification-narrower-delivery-20261016.md` | `PROGRESS-rectification-narrower-delivery-fix-20261017.md` | **交付区间收窄**：显示改按活着的簇分段。第 1 次打回只补两处显示漏段（取整差 8 分、缺区间整段退回）。对半出题和门槛 8 改 6 仍不做。基线与对照各 924 条，12 格包含率都过红线。BUG-1367 起，本轮原记 BUG-1370，因与婚恋合盘保留号冲突改为 BUG-1392 | 待验收 | `codex/rectification-narrower-delivery-20261016` |
 | —（子代理直接执行，无任务书） | `PROGRESS-bug-1060-d9-double-transit-20260927.md` | **双重过运 D9 目标错配（BUG-1060）**：D9 第 N 宫目标误用 D9 上升、D9 宫主目标误用 D1 度数，改为标签所写的 D9 星座；D1 / CL 层逐字节不变；数据卡 golden 重采集（一张盘跨层结论 9→10）；另记 BUG-1061 跨层数字比对（未修） | 已验收（待部署） | `codex/bug-1060-d9-double-transit-20260927`（未推送） |

docs/testing/onboarding-journey-20261022.md

@@ -0,0 +1,25 @@
+# 新用户启程 · 真机清单（2026-10-22）
+
+后面的 issue 往这份清单末尾追加。本页先只覆盖数据层（issue #95，T1 首问免费、T2 关系与引导状态）。起步三问、启程清单、一次性提示和动效还没做，不要在这一轮里验收它们。
+
+用新注册的邮箱。不要把真实出生资料写进记录。
+
+## 首问免费
+
+1. 新账户点数是 0。建完档之后，第一次正式提问能发出去，点数仍是 0，不弹兑换窗。
+2. 这一问回答完成之后，再问一次：弹出原来的兑换窗，文案不变。
+3. 另开一个新账户。第一问发出去之后立刻停止。再问一次仍然不扣点。
+4. 另开一个新账户。第一问如果只被当成寒暄，问完之后正式提问仍然不扣点。
+5. 后台用量里，这次免费提问的资金来源显示「首问免费」。若当时选了更贵的模型，显示「首问免费（差价 N 点）」，账户只少这 N 点。
+
+## 人物关系
+
+1. 星盘档案里添加一个人，选「孩子」，保存。刷新之后，列表和详情的名字后面仍是「孩子」。
+2. 找一份关系还是空的旧档案，打开编辑，补上「父母」，保存后再打开仍是「父母」。没改过的空档案，名字后面显示「其他」。
+3. 本人这一行仍只显示「本人」，编辑本人时没有「TA 是你的」。
+
+## 以后追加
+
+- （二）先看谁的盘、起步三问
+- （三）启程清单、一次性提示
+- （四）动效，以及打开「减少动态效果」再走一遍