# tank-quantization

**Repository Path**: private-codeing/tank-quantization

## Basic Information

- **Project Name**: tank-quantization
- **Description**: 量化工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-22
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tank Quant 量化交易平台

> 面向个人量化交易者和投资团队的全栈量化交易系统

## 📋 项目概述

Tank Quant 提供从数据获取、策略研发、回测验证到收益分析的完整闭环。

### 核心功能
- 📈 **回测引擎**：事件驱动 + 向量化混合模式，支持 A 股 T+1、涨跌停、佣金印花税
- 🔍 **选股引擎**：多因子、多条件组合筛选，支持条件选股/因子选股
- 📊 **收益报表**：全仓总览 → 策略报表 → 个股明细，三层归因
- ⭐ **股票评分**：五维评分体系（估值/成长/质量/技术/资金），自定义权重
- 🛠️ **策略管理**：策略创建、编辑、版本管理和内置模板库

## 🛠️ 技术栈

| 层次 | 技术 |
|------|------|
| 前端 | React 18 + TypeScript + Ant Design 5 + ECharts 5 |
| 后端 | Python FastAPI + SQLAlchemy + Celery |
| 数据库 | MySQL 8.0 + Redis |
| 数据源 | AKShare |
| 语言 | Python / TypeScript |

## 🚀 快速开始

```bash
# 1. 克隆
git clone https://gitee.com/private-codeing/tank-doc.git
cd tank-doc

# 2. 创建 MySQL 数据库
mysql -u root -p -e "CREATE DATABASE tank_quant CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'tank'@'localhost' IDENTIFIED BY 'tank123'; GRANT ALL PRIVILEGES ON tank_quant.* TO 'tank'@'localhost'; FLUSH PRIVILEGES;"

# 3. 启动后端（必须使用虚拟环境）
cd backend
cp .env.example .env
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# 4. 启动前端（新终端）
cd frontend
npm install
npm run dev
```

- 前端：http://localhost:3000
- API 文档：http://localhost:8000/docs

> 详见 [运行指南.md](运行指南.md)

## 📁 文档结构

```
docs/
├── 01-市场分析报告.md        # 8个主流量化工具对比分析
├── 02-系统架构设计.md        # 技术架构与模块设计
├── 03-产品需求文档.md        # PRD - 用户故事与功能需求
├── 04-API接口文档.md         # RESTful API 设计
├── 05-数据库设计.md          # 核心表结构 DDL
├── 06-数据库设计-详细版.md   # 详细版（含安全/备份）
├── 07-股票评分系统设计.md    # 五维评分体系设计
├── 08-GhostAlpha整合方案.md  # 已有模块复用方案
├── 09-数据源与数据架构.md    # 数据采集与存储架构
└── 10-策略设计与信号生成.md  # 策略框架与内置策略详解
```

## 📁 项目结构

```
tank-doc/
├── backend/                 # 后端 (FastAPI + MySQL)
│   ├── app/
│   │   ├── main.py          # 入口
│   │   ├── api/v1/          # 路由: auth / strategies / backtest / screening / reports / data_sync
│   │   ├── core/            # 配置 / 数据库 / 认证 / Celery
│   │   ├── engine/          # 回测引擎 / 选股引擎
│   │   ├── models/          # SQLAlchemy 模型
│   │   ├── schemas/         # Pydantic Schemas
│   │   └── services/        # 数据采集 + 同步
│   ├── requirements.txt
│   └── .env.example
├── frontend/                # 前端 (React + Ant Design)
│   └── src/
│       ├── pages/           # Dashboard / Backtest / Strategy / Screening / Scoring / Reports
│       ├── api/             # Axios 客户端
│       ├── store/           # Zustand 状态
│       └── types/           # TypeScript 类型
├── docs/                    # 设计文档
├── prototype/               # HTML 原型
├── examples/                # 示例代码
└── im/                      # IM 模块（独立）
```

## 📄 License

MIT