feat: add Pyramid home dashboard

2026-09-09 18:20:08 +08:00
parent be76b89e9d
commit e57b1f7a2e
17 changed files with 950 additions and 34 deletions
@@ -0,0 +1,16 @@
+# 首页 Pyramid 看板
+
+Type: task
+Status: ready-for-agent
+
+按 ../spec.md 接入两项只读资源并实现独立首页，完成本地自动化与页面验证。
+
+## Comments
+
+- 用户已授权新增首页模块，首期范围为两个 Pyramid 接口。
+- 实现完成：默认首页、导航/助手页面上下文、两项独立只读资源、摘要卡片、搜索、日期筛选、刷新/重试及连接状态。
+- 验证完成：后端全量 254 项通过；日期格式修正后相关 14 项再次通过；ruff 全量通过。
+- 前端构建通过，现有浏览器回归 22 项全部通过。构建仍有依赖 lottie-web 的 eval 提示。
+- Playwright CLI 在独立临时数据库和模拟平台中检查新首页：未连接、正确摘要、搜索无匹配、日期应用/无效范围/恢复默认、单项失败不影响另一项、重试、空数据、缺失值、迟到响应不覆盖新结果、断开后清空数据均通过。
+- 已检查 1440px 浅色/深色与 390px 窄屏截图，未发生横向页面溢出。截图位于忽略目录 output/playwright/home-dashboard-*.png。
+- 真实平台只读核实了两项响应结构与日期参数的接受格式；没有验证日期范围的服务端统计边界。未部署、未提交。
@@ -0,0 +1,21 @@
+# 首页 Pyramid 看板
+
+新增首页导航并作为无 hash 时的默认页面；保留已有页面深链接。
+首期仅展示 cnhk 已封装的 Pyramid multipliers 与 Pyramid alphas 数据。
+复用后端 WorldQuant 会话及认证重试，浏览器仅访问受系统登录保护的本地接口。
+两个资源独立加载、独立报错；分布支持可选起止日期，乘数不受日期筛选影响。
+不以缺失值推断零，不自行推断点亮规则；响应结构必须以参考代码或样例为依据。
+提供加载、无数据、未连接、失败、刷新状态，支持现有浅色/深色与窄屏布局。
+不新增数据库存储、模型工具、外部写入或部署。
+
+验证：上游路径与日期转发、仅 404 回退、错误隔离、登录保护、数据解析；
+前端构建及浏览器导航/筛选/刷新/异常与响应式检查。真实接口可用性单独说明。
+
+## 接口核实（2026-09-09）
+
+两个真实接口均只读请求成功。响应的 `pyramids` 列表包含 `category.id/name`、
+`region`、`delay`，两类指标分别为 `multiplier` 和 `alphaCount`。
+分布接口实测接受 `startDate/endDate=YYYY-MM-DD`，包含时间的 ISO datetime 返回 400。
+页面按平台日期原样查询，不擅自转换为浏览器时区或推断统计边界。
+浏览器合同仅保留上述字段并统一指标为 `value`，缺失指标保留 null，错误不暴露上游正文。
+统计归属次数跨类别累计，不作为去重后的 Alpha 总数。