Files
ggx/sql/hd_backtest_run.sql
T
simon fce725e13c 初始提交:高股息策略研究与回测系统
从 Point-in-Time 股票筛选到统一 Web 前端的完整链路:
筛选 → 画像 → 策略 → 回测 → Walk-forward → 绩效分析 → 报告/前端。

架构
- 数据层与策略层分离;策略代码不写 SQL,只经 data/repo.py 取数
- 所有业务阈值集中在 config/*.yml,代码零硬编码(字段写错直接报错)
- 报告只做「run_id → SQL → 渲染」,不做任何计算,数字可追溯
- 前后端分离:output/ 静态站点 + hdiv web 提供的 REST API

数据安全
- 只增不删:SQL 钩子拦截 DELETE/DROP/TRUNCATE,并有源码扫描测试守护
- qlib 原有表只读,本项目数据写入 hd_ 前缀表
- 回补使用 INSERT IGNORE,保证既有行零改动
- .env 存密钥且已 gitignore;output/、logs/、.venv/ 不入库

交付物
- 30 张 hd_* 表、7 个 YAML 配置、283 项自动化测试
- 统一 Web 前端(hash 路由 SPA)+ nginx 部署配置与 launchd 托管脚本

如实声明的限制
- 策略缺少稳定的样本外超额收益(Walk-forward 7 窗口均值 -0.95%,
  基准 +2.29%);其价值体现在回撤控制,而非超额收益
- 涨跌停/停牌约束仅覆盖 2019 年起;index_weight 尚未填充
- AI Agent 层(plan.md 第四版 P8)未实现

详见 docs/user-guide.md 与 docs/implementation-status.md。
2026-10-03 13:54:56 +08:00

41 lines
2.3 KiB
SQL

-- 回测运行头(plan.md §47 原则 6:可复现四元组)
-- 由 src/hdiv/data/schema.py 生成,请勿手工修改
CREATE TABLE IF NOT EXISTS `hd_backtest_run` (
`run_id` VARCHAR(32) NOT NULL,
`strategy_id` VARCHAR(32) NOT NULL,
`strategy_version` VARCHAR(16) NOT NULL,
`mode` VARCHAR(16) NOT NULL DEFAULT 'single'
COMMENT 'single/in_sample/out_of_sample/walkforward_window',
`wf_id` VARCHAR(32) NULL,
`window_index` INT NULL,
`start_date` DATE NOT NULL,
`end_date` DATE NOT NULL,
`initial_capital` DECIMAL(24,4) NOT NULL,
`final_capital` DECIMAL(24,4) NULL,
`total_dividend_net` DECIMAL(24,4) NOT NULL DEFAULT 0 COMMENT '累计现金分红(税后)',
`total_dividend_tax` DECIMAL(24,4) NOT NULL DEFAULT 0 COMMENT '累计代扣红利税',
`total_fees` DECIMAL(24,4) NOT NULL DEFAULT 0 COMMENT '累计交易费用',
`cash_final` DECIMAL(24,4) NULL COMMENT '期末现金(用于资金对账)',
`strategy_config_json` MEDIUMTEXT NOT NULL,
`config_hash` VARCHAR(64) NOT NULL,
`backtest_config_json` TEXT NULL,
`cost_json` TEXT NULL,
`data_version` VARCHAR(64) NULL,
`code_version` VARCHAR(32) NULL,
`seed` INT NULL,
`status` VARCHAR(16) NOT NULL DEFAULT 'OK' COMMENT 'OK/FAIL/PARTIAL',
`unimplemented_json` TEXT NULL COMMENT '未建模部分显式声明(如涨跌停近似)',
`display_name` VARCHAR(128) NULL COMMENT '用户命名',
`notes` VARCHAR(500) NULL COMMENT '用户备注',
`universe_run_id` VARCHAR(32) NULL COMMENT '关联的股票池筛选记录(--universe-run 指定时写入)',
`archived_at` DATETIME NULL COMMENT '归档时间;NULL=未归档',
`deleted_at` DATETIME NULL COMMENT '软删除时间;NULL=未删除',
`created_at` DATETIME NOT NULL,
PRIMARY KEY (`run_id`),
KEY `ix_hd_bt_strategy` (`strategy_id`,`strategy_version`),
KEY `ix_hd_bt_wf` (`wf_id`,`window_index`),
KEY `ix_hd_bt_period` (`start_date`,`end_date`),
KEY `ix_hd_bt_universe` (`universe_run_id`),
KEY `ix_hd_bt_state` (`deleted_at`,`archived_at`,`created_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='回测运行头';