Merge remote-tracking branch 'origin/qyqy_develop' into RM2_develop

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）