# 实施与验证记录

2026-09-21，本地实施完成。功能代码已提交为 `b9981aa`；本轮用户已授权推送。生产数据库未迁移、未重算，未部署。

## 已实现

- 单日/波段流入率增加镜像加权评分列，保留 1 位小数，原始率独立展示。左右列头分别排序，加载该侧完整候选榜后应用排序，NULL 始终置后。
- 新算法版本为 `zhixing_ratio_weighted_v2`、`zhixing_swing_weighted_v2`。全池平均名次百分位与 5 日成交额权重在后端计算，波段使用 MA3/MA10 分别排名后各占 50%。
- 排名变化提供波段率/单日率/单日额、近 1–5 天、涨跌幅、另外两项指标的变化、镜像双榜和随基准更新的标题。URL 无显式值时默认波段率、近 1 天。
- 对比使用保存的交易日历和同版本名次。缺发布、缺板块、历史不足或版本不匹配时保持未知，不跳过缺失交易日、不伪造零。
- 迁移 `0010_radar_weighted_score` 增加 nullable NUMERIC(28,12) 和有限值约束。全部排名读写路径、HTTP、前端解析与详情历史同步扩展。
- `sector-radar-build --recompute` 只读取已有聚合事实与源快照，按日期生成新发布，保留原发布。当前名次、历史和详情使用相同版本。

## 实际验证

| 检查 | 结果 |
| --- | --- |
| 后端雷达领域、构建、读取、HTTP、PostgreSQL 集成 | 110 passed |
| 前端雷达 API、query、详情、页面 | 74 passed |
| 后端 Ruff format/check | 通过 |
| 本次后端模块、测试和迁移 Pyright | 0 errors |
| 前端格式、ESLint、TypeScript 和生产 build | 通过；Vite 仍提示既有大 chunk |
| migration 0010 → 0009 → 0010 | 288 条原始排名保留，新增评分为 NULL |
| 真实 PostgreSQL 重算 | 保留旧发布、评分在各读取路径一致、详情来源完整、失败不替换 last-good |
| CLI 完整重算 | 31 日 × 400 个合成板块；首次 success，重复 31 日均 unchanged |
| 浏览器 2 类型 × 3 基准 × 5 天数 | 30 组合通过；首行变化与 API 一致，刷新恢复 URL 选择 |
| 浏览器评分排序 | 左榜完整 31 个、右榜完整 30 个候选；升降序正确且两侧独立 |
| 浏览器窄屏与缺历史 | 390px 页面无整页横向溢出；960px 表格可横向滚动；空历史文案完整可见 |
| Git diff/context manifests | diff --check 与 7/9 条上下文清单校验通过 |

数据库验证均在单独创建的本地 PostgreSQL 17 容器执行，未连接生产数据库。浏览器预览为合成测试数据；`research/seed_local_preview.py` 限制只能写入本地测试库。控制台仅观察到既有 favicon.ico 404，没有本次页面异常。

## 全仓基线问题

完整命令已执行，但不能报告全仓检查通过。已用 `git archive HEAD`（实施前 HEAD `669e89d`）及相同依赖独立复现：

- 后端全量 Pyright：14 个相同错误，位于 selection 的 `chart.py`、`gold_brick.py`、`test_run.py`。
- 后端全量 pytest：本次 230 passed / 6 failed，修改前 221 passed / 同样 6 failed。既有 market_data 集成测试调用不存在的 Connection.executemany；旧迁移测试日志配置导致后续 5 个日志断言失败。雷达相关 110 项在独立运行时全部通过。
- 前端 `pnpm check` 的格式、lint 和类型均通过；全量 Vitest 为 148 passed / 4 failed。修改前 selection 页面同样 4 个执行状态弹窗测试失败（其余 20 个通过）。

这些既有选股/行情问题未在本任务扩展修复。前端 `.prettierignore` 补充已被 Git 忽略的 `.playwright-cli`，避免旧浏览器快照影响格式检查。

## 生产应用步骤（尚未执行）

生产 Compose 的完整构建、迁移、重算顺序见 `docs/market-data-sync.md`。以下为直接使用 Python 环境时的等价命令。

在目标环境确认 `ZHIXING_DATABASE_URL` 指向正确数据库，先执行迁移，再上线代码并重算现有日期区间：

```bash
cd zhixing-server
uv run alembic upgrade head
uv run sector-radar-build --recompute --start-date 2026-08-28 --end-date 2026-09-21
```

日期应覆盖需要展示的已有历史；命令只处理区间内已有成功发布。单日评分需要连续 5 个交易日成交额，波段评分需要连续 10 个交易日输入；要比较近 5 日波段名次，还需要相应更早窗口。缺失日期保持未知，重算不补造原始行情或成员数据。

新列允许旧行为 NULL，旧发布保留追溯。回退需切回保留的旧版本发布；不能在仍运行新代码时直接删列。当前代码库没有自动生产回退动作，本任务没有执行任何生产状态变更。

## 预览证据

- `output/playwright/radar-rank-change-desktop.png`
- `output/playwright/radar-swing-desktop.png`
- `output/playwright/radar-ratio-desktop.png`
- `output/playwright/radar-rank-change-mobile.png`
- `output/playwright/radar-missing-history-mobile.png`

本地预览：`http://127.0.0.1:15173/sector-radar?view=rank_change&tradeDate=2026-09-21`。前端端口 15173，后端端口 18081，数据库容器 `zhixing-radar-score-test`（本地端口 55439）；均用于隔离验收。

## 提交前复核

本轮独立只读检查由 `/root/radar_commit_review` 完成，未发现新增正确性或部署阻塞；范围内 Ruff/Pyright 和 diff 检查通过。Compose Job 的 entrypoint 与新版 CLI 参数已核对，并使用无生产凭据的配置通过 `docker compose config --quiet`。线上操作说明已补入 `docs/market-data-sync.md`；本轮只执行 Git 提交与推送，不执行线上迁移、重算或部署。