 Simon
|
e8fa67ad40
|
feat(web): 回测页统一作业反馈条（点了立刻有字 / 真实阶段 / 可取消）
用户反馈：「点击回测没有任何反馈，不清楚是不是已经开始回测」。
- 新增全站统一的 `useJobRunner`（`lib/jobs.ts`）与 `JobProgress` 组件：
提交瞬间即显示「排队中 + 作业号 + 发起时间」，已用时间**每秒自增**（不依赖后端
是否报新阶段），阶段来自后端真实 `stage`，排队/运行中可**取消任务**、失败直接显示
后端原文、成功给「打开归档 / 去对比」。反馈条出现时自动滚入视野（按钮在长表单底部，
不滚过去就等于没显示）；`role="status" aria-live="polite"`。
- `/backtest` 改用它：删掉原先手写的阶段条与 stage/elapsed/jobId 三个 state，
取消走 `POST /jobs/{id}/cancel`，取消后如实提示「已取消，没有归档」而不是报错。
- 顺带修掉「未命名组合点运行 → 撞 422」：运行是**临时组合不落库**，未填名字时按
「未命名组合（仅本次运行）」提交并明确提示，不再把后端 422 原文甩给用户。
- 修掉反馈条里 `**加粗**` 字面残留（hint 不走 Markdown）。
验证（真实浏览器 CDP，实测数字）：
- 勾选策略 → 点「运行回测组合」→ **+0.11s** 反馈条已显示 `排队中` + `JOB-8508F84D`
+ 发起于 18:05:28 + 已用 0s + 四个真实阶段 + 「取消任务」按钮；+4.5s 进入
`加载行情与因子数据`；点取消 → 「正在取消…」→「已取消」并提示没有归档。
- 反馈条截图逐字核对（阶段、作业号、时间、按钮），并据此修掉 markdown 残留。
|
2026-10-01 18:08:58 +08:00 |
|
|
Simon
|
f13b34c59e
|
feat(web): 字段库页 + 界面单位换算 + 因子目录参数化 + 选股策略条件表单
字段库与单位：
- `/fields`：字段库管理页（中文名/说明可改、可停用；kind 是引擎事实不可改）；
单位只在字段自己的阶梯里选（总市值 = 万元/亿元），越界 422 原样展示。
- `lib/units.ts`：界面单位 ⇄ 基准单位换算集中一处，条件输入按界面单位回显、
提交前换回基准单位（引擎只认基准单位，库里存的也永远是基准单位）。
- `SelectionStrategyForm` 取代 `StrategyParamsForm`：一个策略只定义「怎么选」
（股票池 + 因子 + 过滤条件），条件字段来自字段库接口而不是前端硬编码枚举。
因子参数化（名字即身份，界面不许藏）：
- `/factors` 新增「参数」列与展开行：精确引擎键、每个参数的允许范围、来源、依赖列
（依赖列标明「引擎事实，不可改」）；说明文案从「不可修改」改为
「改参数 = 新建参数化因子 = 新身份，旧因子/既有策略不变义」。
- 「新建参数化因子」卡片：模板下拉 + 受控窗口（min/max）+ 方向枚举下拉，
实时预览规范键/中文名/渲染公式；后端 422 的原文原样展示，不静默截断。
- 因子下拉显示中文名（含参数）与短键，**value 一律是完整引擎键**；
停用的因子从各页候选里消失（/strategies、/selection、/signals、/factors/compose），
既有策略/归档仍按名字解析；`/factors/compose` 顺手修了勾选框点击目标过小。
- `/fields` 加提示：字段库只列内置因子名，参数化因子在 /factors 管理，
选股策略条件下拉里会一并出现。
tsc --noEmit 0 error；verify_ui_alignment 8 页 160 项全过（另跑 3 个选因子页 51/54）。
|
2026-10-01 16:38:29 +08:00 |
|
|
Simon
|
23972e7063
|
feat: 股息率案例口径 + 策略库与图表统一 + 回测存档完整化
汇总三轮未提交的开发（每轮均在本机 MariaDB + 真实浏览器上验证）：
1) 股息率案例（全市场股息率最高 n 只，默认 20，每 m 月择股）
- 新增日频估值表 daily_basic + 迁移；股息率因子（dv_ratio / dividend_yield / TTM）
- 名称历史表 stock_name_history：剔除 ST 按**择股日当时名称**判定，消除
「曾高股息后 ST」的股息陷阱（实测 3.70pp 偏差）
- 区间择股/调仓双周期（m 择股 / y 调仓）、指数成分与白名单、停牌近似剔除
- 复权因子口径核对（4,164,742 行、缺失 0.0%）、收盘价成交与涨跌停拦单
- 案例实测：2020-01-01~2026-09-04 总收益 +24.86%（年化 3.52%、回撤 -28.58%）
2) 策略库与前端统一
- strategy 表 + CRUD/PUT 原地更新 + `describe_strategy` 按 spec 真实推导
「一句话说明 + 计算公式 + 执行步骤 + 注意事项」（与引擎实执行规则同源）
- 任何出现股票代码处都成对显示名称且可点击进个股页
- 全站图表基座统一 TradingView Lightweight Charts（ECharts 依赖、
锁文件、组件与文档标注一并清除），买卖点标记只落在真实交易日上
3) 回测存档完整化（可往复查看）
- 同步端点（POST /api/backtests、/api/factor-tests）此前完全不落库 → 现在同样归档，
归档 id 经响应头 X-Experiment-Id 返回（不破坏 response_model）
- data_version 首次真实写入（数据快照指纹：最新交易日 + 各表规模）
- 个股收益曲线默认**全量保存**（此前硬截断 60 只）；超出体积预算才裁剪，
并写 archive_meta（机器可读）+ unimplemented（人可读）如实标注
- 列表 kind/q 过滤 + X-Total-Count（此前 limit=50 静默截断）、DELETE 归档
- 只读归档页 /experiments/{id}（Server Component，SSR 直出**选股条件**与
**交易执行依据**）；结果视图按 kind 分发（backtest/factor_test/selection），
非回测归档不套用回测口径
- 新增 CLI：prune_experiments（保留策略，默认 dry-run）、
restore_experiment_from_job（从 Job 副本按原 id 重建被删的历史归档，默认 dry-run）
门禁：pytest 388 passed、ruff All checks passed、tsc 0 错误、图表单测 7 passed、
next build 成功、契约脚本 verify_strategy_workspace 59/59（含按 kind 逐类验证归档页）。
|
2026-09-20 07:31:04 +08:00 |
|
|
Simon
|
1cf7c84897
|
fix(web): 因子研究/回测改走异步 Job（修复全市场研究长请求被代理中断 500）
- 根因：全市场因子测试同步执行约 47s，经 Next 同源代理转发时长请求被 socket 中断（前端日志：Failed to proxy .../api/factor-tests [socket hang up]）
- factors/backtest 页改为 POST /api/jobs 提交 → 轮询 GET /api/jobs/{id} → 取内嵌结果（AGENT §19 异步化）
- 新增 lib/jobs.ts（submitJob / waitJob，超时 10 分钟），运行中显示 Job 号
- 端到端验证：全市场 momentum_60 测试 JOB-93479087 → success（IC -0.0598，样本 323 日）+ Experiment 归档
- tsc + next build 通过；同步接口保留（适合小样本/脚本调用）
|
2026-09-07 20:38:56 +08:00 |
|