fix(web): paint the chart page shell before engine calls

BUG-715/716/717: typed engine failures with logs and split copy, natal-only open, on-demand tabs, 10s timeout, in-memory cache, no speed-promise eyebrow.
2026-09-15 22:51:15 +08:00
parent 8caa2a2b4c
commit 5a8328e591
22 changed files with 1027 additions and 133 deletions
@@ -15,8 +15,8 @@

 ## 五个 Tab

-6. 登录且出生资料齐全：打开星盘没有 spinner、骨架或「正在加载」，揭幕就是完整页。
-7. 眉标是「直接计算 · 打开即有 · 不消耗点数」。点数余额不应因打开此页而变。
+6. 登录且出生资料齐全：点「星盘」后先看到外壳（返回、标题），不是白屏。主盘到达前可以出现「这一张盘还没拿到。」，不得出现 spinner、骨架或「正在加载」。
+7. 成功页眉标是「主盘直接算 · 分盘按需 · 不消耗点数」。失败页没有眉标。点数余额不应因打开此页而变。
 8. Tab 顺序：星盘 / 基础信息 / 大运 / 西洋盘 / 七政四余。都能点。
 9. 星盘 Tab：D1–D30 chip 可换；盘面是北印菱形盘；右侧有行星表（星体 / 星座与度数 / 宫位 / 状态）。
 10. 桌面中宫是六行参数；把窗口收到手机宽度（≤767）后，中宫只剩岁差和交点两行，完整参数出现在盘下方。
@@ -0,0 +1,28 @@
+# 真人验收 · 星盘页开页不再整页阻塞（2026-09-15）
+
+执行环境无登录态、无 Chrome。下列条目留给有真实账号的人在 staging 走查。本单自动化不替代这些。
+
+## 开页外壳
+
+1. 登录后点侧栏「星盘」。**大约 1 秒内**能看到页面外壳：返回对话、标题「星盘」。不要整页白屏等到引擎全部算完。
+2. 主盘还没到时，等待句是「这一张盘还没拿到。」没有转圈、骨架或「正在加载」。
+3. 主盘到达后北印盘立刻可见。出生资料行出现。成功眉标是「主盘直接算 · 分盘按需 · 不消耗点数」，没有「打开即有」。
+
+## 按需加载
+
+4. 开页后（还没点其它 tab）开发者工具里发给引擎的路径只有 `/api/chart`。不要同时出现 `/api/western` 或 `/api/qizheng`。
+5. 点「大运」：Vimshottari 可以立刻出现（来自主盘）；Chara 未到时写「这一栏还没拿到。」，到了再填。未点之前不应请求 `/api/dasha/chara`。
+6. 点「西洋盘」才请求 `/api/western`。未点不发。等待时写「这一栏还没拿到。」
+7. 点「七政四余」才请求 `/api/qizheng`。未点不发。等待时写「这一栏还没拿到。」
+8. 星盘 tab 默认 D1。点 D9 等非 D1 chip 才请求 `/api/varga_full`。等待时写「这一分盘还没拿到。」
+
+## 失败文案
+
+9. 失败页没有眉标，没有「打开即有」，没有「过一会儿再打开」。
+10. 若刚好赶上引擎忙（429）：「算盘的服务正忙，稍等几秒再打开就好。」稍等再开，有机会好。
+11. 其它失败：「这张盘算不出来，我们已经记录下来了。」不要暗示等一会儿就会好。
+
+## 回归
+
+12. 点数余额不因打开此页而变。
+13. 资料不全时仍是人话去填星盘资料，不是 500，也没有眉标。