|
|
@@ -51,7 +51,7 @@ Draft
|
|
|
- **调度工具**: node-cron
|
|
|
- **备份工具**: PostgreSQL pg_dump/pg_restore
|
|
|
- **存储位置**: ./backups/ 目录
|
|
|
-- **日志记录**: 使用现有日志系统
|
|
|
+- **日志记录**: 使用现有debug日志系统(src/server/utils/logger.ts)
|
|
|
|
|
|
### 备份策略 [Source: architecture/infrastructure-deployment.md#数据库备份策略]
|
|
|
- **频率**: 每日凌晨2点执行完整备份
|
|
|
@@ -60,6 +60,19 @@ Draft
|
|
|
- **存储**: 本地文件系统,避免外部依赖
|
|
|
- **安全**: 备份文件权限设置为仅管理员可访问(chmod 600)
|
|
|
|
|
|
+### 监控集成 [Source: 现有日志系统]
|
|
|
+- **日志记录**: 使用现有debug日志系统(src/server/utils/logger.ts)
|
|
|
+- **监控指标**:
|
|
|
+ - 备份成功/失败状态
|
|
|
+ - 备份文件大小和生成时间
|
|
|
+ - 磁盘空间使用情况
|
|
|
+ - 备份恢复成功率
|
|
|
+- **告警规则**:
|
|
|
+ - 备份失败时发送邮件通知
|
|
|
+ - 磁盘空间不足时告警
|
|
|
+ - 备份文件异常时告警
|
|
|
+- **集成方式**: 通过现有logger.error()发送错误信息到监控系统
|
|
|
+
|
|
|
### 文件结构
|
|
|
```
|
|
|
scripts/
|
|
|
@@ -72,7 +85,30 @@ backups/ # 备份文件存储目录
|
|
|
```
|
|
|
|
|
|
### 环境变量配置
|
|
|
-需要配置数据库连接和备份调度参数
|
|
|
+需要配置以下环境变量:
|
|
|
+
|
|
|
+```bash
|
|
|
+# 数据库连接配置
|
|
|
+DB_HOST=localhost
|
|
|
+DB_PORT=5432
|
|
|
+DB_NAME=postgres
|
|
|
+DB_USER=postgres
|
|
|
+DB_PASSWORD=postgres
|
|
|
+
|
|
|
+# 备份调度配置
|
|
|
+BACKUP_SCHEDULE="0 2 * * *" # 每天凌晨2点
|
|
|
+BACKUP_RETENTION_DAYS=7
|
|
|
+BACKUP_DIR="./backups"
|
|
|
+
|
|
|
+# 监控配置(可选)
|
|
|
+MONITORING_ENABLED=false
|
|
|
+ALERT_EMAIL=admin@example.com
|
|
|
+```
|
|
|
+
|
|
|
+**安全要求**:
|
|
|
+- 数据库密码必须通过环境变量或密钥管理服务传递
|
|
|
+- 生产环境禁止使用默认凭据
|
|
|
+- 敏感配置必须加密存储
|
|
|
|
|
|
### 测试要求
|
|
|
- 单元测试覆盖所有备份逻辑
|
|
|
@@ -96,10 +132,11 @@ backups/ # 备份文件存储目录
|
|
|
| Date | Version | Description | Author |
|
|
|
|------|---------|-------------|--------|
|
|
|
| 2025-09-19 | v1.0 | 初始故事创建 | Bob |
|
|
|
+| 2025-09-19 | v1.1 | 根据PO建议完善环境变量和监控集成 | Bob |
|
|
|
|
|
|
## Dev Agent Record
|
|
|
### Agent Model Used
|
|
|
-{{agent_model_name_version}}
|
|
|
+Claude Code d8d-model
|
|
|
|
|
|
### Debug Log References
|
|
|
|