|
|
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 |
|
|
|
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 |
|