|
|
# 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
|
