R26-4 R26-5: 优化开关报错并补部署检查清单

deploy/trialrun/checklist.md

@@ -8,6 +8,8 @@
 - [ ] 已在服务器创建 OA 目录（默认 `/opt/hyb-oa-trialrun`）
 - [ ] 已准备 `deploy/trialrun/.env`，并将 `APP_ORIGIN` 改为 OA 公网域名
 - [ ] 已将 `COOKIE_SECURE` 设为 `true`
+- [ ] 已确认 `deploy/trialrun/.env` 作为部署事实源，新增环境变量优先补到该文件
+- [ ] 已尽量使用无引号 env 值；历史带引号值当前兼容，但建议逐步清理
 - [ ] 已将 OA Nginx 配置放到 `/etc/nginx/sites-available/hyb-oa`
 - [ ] 已上传 OA 域名证书到 `/etc/nginx/ssl/<oa-domain>/`
 - [ ] 已执行 `nginx -t && systemctl reload nginx`
@@ -20,6 +22,7 @@
 ## A. 发布前（Pre-flight）
 - [ ] 确认当前版本已打 tag：`git tag -a trialrun-YYYYMMDD-NN -m "trialrun release"`
 - [ ] 本地门禁：`./scripts/check-minimal.sh`
+- [ ] 部署契约校验：`node deploy/trialrun/validate-env-contract.js`
 - [ ] 全量回归（建议）：`cd server && RUN_AUDIT_REGRESSION=1 RUN_OCR_REGRESSION=1 ./scripts/regression-all.sh`
 - [ ] 备份（DB + 文件存储）：
   - [ ] `set -a && source deploy/trialrun/.env && set +a`
@@ -33,6 +36,8 @@
   - [ ] `docker compose -f deploy/trialrun/docker-compose.yml --env-file deploy/trialrun/.env run --rm init`
 - [ ] 探活：
   - [ ] `curl -fsS http://127.0.0.1:3000/ready`
+- [ ] Runtime smoke：
+  - [ ] `docker compose -f deploy/trialrun/docker-compose.yml --env-file deploy/trialrun/.env exec -T server node src/scripts/smoke-trialrun-runtime.js`
 - [ ] 登录验证（管理员账号）：
   - [ ] 访问 `http://127.0.0.1:3000`
   - [ ] 登录成功，菜单权限正确