基于 Backtrader 的现代化量化交易管理平台
Backtrader Web 是一个为量化交易开发者打造的全功能量化交易管理平台，提供：
- 🚀 开箱即用 - 5分钟完成首次回测
- 📊 专业图表 - Echarts K线图 + 10+ 分析图表
- 🔌 API优先 - RESTful API 100% 覆盖
- 💾 多数据库 - 支持 SQLite/PostgreSQL/MySQL/MongoDB
- 🎯 策略管理 - 策略版本控制 + 代码编辑器
- 📈 模拟交易 - 完整的模拟交易环境
- 🔴 实盘交易 - 多券商实盘对接
- 📡 实时行情 - WebSocket 实时推送
- 🚨 监控告警 - 实时监控和告警系统
| 层级 | 技术 |
|---|---|
| 前端 | Vue 3 + TypeScript + Vite + Element Plus + Echarts |
| 后端 | FastAPI + Uvicorn + Pydantic + SQLAlchemy 2.0 |
| 数据库 | SQLite (默认) / PostgreSQL / MySQL / MongoDB |
| 回测引擎 | Backtrader + fincore (标准化指标) |
| 测试 | pytest + Playwright (E2E) + Vitest (前端) |
- Python 3.10+
- Node.js 20+
# 克隆项目
git clone https://gitee.com/xxx/backtrader_web.git
cd backtrader_web
# 步骤 1：安装前环境检查
./scripts/verify-dev-env.sh --preinstall
# 该脚本会检查 Node.js、Python 版本等系统级前置条件
# 如果检查失败，请先修复环境问题
# 步骤 2：安装项目依赖
# 后端
cd src/backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -e ".[dev,backtrader]"
cp .env.example .env
# 安装后环境检查（可选，但推荐）
# 返回项目根目录再次运行校验，确认依赖安装正确
cd ../..
./scripts/verify-dev-env.sh --postinstall
# 该脚本会检查 backtrader、FastAPI 等依赖是否可用
# 前端（新终端）
cd src/frontend
npm ci- 前端: http://localhost:3000
- 后端 API 文档: http://localhost:8000/docs
backtrader_web/
├── src/
│ ├── backend/ # FastAPI 后端
│ │ ├── app/
│ │ │ ├── api/ # API 路由
│ │ │ ├── services/ # 业务逻辑
│ │ │ ├── db/ # 数据库层
│ │ │ ├── models/ # ORM 模型
│ │ │ └── schemas/ # Pydantic 模型
│ │ └── strategies/ # 内置策略
│ └── frontend/ # Vue3 前端
│ ├── src/
│ │ ├── api/ # API 调用
│ │ ├── components/ # 组件
│ │ ├── views/ # 页面
│ │ └── stores/ # Pinia 状态
│ └── package.json
├── strategies/ # 118 内置策略模板
├── examples/ # API 调用示例 (12 个)
├── tests/e2e/ # Playwright E2E 测试 (13 个文件)
└── docs/ # 30+ 篇文档
└── INDEX.md # 文档导航
环境变量配置 (.env):
# 数据库 (默认SQLite，无需额外安装)
DATABASE_TYPE=sqlite
DATABASE_URL=sqlite:///./backtrader.db
# 可选: 使用 PostgreSQL
# DATABASE_TYPE=postgresql
# DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/backtrader
# JWT 配置
SECRET_KEY=your-secret-key
JWT_EXPIRE_MINUTES=1440详细文档请查看: docs/INDEX.md
- 综合技术文档 - 系统功能概览、API 模块、数据模型、部署运维
- 安装指南 - 环境配置和安装
- 快速上手 - 5分钟完成首次回测
- API 文档 - RESTful API 接口说明
- 开发指南 - 本地开发环境配置
- 架构设计 - 整体架构设计
- 数据库设计 - 数据模型和关系
- 安全指南 - 安全最佳实践
- 策略开发 - 如何编写交易策略
- 更新日志 - 版本更新记录
请参阅 CONTRIBUTING.md 获取完整贡献指南。