# 部署文档

## 版本信息

- 版本: v1.0.0
- 最后更新: 2025-01-XX
- 维护者: 运维团队

## 部署前准备

### 1. 环境要求

- Python 3.8+
- 数据库（MySQL/PostgreSQL/SQLite）
- 反向代理（Nginx，可选）

### 2. 安装依赖

```bash
# 安装生产依赖
pip install -r requirements/base.txt
pip install -r requirements/production.txt
```

### 3. 配置环境变量

```bash
# 设置生产环境
export FLASK_ENV=production

# 配置必要的环境变量
# - SECRET_KEY
# - DATABASE_URL
# - CORS_ORIGINS
```

## 部署方式

### 方式1: 使用Gunicorn

```bash
# 使用配置文件
gunicorn -c gunicorn.conf.py "src.your_app:create_app()"

# 或直接指定参数
gunicorn --bind 0.0.0.0:5000 --workers 4 "src.your_app:create_app()"
```

### 方式2: 使用uWSGI

```bash
uwsgi --ini uwsgi.ini
```

### 方式3: 使用Docker

```bash
# 构建镜像
docker build -t your_app .

# 运行容器
docker run -d -p 5000:5000 --env-file .env your_app
```

## Nginx配置示例

```nginx
server {
    listen 80;
    server_name your_domain.com;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

## 监控和日志

### 日志位置

- 应用日志: `logs/app.log`
- Gunicorn访问日志: `logs/gunicorn_access.log`
- Gunicorn错误日志: `logs/gunicorn_error.log`

### 监控建议

- 使用Supervisor管理进程
- 配置日志轮转
- 设置健康检查端点

## 变更记录

### v1.0.0 (2025-01-XX)
- 初始版本
- 添加部署文档