# 期货统一数据平台

期货行情统一数据平台，对接多个数据源（Tushare/CTP等），提供统一的数据出口。

## 功能

- **数据源管理**: 可配置启用/禁用的数据源，优先级管理
- **历史K线**: 日K/周K/60m/30m/15m/5m 数据存储与查询
- **合约管理**: 合约信息同步与查询
- **管理后台**: 数据源监控、接口测试、K线展示
- **RESTful API**: 统一的数据接口供其他系统调用

## 快速开始

### 1. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env，填入你的 Tushare Token
```

### 2. Docker 启动

```bash
docker compose up -d --build
```

启动后访问：
- 管理后台: http://localhost:3000
- 后端API: http://localhost:8000
- API文档: http://localhost:8000/docs

### 3. 初始配置

1. 打开 http://localhost:3000
2. 进入"数据源监控"页面
3. 点击 tushare 行的"配置"按钮，填入你的 Tushare Token
4. 点击"测试连接"确认
5. 开启"启用"开关

## 项目结构

```
├── backend/                 # 后端 (FastAPI + SQLAlchemy)
│   ├── app/
│   │   ├── main.py          # 入口 & API路由
│   │   ├── config.py        # 配置
│   │   ├── database.py      # 数据库连接
│   │   ├── models/          # 数据库模型
│   │   ├── schemas/         # Pydantic 模型
│   │   ├── services/        # 业务逻辑
│   │   │   ├── datasource/  # 数据源适配器
│   │   │   ├── kline_service.py
│   │   │   └── contract_service.py
│   │   └── api/
│   └── requirements.txt
├── frontend/                # 前端 (Vue3 + Element Plus)
│   ├── src/
│   │   ├── views/           # 页面
│   │   └── api/             # API调用
│   └── package.json
├── docker-compose.yml
└── .env
```

## API 接口

### 合约
- `GET /api/v1/contracts` - 合约列表
- `GET /api/v1/contracts/{symbol}` - 合约详情
- `POST /api/v1/contracts/sync` - 同步合约

### K线
- `GET /api/v1/kline?symbol=rb2401&period=daily&limit=100` - 查询K线
- `POST /api/v1/kline/sync` - 同步K线数据

### 数据源
- `GET /api/v1/datasources` - 数据源列表
- `PUT /api/v1/datasources/{name}` - 更新配置
- `POST /api/v1/datasources/{name}/test` - 测试连接

## 技术栈

| 层次 | 技术 |
|------|------|
| 后端 | Python / FastAPI / SQLAlchemy |
| 数据库 | PostgreSQL + TimescaleDB |
| 缓存 | Redis |
| 前端 | Vue3 / Element Plus / ECharts |
| 部署 | Docker Compose |