Download do Template
Baixe o checklist de QA Gate em Markdown. Use em cada PR para garantir qualidade.
🚧 O que e QA Gate
QA Gate e o checkpoint obrigatorio que toda entrega deve passar antes de ser considerada "done". No GIPM, sem QA Gate aprovado, nao ha merge. E a ultima linha de defesa contra bugs, vulnerabilidades e codigo de baixa qualidade.
Principios do QA Gate
Falha = nao faz merge, sem excecoes
Itens objetivos, pass/fail
Cada item tem prova (log, screenshot)
Quanto mais automatico, melhor
💡 QA Gate vs Code Review
Code Review avalia como foi feito (qualidade do codigo). QA Gate verifica o que foi feito (funciona conforme especificado). Ambos sao necessarios, mas servem propositos diferentes.
✅ Validacao de Acceptance Criteria
Cada Acceptance Criteria da story deve ser verificado individualmente. Nao ha "meio aprovado" - cada AC e PASS ou FAIL. E toda validacao deve ter evidencia anexada.
Exemplo de Validacao de ACs
⚠️ Um AC FAIL = Story FAIL
Mesmo que 9 de 10 ACs passem, se 1 falhar, a story nao pode ser aprovada. Corrija o problema e submeta novamente para validacao.
👀 Code Review
O code review vai alem de "funciona". Avalia se o codigo e legivel, mantenivel e segue os padroes do projeto. Um PR deve contar uma historia clara do que foi feito.
Checklist de Code Review
❌ PR Ruim
✅ PR Bom
📏 Padroes de Codigo
Padroes de codigo garantem consistencia em todo o projeto. No GIPM, preferimos automatizar tudo que pode ser automatizado - lint, format, type check. Assim, o code review foca no que realmente importa.
Validacoes Automaticas Obrigatorias
Sem erros ou warnings
Codigo formatado
Sem erros de tipo
💡 Pre-commit Hooks
Configure Husky + lint-staged para rodar essas validacoes automaticamente antes de cada commit. Assim, codigo fora do padrao nunca chega ao repositorio.
🧪 Testes
Sem testes, sem confianca. No GIPM, testes nao sao opcionais. Cada story deve ter testes que cobrem os Acceptance Criteria. A piramide de testes guia o que testar em cada nivel.
Piramide de Testes
Funcoes isoladas, rapidos, muitos. Testam logica de negocio.
Componentes juntos, API + DB. Testam fluxos completos.
Sistema completo, lentos, poucos. Testam jornadas criticas.
Coverage Minimo
⚠️ Casos Obrigatorios
- • Happy path (sucesso)
- • Inputs invalidos
- • Edge cases
- • Erros esperados
🔒 Seguranca
Seguranca nao e uma feature - e um requisito nao-negociavel. Cada entrega deve passar pelo checklist de seguranca. Vulnerabilidades descobertas apos deploy sao muito mais caras de corrigir.
Checklist de Seguranca
Ferramentas Automaticas
⚡ Performance
"Meca, nao ache" e o mantra de performance no GIPM. Nao assuma que algo e rapido - meça. E nao otimize prematuramente - otimize quando os numeros mostrarem que e necessario.
Metricas a Monitorar
P95 das requisicoes
Tempo ate primeiro byte
Queries individuais
Sem memory leaks
💡 Performance Budget
Defina budgets no comeco do projeto. Ex: "Pagina inicial carrega em menos de 3s em 3G". Isso evita degradacao gradual de performance ao longo do tempo.
📚 Documentacao
Codigo sem documentacao e codigo temporario. No GIPM, a documentacao faz parte do "done". Se nao esta documentado, nao existe para quem vier depois.
O que documentar
Comentarios explicando o "por que", nao o "o que"
OpenAPI/Swagger atualizado
Setup, como rodar, como contribuir
O que mudou em cada versao
❌ Doc Ruim
i++;
✅ Doc Boa
// before circuit breaker opens
retryCount++;
📋 Resumo: QA Gate no GIPM
Baixe o checklist e use em cada PR!
⬇️ Download Checklist