# quant-platform

**Repository Path**: hao-shaopeng58/quant-platform

## Basic Information

- **Project Name**: quant-platform
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-05
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Quant Platform

📈 **Quant Platform** - 个人量化交易平台

基于 Docker 的量化交易系统，支持股票分析、回测、模拟交易和策略管理。

---

## ✨ 功能特性

### 📊 数据分析
- **实时行情** - A股实时数据获取与展示
- **技术分析** - K线图、指标计算、趋势分析
- **资金流向** - 主力资金、龙虎榜、板块轮动
- **基本面分析** - 财务报表、估值指标

### 🤖 策略交易
- **策略回测** - 历史数据回测验证
- **模拟交易** - 虚拟资金实盘模拟
- **智能选股** - 多因子选股器
- **预警系统** - 价格/指标异动提醒

### 🎯 特色功能
- **AI预测** - 机器学习价格预测
- **舆情监控** - 社交媒体情绪分析
- **投资组合** - 组合优化与风险分析
- **策略市场** - 分享和下载策略

---

## 🏗️ 技术架构

```
quant-platform/
├── backend/                 # Python FastAPI 后端
│   ├── app/
│   │   ├── api/            # RESTful API 路由
│   │   ├── services/       # 业务逻辑服务
│   │   └── database/       # 数据库模型
│   ├── data/               # 数据存储
│   └── main.py            # 服务入口
│
├── frontend/               # React + TypeScript 前端
│   ├── src/
│   │   ├── components/    # 业务组件
│   │   ├── pages/         # 页面组件
│   │   └── hooks/         # 自定义 Hooks
│   └── package.json
│
└── docker-compose.yml      # Docker 编排配置
```

---

## 🚀 快速开始

### 环境要求
- Docker & Docker Compose
- 4GB+ 内存
- 10GB+ 磁盘空间

### 安装部署

```bash
# 克隆项目
git clone https://github.com/Haoshaopeng/quant-platform.git
cd quant-platform

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f
```

### 访问服务
- **前端界面**: http://localhost
- **后端API**: http://localhost:8888
- **API文档**: http://localhost:8888/docs

---

## 📡 API 接口

### 股票数据
```
GET /api/stocks/{code}           # 股票基本信息
GET /api/stocks/{code}/kline     # K线数据
GET /api/stocks/{code}/realtime  # 实时行情
```

### 分析工具
```
POST /api/analysis/technical     # 技术分析
POST /api/analysis/backtest      # 策略回测
GET /api/analysis/ranking        # 股票排行
```

### 交易功能
```
POST /api/paper-trading/order    # 模拟下单
GET /api/paper-trading/position  # 持仓查询
GET /api/paper-trading/records   # 交易记录
```

---

## 🐳 Docker 部署

### 开发环境
```bash
docker-compose -f docker-compose.yml up --build
```

### 生产环境
```bash
docker-compose -f docker-compose.prod.yml up -d
```

### 服务组件
| 服务 | 端口 | 说明 |
|------|------|------|
| quant-frontend | 80 | React 前端 |
| quant-backend | 8888 | FastAPI 后端 |
| postgres | 5432 | PostgreSQL 数据库 |
| redis | 6379 | Redis 缓存 |

---

## 📊 数据源

- **akshare** - 开源财经数据接口
- **tushare** - 金融数据平台（可选）
- **实时行情** - WebSocket 推送

---

## 🔧 配置说明

### 环境变量
```bash
# 数据库配置
DATABASE_URL=postgresql://user:pass@localhost:5432/quant

# Redis配置
REDIS_URL=redis://localhost:6379/0

# API密钥（可选）
TUSHARE_TOKEN=your_token_here
```

### 数据存储
- 行情数据: `/app/data/market/`
- 用户数据: `/app/data/users/`
- 模拟交易: `/app/data/paper_trading/`

---

## 🛠️ 技术栈

| 层级 | 技术 |
|------|------|
| **前端** | React 18, TypeScript, TailwindCSS, ECharts |
| **后端** | Python 3.11, FastAPI, Uvicorn |
| **数据库** | PostgreSQL 15, Redis 7 |
| **数据源** | akshare, WebSocket |
| **部署** | Docker, Docker Compose |

---

## 📈 性能指标

- 支持 5000+ 只股票实时数据
- K线数据查询 < 100ms
- 回测计算 1000 只股票 < 30s
- WebSocket 并发连接 1000+

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

---

## 📄 许可证

MIT License

---

**⚠️ 免责声明**: 本项目仅供学习和研究使用，不构成投资建议。股市有风险，投资需谨慎。

---

**Made with ❤️ by haoshaopeng**