# AmazingData 数据服务平台

基于 AmazingData SDK 的企业级数据服务平台，提供股票、期货 K 线数据获取和实时订阅服务。

## 功能特性

### 1. 单只品种查询
- 输入：品种代码（股票/期货）、交易日、周期、保存路径
- 输出：JSON 格式数据保存到指定目录

### 2. 批量股票获取
- 输入：股票代码列表、交易日列表、保存路径
- 输出：以每个交易日为文件名的 JSON 数据

### 3. 批量期货获取
- 输入：期货品种代码、交易日列表、保存路径
- 输出：以每个交易日为文件名的 JSON 数据

### 4. 实时订阅（股票）
- 输入：股票代码、订阅周期、保存路径
- 输出：按时间命名的实时数据文件

### 5. 实时订阅（期货）
- 输入：期货代码、订阅周期、保存路径
- 输出：按时间命名的实时数据文件

### 6. 批量品种订阅
- 支持同时订阅多个品种
- 支持多周期订阅

## 技术栈

- **后端**: FastAPI + SQLAlchemy + MySQL
- **前端**: Vue 3 + Vite + Element Plus
- **数据源**: AmazingData SDK
- **部署**: Docker + Docker Compose

## 快速开始

### 环境要求

- Python 3.11+
- Node.js 18+
- MySQL 8.0+
- AmazingData SDK

### 本地开发

#### 1. 后端

\\\ash
cd amazingdata_platform

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r backend/requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件

# 启动服务
uvicorn backend.main:app --reload --port 8000
\\\

#### 2. 前端

\\\ash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
\\\

### Docker 部署

\\\ash
# 构建并启动
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止
docker-compose down
\\\

## 项目结构

\\\
amazingdata_platform/
├── backend/                    # 后端服务
│   ├── api/                   # API 路由
│   │   ├── auth.py           # 认证接口
│   │   ├── historical.py     # 历史数据接口
│   │   ├── realtime.py       # 实时订阅接口
│   │   ├── batch.py          # 批量操作接口
│   │   ├── cache.py          # 缓存管理接口
│   │   └── settings.py       # 系统配置接口
│   ├── auth/                  # 认证模块
│   ├── models/                # 数据模型
│   ├── services/              # 业务逻辑
│   ├── config.py              # 配置
│   └── main.py                # 主应用
├── frontend/                   # 前端应用
│   ├── src/
│   │   ├── api/              # API 请求
│   │   ├── router/           # 路由
│   │   ├── stores/           # 状态管理
│   │   └── views/            # 页面组件
│   └── package.json
├── database/                   # 数据库
│   └── init.sql               # 初始化脚本
├── docker-compose.yml          # Docker 配置
├── Dockerfile.backend          # 后端 Dockerfile
├── Dockerfile.frontend         # 前端 Dockerfile
└── nginx.conf                  # Nginx 配置
\\\

## API 文档

启动服务后访问 \http://localhost:8000/docs\ 查看 Swagger API 文档。

### 主要接口

| 接口 | 方法 | 描述 |
|------|------|------|
| \/api/v1/auth/login\ | POST | 用户登录 |
| \/api/v1/historical/single\ | POST | 获取单只品种数据 |
| \/api/v1/historical/batch-stocks\ | POST | 批量获取股票数据 |
| \/api/v1/historical/batch-futures\ | POST | 批量获取期货数据 |
| \/api/v1/realtime/subscribe\ | POST | 创建实时订阅 |
| \/api/v1/realtime/tasks\ | GET | 获取订阅任务列表 |
| \/api/v1/realtime/stop/{id}\ | POST | 停止订阅任务 |
| \/api/v1/batch/execute\ | POST | 执行批量任务 |
| \/api/v1/batch/tasks\ | GET | 获取批量任务列表 |
| \/api/v1/cache/list\ | GET | 获取缓存文件列表 |
| \/api/v1/cache/stats\ | GET | 获取缓存统计 |
| \/api/v1/settings/amazing-data/config\ | GET | 获取 AmazingData 配置 |
| \/api/v1/settings/test-connection\ | POST | 测试连接 |

## 使用示例

### 获取单只股票数据

\\\ash
curl -X POST http://localhost:8000/api/v1/historical/single \
  -H \
Content-Type:
application/json\ \
  -d '{
    \code\: \000001.SZ\,
    \trading_day\: \20260407\,
    \period\: \day\,
    \save_path\: \./data/single\
  }'
\\\

### 创建实时订阅

\\\ash
curl -X POST http://localhost:8000/api/v1/realtime/subscribe \
  -H \Content-Type:
application/json\ \
  -d '{
    \codes\: [\ag2605.SHF\],
    \periods\: [\min1\, \min5\],
    \save_path\: \./data/realtime\,
    \duration\: 3600
  }'
\\\

## 默认账号

- 管理员: admin / admin123
- 普通用户: user / user123

## 许可证

MIT License