# 14_部署运维_日志监控_备份设计

## 1. 文档目标

本文档定义系统 B 的部署结构、服务目录、环境变量、日志、监控、备份、告警和清理策略。

## 2. 推荐部署架构

第一阶段单服务器即可：

```text
Nginx
NestJS API
BullMQ Workers
MySQL
Redis
MinIO
FFmpeg
Geeker-Admin 静态文件
uni-app H5 静态文件
```

后续可拆分：

```text
API 服务器
Worker 服务器
数据库服务器
对象存储
视频渲染服务器
```

## 3. 目录结构建议

```text
/opt/system-b/
  backend/
  admin-web/
  user-web/
  workers/
  logs/
  ffmpeg-temp/
  docker-compose.yml
  .env
```

## 4. 环境变量

```text
NODE_ENV=production
APP_PORT=3000
MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=system_b
MYSQL_PASSWORD=xxx
MYSQL_DATABASE=system_b
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
MINIO_ENDPOINT=127.0.0.1
MINIO_PORT=9000
MINIO_ACCESS_KEY=xxx
MINIO_SECRET_KEY=xxx
JWT_SECRET=xxx
OPENAI_API_KEY=xxx
```

Provider 密钥建议使用密钥管理或环境变量，不直接写入数据库明文。

## 5. Nginx 配置目标

反代：

```text
/api → NestJS
/admin → Geeker-Admin
/ → uni-app H5
/ws → WebSocket
```

静态文件不直接暴露 MinIO 私密 bucket。

## 6. 进程管理

可选：

- PM2
- systemd
- Docker Compose

服务：

```text
api-server
worker-photo
worker-text
worker-image
worker-video
worker-ffmpeg
worker-qc
```

## 7. 日志设计

日志类型：

```text
api.log
worker.log
error.log
provider.log
payment.log
ffmpeg.log
audit.log
```

日志要求：

- 按天切割
- 保留 30-90 天
- 敏感信息脱敏
- 重要错误报警

## 8. 监控指标

应用指标：

- API 响应时间
- API 错误率
- 队列积压数
- 任务失败率
- Provider 失败率
- 视频合成耗时

系统指标：

- CPU
- 内存
- 磁盘
- 网络
- MinIO 容量
- MySQL 连接数
- Redis 内存

业务指标：

- 今日订单数
- 今日收入
- 今日 AI 成本
- 项目完成数
- 待审核数

## 9. 告警规则

触发：

- API 5xx 错误率过高
- 队列积压超过阈值
- Provider 连续失败
- 磁盘剩余空间低于 20%
- MinIO 容量不足
- MySQL 备份失败
- 单日 AI 成本超阈值

## 10. 数据库备份

建议：

```text
每日全量备份
每小时 binlog 增量
备份保留 7-30 天
定期恢复演练
```

备份目录：

```text
/backups/mysql/YYYY-MM-DD/
```

## 11. MinIO 备份

策略：

- 重要成品每日同步
- 用户原图按隐私策略备份
- 临时文件不备份
- 公开案例单独备份

## 12. Redis 持久化

Redis 用于队列和缓存：

- 开启 AOF 或 RDB
- 定期检查内存
- 设置合适 maxmemory 策略

## 13. 临时文件清理

清理对象：

- FFmpeg 临时文件
- 预览临时素材
- 失败任务中间文件
- 过期下载包

策略：

```text
每晚 cleanup_queue 执行
临时文件保留 1-3 天
失败任务文件保留 7 天
```

## 14. 项目素材保留策略

建议：

| 类型 | 保留 |
|---|---|
| 用户上传原图 | 按用户协议，默认 90-180 天或项目删除后清理 |
| 预览图 | 30 天 |
| 正式图 | 180 天或长期，按套餐 |
| 成品视频 | 180 天或长期，按套餐 |
| 公开案例 | 授权有效期间保留 |

## 15. 发布流程

```text
代码提交
→ 自动测试
→ 构建后端
→ 构建后台
→ 构建用户端
→ 数据库迁移
→ 灰度发布
→ 检查日志
→ 正式发布
```

## 16. 回滚方案

必须保留：

- 上一个后端版本
- 上一个前端静态包
- 数据库迁移回滚脚本
- 配置备份

## 17. 安全要求

- HTTPS
- 后台登录二次验证，后续可加
- 密钥不提交代码仓库
- 上传文件类型限制
- API 限流
- 防刷验证码
- 后台操作日志