docs: 记录开发服务器整改基线部署与回滚点

开发交接记录.md

@@ -1200,3 +1200,34 @@ MVP 沿用 IoTDB（现状）；TDengine 作为生产规模化候选（先基准
 
 - 合并回滚：`dev_wjs` 可回到 `1b8cab1`（合并前基线）；
 - 后续部署需在服务器先打 `pre-<timestamp>` tag、备份数据库，再上传二进制和 `web/dist`。
+
+## 2026-08-14 开发服务器部署（整改基线）
+
+### 做了什么
+
+- 完成 `dev_wjs` 整改基线首次开发服务器部署；
+- 数据库已全量备份：`/home/pan/backups/silk-20260814-191754.dump`；
+- Go 后端已切换到修复后二进制，schema 迁移到 `schemaVersion=8`；Web 和 AI 服务已同步更新；
+- 部署中发现并修复 `outbox.Start` 阻塞主流程问题：改为后台 goroutine，提交 `3d49c03`。
+
+### 设计思路与决策依据
+
+- 服务器应用目录无 git 仓库，采用二进制和 `web/dist` 制品部署，并在覆盖前保留旧制品；
+- 数据库涉及多批 schema 变更，部署前先执行 `pg_dump`，满足回滚要求；
+- AI 服务继续 mock 模式，部署前保留原 `app` 目录以便回滚。
+
+### 验证结果
+
+- Go `/api/v1/health` 200；Web `:5174` 200；AI `/health` 200；
+- 新路由未登录返回 401：`/detection-tasks`、`/disease-events`、`/ops/metrics`、`/health-profiles/:id/effect`、`POST /biosecurity/qr/resolve`；
+- 后端日志显示 `schemaVersion=8` 和正常启动，无 panic；
+- IoTDB 仍不可用并降级 PostgreSQL，属部署前已知状态；
+- 默认 admin 登录失败，未做需登录的新接口全量冒烟。
+
+### 回滚点
+
+- 数据库：`/home/pan/backups/silk-20260814-191754.dump`；
+- Go 旧二进制：`/home/pan/silk/server-go/server-go-linux.pre-20260814-191754`；
+- Go 修复前问题二进制：`/home/pan/silk/server-go/server-go-linux.broken-20260814-1921`；
+- Web 旧目录：`/home/pan/silk/web/dist.pre-20260814-191754`；
+- AI 旧目录：`/home/pan/ai-service/app.pre-20260814-191754`、`tests.pre-20260814-191754`。