|
|
1bf91bdcd0
|
docs(framework_v2): 添加 FlaskAPIFetcher 文档体系
## 文档（2 个文档，互相关联）
- FLASK_API_FETCHER_GUIDE.md - 使用指南（365 行）
- 快速开始示例
- 完整 API 参考
- 结合 CrossMarketAligner 示例
- 错误处理 + 性能优化
- 注意事项（交易日历、净值数据量）
- FLASK_API_FETCHER_ARCHITECTURE.md - 架构设计（367 行）
- 架构层次图
- 设计原则（DIP, SRP, OCP）
- 数据流图（指数、ETF）
- 与 CrossMarketAligner 集成
- 未来优化方向（缓存、异步）
## 更新
- README.md: 添加文档链接（5 个文档）
- 形成完整文档网络（6 个文档互链）
|
2026-05-24 10:39:02 +08:00 |
|
|
|
40116f436f
|
feat(framework_v2): 添加 FlaskAPIFetcher 数据获取器
## 核心功能
- FlaskAPIFetcher: 继承 DataFetcher 抽象基类
- fetch_indices(): 获取指数 OHLCV 数据
- fetch_etf(): 获取 ETF 数据（自动附加净值+溢价率）
- get_trading_calendar(): 获取交易日历
- get_benchmark(): 获取基准数据
## 技术实现
- 委托调用 FlaskAPIDataSource（HTTP API）
- 自动重试 3 次，超时 120 秒
- Pydantic Schema 验证响应
- 进度显示（批量获取）
- 无需本地 SSH 隧道配置
## 测试验证
- 5/5 测试通过（健康检查、指数、ETF、日历、基准）
- 成功获取线上数据（000300.SH, 510300.SH）
- ETF 自动附加净值（3695 条）和溢价率
## 架构设计
- shared/data/flask_api_fetcher.py - 实现（262 行）
- tests/test_flask_api_fetcher.py - 测试（199 行）
- 依赖倒置原则（策略依赖抽象接口）
|
2026-05-24 10:38:34 +08:00 |
|
|
|
5f08e508ac
|
docs(framework_v2): 完善文档体系 + 修复 .gitignore
## 文档体系（5 个文档，互相关联）
- README.md - 框架总览 + 文档索引
- DATA_ARCHITECTURE.md - 数据架构方案（Schema、验证、性能优化）
- ALIGNMENT_GUIDE.md - CrossMarketAligner 使用指南
- DATA_FLOW_DEMO.md - 从 OHLCV 到最终收益的 7 个阶段推演
- ALIGNMENT_SCHEMA_INTEGRATION.md - Aligner + Schema 整合方案
## 文档特色
- 大量代码示例（✅ 正确 vs ❌ 错误对比）
- 数据流可视化（ASCII 图）
- 表格总结（问题、严重度、解决方案）
- 实际场景推演（2024-01-01 ~ 2024-01-31）
- 文档互链（形成知识网络）
## 修复
- .gitignore: 添加 !framework_v2/shared/data/ 例外
- 允许提交对齐器相关文件
|
2026-05-24 10:29:20 +08:00 |
|
|
|
a16681bda9
|
feat(framework_v2): 添加跨市场数据对齐器 + Pydantic Schema 验证
## 核心功能
- CrossMarketAligner: 跨市场数据对齐（解决 ffill 陷阱）
- Pydantic Schema: 数据结构验证（OHLCVInputSchema, AlignedFactorSchema 等）
- 验证装饰器: @validate_factor_after_align, @validate_returns_after_align
## 解决的问题
- 跨市场交易日历不同（美股/港股/A股）
- ffill 收益率陷阱（休市日复制非零收益率）
- NaN 传播问题
- 日期不一致问题
## 测试验证
- 5/5 测试通过（因子对齐、收益率对齐、多标的对齐、信号验证、ffill陷阱）
- 休市日收益率 = 0%（正确）
- 无 NaN 传播
## 架构设计
- shared/data/alignment.py - 对齐器实现
- shared/data/schemas.py - Pydantic Schema 定义
- tests/test_alignment.py - 完整测试套件
|
2026-05-24 10:28:35 +08:00 |
|
|
|
908b28473f
|
feat(framework_v2): 创建框架V2骨架 - 三层架构+因子验证通过
## 架构设计
- 三层架构：core(抽象接口) → shared(通用实现) → tests(验证测试)
- 5个核心抽象基类：StrategyBase, FactorBase, SignalGenerator, Executor, DataFetcher
- 零侵入：与现有框架并行开发，不修改生产代码
## 已完成
✓ 核心接口层（5个ABC类）
✓ 通用因子层（MomentumFactor完全复制现有逻辑）
✓ 对比验证测试（新旧因子输出差异=0，测试通过）
## 验证结果
- 最大差异: 0.000000e+00
- 平均差异: 0.000000e+00
- 容差: < 1e-10
## 下一步
- 阶段3: 信号层迁移（TopNSelector, DynamicThreshold, RebalanceController）
- 阶段4: 执行层迁移（BacktestRunner）
- 阶段5: 数据层迁移（DataFetcher实现）
- 阶段6: 完整策略对比验证
## 设计原则
- 按需抽象，不预先设计
- 职责分离，避免框架膨胀
- 测试驱动，每个组件必须有对比测试
- 渐进式迁移，验证通过再替换
|
2026-05-24 09:12:29 +08:00 |
|
