# Docker 快速启动指南

## 前置要求

- 安装 [Docker Desktop](https://www.docker.com/products/docker-desktop)

## 启动步骤

### 1. 启动数据库

Windows:
```bash
start-db-only.bat
```

或者手动启动：
```bash
docker run -d --name market_data_postgres \
    -e POSTGRES_USER=postgres \
    -e POSTGRES_PASSWORD=postgres123 \
    -e POSTGRES_DB=marketdata \
    -p 5432:5432 \
    postgres:15-alpine
```

### 2. 初始化数据库表

```bash
python test_db.py
```

输出示例：
```
==================================================
数据库连接测试
==================================================
✅ 数据库连接成功
   PostgreSQL 版本: PostgreSQL 15.5 on x86_64-pc-linux-musl...

正在初始化数据库表...
✅ 数据库表创建成功

已创建的表 (13 个):
   - data_quality_checks
   - data_source_config
   - futures_klines_1d
   - futures_klines_1m
   - futures_symbols
   - futures_trading_calendar
   - stock_klines_1d
   - stock_klines_1m
   - stock_klines_5m
   - stock_symbols
   - stock_trading_calendar
   ...

==================================================
数据库初始化完成！
==================================================
```

### 3. 启动服务

```bash
python -m app.main
```

## 验证服务

打开浏览器访问：
- http://localhost:8080/admin - 管理后台
- http://localhost:8080/docs - API 文档

## 完整 Docker Compose 启动

一键启动所有服务（数据库 + Redis + 应用）：

```bash
docker compose up -d
```

查看日志：
```bash
docker compose logs -f
```

停止服务：
```bash
docker compose down
```

## 故障排查

### 问题 1: 端口被占用

错误：
```
Bind for 0.0.0.0:5432 failed: port is already allocated
```

解决：
```bash
# 查看占用端口的进程
netstat -ano | findstr 5432

# 停止冲突的容器
docker stop <container_id>
```

### 问题 2: 数据库连接失败

检查步骤：
```bash
# 1. 检查容器是否运行
docker ps | findstr postgres

# 2. 查看容器日志
docker logs market_data_postgres

# 3. 测试连接
docker exec -it market_data_postgres pg_isready -U postgres
```

### 问题 3: 表未创建

手动初始化：
```bash
python test_db.py
```

## 数据持久化

数据存储在 Docker 卷中：

```bash
# 查看卷
docker volume ls

# 备份数据
docker exec -it market_data_postgres pg_dump -U postgres marketdata > backup.sql

# 恢复数据
docker exec -i market_data_postgres psql -U postgres marketdata < backup.sql
```

## 完全重置

删除所有数据并重新启动：

```bash
# 停止并删除容器
docker compose down -v

# 重新启动
docker compose up -d

# 初始化表
python test_db.py
```