release-checklist.md 1.6 KB

上线检查清单

文件位置:每次上线前逐项勾选,完成后归档到 docs/05-operations/deploy/(命名 上线检查-YYYY-MM-DD-版本号.md)。

字段 值
上线日期 YYYY-MM-DD
版本号 v1.2.3
上线人

一、代码与质量

  • 代码评审完成(自查清单/AI Review)
  • 全部测试通过(前端 + 后端)
  • lint 通过
  • 无调试残留(console.log/debugger)
  • 提交信息规范、改动聚焦

二、文档同步

  • PRD/技术方案已更新
  • ER 图/表结构文档已同步
  • API 文档已同步(含新错误码)
  • 修改留痕已写(docs/07-records/)
  • docs/README.md 索引已更新
  • CHANGELOG 已更新

三、配置与环境

  • env 文件已提交 git(配置变更走提交留痕)
  • 生产 env 值正确(无 dev 残留)
  • 鉴权开关:生产环境鉴权强制生效(双重校验)
  • 新依赖已锁定版本

四、数据库

  • 迁移/schema 脚本已执行(幂等验证)
  • 迁移前已完成备份
  • 迁移后数据完整性已验证
  • 新索引已建立

五、部署与验证

  • 构建通过(前端 build + 后端)
  • PM2/nginx 配置就绪
  • 部署完成,核心链路验证(登录、核心业务)
  • 回滚方案确认可行(记录回滚方式)
  • 日志正常、无异常堆栈
  • 监控/告警确认

六、发布收尾

  • git tag 已打(v1.2.3)
  • 版本号与 CHANGELOG 一致
  • 遗留事项记录(如有)

七、回滚记录(如发生)

  • 回滚时间:
  • 回滚方式:
  • 回滚原因: