user-system/docs/team/PRODUCTION_CHECKLIST.md

生产级发布清单

版本：2.0
更新时间：2026-03-25

本清单用于发布前、发布后和对外表述前的最后核查。

1. 发布前必须完成

1.1 代码与构建

• go test ./... -count=1
• go vet ./...
• go build ./cmd/server
• cd frontend/admin && npm.cmd run lint
• cd frontend/admin && npm.cmd run build

1.2 真实浏览器验证

• cd frontend/admin && npm.cmd run e2e:full:win
• 本轮改动涉及认证、路由、导航、弹窗、防线或主流程时，不得跳过真实浏览器回归

1.3 运行时规则核查

• 非测试代码中无 panic
• 运行时无 mock provider / fake success 路径
• smoke 仅用于诊断，不是运行时依赖
• 敏感接口仍带 no-store 等防缓存头
• 邮件、短信、文件上传、外部调用均为 fail closed

1.4 配置与安全核查

• release 模式下无占位密钥
• release 模式下无 localhost OAuth 回调
• release 模式下无 * CORS 放行
• 真实密钥来自环境变量或密钥管理系统

2. 可选但建议同时检查

• cd frontend/admin && npm.cmd run test:run
• 已同步检查 docs/status/REAL_PROJECT_STATUS.md
• 已同步检查是否需要补证据文档

3. 不能夸大的结论

满足本清单，不等于自动满足以下结论：

• 完整 OS 级自动化已闭环
• 真实第三方 OAuth live 验证已闭环
• 外部 Secrets/KMS 已闭环
• 多环境 CI/CD 密钥分发已闭环
• 跨历史版本 schema downgrade 回滚证据已闭环

如果上述材料未齐备，必须在发布说明中明确列为剩余缺口。

4. 当前项目的主验收路径

当前受支持的真实浏览器主验收路径：

cd D:\project\frontend\admin
npm.cmd run e2e:full:win

当前可诚实表述的边界：

• 已完成浏览器级真实 E2E 收口
• 未完成完整 OS 级自动化收口

5. 发布后 30 分钟内检查

• 核心登录/登出链路正常
• 后台主导航正常
• 关键日志无新增异常
• 无异常弹窗、popup、page error、401 回归
• 健康检查正常：
  • GET /health
  • GET /health/live
  • GET /health/ready