Jyotisha/docs/tasks/PROGRESS-mobile-chart-confirmed-edit-20260929.md

# PROGRESS · 手机星盘 / 确认时间可改 / 天空定格 / 去掉报告封面（2026-09-29）

任务书：`docs/tasks/TASK-mobile-chart-and-confirmed-edit-20260929.md`（M1–M4 在 `53c0b9ea`，M5 在 `47eda7e1` 追加）。产品授权直接执行（Claude 子代理）。

- 基线：`origin/staging` = `53c0b9ea`（开工时；其后 `47eda7e1` 只加了任务书 M5 段，纯文档，分支未 rebase）
- 分支 / 工作树：`codex/mobile-chart-confirmed-edit-20260929` / `.worktrees/mobile-chart-confirmed-edit-20260929`，**未推送**
- 环境：Node v22.14.0（`/exec-daemon/node`）；系统 `python3`；无 Docker；无头 Chrome 151（`--disable-dev-shm-usage`，CDP 设备模拟）
- BUG 编号：开工时最大 BUG-1082；本单 M1 = BUG-1083；M2 是 BUG-264 下的产品修订段，不另开号

## 结论

| 项 | 结果 | 提交 |
| --- | --- | --- |
| M1 手机星盘完整显示（BUG-1083） | 完成 | 1 |
| M2 已确认时间，改声明字段后重置 | 完成（数据库侧未跑 `test:db`，见环境缺口） | 2 |
| M4 「那一刻的天空」重放 → 定格 → 右上角分享 | 完成 | 3 |
| M5 去掉报告星图封面 | 完成 | 4 |
| M3 文档 | 完成（DESIGN、VOICE、CHANGELOG、BUG_HISTORY、BLOCKED、真机清单） | 1–4 各自带 |

## M1 · 根因与修复（BUG-1083）

复现方法：真实组件（`ChartPageView` / `ChartVedicTab` / `AppSidebar` / `SidebarInset`）+ golden 夹具（`chart-view-golden.json`、`chart-view-bhava-golden.json`）SSR 成静态页，套上**本次构建产物**里 `/chart` 引用的全部 CSS，无头 Chrome 用 CDP `Emulation.setDeviceMetricsOverride` 模拟 390×844（新版无头窗口最小 500 宽，`--window-size` 不够用），从盘面 SVG 往上逐层量 `getBoundingClientRect().width`。

修复前（基线 CSS，本命与 Bhava 相同）：

| 层 | 宽度 |
| --- | ---: |
| `svg.personal-report-chart-svg` | 1043 |
| `.chart-page-vedic-stage` / `-vedic-layout` / `.chart-page-vedic` / `.chart-page-panel` | 1069 |
| **`.chart-page-body`（第一个超宽祖先）** | **1101** |
| `.secondary-page` | 390 |
| `.secondary-panel` / `main.chat-app` | 390 |

- 根因：`.secondary-page` 是 `display: grid` 且没有 `grid-template-columns`，隐式列是 `auto`；子项 `.chart-page-body` 保持默认 `min-width: auto`，这一列就按正文最小内容宽度定宽（不折行的 23 个盘型 chip、34rem 行星表）。内层表格与盘型条自己的 `min-width: 0` + 横滚都在，撑宽发生在它们外面。面板 `overflow-x: hidden` 把溢出直接裁掉，所以看起来是「盘很大、右边没了」。
- 修复：`.secondary-page { grid-template-columns: minmax(0, 1fr); }`。修在四个次级页共用的这一层。
- 修复后（本次构建 CSS）：390×844 下本命 / D9 / Bhava / 月亮 / D10 都是 `documentElement.scrollWidth` = 390、没有超宽祖先、盘面 332px。大运 / 基础信息 / 西洋盘三个 Tab 修复前就不溢出（让步 1：未另改）。
- 桌面：1280×900 下修复前其实也被裁（`.chart-page-vedic-layout` 1069px 塞在约 1024px 的内容区，参数卡右边被切、「≡」看不到）；修复后两栏布局不变，盘面 549 → 480px，参数卡与「≡」完整可见。
- 回归测试：`frontend/tests/chart-page-mobile-width-20260929.test.ts`（2 条）。

截图（`/tmp/claude-1000/-workspace-Jyotisha/fb88e01e-1ced-4bcc-92fe-44c5bdcc878e/scratchpad/mobilechart/`）：

- 修复前：`before-D1-390.png`、`before-BHAVA-390.png`、`before-D1-1280.png`
- 修复后（本次构建 CSS）：`after-D1-390.png`、`after-D9-390.png`、`after-BHAVA-390.png`、`after-MOON-390.png`、`after-D10-390.png`、`after-D1-1280.png`
- 桌面前后对比：`cmp-1280.png`

## M2 · 结论

- 改法：`resolveAccountBirthTimeApplicationPatch` 去掉「confirmed 直接 `{}`」。confirmed（含状态为空、有遗留分钟的 legacy 行）**只有声明字段真的变了**才重置，之后与未确认完全同一套派生：零误差家人时间 → `accepted` + 新分钟；否则 `reported`、`active_birth_time = null`；`rectification_case_id = null`。只改称呼、岁差、性别、头像 → `{}`。
- 跨午夜三列（硬红线 3）：
  - 写入方：采用 / 确认候选的 RPC（`20260920020000_adopted_birth_date.sql` 起的 dated-v1 路径）；读取方：`server-owned-birth-profile.ts`（`active_birth_timezone_offset` 覆盖声明时区）、`chart-birth-truth.ts`（`adoption = "adopted"`、指纹）。
  - 数据库触发器 `zz_guard_adopted_birth_date`（BEFORE INSERT/UPDATE）在任一声明字段（日期、时间、来源、时段、范围、误差、经纬度、时区）变化或状态不在 accepted/confirmed 时把三列置空；前端镜像是 `applyAdoptedBirthDateGuard`。
  - 本次仍在派生补丁里**显式**写三列为 null（仅当当前行有值），不只依赖触发器。
- 遗留列 `birth_time`：`chart-birth-truth.ts` 与 `server-owned-birth-profile.ts` 在 `active_birth_time` 为空时会回落读 `birth_time`。confirmed / legacy 重置成「只有时段」时，若不清它，星盘仍会按旧分钟排。所以当前行 `birth_time` 非空时一并写 null。
- 触发器会不会改回 confirmed：不会。
  - `guard_birth_time_journey` 最新版（`20260804020000`）只在「状态为空且有 active 分钟」时补 `confirmed`，本修订总写明确状态。
  - `agentic_rectification_profiles_rebaseline_guard` 与 `invalidate_agentic_rectification_results_on_profile_change`（最新版 `20260827010000`）在声明变化时把进行中的校正 Case 标成 `needs_rebaseline`、把结果标 `invalidated_at`，这是期望行为。
  - 没有改触发器、没有加迁移。
- 并发守卫：派生补丁非空时，路由照旧用 `applyAccountProfileConcurrencyGuards` 按当前行做条件更新，confirmed 行现在也会走到这条，能挡住与一次并发采用的竞争。
- 客户端：`/people` 保存本人走 `saveSelfProfile` → `applyPersistedBirthTime`，用路由返回的 `status` / `activeTime`（取自写回的行）；新增单测证明「确认 07:52 → 改 08:05」后本地是 `accepted` / `08:05`，改成时段后是 `reported` / 空分钟。缓存失效沿用 BUG-1081 那一套。
- **偏离（请 Claude 定）**：声明比较由 `!==` 改成按值比较（`sameDeclarationValue`：库里 `HH:MM:SS` 与表单 `HH:MM`、数字与数字字符串、空串与 null 视为相同）。原因：`/people` 每次保存都整表重提全部出生字段，库里的 `time` 列回来是 `HH:MM:SS`，原来的 `!==` 会把「只改称呼」判成新声明，于是本单改完后会把已确认分钟清掉。副作用：未确认状态（例如 `accepted`）下「只改称呼」以前也会被误判并退回 `reported`，现在不会了——这是修正，不是新行为。

## M4 · 完成情况

- 纯函数：`birthSkyRevealAt(elapsed, reduced, mode)`，新增 `mode = "hold"`：汇聚与文字与首页过场完全相同，文字淡入完（3.6 s；减少动态效果时 0.6 s）就 `held`，此后永远是定格帧、`layer = 1`、`done = false`。`birthSkyHoldAtMs(reduced)` 给出定格时刻。首页过场（`reveal`）时间轴不变。
- 组件：`BirthSkyConverge` 加 `mode` 与 `controls` 两个可选参数（默认 `reveal`、无控件，首页过场行为不变）。`hold` 模式：
  - 定格后停止 `requestAnimationFrame`；resize 会清空画布，所以定格后 resize 时重画一次；
  - 点画面（不在控件上）直接跳到定格帧，不关闭；
  - Esc 关闭；卸载时取消动画。
- 新组件 `components/birth-sky/birth-sky-replay.tsx`：左上 ×（读屏名「关闭」），右上「分享」（`saveBirthSkyImage(cover.blob)`：能分享文件就调系统分享，不能就下载；用户取消不提示；其他失败提示「没能分享，再试一次。」）。样式在 `birth-sky-converge.css`，44px，顶部让出安全区。入口 `birth-sky-entry.tsx` 懒加载它，每次打开都重放。
- 定格帧 = 海报：定格帧画布调用序列与导出 PNG 逐条相同（单测，三个 phase）；并且 `BirthSkyCover` 新增 `serif`（`render.ts` 新增 `paintBirthSkyPng` 同时返回 PNG 与宋体判定），重放用画 PNG 时同一个字体判定，避免「PNG 用黑体、屏幕用宋体」。
- 删除：静态海报弹层 `birth-sky-dialog.tsx` 与 `birth-sky.css`（不再有引用）。
- 无头 Chrome 实测（真实组件 esbuild 打包 + golden 夜盘 + 「中国 · 浙江省 · 杭州市 · 西湖区」标签），390×844 与 1280×900 都通过：
  - 1.5 s 在播放；
  - 5 s 已定格、不透明；
  - 8 s 仍打开；
  - 0.7 s 时点画面 → 跳到定格、仍打开；
  - Esc → 关闭。
  截图：`replay-390-playing.png`、`replay-390-held.png`、`replay-390-tapped.png`、`replay-1280-playing.png`、`replay-1280-held.png`、`replay-1280-tapped.png`、`replay-390-strip.png`（同一目录）。
- 「分享」按钮「PNG 未就绪时禁用」：没有实现禁用态。星盘页只在 PNG 画好后才渲染入口按钮，重放层打开时 PNG 一定已经在手，这一状态不存在（偏离，见下）。

## M5 · 完成情况

- 删除：`components/birth-sky/report-sky-cover.tsx` / `.css`、`lib/birth-sky/report-cover.ts`、`personal-report-page.tsx` 的动态导入与挂载点（连同只给它用的 `next/dynamic` import）、`classifyReportEnvelope` 的 `coverSubject` 解析、`ReportLoadState` / `ReportEnvelopeView` 上的字段。
- 服务端：`reportView` 的 `coverSubject` 参数、`readyReportCoverSubject`、`ReportReadCoreDeps.loadCurrentBirthFingerprint`、详情路由里的 `loadCurrentBirthFingerprint`（以及随之无用的 `subjectBirthFingerprint` / `loadSubjectBirth` import）全部删除；读报告不再多查一次人物资料。
- `lib/report-birth-binding.ts` 只保留 F1 写入用到的：`REPORT_BIRTH_FINGERPRINT_KEY`、`subjectBirthFingerprint`、`stampReportBirthFingerprint`、`readReportBirthFingerprint`、`withReportBirthFingerprint`；删掉 `reportDocumentBirthFingerprint`、`reportSubjectId`、`reportCoverSubject`。
- 保留：三条生成路径写 `subject.birthFingerprint`、TS / JSON Schema / Python 三处 schema 可选字段及其测试。
- `grep -rn "ReportSkyCover\|report-sky-cover\|coverSubject" frontend/src` = 0。
- `BLOCKED.md` T5 保持划掉，追加「→ 2026-09-29 产品决定去掉报告封面」。

## 验证

| 项 | 基线 `53c0b9ea` | 交付 |
| --- | --- | --- |
| `tsc --noEmit` | 0 错 | 0 错 |
| `npm run lint` | 0 error / 126 warning | 0 error / 126 warning |
| `npm test` | tests 4335 · pass 4280 · fail 24 · cancelled 0 · skipped 31 | tests 4335 · pass 4280 · fail 24 · cancelled 0 · skipped 31 |
| 失败清单 | 24 条（Docker / PostgreSQL / 部署） | 与基线逐条同名 |
| 测试名对比（同机同命令跑基线） | — | 消失 15、新增 15（下表逐条） |
| `run_quality_gate.py --profile quick --skip-yoga-logic --skip-frontend-runtime`（门禁同参数） | — | 997 passed / 1 skipped，`Quality gate passed.`，退出 0 |
| `commercial_privacy_artifact_scan.py --json` | — | `status: pass`，`finding_count: 0` |
| pytest `test_repo_privacy_markers` + `test_birth_sky` + `test_api_server_growth_contract` + `test_personal_report_contract` | — | 126 passed |
| `rm -rf .next && next build` | `/` ○ Static | `/` ○ Static |
| `page.tsx` / `jyotish_api_server.py` | — | 未改 |

### 首屏 gzip（`index.html` 引用的全部 `/_next/static/*.js|css` 逐个 gzip -9 求和；同一工作树先在基线代码上全量构建一次，再在交付代码上全量构建）

| | 基线 | 交付 | 变化 |
| --- | ---: | ---: | ---: |
| JS | 651,520 B | 651,512 B | −8 B（−0.001%） |
| CSS | 66,031 B | 66,035 B | +4 B（+0.006%） |

### 消失的测试名（15 条，§7.3）

| 消失的测试名 | 去向 / 原因 |
| --- | --- |
| ordinary declaration edits clear stale candidate application but never overwrite confirmed active time | 改名为 “…and a new declaration drops a confirmed minute too”；产品 2026-09-29 推翻 BUG-264 约定（M2） |
| confirmed ordinary edits keep the active minute and clear a complete adopted tuple together | 改名为 “confirmed declaration edits drop the minute and clear a complete adopted tuple together”；同上（M2） |
| chart page dialog shows only the picture: no title bar, no panel; icon × and 「保存图片」 | 由 “chart page replay stays on the poster: × top left, 「分享」 top right…” 取代；静态弹层删除（M4） |
| the chart page dialog no longer has a reveal variant (「继续」, is-reveal) | 由 “the chart page replay has no 「继续」 and the poster dialog is gone” 取代；读的两个文件已删除（M4） |
| GET /api/reports/:id compares on the server through the chart page's subject loader | 由 “GET /api/reports/:id no longer looks up the subject for a cover (M5)” 取代；产品决定去掉报告封面（M5） |
| coverSubject: only a matching fingerprint yields the subject id, self when chart_profile_id is null | 删除：比对函数 `reportCoverSubject` 已删（M5） |
| core read: coverSubject is the subject id when the stored fingerprint matches the current one | 删除；由 “core read: the detail response has no coverSubject, and never the fingerprint or birth fields” 取代（M5） |
| core read: coverSubject is null when the birth data changed since the report | 同上（M5） |
| core read: coverSubject is null for a legacy report without the field, and nothing is looked up | 同上（M5） |
| core read: coverSubject is null for a subject that is not the reader's (foreign, deleted, unreadable) | 同上（M5） |
| matching fingerprint → the ready state carries coverSubject; mismatch or legacy → no cover | 删除：`report-sky-cover.test.ts` 整个文件随组件删除（M5） |
| the cover sits above the body, lazy, and only when coverSubject is set | 同上（M5） |
| loader paints night for the screen and paper for print with the same sky | 同上（M5） |
| fetch failure, an empty sky or an abort → no cover, and nothing throws into the report | 同上（M5） |
| print: paper picture alone on the first A4 page; the screen picture is hidden | 同上（M5） |

新增 15 条：M1 2 条（`chart-page-mobile-width-20260929.test.ts`）；M2 4 条（两条改名 + “confirmed minute follows a new declaration and survives everything else” + “saving a new time over a confirmed minute takes the server's new status and minute”）；M4 7 条（`birth-sky-replay-20260929.test.ts` 5 条 + 两条替代）；M5 2 条（替代）。总数 4335 不变。

## 改动的既有断言（原值 / 新值 / 原因）

| 测试（文件） | 原值 | 新值 | 原因 |
| --- | --- | --- | --- |
| `account-api.test.ts` 第一条 confirmed + 新声明（两处） | `{}` | `{ active_birth_time: null, birth_time_status: "reported", rectification_case_id: null, birth_time: null }` | M2：新声明丢掉已确认分钟；夹具 `birth_time` 有值，所以一并清 |
| `account-api.test.ts` confirmed / legacy + 新零误差家人时间 | `{}` | `accepted` + `05:40`（legacy 另加 `birth_time: null`） | M2 |
| `account-api.test.ts` “PATCH answers…” confirmed / legacy + 改 `district_code` | `confirmed` / `05:18` | `accepted` / `05:00`（夹具声明是零误差家人时间 05:00）；另加两条「只改称呼 / 岁差 → 仍 confirmed 05:18」 | M2：改地点属于新声明 |
| `account-api.test.ts` confirmed + 只改岁差 | `{}` | 不变 | —— |
| `chart-profile-update-consistency.test.ts` 跨午夜 confirmed + 新声明 | `{}`，排盘仍 confirmed 23:55（legacy） | 回到 `reported` 并显式清三列，排盘按新声明 00:20（declared） | M2 |
| `profile-onboarding-birth-sky-reveal.test.ts` overlay | `layer.addEventListener("pointerdown", finish)` | `onPointerDown = mode === "hold" ? skip : finish`，默认 `mode = "reveal"` | M4：定格模式点一下只跳到定格帧 |
| `chart-page-view.test.tsx` 入口懒加载 | `import("./birth-sky-dialog")` | `import("./birth-sky-replay")` | M4 |
| `chart-page-view.test.tsx` 封面夹具 | 无 `serif` | `serif: false` | `BirthSkyCover` 新增字段（夹具形状，断言未变） |
| `report-birth-binding.test.ts` longform cover | 另用 `reportDocumentBirthFingerprint` 读回 | 只看 `subject.birthFingerprint` | M5：读回函数已删；F1 写入断言保留 |

改动的断言都在测试文件里就地写了三栏注释。

## 偏离任务书（请 Claude 定）

1. **M2 声明比较改成按值比较**（见 M2 节）。不改的话，本单会让「只改称呼」清掉已确认分钟，违反决策记录第 1 条。
2. **M2 同时清遗留 `birth_time`**（任务书只写了三列）。原因：图表在 `active_birth_time` 为空时会回落读它。
3. **M4 「分享」没有做禁用态**：PNG 在入口按钮出现前已就绪，这个状态不存在。
4. **M4 失败文案改为「没能分享，再试一次。」**，原「没能保存。长按或右键上面的图，也能存下来。」停用，因为画面是画布，不能长按存图。已收进 VOICE。
5. **M1 修在 `.secondary-page`**（四个次级页共用），而不是只给 `.chart-page-body` 补 `min-width: 0`。桌面宽度下被裁的问题也随之消失。
6. 首页过场结束后的提示「这片天空在星盘页可以保存。」未改；星盘页现在的按钮字是「分享」，保存要经分享面板或下载，句意仍成立。请 Claude 判断是否改句。
7. 分支基于 `53c0b9ea`，未 rebase 到只加了文档的 `47eda7e1`（按协调要求）；`docs/tasks/README.md` 索引行的状态未改，留给 Claude 交付时处理，避免冲突。

## 环境缺口

- **无 Docker**：
  - 24 条 DB / 部署套件失败，与基线逐条同名；
  - 没跑 `npm run test:db`，所以 M2 在真实 PostgreSQL 上的效果（触发器链、条件更新）只做了静态核对。staging 实测见真机清单第 5–7 条。
- **无登录态与真机**：M1 只在无头 Chrome 设备模拟上验证；M4 的系统分享面板、M5 的打印 PDF 没有实测。见 `docs/testing/mobile-chart-confirmed-edit-20260929.md`（18 条）。
- **无模型凭据**：本单不涉及模型输出。
- 未推送、未部署。

## Claude 验收（2026-09-29）

分支已 rebase 到 `origin/staging` `56722063`（另一会话同期写入 BUG-1084～1089，`BUG_HISTORY.md` 冲突按编号顺序合并，BUG-1083 在前）。独立重跑：`tsc` 0 错；lint 0 error / 126 warning；`npm test` 4335 · pass 4280 · fail 24 · cancelled 0，失败清单与上一单逐条同名；门禁同参数 quick 门禁 997 passed、`Quality gate passed.`；隐私制品扫描 pass；`rm -rf .next && next build` `/` ○ Static；首屏 gzip 651,512 / 66,035（基线 651,520 / 66,031，−8 B / +4 B）；`src/` 下 grep `ReportSkyCover|report-sky-cover|coverSubject` = 0。

看过截图：`before-BHAVA-390` 复现产品真机现象；`after-{BHAVA,D1}-390` 盘面完整、表格在框内；`replay-390-held` 定格帧有 × 与「分享」。

M2 复核：最新 `guard_birth_time_journey`（`20260804020000`）已不在 `birth_time` 与 `active_birth_time` 间互相同步，因此同时清 `birth_time` 不会连带清掉新写入的 `active_birth_time`。偏离 1–7 接受；偏离 6（首页提示句「这片天空在星盘页可以保存。」）保留，待产品定。