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/ 例外
- 允许提交对齐器相关文件
This commit is contained in:
2026-05-24 10:29:20 +08:00
parent a16681bda9
commit 5f08e508ac
6 changed files with 2613 additions and 4 deletions

View File

@@ -20,6 +20,15 @@ framework_v2/
---
## 📚 文档
- **[数据架构方案](DATA_ARCHITECTURE.md)** - 完整的数据架构设计Schema、验证、性能优化
- **[跨市场对齐方案](ALIGNMENT_GUIDE.md)** - CrossMarketAligner 使用指南
- **[数据流完整推演](DATA_FLOW_DEMO.md)** - 从 OHLCV 到最终收益的 7 个阶段推演
- **[Aligner + Schema 整合方案](ALIGNMENT_SCHEMA_INTEGRATION.md)** - Pydantic Schema 与对齐器结合使用
---
## 🏗️ 目录结构
```
@@ -37,10 +46,15 @@ framework_v2/
├── shared/ # 通用实现
│ ├── __init__.py
── factors/
├── __init__.py
├── talib_base.py # TALibFactorBase (需要 talib)
└── momentum.py # 动量因子(已验证✓)
── factors/
├── __init__.py
├── talib_base.py # TALibFactorBase (需要 talib)
└── momentum.py # 动量因子(已验证✓)
│ ├── data/
│ │ ├── __init__.py
│ │ └── alignment.py # 跨市场对齐器(已验证✓)
│ └── signals/ # 待实现
│ └── ...
└── tests/ # 测试
├── __init__.py
@@ -64,6 +78,14 @@ framework_v2/
- [x] MomentumFactor - 动量因子(完全复制现有逻辑)
- [x] 对比验证测试(通过✓,差异 = 0
### 阶段2.5: 数据对齐层 ✓
- [x] CrossMarketAligner - 跨市场数据对齐器
- [x] 解决 ffill 陷阱(价格 vs 收益率)
- [x] 解决跨市场日历不对齐
- [x] 解决 NaN 传播问题
- [x] 完整测试套件5/5 通过✓)
---
## 🎯 验证结果