feat(portal): 接入历史净值，产品详情页恢复真实走势图

`fin_nav_history` 一直是**空表**，所以产品详情页画不出走势图 —— 此前那条曲线是
前端 `mock-data.js` 里编的 12 个点位，接入公开产品接口时把它去掉了
（走势图最容易被当成真实业绩），页面改为显示"尚未接入"。本次补上完整链路。

## 1. 取数（app/infrastructure/fund_market_adapter.py）

新增 `fetch_nav_history()`：东方财富历史净值接口（`api.fund.eastmoney.com/f10/lsjz`）
分页取序列。

- **为什么不复用 `fetch_kline`**：它走 `push2his.eastmoney.com`，
  该域名在本环境实测连接被拒（`RemoteProtocolError`）；
- **为什么不复用 `hq.get_southern_fund_nav_history`**：那个函数校验**南方基金白名单**，
  而 `fin_product` 里有非南方基金的产品（510300 是华泰柏瑞的），调它会直接 `ValueError`。

⚠️ 实现里踩到一个坑：接口**会忽略请求中的 `pageSize`**（实测固定每次返回 20 条）。
最初按硬编码的 30 判断"是否最后一页"，于是 `len(items) < 30` 永远成立、只取到第一页 ——
走势图看上去"有数据"，其实只有最近 20 天，而且毫无报错。
改为按首屏**实际条数** + `TotalCount` 推算页数后，同样区间取到 124 条。

## 2. 落库（tools/sync_nav_history.py，新增）

写入 `fin_nav_history`，按 `(product_id, nav_date)` 幂等 upsert。
实测：20 只产品 / **2513 行** / 2026-03-17 ~ 09-13；重跑**新写入 0 行**。

## 3. 接口（P002）

`GET /api/v1/products/{product_code}/nav-history`，编号 **P002**，已登记 `docs/05` §19。
鉴权口径与 P001 相同（要求有效令牌、不校验权限码，访客令牌可用）；`days` 有界 1–365。

**表为空时返回 `count=0` 与空数组，而不是报错** —— 调用方据此显示"尚未接入"，
**不得回退到编造曲线**。产品不存在或未上市 → `404`（否则前端分不清"没有数据"
和"没有这只产品"）。

## 4. 前端

详情页按序列画 SVG 折线，期数标题改为动态（"近 N 个交易日"）。
表为空时仍显示"尚未接入"占位，并补上此前缺失的 `.detail-chart__empty` 样式。
`product-detail.js` / `.css` / `index.html` 的缓存版本参数一并 bump 到 `-7`。

## 5. 演示数据

`tools/seed_demo_data.py` 增加第 5 步「历史净值」（现 **11 步**），
否则换台机器演示时走势图又会是空的。

验证：P002 实测 515450 / 510300 各 120 个净值点；ruff 通过；mypy 251 文件 0 错；
unit+contract 1391 passed；integration 108 passed；e2e 冒烟 40/40。

docs/05-接口文档.md

@@ -1163,6 +1163,7 @@ GET /internal/metrics
 | T008 | `GET /api/v1/users/me/transactions/{txn_no}` | `trade:txn:read`（资源所有者） | 否 | `200` | 成交详情 |
 | T009 | `GET /api/v1/users/me/cash-ledger` | `account:read:self`（已登录） | 否 | `200` | 资金账本（按 id 倒序游标分页） |
 | P001 | `GET /api/v1/products` | 仅要求有效令牌（访客令牌即可，不校验权限码） | 否 | `200` | 否 |
+| P002 | `GET /api/v1/products/{product_code}/nav-history` | 同上；`days` 取 1–365，默认 90 | 否 | `200` | 否 |
 
 > **T001 – T009 的四点说明**：
 >
@@ -1208,10 +1209,22 @@ GET /internal/metrics
 > - **`change_pct` 可能为 `null`，调用方必须显示"暂无"而不得当成 `0`。**
 >   当日涨跌幅需要**两个交易日**的收盘价，而行情可能只同步过一天。
 >   把 `null` 读成 `0` 等于对客户说"今天平盘"，那是编出来的结论。
-> - **首版不提供历史净值/走势曲线**：`fin_nav_history` 目前为空，走势图数据源尚未接入。
->   首页推荐位、产品列表页、产品详情页共用本端点；此前它们读的是前端手写的
->   `app/static/portal/common/mock-data.js`（8 只演示数据，其中 6 只不在
->   `fin_product` 里），该文件已随本次接入删除。
+> - **首页推荐位、产品列表页、产品详情页共用本端点**；产品详情页的净值走势图另走 P002。
+>   此前这三页读的是前端手写的 `app/static/portal/common/mock-data.js`
+>   （8 只演示数据，其中 6 只不在 `fin_product` 里），该文件已随本次接入删除。
+>
+> **P002（历史净值序列）的三点说明**：
+>
+> - **用途**：产品详情页的净值走势图。数据来自 `fin_nav_history`，
+>   由 `tools/sync_nav_history.py` 从东方财富历史净值接口
+>   （`api.fund.eastmoney.com/f10/lsjz`）同步 —— 注意该域名与**行情**域名不同：
+>   东财的 `push2` / `push2his` 在本环境连接被拒，所以历史走势走净值这条路。
+> - **表为空时返回 `count=0` 与空数组，不是错误**：调用方据此显示"尚未接入"，
+>   而**不得回退到编造的曲线**。此前详情页那条线是演示数据里 12 个假点位，
+>   走势图最容易被当成真实业绩。
+> - **不校验基金归属**：`fin_product` 里有非南方基金的产品（510300 是华泰柏瑞的），
+>   所以这里不套 `hq.py` 的南方基金白名单，只按 `product_code` 取数。
+>   产品不存在或未上市 → `404`。
 
 ## 20. 变更流程
 

docs/40-前端验收清单.md

@@ -92,8 +92,10 @@ python -m app.worker
 > 1. `change_pct` **可能是 `null`**（行情只同步过一个交易日时算不出涨跌）。
 >    页面必须显示"暂无"—— `formatPercent` 收到 `null` 会渲染成 `+0.00%`，
 >    那等于告诉客户"今天平盘"。
-> 2. **历史净值走势图没有数据源**：`fin_nav_history` 目前 0 行，详情页**不画曲线**并显式说明。
->    此前那条曲线是 mock 里 12 个编造点位 —— 走势图最容易被当成真数据。
+> 2. **历史净值走势图**：`fin_nav_history` 由 `tools/sync_nav_history.py` 同步
+>    （东财净值接口，近 120 个交易日，实测 20 只 / 2513 行）。
+>    **表为空时不画曲线**、显式显示"尚未接入"，绝不回退到编造点位 ——
+>    走势图最容易被当成真实业绩。
 
 ### 2.5 访客智能客服浮窗 ⭐ 本轮重点
 

docs/44-演示流程.md

@@ -88,8 +88,9 @@ python tools/e2e_smoke_test.py --read-only
 > ⚠️ 两个**可能被问到、但其实不是故障**的地方：
 > - 产品列表的「最近涨跌」列当前显示 **"暂无"** —— 当日涨跌要**两个交易日**的收盘价才算得出，
 >   而行情库目前只有一个交易日。跑过第二次行情同步后自然会显示。我们**不编这个数**。
-> - 产品详情的**历史净值走势图显示"尚未接入"** —— `fin_nav_history` 目前是空的。
->   此前那条曲线是演示数据里编的 12 个点位，已随接口接入一并去掉。
+> - 产品详情的**净值走势图现在是真实数据**：`fin_nav_history` 由
+>   `tools/sync_nav_history.py`（演示数据第 5 步）从东财净值接口同步，近 **120 个交易日**。
+>   若图上显示"尚未接入"，说明第 5 步没跑 —— 补跑即可，不用重启服务。
 
 ### 场景 2 · 客户资产（1 min）