shipping-and-launch

发布和上线

概览

带着信心发布。目标不只是部署，而是安全地部署：监控到位、回滚计划就绪，并且清楚知道成功是什么样子。每次上线都应该是可回滚、可观测、增量推进的。

何时使用

• 首次将功能部署到生产环境
• 向用户发布重大变更
• 迁移数据或基础设施
• 开放 beta 或 early access 项目
• 任何有风险的部署（也就是所有部署）

发布前检查清单

代码质量

• 所有测试通过（unit、integration、e2e）
• Build 成功且没有警告
• Lint 和类型检查通过
• 代码已 review 并获批准
• 没有应在上线前解决的 TODO 注释
• 生产代码中没有 console.log 调试语句
• 错误处理覆盖预期失败模式

安全

• 代码或版本控制中没有 secrets
• npm audit 没有 critical 或 high 漏洞
• 所有用户可访问 endpoint 都有输入校验
• 认证和授权检查已到位
• 安全 header 已配置（CSP、HSTS 等）
• 认证 endpoint 已设置 rate limiting
• CORS 配置为具体 origin（不是通配符）

性能

• Core Web Vitals 在 "Good" 阈值内
• 关键路径中没有 N+1 查询
• 图片已优化（压缩、响应式尺寸、lazy loading）
• Bundle size 在预算内
• 数据库查询有合适索引
• 静态资源和重复查询已配置缓存

可访问性

• 所有交互元素都支持键盘导航
• 屏幕阅读器可以传达页面内容和结构
• 颜色对比度满足 WCAG 2.1 AA（文本 4.5:1）
• 模态框和动态内容的焦点管理正确
• 错误消息具有描述性，并与表单字段关联
• axe-core 或 Lighthouse 中没有可访问性警告

基础设施

• 生产环境变量已设置
• 数据库 migration 已应用（或准备好应用）
• DNS 和 SSL 已配置
• 静态资源 CDN 已配置
• Logging 和 error reporting 已配置
• Health check endpoint 存在且有响应

文档

• README 已更新任何新的 setup 要求
• API 文档为最新
• 任何架构决策都有 ADR
• Changelog 已更新
• 面向用户的文档已更新（如适用）

Feature Flag 策略

通过 feature flags 发布，将部署和发布解耦：

// Feature flag check
const flags = await getFeatureFlags(userId);

if (flags.taskSharing) {
  // New feature: task sharing
  return <TaskSharingPanel task={task} />;
}

// Default: existing behavior
return null;

Feature flag 生命周期：

1. DEPLOY with flag OFF     → Code is in production but inactive
2. ENABLE for team/beta     → Internal testing in production environment
3. GRADUAL ROLLOUT          → 5% → 25% → 50% → 100% of users
4. MONITOR at each stage    → Watch error rates, performance, user feedback
5. CLEAN UP                 → Remove flag and dead code path after full rollout

规则：

• 每个 feature flag 都有 owner 和到期日期
• 全量发布后 2 周内清理 flags
• 不要嵌套 feature flags（会产生指数级组合）
• 在 CI 中测试 flag 的两种状态（on 和 off）