first commit

docs/deployment/README.md

@@ -0,0 +1,101 @@
+# 部署文档
+
+## 版本信息
+
+- 版本: 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)
+- 初始版本
+- 添加部署文档
+