# 合约数据获取逻辑

## 核心流程

系统启动后，根据合约数据使用配置的数据源获取合约具体数据的整体逻辑如下：

1. **系统初始化**：
   - 后端服务启动时加载配置文件（`config.ts`）
   - 注册市场相关API路由（`market.ts`）

2. **数据源管理**：
   - 通过`DataSourceFactory`创建和管理数据源实例
   - 支持多种数据源类型：TQSDK（实盘数据）、测试数据源（模拟数据）

3. **数据获取流程**：
   - 客户端请求市场数据时，`marketService`中的方法被调用
   - 方法首先检查数据源配置，确定使用哪个数据源
   - 尝试使用配置的数据源获取合约数据
   - 如果主数据源失败，自动切换到备用数据源
   - 处理数据并返回给客户端

4. **合约数据处理**：
   - 使用预定义的合约列表（`futuresList`）作为基础
   - 为每个合约构建完整的合约符号（如`SHFE.rb2505`）
   - 调用数据源的方法获取实时行情、K线等数据
   - 转换数据格式为前端需要的结构

## 代码位置

### 数据源管理
- **数据源工厂**：`backend/src/services/datasource/DataSourceFactory.ts`
  - 负责创建和管理数据源实例
  - 支持数据源的初始化、切换和关闭

- **数据源接口**：`backend/src/services/datasource/DataSource.ts`
  - 定义了数据源必须实现的方法，如获取合约列表、合约详情、K线数据等

- **TQSDK数据源实现**：`backend/src/services/datasource/TQDataSource.ts`
  - 基于TQSDK库实现的实盘数据源
  - 提供获取合约数据的具体方法

### 数据服务
- **市场服务**：`backend/src/services/marketService.ts`
  - 实现了获取市场概览、品种详情、K线数据等方法
  - 处理数据源的选择和切换逻辑
  - 提供数据转换和错误处理

### API接口
- **市场API**：`backend/src/api/market.ts`
  - 提供RESTful API接口，如`/api/market/overview`、`/api/market/detail/:symbol`等
  - 调用市场服务的方法获取数据并返回给客户端

### 配置管理
- **配置文件**：`backend/src/config/index.ts`
  - 存储数据源配置信息，如TQSDK的启用状态和参数

## 数据源切换机制

系统实现了智能的数据源切换机制：
1. 优先使用配置的主数据源（如TQSDK）
2. 如果主数据源失败，自动尝试使用备用数据源（如测试数据源）
3. 如果所有数据源都不可用，返回友好的错误提示

## 数据获取示例

以获取市场概览为例：
1. 客户端请求 `/api/market/overview`
2. `marketService.fetchMarketOverview()` 被调用
3. 检查数据源配置，确定使用TQSDK还是测试数据源
4. 如果使用TQSDK，创建TQSDK数据源实例并初始化
5. 遍历合约列表，为每个合约构建完整符号
6. 调用数据源的 `getTickData()` 方法获取实时行情
7. 处理数据并返回给客户端
8. 如果TQSDK失败，自动切换到测试数据源

## 技术特点

1. **工厂模式**：使用工厂模式管理数据源实例，提高代码可维护性
2. **接口隔离**：通过接口定义数据源行为，便于扩展新的数据源类型
3. **容错机制**：实现了数据源故障自动切换，提高系统可靠性
4. **配置驱动**：数据源配置通过配置文件管理，便于运维和部署
5. **模块化设计**：将数据获取逻辑与API接口分离，提高代码可读性