40 lines
2.5 KiB
Markdown
40 lines
2.5 KiB
Markdown
|
# 执行计划
|
||
|
|
|
||
|
|
状态：本地实现与范围内验收完成；全仓既有失败已在实施前版本复现。详细结果及生产应用命令见 `validation.md`。
|
||
|
|
|
||
|
|
1. 完整阅读要修改的文件；确认已保存的评分研究、接口契约、版本及缺失语义。核对需要使用的 Alembic/Pydantic 等当前版本与官方文档。
|
||
|
|
2. 实现版本化评分特征和全池计算，分离 raw value/score；更换单日/波段排序键，补独立数值样例、并列、未来数据排除及缺失窗口测试。
|
||
|
|
3. 新增 nullable score 列迁移；同步 PostgreSQL/内存仓库所有读写与 historical ranking 查询。补充真实数据库往返、旧行 NULL 和事务失败测试。
|
||
|
|
4. 接入发布构建与 input_hash；实现不访问 Tushare 的历史重算入口、新旧版本解析及严格对比日期。验证幂等、旧发布保留、失败 last-good 与详情来源完整。
|
||
|
|
5. 扩展榜单/详情 HTTP 输出和前端类型解析，支持评分、三指标变化值及对比日期；覆盖不匹配版本与缺失历史。
|
||
|
|
6. 单日/波段表格添加评分列与侧内排序；按截图调整排名变化次级控制行、双榜标题、中央标题、涨跌幅和两项辅助变化列，保持 URL/查询联动。
|
||
|
|
7. 执行领域、发布、读取、HTTP、仓库、前端 API 和页面行为测试；用本地测试数据库验证迁移和离线重算，避免使用用户生产库进行测试写入。
|
||
|
|
8. 完成后端 Ruff/Pyright/pytest 与前端格式、lint、typecheck、Vitest/build。浏览器实际检查三基准、1–5 日、空历史、评分列和窄屏；保存必要截图和验证结果。
|
||
|
|
9. 检查 diff 范围、已有用户改动和未验证事项；交付本地成果及明确的迁移/重算命令，不自行提交、部署或写入生产库。
|
||
|
|
|
||
|
|
## 验证命令
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd zhixing-server
|
||
|
|
uv run ruff format --check .
|
||
|
|
uv run ruff check .
|
||
|
|
uv run pyright
|
||
|
|
uv run pytest
|
||
|
|
```
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd zhixing-web
|
||
|
|
pnpm check
|
||
|
|
pnpm build
|
||
|
|
```
|
||
|
|
|
||
|
|
实现期间先执行相关测试，最后执行项目规定完整检查；通过后仅在新改动或未解决问题需要时重复。
|
||
|
|
|
||
|
|
## 高风险核验点
|
||
|
|
|
||
|
|
- P 必须来自完整同类池，不能来自当前页面 TOP10% 子集。
|
||
|
|
- Swing 分数是两次排名后合成，不是合成 raw 后再排名。
|
||
|
|
- 历史不足时不能伪造评分/0变化；不能跨失败交易日跳位或跨版本相减。
|
||
|
|
- migration 列顺序涉及所有 ranking SELECT 与 fake row，不得只改写入。
|
||
|
|
- 离线重算的新发布必须可继续打开详情，且不得重新请求上游或改变旧快照。
|