配置、发布与回滚

应用发布顺序

1. 确认目标版本、数据库迁移、外部契约和需要的配置。
2. 单独构建目标 Web workspace 与后端 Maven 模块。
3. 为数据库与相关文件准备恢复点；发布涉及迁移时确认向前兼容及回滚策略。
4. 发布制品与环境配置，启动服务并观察健康状态。
5. 验证统一登录、普通角色与关键业务链路。

后端代码回退不意味着数据库迁移可直接反向执行。需要单独判断迁移兼容性，不能仅替换旧 Jar 就宣称完成恢复。

配置边界

配置类别	重点
身份	issuer、公钥、回调 URI、客户端与租户 scopes
数据	独立数据库、迁移版本、账号与连接
访问入口	内部路由、HTTPS、可信 Origin 与超时
文件	存储端点、Bucket、凭据和历史对象可读性
审批	接收端 Origin、业务类型、审批人服务与回调
HRM	加密密钥、同步作业、映射和来源切换

前端环境变量会进入浏览器制品，不能用来保存私密服务凭据。

文档中心发布

文档域名为 docs.wanghuanlab.com。本地操作：

npm ci
npm run build:docs
npm run deploy:docs

发布脚本只构建文档 workspace，上传独立版本目录并切换当前制品。站点配置使用静态 HTML 深层路径匹配；不存在路径返回真实 404，不使用业务 SPA 的首页兜底。

HTTPS 证书由首次配置脚本签发，自动续期脚本定期检查。站点读者无需业务登录。

文档中心回滚

npm run rollback:docs

默认回到上一发布目录。回滚前会显示并检查已有版本；首次发布没有历史版本时拒绝回滚。回滚后检查首页、深层链接和搜索。

验收

检查 HTTPS、HTTP 跳转、资源缓存、404、中文搜索、手机导航和关键指南。不要把发布日志中的上传成功当作公网验证成功。