R24-0 R24-3 R24-4: 完成同机部署文档与验收收口

deploy/trialrun/checklist.md

@@ -2,6 +2,18 @@
 
 > 目标：一次发布可追踪、可回归、可回滚（10 分钟内恢复到上个版本）。
 
+## 0. 同机官网部署最小步骤
+- [ ] 已确认官网继续走 `hyinda.com / www.hyinda.com`，OA 使用独立二级域名（建议 `oa.hyinda.com`）
+- [ ] 服务器已执行 `bash deploy/trialrun/setup-server.sh`
+- [ ] 已在服务器创建 OA 目录（默认 `/opt/hyb-oa-trialrun`）
+- [ ] 已准备 `deploy/trialrun/.env`，并将 `APP_ORIGIN` 改为 OA 公网域名
+- [ ] 已将 `COOKIE_SECURE` 设为 `true`
+- [ ] 已将 OA Nginx 配置放到 `/etc/nginx/sites-available/hyb-oa`
+- [ ] 已上传 OA 域名证书到 `/etc/nginx/ssl/<oa-domain>/`
+- [ ] 已执行 `nginx -t && systemctl reload nginx`
+- [ ] 已从本地执行 `bash deploy/trialrun/deploy.sh`
+- [ ] 已通过 `https://<oa-domain>/ready` 或首页登录完成最小探活
+
 ## A. 发布前（Pre-flight）
 - [ ] 确认当前版本已打 tag：`git tag -a trialrun-YYYYMMDD-NN -m "trialrun release"`
 - [ ] 本地门禁：`./scripts/check-minimal.sh`

deploy/trialrun/runbook.md

@@ -2,6 +2,17 @@
 
 > 目标：按本文档在一台新机器完成 **启动 → 迁移 → 初始化管理员 → 验收 → 备份 → 恢复 → 回滚** 演练。
 
+## 0A. 如果官网 `hyb-web` 已在同机运行（推荐方案）
+- 官网继续保持 `hyinda.com / www.hyinda.com` 静态托管，不要改官网目录和配置。
+- OA 新增独立二级域名，例如 `oa.hyinda.com`。
+- OA 推荐部署目录：`/opt/hyb-oa-trialrun`。
+- OA 推荐访问方式：`Nginx(443) -> 127.0.0.1:3000 -> docker compose(server)`。
+- 首次初始化时：
+  1. 服务器以 root 执行 `bash deploy/trialrun/setup-server.sh`
+  2. 手工创建 `deploy/trialrun/.env`
+  3. 手工放置 OA 的 Nginx 站点配置和证书
+  4. 本地执行 `bash deploy/trialrun/deploy.sh`
+
 ## 0. 前置条件
 - Docker + Docker Compose（v2）
 - 机器时间正确（影响 token / cron / OCR）