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

# TASK · 手机上星盘显示不全 + 已确认出生时间改资料后跟着变 + 「那一刻的天空」改为动画定格（2026-09-29）

## 基线与依赖

- 基线：`origin/staging` = `da989c15`（本人编辑 + 头像菜单已部署）。开工前 `git fetch origin --prune`，基线 SHA 写进 PROGRESS。
- 分支 / 工作树：`codex/mobile-chart-confirmed-edit-20260929` / `.worktrees/mobile-chart-confirmed-edit-20260929`。
- 进度：`docs/tasks/PROGRESS-mobile-chart-confirmed-edit-20260929.md`。
- 不改 `page.tsx`。同日若有别的单改 `globals.css` 里 `.chart-page-*` 或 `lib/account-profile-patch.ts`，先停下告知 Claude。
- BUG 编号：开工时核对 `docs/BUG_HISTORY.md` 最大号（写作时 BUG-1082）。本单 M1 记 **BUG-1083**；M2 是产品决策，改的是 BUG-264 以来锁住的行为，在 BUG-264 下追加「2026-09-29 产品修订」，不另开号。

## 事实

### M1 · 手机上星盘显示不全（产品 2026-09-29 真机截图，iPhone，staging，星盘 → Bhava）

- 北印度盘远大于屏幕，右侧与下方被裁掉。星盘卡片左边框可见，右边框在屏幕外。下面的参数表与行星表看不到。
- 按截图倒推，盘面所在列约 **540px 宽**，屏幕约 390px。这与 `.chart-page-planet-table { min-width: 34rem; }`（`globals.css`，34rem = 544px）吻合。推测：宽表的最小内容宽度一路向上撑开了某层网格或弹性容器的列宽，盘面 `width:100%` 跟着变大。
- 已排除：`.chart-page-varga-table-block`、`.chart-page-planet-table-wrap`、`.chart-page-vedic` 都已有 `min-width: 0`。**哪一层没收住还没找到**，候选有：
  - `.chart-page-vedic-layout`（窄屏下只有 `display:grid`，没有 `grid-template-columns`，隐式列是 `auto`，本身也没有 `min-width:0`）；
  - `.chart-page-params`；
  - 更外层的星盘页面板与 `SecondaryPageShell`。
- 本命、D9、Bhava 各页的盘下都有宽表，所以很可能不止 Bhava 一页。9-28 的盘型改造（BUG-1076～1078）把行星表从 26rem 放宽到 34rem，这可能是诱因。

### M2 · 已确认的出生时间，改资料后排盘不变

- `lib/account-profile-patch.ts` `resolveAccountBirthTimeApplicationPatch`：当前 `birth_time_status === "confirmed"`（或 legacy 有分钟、状态为空）时直接 `return {}`。于是改了出生日期 / 时间 / 地点，`active_birth_time` 仍是旧的已确认分钟，星盘按旧时间排。
- 锁定这条行为的是 `frontend/tests/account-api.test.ts` 的测试 “ordinary declaration edits clear stale candidate application but never overwrite confirmed active time”，来自 BUG-264。
- 现在本人可以在 `/people` 编辑资料（BUG-1081），这个行为第一次对用户可见。

## 决策记录（产品 2026-09-29）

1. **M2：用户改了出生资料，就按新资料排盘，即使原来是「确认」状态**（包括采用过校正结果）。产品原话：「用户改生日肯定是得到信息了」。
   - **这推翻了 BUG-264 起「已确认分钟不被普通资料修改覆盖」的约定**，以及 `account-api.test.ts` 上面那条测试的对应断言。执行方不得以既有约定为由拒改。
   - 只有**声明字段**（`declarationFields`：出生日期、时间与来源、时段 / 范围、地点代码等）真的变了才重置；只改称呼、岁差、性别、头像，**不得**动已确认时间。
   - 重置后与非确认状态的现有做法完全一致：给了精确的零误差时间就是 `accepted` + 新分钟，否则是 `reported`；`rectification_case_id` 清空。
2. M1 是缺陷，按「手机上完整看到盘、表格在自己的框里横向滚动」修，不改桌面布局。
3. **M4：星盘页点「那一刻的天空」，改为重放群星汇聚动画并定格在最后一帧，右上角「分享」才导出海报**。产品原话：「点击那一刻的天空，然后重新跑咱们的星星动画，最后定格到最后一帧，然后右上角可以分享，分享的时候才是咱们的海报」。
   - 这替换了 polish 单 P1 的「压暗页面 + 静态图 + 图下保存图片」弹层。
   - 首次建盘过场（首页）不变：仍然放完自动淡出。
4. **M5：去掉报告里的星图封面**（产品 2026-09-29：「报告首页的那个星图封面需要去掉」）。这推翻了 `TASK-birth-sky-followup-20260928` 的 F2 / F3（屏幕与打印封面、`coverSubject` 下发）。F1（生成时写入 `subject.birthFingerprint`）保留：不花钱、旧文档兼容，将来想绑定报告与资料时还能用。

## 硬红线

1. M1 只改 CSS / 结构，不改盘面绘制与数据；桌面 ≥1024px 的两栏布局不变。表格仍然是在自己的容器里横向滚动，不许为了不溢出把列挤坏或删列。
2. M2 只改服务端派生（`account-profile-patch.ts` 与账户路由），客户端不得自己写 `active_*` 或 `birth_time_status`。
3. M2 必须一并清掉跨午夜采用写入的 `active_birth_date`、`active_birth_timezone_offset`、`active_birth_provenance`（若当前行有值），不能留下「新日期 + 旧的已采用日期」的半截状态。先查清这三列由谁写入、谁读取，写进 PROGRESS。
4. 查清 `profiles` 上当前生效的触发器（`guard_birth_time_journey` 等最新版本）会不会把重置改回 `confirmed`，结论写进 PROGRESS。本机没有 Docker 跑不了 `npm run test:db`，这一项写成环境缺口，并在真机清单里列一条 staging 实测。
5. 改既有断言写「原值 / 新值 / 原因」三栏。**前端改动也要跑 Python quick 门禁**（上一单因为没跑，Python 合同测试在门禁 run 1584 上红了）。
6. 不加依赖，不改表、不加迁移（若确认必须改触发器才能生效，先停下告知 Claude，不要自行加迁移）。

## 任务分解

### M1 · 手机上星盘完整显示（BUG-1083）

- **先复现**：在无头 Chrome 里用真实组件和虚构数据（golden 夹具）搭星盘页，视口 390×844。本命、D9、Bhava、行运、D10 各截一张，量出每一层容器的实际宽度，找出第一个宽度超过视口的祖先，并写进 BUG-1083 的根因。
- **修**：在找到的那一层收住宽度（例如补 `min-width: 0`，或窄屏下给网格 `grid-template-columns: minmax(0, 1fr)`）。同类布局 `.chart-page-dasha-columns`、`.chart-page-western-layout`、`.chart-page-basics-grid` 一并检查，同样有问题就一起修。
- **验收**：
  - 修复前后各截 390×844 的五张图，外加 1280×900 一张，确认桌面不变；截图放 scratchpad，路径写 PROGRESS。
  - 390 宽时页面没有横向滚动，盘面宽度 ≤ 视口，表格在自己的框里能横向滑动。
  - 加一条回归测试，锁住修复的那条 CSS 规则（按源码文本断言即可，写明对应 BUG-1083）。
  - 如果能在无头 Chrome 里断言 `document.documentElement.scrollWidth <= innerWidth`，就加上。

### M2 · 已确认时间，改声明字段后重置

- 改 `resolveAccountBirthTimeApplicationPatch`：去掉「confirmed 直接返回 {}」。改为：声明字段有变化时，confirmed 也走与 reported 相同的派生；没有变化时维持原样（包括 legacy 分钟）。
- 按硬红线 3，把跨午夜三列也纳入重置。
- 账户路由里依赖「confirmed 不变」的并发守卫（`applyAccountProfileConcurrencyGuards`）要核对仍然正确。
- 客户端：`/people` 保存本人后，已有的缓存失效逻辑要能让星盘页拿到新的排盘时间。用单测证明保存后读取到的是新分钟。
- **验收（测试）**：
  - confirmed + 改出生时间（精确） → `accepted` + 新分钟，`rectification_case_id` 为 null；
  - confirmed + 改成时段 → `reported`，`active_birth_time` 为 null；
  - confirmed + 只改称呼 / 岁差 / 性别 → 不变；
  - confirmed + 跨午夜三列有值 + 改日期 → 三列清空；
  - legacy（状态空、有分钟）+ 改时间 → 重置；不改则不变。
  - `account-api.test.ts` 那条旧测试改名并改断言，三栏说明。
- BUG-264 下追加「2026-09-29 产品修订」一段：写明原约定、新决定、影响（改资料会让已采用的校正结果失效）。

### M4 · 「那一刻的天空」：重放动画 → 定格 → 右上角分享

- 星盘页点「那一刻的天空」后，打开全屏层：
  - 复用首页过场的同一套时间轴与绘制（`lib/birth-sky/converge.ts` `birthSkyRevealAt` + `drawBirthSky`，组件 `components/birth-sky/birth-sky-converge.tsx`），加一个「定格」模式：汇聚 → 文字淡入 → **停在最后一帧**，不淡出，不自动关闭。每次打开都从头重放。
  - 定格帧就是导出海报（沿用「最后一帧与导出封面逐调用一致」的测试）。
  - 播放中点一下，直接跳到定格帧，不关闭。
  - 系统开了「减少动态效果」：不汇聚，直接淡入到定格帧。
- 按钮（定格前后都在，深色底上可读，44px 触控）：
  - 左上角 ×：关闭（Esc 也关闭）。
  - 右上角「分享」：导出海报 PNG，走现有 `saveBirthSkyImage`（能调系统分享就分享，不能就下载）；失败提示沿用现有文案。
  - 不再有图下方的「保存图片」按钮。
- 不等待：点按钮时若海报 PNG 还没画好，仍然先开始放动画；PNG 在后台画，「分享」按钮在 PNG 就绪前禁用，不加 spinner。星盘页已有的预取（`use-birth-sky-cover`）照用，入口按钮仍然只在数据就绪后出现。
- 删掉 polish 单的静态图弹层（`birth-sky-dialog.tsx` 里只给它用的结构与样式），确认没有别处引用。首页过场的淡出行为不变。
- **验收**：
  - 测试：定格模式时间轴在终点停住，不淡出、不调用 onDone；点击跳到终点不关闭；reduced-motion 直接到终点；× 与 Esc 关闭；「分享」调用 `saveBirthSkyImage`，PNG 未就绪时禁用；首页过场仍会淡出并关闭（原测试保留）。
  - 无头 Chrome：390×844 与 1280×900 各截「播放中」与「定格」两张，放 scratchpad，路径写 PROGRESS。
  - DESIGN §17 与 VOICE（「分享」按钮文案）同步。

### M5 · 去掉报告星图封面

- 删除：`components/birth-sky/report-sky-cover.tsx` 与 `report-sky-cover.css`、`lib/birth-sky/report-cover.ts`、`personal-report-page.tsx` 里的动态导入与挂载点、`classifyReportEnvelope` 里的 `coverSubject` 解析与 `ReportLoadState` / `ReportEnvelopeView` 上的字段。
- 服务端：`reportView` 的 `coverSubject` 参数、`readyReportCoverSubject`、报告详情路由的 `loadCurrentBirthFingerprint` 一并删掉。没人用了，每次读报告就不必多查一次人物资料。`lib/report-birth-binding.ts` 只保留 F1 写入用到的函数，只给比对用的删掉。
- 保留：F1 的写入路径、`subject.birthFingerprint` 的 schema 可选字段及其测试。
- 测试：`report-sky-cover.test.ts` 删除；`report-birth-binding.test.ts`、`personal-report-api.test.ts` 里只测封面比对与 `coverSubject` 的用例删除或改成「详情响应不再有 `coverSubject`」。按 §7.3 把消失的测试名逐条列进 PROGRESS，并写原因（产品决定去掉封面）。
- `BLOCKED.md` 里 T5 那条保持划掉，追加一句「→ 2026-09-29 产品决定去掉报告封面」。
- **验收**：报告页没有封面，打印第一页是正文；报告详情响应不含 `coverSubject`；grep `ReportSkyCover` / `report-sky-cover` / `coverSubject` 在 `src/` 下为 0。

### M3 · 文档

- `frontend/DESIGN.md`：星盘页窄屏布局一句。
- `CHANGELOG.md`：两条。
- `docs/BUG_HISTORY.md`：BUG-1083；BUG-264 的修订段。
- `docs/testing/mobile-chart-confirmed-edit-20260929.md`（新建真机清单）：
  - iPhone 上星盘页的本命、D9、Bhava、行运、D10 都能看到完整的盘，表格能左右滑；
  - 用采用过校正结果的账号，在星盘档案里把出生时间改掉：星盘页按新时间排，报告封面对旧报告不再显示；
  - 只改称呼：排盘时间不变；
  - 打开任意一份报告：顶部没有星图封面；打印 PDF 第一页就是正文；
  - 星盘页点「那一刻的天空」：每次都重放汇聚，定格；右上角「分享」在手机上弹出系统分享、在电脑上下载；× 关闭。

## 验证

- `tsc --noEmit` 0 错；`npm run lint` 0 error。
- `npm test` 全量：与基线比测试名清单，不得有测试名消失；失败清单与基线（24 条 Docker / DB / 部署）逐条同名。
- **`python3 scripts/run_quality_gate.py --profile quick --skip-yoga-logic --skip-frontend-runtime`（与门禁同参数）必须通过**；`python3 scripts/commercial_privacy_artifact_scan.py --json` 为 pass。
- `rm -rf .next && next build`：`/` 仍 `○ Static`；首屏 gzip 与基线同口径对比，变化在 ±2% 内。

## 让步顺序

1. 同类布局（大运 / 西洋盘 / 基础信息）没有复现问题的，可以不改。
2. M1 的无头 Chrome `scrollWidth` 断言可以只留截图证据。
3. M4 在 1280 宽下的截图可以只留定格一张。
4. M1 手机上完整显示、M2 确认状态下改资料会重置、硬红线 3 的跨午夜三列、M4 定格帧 = 海报、M5 去掉报告封面，**不可让步**。

## 交付

- M1、M2、M4、M5+M3 分提交，**不推送**；由 Claude 独立验收后快进推 staging。