Explorar o código

📝 docs(stories): 完善数据库备份故事文档

- 明确日志记录系统路径为src/server/utils/logger.ts
- 新增监控集成章节,包含日志记录、监控指标、告警规则和集成方式
- 详细列出环境变量配置要求和安全规范
- 添加版本历史记录,记录文档更新信息
- 补充Agent Model使用信息为Claude Code d8d-model
yourname hai 2 meses
pai
achega
dfe00ab0c8
Modificáronse 1 ficheiros con 40 adicións e 3 borrados
  1. 40 3
      docs/stories/001.005.story.md

+ 40 - 3
docs/stories/001.005.story.md

@@ -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