docs: 记录开发服务器版本化迁移部署与回滚点

2026-08-13 23:46:37 +08:00
parent a1f1e7baaa
commit f1ba6b35dc
3 changed files with 31 additions and 4 deletions
@@ -1159,3 +1159,27 @@ UPDATE cameras SET gb_channel_id = '44010201001320000001' WHERE gb_device_id = '
 - `npm run build` 通过，无 TS 诊断错误
 - 前端已部署到 `http://100.83.103.1:5174/videos`（5174 端口正常监听）
 - 编辑摄像头不再崩溃，"认证密码"正确回显，"码流类型"字段已移除且不再出现残留值
+
+---
+
+## 2026-08-13 版本化数据库迁移部署（Task 2）
+
+### 变更内容
+
+- 后端采用 `golang-migrate/migrate/v4 v4.18.2`，启动时执行 `server-go/migrations/` 下 SQL 迁移并校验 `schema_migrations`；
+- `000001_baseline` 覆盖当前 26 张业务表、索引和唯一约束，并已调整为幂等建表/建索引；
+- `database.Init` 不再无条件 AutoMigrate；生产环境忽略 `ALLOW_DEV_AUTOMIGRATE`；
+- 开发服务器 `100.83.103.1` 已从 AutoMigrate 旧二进制切换为迁移版本二进制。
+
+### 验证结果
+
+- 开发服务器后端 `:3000` 与 Web `:5174` 均监听正常，`/api/v1/health` 返回 200；
+- `schema_migrations`：`1|f`；
+- 后端日志：`数据库连接成功，版本化迁移完成 schemaVersion=1`；
+- 新二进制 SHA256：`9acb5fbfdb854b90b821d456f0f05177cd34dd8f3161686e1c472170af5d1201`。
+
+### 回滚点
+
+- 数据库备份：`/home/pan/backups/silk-20260813-234221.dump`；
+- 旧二进制：`/home/pan/silk/server-go/server-go-linux.bak-20260813-234221`；
+- 回滚步骤：恢复旧二进制并重启，或先 `pg_restore` 恢复数据库备份；开发服务器无 git 仓库，不依赖 git tag。