group_fqcd_jr

341 Commits 12 Branches 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
lzf_0626	02ba1befc0	feat(data): 取真实费率并回填 fin_product；发现 510300 的身份问题 ## 取费率项目原有的行情适配器只有 names/quotes/history，没有费率。东财也没有可用的 JSON 接口（`FundArchivesDatas.aspx?type=jjfl` 实测正文只有一句 `var apidata=`），所以给 EastmoneyFundAdapter 加了 fetch_fees：抓 f10 基金概况页（fundf10.eastmoney.com/jbgk_{code}.html）去标签后匹配字段名，取管理费/托管费/ 销售服务费/申赎费，并顺带带回基金全称。取不到的基金不进返回（而不是给全 None），免得调用方把"没抓到"当成"该基金确实没有费率"。实测 20/20 全部取到。 ## 回填新增 tools/backfill_product_fees.py，默认 dry-run、默认只补 NULL： - 只补空值：写入 38 个字段（19 只 × 管理费/托管费），已执行 - 已有值一律不动 —— `510300` 库里的 0.5000/0.1000 保持原样，要改需显式 --overwrite - 写入走单事务回填前 grep 确认：`fin_product.management_fee_rate` / `custodian_fee_rate` 目前没有任何业务代码读取（advisor 域那两个 fee 字段属于另一张表 advisor_product_contract），所以这次回填不改变任何现有行为。要让客户真的看到费率，还需要接口与前端读它 —— 那不在本次范围。 ## 两个数据问题（都指向 510300） 1) 它不是南方基金的产品。数据源返回的基金全称是「华泰柏瑞沪深300交易型开放式指数证券投资基金」，而库里 fund_manager 写「南方基金」。其余 19 只全称都是"南方…"开头，只有它例外。影响面不只是知识库：MarketQuoteSyncService 按 fund_manager='南方基金' 筛选同步对象，所以它会被当成自家产品一起同步、一起展示。 2) 它的费率是照抄的。库里 0.5000/0.1000，真实 0.15/0.05；而 0.50/0.10 恰好是 159329/159382/159511/588890 这四只的真实费率。结合它的净值快照时间是当天（其余 19 只停在 09-11）、净值取整数 4.500000，判断是演示用途的人为设定。这两条都由用户决定怎么处理，本次只记录、不擅自改（510300 的 fund_manager、净值、费率三处原值都没动）。 ## 其他 - tools/fetch_live_quotes.py 增加费率核对段落与 --no-fees（费率要串行抓 45KB/只，较慢） - docs/42 用真实费率重写 1.2 节与新增 4.3 真实费率清单，3.1 节标出 510300 的身份问题 - docs/42 的数据缺口表更新：费率不再是缺口门禁：ruff 通过 / mypy 249 文件 0 错 / 单元+契约 1377 passed 2 skipped。	2026-09-13 19:39:16 +08:00
lzf_0626	131effcfae	feat(tools): 新增 fetch_live_quotes 拉真实行情并核对库里快照项目本来就对接了东方财富真实行情（app/infrastructure/fund_market_adapter.py： push2.eastmoney.com 的行情接口 + api.fund.eastmoney.com 的历史净值接口），下单链路取 quote_price/quote_source 走的也是它。之前做知识草稿时用的是 fin_product 表里的快照，没有去核对真实数据源，这次补上。新增 tools/fetch_live_quotes.py： - 用项目自带的 EastmoneyFundAdapter 取数，不自己拼 HTTP、不引第三方行情库 - 产品范围与 MarketQuoteSyncService.sync 一致（南方基金 / SSE,SZSE / 上市） - 逐只对比真实净值与 fin_product.current_nav，只报告差异、不写库（刷新快照是 ProductHistorySyncService / MarketQuoteSyncService 的职责）实测结果（2026-09-13，20 只全部取到真实数据）： - 18 只完全一致（库里 6 位小数、数据源 4 位，是同一笔数） - 2 只不一致： · 510300 沪深300ETF：库里 4.500000，真实 4.5794。库里快照时间是今天 08:19:37，其余 19 只都停在 09-11 15:00:00 —— 说明这是被人为改过的演示值（4.5 凑"1 手 450 元"）。需要定：知识用真实值还是演示值；若交易按库里的 4.5 成交而知识说 4.5794，两处口径会打架。 · 511810 货币ETF南方：库里 0.266100，NAV_API 给 0.2332，而 QUOTE_API（场内实时价）给 100.012 —— 差三个数量级，说明两个接口对这只的含义不同，需人工核实口径。 docs/42 随之更新： - 产品清单改用真实净值，并加上当日涨跌与净值日期，注明取数来源与复现命令 - 3.1 节的沪深300ETF 条目改用真实值 4.5794，并列出两处待确认口径 - 新增 4.2 节记录本次核对结果与两只不一致项的判断依据	2026-09-13 19:27:58 +08:00

Author

SHA1

Message

Date

lzf_0626

02ba1befc0

feat(data): 取真实费率并回填 fin_product；发现 510300 的身份问题

## 取费率

项目原有的行情适配器只有 names/quotes/history，没有费率。东财也没有可用的 JSON 接口
（`FundArchivesDatas.aspx?type=jjfl` 实测正文只有一句 `var apidata=`），
所以给 EastmoneyFundAdapter 加了 fetch_fees：抓 f10 基金概况页
（fundf10.eastmoney.com/jbgk_{code}.html）去标签后匹配字段名，取管理费/托管费/
销售服务费/申赎费，并顺带带回基金全称。取不到的基金不进返回（而不是给全 None），
免得调用方把"没抓到"当成"该基金确实没有费率"。

实测 20/20 全部取到。

## 回填

新增 tools/backfill_product_fees.py，默认 dry-run、默认只补 NULL：
- 只补空值：写入 38 个字段（19 只 × 管理费/托管费），已执行
- 已有值一律不动 —— `510300` 库里的 0.5000/0.1000 保持原样，要改需显式 --overwrite
- 写入走单事务

回填前 grep 确认：`fin_product.management_fee_rate` / `custodian_fee_rate`
**目前没有任何业务代码读取**（advisor 域那两个 fee 字段属于另一张表
advisor_product_contract），所以这次回填不改变任何现有行为。
要让客户真的看到费率，还需要接口与前端读它 —— 那不在本次范围。

## 两个数据问题（都指向 510300）

1) **它不是南方基金的产品**。数据源返回的基金全称是
   「华泰柏瑞沪深300交易型开放式指数证券投资基金」，而库里 fund_manager 写「南方基金」。
   其余 19 只全称都是"南方…"开头，只有它例外。
   影响面不只是知识库：MarketQuoteSyncService 按 fund_manager='南方基金' 筛选同步对象，
   所以它会被当成自家产品一起同步、一起展示。

2) **它的费率是照抄的**。库里 0.5000/0.1000，真实 0.15/0.05；而 0.50/0.10 恰好是
   159329/159382/159511/588890 这四只的真实费率。结合它的净值快照时间是当天
   （其余 19 只停在 09-11）、净值取整数 4.500000，判断是演示用途的人为设定。

这两条都由用户决定怎么处理，本次只记录、不擅自改（510300 的 fund_manager、净值、费率
三处原值都没动）。

## 其他

- tools/fetch_live_quotes.py 增加费率核对段落与 --no-fees（费率要串行抓 45KB/只，较慢）
- docs/42 用真实费率重写 1.2 节与新增 4.3 真实费率清单，3.1 节标出 510300 的身份问题
- docs/42 的数据缺口表更新：费率不再是缺口

门禁：ruff 通过 / mypy 249 文件 0 错 / 单元+契约 1377 passed 2 skipped。

2026-09-13 19:39:16 +08:00

lzf_0626

131effcfae

feat(tools): 新增 fetch_live_quotes 拉真实行情并核对库里快照

项目本来就对接了东方财富真实行情（app/infrastructure/fund_market_adapter.py：
push2.eastmoney.com 的行情接口 + api.fund.eastmoney.com 的历史净值接口），
下单链路取 quote_price/quote_source 走的也是它。之前做知识草稿时用的是
fin_product 表里的快照，没有去核对真实数据源，这次补上。

新增 tools/fetch_live_quotes.py：
- 用项目自带的 EastmoneyFundAdapter 取数，不自己拼 HTTP、不引第三方行情库
- 产品范围与 MarketQuoteSyncService.sync 一致（南方基金 / SSE,SZSE / 上市）
- 逐只对比真实净值与 fin_product.current_nav，只报告差异、**不写库**
  （刷新快照是 ProductHistorySyncService / MarketQuoteSyncService 的职责）

实测结果（2026-09-13，20 只全部取到真实数据）：
- 18 只完全一致（库里 6 位小数、数据源 4 位，是同一笔数）
- 2 只不一致：
  · 510300 沪深300ETF：库里 4.500000，真实 4.5794。库里快照时间是今天 08:19:37，
    其余 19 只都停在 09-11 15:00:00 —— 说明这是被人为改过的演示值（4.5 凑"1 手 450 元"）。
    需要定：知识用真实值还是演示值；若交易按库里的 4.5 成交而知识说 4.5794，两处口径会打架。
  · 511810 货币ETF南方：库里 0.266100，NAV_API 给 0.2332，而 QUOTE_API（场内实时价）
    给 100.012 —— 差三个数量级，说明两个接口对这只的含义不同，需人工核实口径。

docs/42 随之更新：
- 产品清单改用真实净值，并加上当日涨跌与净值日期，注明取数来源与复现命令
- 3.1 节的沪深300ETF 条目改用真实值 4.5794，并列出两处待确认口径
- 新增 4.2 节记录本次核对结果与两只不一致项的判断依据

2026-09-13 19:27:58 +08:00