Envio e Lançamento

Visão Geral

Envie com confiança. O objetivo não é apenas implantar — é implantar com segurança, com monitoramento ativo, um plano de reversão pronto e um entendimento claro do que significa sucesso. Cada lançamento deve ser reversível, observável e incremental.

Quando Usar

• Implantando um recurso em produção pela primeira vez
• Lançando uma mudança significativa para os usuários
• Migrando dados ou infraestrutura
• Abrindo um programa beta ou de acesso antecipado
• Qualquer implantação que apresente risco (todas elas)

O Checklist Pré-Lançamento

Qualidade do Código

• Todos os testes passam (unitários, de integração, ponta a ponta)
• A compilação é bem-sucedida sem avisos
• Verificações de lint e de tipo passam
• Código revisado e aprovado
• Não há comentários TODO que devam ser resolvidos antes do lançamento
• Não há instruções de depuração console.log no código de produção
• O tratamento de erros cobre os modos de falha esperados

Segurança

• Nenhum segredo no código ou controle de versão
• A auditoria de dependências do ecossistema (npm audit, pip-audit, cargo audit, ...) não mostra vulnerabilidades críticas ou de alta gravidade
• Validação de entrada em todos os endpoints voltados para o usuário
• Verificações de autenticação e autorização implementadas
• Cabeçalhos de segurança configurados (CSP, HSTS, etc.)
• Limitação de taxa em endpoints de autenticação
• CORS configurado para origens específicas (não wildcard)

Desempenho

• Core Web Vitals dentro dos limites "Bom"
• Não há consultas N+1 em caminhos críticos
• Imagens otimizadas (compressão, tamanhos responsivos, carregamento preguiçoso)
• Tamanho do pacote dentro do orçamento
• Consultas ao banco de dados possuem índices apropriados
• Cache configurado para ativos estáticos e consultas repetidas

Acessibilidade

• Navegação por teclado funciona para todos os elementos interativos
• O leitor de tela consegue transmitir o conteúdo e a estrutura da página
• O contraste de cores atende ao WCAG 2.1 AA (4.5:1 para texto)
• Gerenciamento de foco correto para modais e conteúdo dinâmico
• Mensagens de erro são descritivas e associadas aos campos do formulário
• Não há avisos de acessibilidade em axe-core ou Lighthouse

Infraestrutura

• Variáveis de ambiente definidas em produção
• Migrações de banco de dados aplicadas (ou prontas para aplicar)
• DNS e SSL configurados
• CDN configurado para ativos estáticos
• Logs e relatórios de erros configurados
• Endpoint de verificação de integridade existe e responde

Documentação

• README atualizado com quaisquer novos requisitos de configuração
• Documentação da API atualizada
• ADRs escritos para quaisquer decisões arquiteturais
• Changelog atualizado
• Documentação voltada para o usuário atualizada (se aplicável)

Estratégia de Feature Flags

Implante atrás de feature flags para desacoplar a implantação do lançamento:

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

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

// Default: existing behavior
return null;

Ciclo de vida da 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

Regras:

• Cada feature flag tem um proprietário e uma data de expiração
• Limpe as flags em até 2 semanas após o lançamento completo
• Não aninhe feature flags (cria combinações exponenciais)
• Teste ambos os estados da flag (ligada e desligada) no CI

Rollout Gradual

A Sequência de Rollout

1. DEPLOY to staging
   └── Full test suite in staging environment
   └── Manual smoke test of critical flows

2. DEPLOY to production (feature flag OFF)
   └── Verify deployment succeeded (health check)
   └── Check error monitoring (no new errors)

3. ENABLE for team (flag ON for internal users)
   └── Team uses the feature in production
   └── 24-hour monitoring window

4. CANARY rollout (flag ON for 5% of users)
   └── Monitor error rates, latency, user behavior
   └── Compare metrics: canary vs. baseline
   └── 24-48 hour monitoring window
   └── Advance only if all thresholds pass (see table below)

5. GRADUAL increase (25% -> 50% -> 100%)
   └── Same monitoring at each step
   └── Ability to roll back to previous percentage at any point

6. FULL rollout (flag ON for all users)
   └── Monitor for 1 week
   └── Clean up feature flag

Limiares de Decisão de Rollout

…