docs: DRY开发规范 and v1.3.1 SOP update

2026-04-24 10:33:32 +08:00
parent a33a5532cc
commit ad621d9426
1 changed files with 17 additions and 0 deletions
@@ -21,6 +21,23 @@
 > **使脚本执行失败时：修复脚本，而非绕过脚本。**
 ### 双备份先行原则（铁律 - 新增）
 > **在双备份（本地 `releases/v{version}/bk/` + 服务器 `/opt/piano-plan/releases/v{version}/bk/`）全部完成之前，禁止执行任何实质性的部署操作。**
 以下操作在双备份完成前**严禁**执行：
 - ❌ 更新/修改生产数据库 schema
 - ❌ 停止旧 Docker 容器
 - ❌ 启动新 Docker 容器
 - ❌ 上传/覆盖生产环境数据
 - ❌ 加载新镜像到服务器
 正确流程：
 1. ✅ 完成本地 `releases/v{version}/bk/` 备份
 2. ✅ 完成服务器 `/opt/piano-plan/releases/v{version}/bk/` 备份
 3. ✅ **验证两份备份均存在且完整**
 4. ✅ **方可执行部署操作**
 | 错误行为 | 正确行为 |
 |---------|---------|
 | 脚本报错 → `docker rm` 手动清理 | 脚本报错 → 查看日志 → 修复脚本问题 → 重跑脚本 |