# 快速开始指南

## 1. 数据库初始化

```bash
# 创建数据库
mysql -u root -p < backend/database/init.sql

# 或手动执行
mysql -u root -p
source backend/database/init.sql;
```

## 2. 初始化配置到数据库

```bash
cd backend
python init_config.py
```

这将把 `config.py` 中的配置迁移到数据库。

## 3. 启动后端服务

```bash
cd backend

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

# 配置数据库（方式1：使用.env文件，推荐）
cp .env.example .env
# 编辑 .env 文件，设置数据库连接信息

# 或方式2：使用环境变量
export DB_HOST=localhost
export DB_PORT=3306
export DB_USER=root
export DB_PASSWORD=your_password
export DB_NAME=auto_trade_sys

# 启动
uvicorn api.main:app --host 0.0.0.0 --port 8000 --reload

# 或使用启动脚本
chmod +x start.sh
./start.sh
```

访问 API 文档：http://localhost:8000/docs

## 4. 启动前端

```bash
cd frontend

# 安装依赖
npm install

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

访问前端：http://localhost:3000

## 5. 安装交易系统依赖

### 方式1：使用安装脚本（推荐）

```bash
cd trading_system
./setup.sh
```

### 方式2：使用项目根目录虚拟环境

```bash
# 如果项目根目录已有虚拟环境
source .venv/bin/activate  # 从项目根目录
cd trading_system
pip install -r requirements.txt
```

### 方式3：手动创建虚拟环境

```bash
cd trading_system
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

## 6. 启动交易系统

```bash
# 确保虚拟环境已激活
source .venv/bin/activate  # 从项目根目录
# 或 source ../.venv/bin/activate  # 从trading_system目录

# 进入trading_system目录
cd trading_system
python main.py

# 或从项目根目录运行
python -m trading_system.main
```

## 配置说明

### 1小时主周期配置

配置已更新为1小时主周期：
- **主周期**: 1小时
- **确认周期**: 4小时
- **入场周期**: 15分钟
- **扫描间隔**: 1小时

### 通过前端修改配置

1. 访问 http://localhost:3000/config
2. 修改任意配置项
3. 配置会自动保存到数据库
4. 交易系统会在下次扫描时读取新配置

### 配置分类

- **市场扫描**: 扫描间隔、K线周期等
- **仓位控制**: 单笔仓位、总仓位限制
- **风险控制**: 止损、止盈
- **策略参数**: 信号强度、杠杆等
- **API配置**: API密钥、测试网设置

## 数据统计

访问前端查看：
- **仪表板**: 实时账户和持仓信息
- **交易记录**: 历史交易和统计
- **配置管理**: 可视化配置界面

## 注意事项

1. **数据库连接**: 确保MySQL服务运行，数据库已创建
2. **API密钥**: 在配置界面设置API密钥（或使用环境变量）
3. **端口冲突**: 确保8000（后端）和3000（前端）端口未被占用
4. **配置同步**: 前端修改配置后，交易系统需要重启或等待下次扫描

## 故障排查

### 后端无法连接数据库

检查环境变量：
```bash
echo $DB_HOST
echo $DB_NAME
```

### 前端无法连接后端

检查 `frontend/.env` 文件：
```
VITE_API_URL=http://localhost:8000
```

### 交易系统无法读取配置

确保：
1. 数据库已初始化
2. 已运行 `python backend/init_config.py`
3. `backend/` 目录存在
