Jyotisha/docs/tasks/PROGRESS-settings-dialog-and-billing-pane-20260906.md

# PROGRESS · 设置弹窗重排与账户与点数入弹窗（2026-09-06）

工作树：`.worktrees/settings-dialog-and-billing-pane-20260906`
分支：`codex/settings-dialog-and-billing-pane-20260906`
基线：任务书写 `origin/staging` @ `985c3258`；开工时 `origin/staging` 已到 `9ce7a374`（含 composer 与会话列表），以当时远端为准。

`page.tsx` 开工 **2035** 行，收尾 **1976** 行（净减 59，上限 1995）。未改迁移、未 bump Skill、未改支付 API。

| 任务 | 状态 | BUG |
| --- | --- | --- |
| 5.1 弹窗壳固定尺寸 + 四分区 | 完成 | BUG-554 |
| 5.2 个人资料搬出 `page.tsx` | 完成 | — |
| 5.4 账户与点数入弹窗，删除 `/membership` | 完成 | BUG-554 |
| 5.3 星盘资料列表→详情 | 完成 | BUG-554 |
| 5.5 BUG_HISTORY / CHANGELOG / DESIGN / VOICE | 完成 | — |

## 实现要点

- `.settings-modal`：桌面 `width: min(100vw - 32px, 880px); height: min(84dvh, 640px)`；四分区共用；退出仍是 400px `logout-modal`。
- `AccountDialog` 增加 `"billing"`。导航顺序：个人资料 → 星盘资料 → 账户与点数 → 通用设置。
- `profile-panel.tsx`：48px 头像一行；删除「管理星盘资料」。
- `chart-library-panel.tsx`：内部视图 `list | self | other | add`；列表条可点 + chevron；合盘操作只在其他人详情。
- `billing-panel.tsx` + `use-billing-panel.ts`：`next/dynamic` `{ ssr: false }`。页签含订单；兑换码行内表单。无 spinner / 「正在加载」。
- 删除 `frontend/src/app/membership/page.tsx` 与 `orders/page.tsx`。`next.config.ts` 临时重定向到 `/?settings=billing`。
- `settings-url.ts` 在 hydrate / popstate 解析后 `history.replaceState` 抹掉参数；`/` 不用 `useSearchParams`。
- 七处入口改为 `openAccountDialog("billing", { source, plan, tab })`。生时校正 402 不再 `window.location.assign`。

## 既有断言改动

| 文件 | 原值 | 新值 | 原因 |
| --- | --- | --- | --- |
| `account-dialog-overlay` | `openRedeem`；`profile-modal` / `chart-library-modal` | `renderBilling`；四导航；`.settings-modal` 同时有 width 与 height | 5.1 固定尺寸四分区 |
| `page.tsx` `renderProfile` | 约 50 行 JSX + 「管理星盘资料」 | `<ProfilePanel />`，头像 48px | 5.2 净减行；去掉重复入口 |
| `chart-library-panel` | 无条件 `<form`；`setEditingSelfChart(true)` | 列表默认；`setView({ kind: "add" })` 后才出表单 | 决策 4 |
| 本人详情标题 | 编辑本人资料 | 编辑本人星盘 | 详情视图文案 |
| 合盘 pending 文案 | `synastryPendingId === record.id` | `selectedOther.id` | 操作只在详情 |
| `membership-page` 26 条支付/兑换/订单 | 读 `app/membership/page.tsx` | 读 `billing-panel.tsx` + `use-billing-panel.ts` | 页面删除 |
| 会员页存在 / Suspense / loading | 页面必须存在 | 页面不存在；无 spinner | 决策 6、8 |
| 兑换码 | `redeemOpen` 子弹窗 | `value="redeem"` 页签 | 决策 5 |
| `goBack` / `history.back` | 整页返回 | 无；`stripSettingsQuery` | 账单在首页 |
| 订单 | 独立页 + 「正在加载订单…」 | 页签 idle/ready/unavailable，无加载句 | AGENTS §6 |
| 页签「点数充值」 | 点数充值 | 点数包 | VOICE |
| 主标题「套餐与会员」 | `<h1 className="membership-title">` | 弹窗标题「账户与点数」+ `billing-summary` | 不再是整页 |
| `.membership-page` / `.membership-shell` / `.membership-hero` | 整页壳 CSS | 删除；卡片/页签 CSS 保留 | 只删整页 chrome |
| `membershipHref` | `/membership?source=` | `/?settings=billing&source=` | 深链接 |
| `chat-navigation` 4 条软跳 | `router.push(membershipHref(...))` | `openAccountDialog("billing", { source })` | 决策 7 |
| 校正 402 | `window.location.assign(membershipHref("rectification"))` | `onOpenBilling({ source: "rectification" })` | 硬跳转清单缩小 1 |
| 会员 401 | membership 页 3 次 + 订单页 1 次 | billing hook 4 次 `assign("/login")` | 认证仍硬跳 |
| `test_api_server_security` `app_routes` | 含 `membership`、`membership/orders` | 去掉这两条 | BUG-143 路由集合 |
| 付费墙 | `<Link href={membershipHref("onboarding-paywall")}>` | `onOpenBilling` 按钮 | 关掉墙后打开 billing |
| `beam-avatar` | 头像编辑 JSX 在 `page.tsx` | 读 `profile-panel.tsx`；`page.tsx` 只挂 `ProfilePanel` | 5.2 搬出 |
| `knownUnstyled` | 允许 `membership-orders` / `membership-segment` | 从白名单删除 | 整页删除后不再渲染 |

`git grep -n "/membership" frontend/src` 还会命中 `@/lib/membership` 模块 import，不是路由。路由字符串只出现在 `next.config.ts` 重定向。

## 测试

| 命令 | 结果 |
| --- | --- |
| 任务书收尾 tsx 合同（overlay / chart-library / membership / billing / settings-url / profile-panel / chat-navigation / epay / redeem-orders / starter / settings-mvp / consultation / rectification-surface） | **168 pass / 0 fail** |
| `beam-avatar` + `class-name-definition-contract` + `profile-panel` | **10 pass / 0 fail** |
| `./node_modules/.bin/tsc --noEmit` | 0 错 |
| 改动文件 `eslint --quiet`；`npm run lint` | **0 error**（全仓 79 条既有 warning） |
| `page.tsx` | 1976 行（开工 2035，净减 59） |
| `/opt/anaconda3/bin/python3.12 -m pytest tests/test_api_server_security.py -k capability_audit` | 2 passed |
| `npm run build -- --webpack` | `/` 为 `○` Static；产物无 `/membership` 页面；`routes-manifest` 有两条 307 重定向。首页 `page-*.js` gzip **181103** 字节；账单文案在按需 chunk `773.*.js`（gzip **4994**），未打进首屏合同路径。 |
| 默认 `npm run build`（Turbopack） | 本工作树 `frontend/node_modules` 是指向主仓的 symlink，Turbopack 报 `points out of the filesystem root`。验收用 webpack 构建。 |
| `npm test` 全量 | 产品合同已绿。其余失败均走 `startPostgresFixture` / `docker compose up postgres`，本机 compose 起不来，与本单无关。 |

Next.js 16 typed routes 不允许 `route.ts` 额外 export。`dossierResponse` 去掉 `export`（仍只给同文件 GET 用），否则 `next build --webpack` 的生成类型检查失败。不是产品改动。

分支相对当前 `origin/staging` 落后 2 个提交（BUG-555/556）。未在脏树上合并，避免和本单的 `CHANGELOG` / `BUG_HISTORY` 撞车。

浏览器走查见 `docs/testing/settings-dialog-and-billing-pane-20260906.md`。本机未起登录会话，真实四分区切换留给 staging 验收。

## 验收（Claude，2026-09-06，对照 `TASK-settings-dialog-and-billing-pane-20260906.md`）

共用门禁见 `PROGRESS-session-list-title-and-order-20260906.md` 验收段（`e2f4b55c`：tsc 0 错、lint 0 error、2770 项测试 29 条环境失败、`next build` `/` Static、首屏 gzip +0.61%）。

| 项 | 结论 | 依据 |
| --- | --- | --- |
| 5.1 弹窗壳固定尺寸 + 四分区 | 通过 | `.settings-modal { width: min(100vw − 32px, 880px); height: min(84dvh, 640px) }`；`chart-library-modal` / `profile-modal` 已无；导航 个人资料 → 星盘资料 → 账户与点数 → 通用设置 |
| 5.2 个人资料搬出 `page.tsx`，无「管理星盘资料」 | 通过 | `profile-panel.tsx`；`page.tsx` 2035 → 1976 行（净减 59 ≥ 40） |
| 5.3 星盘资料列表 → 详情 | 通过 | `chart-library-panel.tsx` 内部视图 `list / self / other / add`，默认列表，无无条件 `<form` |
| 5.4 「账户与点数」入弹窗；删 `/membership` 与 `/membership/orders`；307 重定向；七处入口改回调；`/` 不用 `useSearchParams` 保持 Static | 通过 | `src/app/membership` 已删；`next.config.ts` 两条 `redirects`；`git grep "/membership" frontend/src` 只剩 `next.config.ts`；`settings-url.ts` 用 `window.location` 解析后 `replaceState` 抹参 |
| 5.4 测试迁移（26 条进 `billing-panel.test.ts`）、`settings-url.test.ts`、`chat-navigation-a11y` 三栏表、Python `app_routes` 去掉两条 | 通过 | 三栏表完整；`tests/test_api_server_security.py` 已去 `membership` / `membership/orders` |
| 5.5 BUG-554、CHANGELOG、DESIGN、VOICE | 通过 | — |

**结论：通过**。修复 SHA `dc6598d7`。四分区真实切换、移动端弹窗、`/membership` 深链回落留 `docs/testing/settings-dialog-and-billing-pane-20260906.md` 真人走查。