docs(framework_v2): 更新 FlaskAPIFetcher 文档(API 日历集成)

## 使用指南更新(FLASK_API_FETCHER_GUIDE.md)
- get_trading_calendar() 方法签名更新
  - 新增 start, end 参数(支持动态日期范围)
  - 返回类型: pd.DatetimeIndex(准确日历)
- 使用示例更新(API 调用方式)
- 注意事项更新:交易日历准确性  已解决

## 架构设计更新(FLASK_API_FETCHER_ARCHITECTURE.md)
- get_trading_calendar() 实现更新
  - 从临时 pandas BDay → API 准确日历
  - API 端点: GET /api/v1/trading-calendar
- 未来优化: 移除交易日历 TODO(已完成)

## 文档一致性
- 所有示例代码使用 API 日历
- 架构描述与实际实现一致
- 版本历史更新(2024-04-16)
This commit is contained in:
2026-05-24 12:38:55 +08:00
parent b462c0520c
commit 99d3584d05
2 changed files with 26 additions and 20 deletions

View File

@@ -286,18 +286,23 @@ python framework_v2/tests/test_flask_api_fetcher.py
### 1. 交易日历准确性
**当前问题**:使用 pandas `bdate_range` 生成近似日历,未考虑节假日
**已解决**:通过 API 获取准确交易日历
**优化方案**
**实现**
```python
# TODO: 通过 API 获取准确日历
def get_trading_calendar(self, market: str) -> pd.Index:
# 1. 调用 API 端点
# 2. 或从数据库查询
# 3. 或加载本地日历文件
pass
def get_trading_calendar(self, market, start, end):
# 调用 API 获取准确日历
calendar = self._source.get_trading_calendar(
market=market,
start_date=start,
end_date=end
)
return calendar
```
**API 端点**`GET /api/v1/trading-calendar`
**返回**:准确的 DatetimeIndex包含节假日处理
### 2. 缓存机制
**当前问题**:每次请求都调用 API重复获取相同数据。