lzf_0626
6f397ab513
按项目方决定处理三件事。 ## 510300（沪深300ETF） 决定：保留 fund_manager = "南方基金" 作演示口径，**不**改成"华泰柏瑞" （改了它会退出 MarketQuoteSyncService 的同步范围，投顾与知识条目也不该再算自家产品）， 但净值与费率改成真实值，并在产品页显式披露它不是本公司产品。 - 回填（tools/backfill_product_snapshot.py --codes 510300 --apply --overwrite）： current_nav 4.500000 → 4.5794、current_nav_at 同步为 2026-09-11 15:00:00、 management_fee_rate 0.5000 → 0.15、custodian_fee_rate 0.1000 → 0.05 - 产品页披露：mock-data.js 给这只加 product_note，详情页新增提示块渲染它 （"本产品为同指数参考产品，非本公司发行的基金，仅用于功能演示"）。 同时把 mock 里这只的净值/费率也对齐真实值，避免出现"页面显示 mock 值、 库里是真实值"两套数字。 - 产品详情页的 css/js 版本参数提到 20260913-5，避免旧缓存。 ## 511810（货币ETF南方） 之前说它"三个数量级不一致"是**我比错了接口**：QUOTE_API 返的是**场内交易价格** （货币 ETF 约 100 元/份），而 current_nav 的口径是 DWJZ 单位净值。 查证结果：库里 0.2661 正是 09-11 的真实 DWJZ，快照时间也对得上 —— 不是脏数据，是旧值。 口径由其余 19 只的一致性确定（current_nav == DWJZ）。 要不要刷新到最新（0.2332）属运维节奏问题，**本次未执行**。 ## 最小交易金额 按项目方口径：一律**以产品字段为准**（100.00 元），不用「1 手 × 净值」推算金额 —— 后者会与字段值不一致，客户会看到两套数字。docs/42 的 1.1 节据此重写。 ## 工具改名 tools/backfill_product_fees.py → tools/backfill_product_snapshot.py：扩展为 净值 + 费率统一入口，新增 --codes 限定范围（避免顺手把全部快照刷成最新， 全量刷新是 ProductHistorySyncService / MarketQuoteSyncService 的职责）。 安全设计不变：默认 dry-run、默认只补 NULL（净值永不为空，所以刷净值需显式 --overwrite）、写入走单事务。 门禁：ruff 通过 / mypy 249 文件 0 错 / 单元+契约 1377 passed 2 skipped。
Portal 路由与角色映射
正式门户使用原生 JavaScript、原生 CSS 与同源 fetch，静态资源统一从 /static/portal/ 加载。
| 路由 | 角色 | 数据源 |
|---|---|---|
/portal/guest/home/ |
访客 / 全部 | 公开展示，产品摘要为集中 mock |
/portal/guest/products/ |
访客 / 全部 | fin_product 同字段集中 mock |
/portal/guest/product-detail/?code= |
访客 / 全部 | fin_product、fin_nav_history 同字段集中 mock |
/portal/customer/login/ |
未登录客户 | A034 |
/portal/customer/dashboard/ |
customer / admin | T001、T002 |
/portal/customer/holdings/ |
customer / admin | T006 |
/portal/customer/profit-loss/ |
customer / admin | T001 |
/portal/customer/orders/ |
customer / admin | T003 |
/portal/customer/transactions/ |
customer / admin | T007 |
/portal/customer/cash-ledger/ |
customer / admin | T009 |
/portal/customer/risk-questionnaire/ |
customer | ONB001、ONB002 |
/portal/employee-console/login/ |
未登录员工 / 管理员 | A034 |
/portal/employee-console/workspace/ |
admin / super_admin | A002-A006、A012、A033、A035-A040、客服转人工管理接口 |
/portal/employee-risk/dashboard/ |
risk_operator / admin / super_admin | /api/v1/risk/**、R001-R003 |
/portal/employee-advisor/dashboard/ |
advisor / admin / super_admin | /api/v1/advisor/recommendations/published（本人 + 名下归属客户的已发布交付物） |
/portal/employee-operations/dashboard/ |
operator / admin / super_admin | /api/v1/offsite-fund/mails、/api/v1/offsite-fund/mailbox-status |
投顾页的数据口径：接口按「本人 +
sys_customer_assignment里名下归属客户」过滤，且同时覆盖investment_goal_book（方案书，发布后review_status='published'）与advisor_recommendation_plan（推荐方案，审核后review_status='approved'）两类内容。 方案书的审核与发布都要求管理员（investment-goal:review/publish都带admin=True）， 投顾自己发不出来 —— 这是有意设计的复核环节，不是缺陷。
客服浮窗由公开首页、基金产品页和客户工作台统一挂载。访客使用 /api/v1/visitor-tokens
获取短期令牌（角色 visitor，权限只有 agent:run + knowledge:query），因此必须走
query_knowledge 这个工具名；登录客户走 search_knowledge。两者都要出现在发布配置的
agent_tools/customer_service:<intent> 白名单里，缺哪一条，对应人群就一问即失败。
公开产品 HTTP 接口尚未实现，因此相关页面使用 common/mock-data.js，不得与登录后的真实账户数据混用。
凡渲染这些 mock 数据的页面都必须挂 data-source-notice 并写入 MOCK_SOURCE_NOTICE
（guest/products/、guest/product-detail/）—— 删掉声明不会让数据变真，只会让客户误以为看到的是真实净值。
客户页面均由 common/auth.js 执行入口守卫，接口路径只在 common/api-client.js 的端点表登记。