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。

发布中

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

发布后

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

回滚触发条件

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