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 逐类验证归档页)。
This commit is contained in:
Simon
2026-09-20 07:31:04 +08:00
parent 7e15b7251e
commit 23972e7063
112 changed files with 17908 additions and 3893 deletions
+38 -15
View File
@@ -14,7 +14,44 @@ interface LoadState {
error: string;
}
/**
* 快速入口按**研究闭环的真实顺序**排列:
* 出候选(筛选)→ 定规则(策略库)→ 验规则(回测)→ 复盘(实验对比)。
* 顺序即引导:新用户按从左到右走一遍就是完整流程。
*
* ④ 之后是**归档回看**:每次回测(含同步接口调用)都会自动写一份完整归档,
* 入口在实验列表的「打开归档」、以及回测跑完后的提示条里;归档页是只读快照,
* 明确写出这次的**选股条件**与**交易执行依据**。
*/
const LINKS = [
{
href: "/selection",
title: "① 股票筛选",
desc: "因子评分 TopN 或条件选股,支持当前/历史时点,结果可解释、可查历史",
icon: "target" as const,
tone: "quick-card--violet",
},
{
href: "/strategies",
title: "② 策略库",
desc: "把选股规则存成命名策略:一句话说明 + 计算公式,可一键回测、可复用对比",
icon: "book" as const,
tone: "quick-card--pos",
},
{
href: "/backtest",
title: "③ 选股回测",
desc: "两级截断(候选池 n → 持仓 x)+ 择股/调仓双周期(m/y),买卖点标注在曲线上",
icon: "gauge" as const,
tone: "quick-card--warn",
},
{
href: "/experiments",
title: "④ 实验对比与归档",
desc: "勾选 2~3 次回测做对比;每次回测都已完整存档,点「打开归档」可随时回看选股条件与交易执行依据",
icon: "archive" as const,
tone: "quick-card--violet",
},
{
href: "/factors",
title: "因子研究",
@@ -29,20 +66,6 @@ const LINKS = [
icon: "layers" as const,
tone: "quick-card--pos",
},
{
href: "/backtest",
title: "选股回测",
desc: "单因子完整回测:净值 / 回撤 / 月度收益 / 持仓",
icon: "gauge" as const,
tone: "quick-card--warn",
},
{
href: "/selection",
title: "股票筛选",
desc: "因子评分 TopN 或条件选股,支持当前/历史时点,结果可解释",
icon: "target" as const,
tone: "quick-card--violet",
},
{
href: "/signals",
title: "交易信号",
@@ -124,7 +147,7 @@ export default function DashboardPage() {
</div>
)}
<Card title="快速开始" icon="spark" sub="四个研究入口,从数据到结论" flush={false}>
<Card title="快速开始" icon="spark" sub="按 ①→④ 走一遍即是完整闭环:出候选 → 定规则 → 验规则 → 复盘微调" flush={false}>
<div className="quick-cards" style={{ marginBottom: 0 }}>
{LINKS.map((l) => (
<Link key={l.href} href={l.href} className={`quick-card ${l.tone}`}>