QuestionProject/ai_knowledge_base_v2/deployment/RELEASE_CHECKLIST.md

V2 发布检查清单

发布前

• 已确认当前 Git commit。
• 已执行 ./scripts/phase6_verify.sh。
• 已备份 MySQL 数据库。
• 已确认管理后台登录页没有预填账号密码。
• 已配置生产环境 BOOTSTRAP_ADMIN_USERNAME 和安全的 BOOTSTRAP_ADMIN_PASSWORD，且密码不是 admin123456。
• 已替换 JWT_SECRET_KEY。
• 已确认飞书检索配置。
• 已确认模型配置和额度策略。
• 已确认统一入口 gateway 可访问。
• 已确认前端 API 地址使用同域 /api。
• 已确认内网穿透指向 gateway:80。
• 已使用 docker-compose.prod.yml，未使用开发编排上线。
• 已关闭 DEBUG、短信 mock、模型 mock 和飞书 mock。
• 已配置敏感配置加密密钥，后台接口仅显示密钥掩码。
• 已验证短信发送、验证码和管理员登录限流。
• 已验证每日问答额度跨自然日自动重置。
• 已验证并发排队、超时、取消和队列满提示。
• 已验证退出登录后的 Token 在多 worker 下立即失效。

发布中

• 拉取最新代码或镜像。
• 执行数据库迁移。
• 启动后端服务。
• 启动用户端 H5。
• 启动管理后台。
• 启动统一入口 gateway。
• 检查 域名/api/health 后端健康接口。

发布后

• 用户端可以登录。
• 默认打开域名进入用户端。
• 域名/login 进入管理后台登录页。
• 用户端可以创建会话。
• 用户端可以提问并收到回答。
• 无命中问题返回固定兜底。
• 管理后台可以登录。
• 管理后台可以查看 Dashboard。
• 管理后台可以保存 Prompt。
• 管理后台可以新增知识库。
• AI 请求日志有记录。
• 操作日志有记录。

回滚触发条件

• 用户端无法登录。
• 用户端无法完成提问主链路。
• 后台无法登录。
• 数据库迁移失败且无法快速修复。
• 外部服务异常导致核心链路不可用。