# 上线检查清单

> 文件位置:每次上线前逐项勾选,完成后归档到 `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 一致
- [ ] 遗留事项记录(如有)

## 七、回滚记录(如发生)

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