| content |
{"Commits":[{"Sha1":"9f1ea88bc {"Commits":[{"Sha1":"9f1ea88bcf8f55b6a1d25f0c5e5d0e282fd09a56","Message":"fix(dev): 本地启动链补齐 G8 验签所需 env——launch.json 与 README 都停在验签之前\n\n## 症状\n`preview_start` 起 web 后页面能开、功能全死：每个 API 请求 500 AUTH_NOT_CONFIGURED。\n（同时出现的 corepack `Invalid package.json` 是另一回事——那三次重试恰好撞在\n上一个 cherry-pick 的冲突窗口里，`package.json` 当时带着冲突标记，确实不是合法 JSON。\n冲突收干净后自动消失，不是配置问题。）\n\n## 根因\n`.claude/launch.json` 与 README 的「快速开始」都写于 G8 落地之前。\nG8 之后两个后端每请求都要 verifyAccessToken，缺 AUTH_JWT_SECRET 即 fail-closed 500\n——刻意不回 401：密钥没配是服务端故障，回 401 会把运维问题伪装成调用方的凭证问题。\n而 `.env.example` 双端其实都已补过密钥，漏的只有这两个**启动入口**。\n\n## 改动\n- launch.json 四个配置：后端补 AUTH_JWT_SECRET + LOCAL_IDENTITY_SWITCH_ENABLED\n- web 侧现签引导令牌：本地身份切换接口自己也要验签，没有引导令牌就是先有鸡还是\n 先有蛋。令牌用 contracts 的 signAccessToken 现签——**与后端同一份密钥、同一个\n 函数**，不另造第二条签发路径（那正是 P1 禁止的双真源形态）\n- 加 `test -n \"$NEXT_PUBLIC_AUTH_TOKEN\"`：签发失败当场退出，不让「令牌为空」\n 静默退化成满屏 401——那种失败看起来和「没登录」一模一样，最难判责\n- 顺手修 api-nestjs 的 `port` 字段：原为 3099，与实际监听的 3097 对不上\n- README 第 3 步补 AUTH_JWT_SECRET / NEXT_PUBLIC_AUTH_TOKEN 及其 fail-closed 语义；\n 命令表补 4 个已存在却从未登记的门禁（api-routes / approval-payload /\n workspace-hygiene / gate-selftest）\n\n## 证据（本地工作区，Fastify + PG:55432 + Redis:6382）\n- /api/health → `{\"status\":\"ok\",\"checks\":{\"database\":\"up\",\"redis\":\"up\"}}`\n- 无令牌 GET /api/quotations → 401；签名令牌 → 200 带真实数据；\n 令牌改一个字符 → 401（验签真的参与判定，不是摆设）\n- 浏览器 http://localhost:3098：demo-tenant 工作台渲染，KPI ¥2,733,893.60 / 5 份报价，\n 实时通道在线，本地身份切换 10 个角色可用，控制台零报错\n- `pnpm check` exit 0\n\nCo-Authored-By: Claude Fable 5 \u003cnoreply@anthropic.com\u003e\n","AuthorEmail":"luoguoguo@gmail.com","AuthorName":"luoguoguo","CommitterEmail":"luoguoguo@gmail.com","CommitterName":"luoguoguo","Timestamp":"2026-08-02T18:24:48-07:00"},{"Sha1":"44a51eebab6962f641bdf6d95eb2742d082d0a32","Message":"fix(gate): 捡回工作区卫生门禁（C28）——check:ui 的 tsconfig 残留会自愈\n\n`34635aa` 是 2026-07-31 落在一个 detached worktree 里、**从未合入也未被重新实现**的\n改进。经核查：三个脚本文件在 main 血脉里全都不存在，棘轮无 workspaceHygieneViolations，\n而它修的 bug 至今仍在（restoreWebTypeArtifacts 仍是快照式还原）。故 cherry-pick 捡回。\n\n## 解决的问题\ncheck:ui 为规避 manifest/EMFILE 假 404（C17）给 Next 用独立 distDir `.next-ui-\u003cpid\u003e`，\nNext dev 会把该路径写进**被跟踪的** apps/web/tsconfig.json。\n此前的备份/还原是**快照式**——把启动前就存在的残留原样写回，永不自愈；\n而残留恰恰来自还原逻辑捕获不到的退出路径（SIGKILL / 并发轮次互相复活死条目）。\n本仓有并发会话共用 checkout，这条路径不是假想。\n\n## 修法两层\n- runner 还原后**无条件剥离** `.next-ui-*`：干净工作区上是恒等变换，仍严格净零\n- 独立门禁 `check:workspace-hygiene` 作第二道防线，入棘轮\n 判据刻意收窄防假门禁：只查 include 不查 exclude（node_modules 天然 gitignore，\n 一并查会注册即红，重蹈 C1）；合法性只看首个路径段而非字面量白名单，\n 以免随 Next 版本增删而变成维护跑步机\n\n## 落地时的两处调整\n1. **编号 C25 → C28**：并行工作里已有另一个 C25（孤儿组件 `OrdersPanel`/`UsersPanel`），\n 撞车。按「编号只用于定位、不复用」的约定改为空号 C28。\n2. **只取代码不取报告**：原提交带的 baseline 与 20 份 report 快照已全部过期\n （gateSelftests 地板当时 2→3，现已是 6），直接取会把棘轮改坏。\n 报告全部还原为当前 HEAD，改由本轮重跑生成。\n\n## 门禁上线即抓到 5 处真实残留\n`.next-manual-10560` / `.next-ui-{49228,61102,94609}` / `.next-dev-3098`\n——比原提交记录的面更广：除 check:ui 外，手册截图 runner 与开发服务器同样会写入。\n已清理；runner 侧自愈只覆盖 `.next-ui-*`，其余 runner 若再产生仍由本门禁兜住。\n\n## 证据（本地工作区）\n`pnpm check` exit 0（含新门禁）；`check:gate-selftest` 7 组负向全绿；\n真实链路负向：注入 `.next-ui-99999` → exit 1，移除后 → exit 0。\n\nCo-Authored-By: Claude Fable 5 \u003cnoreply@anthropic.com\u003e\n","AuthorEmail":"luoguoguo@gmail.com","AuthorName":"luoguoguo","CommitterEmail":"luoguoguo@gmail.com","CommitterName":"luoguoguo","Timestamp":"2026-08-02T18:13:12-07:00"}],"HeadCommit":{"Sha1":"9f1ea88bcf8f55b6a1d25f0c5e5d0e282fd09a56","Message":"fix(dev): 本地启动链补齐 G8 验签所需 env——launch.json 与 README 都停在验签之前\n\n## 症状\n`preview_start` 起 web 后页面能开、功能全死：每个 API 请求 500 AUTH_NOT_CONFIGURED。\n（同时出现的 corepack `Invalid package.json` 是另一回事——那三次重试恰好撞在\n上一个 cherry-pick 的冲突窗口里，`package.json` 当时带着冲突标记，确实不是合法 JSON。\n冲突收干净后自动消失，不是配置问题。）\n\n## 根因\n`.claude/launch.json` 与 README 的「快速开始」都写于 G8 落地之前。\nG8 之后两个后端每请求都要 verifyAccessToken，缺 AUTH_JWT_SECRET 即 fail-closed 500\n——刻意不回 401：密钥没配是服务端故障，回 401 会把运维问题伪装成调用方的凭证问题。\n而 `.env.example` 双端其实都已补过密钥，漏的只有这两个**启动入口**。\n\n## 改动\n- launch.json 四个配置：后端补 AUTH_JWT_SECRET + LOCAL_IDENTITY_SWITCH_ENABLED\n- web 侧现签引导令牌：本地身份切换接口自己也要验签，没有引导令牌就是先有鸡还是\n 先有蛋。令牌用 contracts 的 signAccessToken 现签——**与后端同一份密钥、同一个\n 函数**，不另造第二条签发路径（那正是 P1 禁止的双真源形态）\n- 加 `test -n \"$NEXT_PUBLIC_AUTH_TOKEN\"`：签发失败当场退出，不让「令牌为空」\n 静默退化成满屏 401——那种失败看起来和「没登录」一模一样，最难判责\n- 顺手修 api-nestjs 的 `port` 字段：原为 3099，与实际监听的 3097 对不上\n- README 第 3 步补 AUTH_JWT_SECRET / NEXT_PUBLIC_AUTH_TOKEN 及其 fail-closed 语义；\n 命令表补 4 个已存在却从未登记的门禁（api-routes / approval-payload /\n workspace-hygiene / gate-selftest）\n\n## 证据（本地工作区，Fastify + PG:55432 + Redis:6382）\n- /api/health → `{\"status\":\"ok\",\"checks\":{\"database\":\"up\",\"redis\":\"up\"}}`\n- 无令牌 GET /api/quotations → 401；签名令牌 → 200 带真实数据；\n 令牌改一个字符 → 401（验签真的参与判定，不是摆设）\n- 浏览器 http://localhost:3098：demo-tenant 工作台渲染，KPI ¥2,733,893.60 / 5 份报价，\n 实时通道在线，本地身份切换 10 个角色可用，控制台零报错\n- `pnpm check` exit 0\n\nCo-Authored-By: Claude Fable 5 \u003cnoreply@anthropic.com\u003e\n","AuthorEmail":"luoguoguo@gmail.com","AuthorName":"luoguoguo","CommitterEmail":"luoguoguo@gmail.com","CommitterName":"luoguoguo","Timestamp":"2026-08-02T18:24:48-07:00"},"CompareURL":"luoanwu/juhai-quotation-system/compare/90cb8a4111b88f700b2dba5913e7a1e29c9666b6...9f1ea88bcf8f55b6a1d25f0c5e5d0e282fd09a56","Len":2}... |