summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorSomhairle H. Marisol <[email protected]>2026-09-18 10:36:34 +0800
committerSomhairle H. Marisol <[email protected]>2026-09-18 10:36:34 +0800
commita9e5053e51501346bd956609157aa2d1df75f566 (patch)
tree3f95f05fe30ea20ae6ddfb311564792c6f6f821a /docs
parentcad7b02266c6fc582f4ea70422f0128fd0178f02 (diff)
downloadstrategy-lab-a9e5053e51501346bd956609157aa2d1df75f566.tar.gz
docs(frontend): 任务 B 部署准备——dist 产物哈希附录与最终实测记录
[变更性质] 交付文档补充,产物不入库(历史一致性)。 [新增内容] 附录七:投入口径 reporting 推导口径(锚点 run 26e9c9ab:投入12029.09/估值10846.00/-9.84%)、dist 三文件 sha256 前24位、18/18 probe 实测(tabbar@375=true)、权限无变更说明。
Diffstat (limited to 'docs')
-rw-r--r--docs/ui-redesign-round2.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/docs/ui-redesign-round2.md b/docs/ui-redesign-round2.md
index 69c990a..ec66009 100644
--- a/docs/ui-redesign-round2.md
+++ b/docs/ui-redesign-round2.md
@@ -115,3 +115,30 @@ Leader 独立验收发现三处问题,已修复:
1. Sparkline 目前为两点方向线段;若要更像"曲线"可后续接入折线渲染(保持不引依赖仍可行)。
2. 生产部署:本轮为纯前端构建产物 + 脚本,部署流程与前轮一致(deploy.sh 幂等拒重复部署),未重复执行生产发布;_leader 审核后按需发布_。
+
+## 七、附录:投入口径 reporting(任务 A)与部署前准备(任务 B)
+
+### A. 投入口径 reporting(前端推导,未动 server/worker)
+
+- 推导函数 `frontend/src/lib/capitalMetrics.ts:capitalReporting`:
+ - 累计投入 = 首日 `equity[0].cash` − 末日 `equity[-1].cash`(保留 2 位);
+ - 最终持仓估值 = Σ 末日 `positions[k] × closes[k]`;
+ - 投入回报率 = 估值 / 投入 − 1(带正负号与百分号,如 `-9.84%` / `+3.00%`);
+ - 无数据/未建仓 → `null`(UI 渲 `—`),不除零。
+- 结果页(ProjectResultsTab)metric 区新增一行三项[data-testid="capital-reporting"],口径注明"**不含初始账户闲置现金**:累计投入 = 首日现金 − 末日现金;持仓估值 = 末日持仓 × 最新收盘价"。
+- 回测对比页(RunsPage 条件差异表)已加同口径三行:累计投入 / 持仓估值 / 投入回报率(逐 run 对照)。
+- 测试锚点 = 现网 run `26e9c9ab-2fad-4a7d-8190-2a7134a11f76`:`capitalMetrics.test.ts` 9 用例全绿(投入 12029.09 / 估值 10846.00 / -9.84%),vitest 全量 **84/84**(原 75 + 新 9)。
+- 后端/worker 零改动。
+
+### B. 部署前准备(只出产物,未触生产)
+
+- `npm run build` 干净产物(appendix 构建 = probe 内置 build,与最终产物一致):
+
+| 文件 | sha256(前 24 位) |
+| --- | --- |
+| `dist/index.html` | `b907ac48a7dd5a417a8dd610` |
+| `dist/assets/index-C7BAgQZO.js` | `b97112210b8a85c9275461ed` |
+| `dist/assets/index-6tSy0ZnS.css` | `64dcc813d10bfaac99005c2e` |
+
+- 三档 probe(登录态真数据):**18/18 bad=0**,overflow=0、pageErrors=0,`tabbarAttached=true / tabbarVisible=true @375`(768/1440 false),metricCards=4、sparks=2(#/projects),面包屑 `nav.crumbs` 三页齐全。截图已更新至 `artifacts/ui-shadcn-round2/`。
+- 文件权限保持默认(仓库内 644/755 目录常规),无 chmod 变更;生产部署由 Leader 执行,本任务未触生产。