Jyotisha/docs/tasks/PROGRESS-chart-page-20260915.md

PROGRESS · 只读星盘页（2026-09-15）

工作树：.worktrees/chart-page-20260915
分支：codex/chart-page-20260915
任务书基线：2d7698ea；开工时 origin/staging = 4cacea8e（其后纯文档提交若干，代码基线以当时 HEAD 为准）。
本机 Windows。未新建 worktree。

Skill 未 bump。未开 BUG 号（704–706 预留未用）。未改 scripts/**、deploy/**、vendor/**、frontend/src/app/page.tsx、vedic-chart-svg.tsx、frontend/src/app/ephemeris/**。未做 TASK-api-server-decomposition-20260916。

开工基线

项	数字
frontend/src/app/page.tsx	1951 行（PowerShell (Get-Content).Count）
tsc --noEmit	0 错
本单新增测试	见下；全量 npm test 收尾时再记

frontend/node_modules 用 junction 指向主仓 G:\Ferti\Jyotisha\frontend\node_modules（本 worktree 无独立安装）。

任务状态

任务	状态	说明
1 BFF /api/chart-view	完成	GET；出生资料只读服务端；不 import billing / mastra
2 五个 Tab	完成	前三个印度 Tab 用现有 /api/chart + /api/varga_full + /api/dasha/chara；西洋 / 七政未上线时 unavailable
3 侧栏两个入口	完成	星盘 /chart、星历 /ephemeris（对方未合入前 404 是预期）

实现要点

• 独立 route frontend/src/app/chart/page.tsx（force-dynamic）。服务端 loadChartView() 算完再揭幕，页面组件里没有 spinner / 骨架 / 「正在加载」。
• 盘面从 @/components/personal-report/vedic-chart-svg 引入，导出签名零改动。
• 上游：先 /api/chart，再并行 chara / varga_full / western / qizheng。chara 与 varga 带上 planets、ascendant、houses。Vimshottari 大运取 /api/chart 的 dasha.periods，不单独打 /api/dasha。
• 西洋 / 七政失败或 404 → 该字段 unavailable，其余 Tab 照常。
• 分运：Vimshottari 按标准年限比例从大运边界推，界面注明「不是引擎单独返回的字段」。Chara 名称写 Chara Dasha（kn_rao 变体）。
• 中宫参数卡：≥768 六行；≤767 中宫两行（岁差、交点），完整卡在盘下。切点跟壳层。
• 侧栏新入口复用 .report-nav-button，当前项白玻璃 + 2px 深棕标记。

既有断言改动

文件	原值	新值	原因
tests/test_api_server_security.py app_routes	不含 chart	加入 'chart'（排序在 home 前）	_scan_app_routes 会扫到新的 frontend/src/app/chart/page.tsx

未改其他既有断言。

Golden

frontend/tests/fixtures/chart-view-golden.json 来自本机 Anaconda swisseph 2.10.03 实跑：domain_calculation_service.compute_chart + compute_vimshottari_timeline、DivisionalChartsCalculator、jaimini.calc_chara_dasha_with_antardasha（去掉未使用的 pratyantar_dashas）、western_chart_engine.build_tropical_natal_chart。虚构出生 1990-06-15 12:00 北京 39.9042N 116.4074E tz+8 Raman mean node（与既有 report-chart-blocks-golden 同一例）。

测试

命令	结果
npx tsx --test tests/chart-view-route.test.ts tests/chart-page-view.test.tsx	14 pass / 0 fail（本单新增）
上列 + class-name-definition / sidebar-contract / dark-theme-contract / personal-report-theme-contract	69 pass / 0 fail
./node_modules/.bin/tsc --noEmit	0 错
npm run lint	0 error（全仓既有 warning；本单新文件 0 warning）
page.tsx	仍 1951 行，未改
npx next build --webpack	compile + TypeScript 过；Collecting page data 死在既有 SkillPackageRegistryError（jyotish-birth-time-rectification@10.0.26 SHA 对不上），与本单无关。未能从本机构建表确认 / 的 ○ Static。
npm test 全量	# tests 3067 / # pass 2909 / # fail 144 / # skipped 14。失败集中在无 Docker 的 database-*、部署/Caddy 的 CRLF 正则、Skill SHA、Windows 下 G:\\G:\\ 双前缀读文件。本机不是 BLOCKED 里那台 Linux 验收机（那边记 3214 / 27 fail）。本单新增 14 条，未弱化既有断言。

Windows 上改 globals.css 时曾被写成 CRLF，暗色主题合同会整文件红；已把本单改过的文件转回 LF。不要再让 CSS 带 CR。

合入顺序

规定：qizheng → 本单 → ephemeris。

2026-09-15 收尾时 git fetch：origin/staging = 3e58e85f（比开工 4cacea8e 多 1 个纯文档提交）。qizheng 尚未合入（staging 上没有 /api/qizheng / /api/western 端点提交）。按任务书停在待推，不抢推 staging。

星历入口现在指向尚未存在的 /ephemeris，对方合入前 404 是预期。

环境缺口

• 无登录态、无 Chrome：浏览器走查见 docs/testing/chart-page-20260915.md，不得写成通过。
• 无 Docker：未跑 npm run test:db（本单未动表）。
• worktree node_modules 是指向主仓的 junction；Turbopack next build 可能报 symlink 出文件系统。/ Static 用 webpack 构建核。