Como relatar um bug
Um modelo de relato que qualquer pessoa reproduz na primeira tentativa, com severidade e evidências.
5 min de leitura · Iniciante · Revisado em
Um bom relato poupa uma conversa
O objetivo de um relato é que outra pessoa reproduza o problema na primeira tentativa, sem precisar perguntar nada. Se ela não reproduz, o bug fica parado, e a culpa raramente é de quem desenvolve.
Difícil de agir
"O checkout não funciona"
Qual navegador? Qual produto? O que apareceu? Funcionava antes? Tudo isso vira perguntas e espera.
Pronto para corrigir
"Cupom com 100% de desconto deixa o total negativo"
O título já diz onde, o que e em qual condição. Quem lê sabe por onde começar.
Um modelo que funciona
Copie para o seu rastreador de issues
## Cupom de 100% deixa o total do pedido negativo
**Ambiente:** staging · Chrome 130 · macOS 15 · build 2026.10.13-3f9a
**Passos para reproduzir**
1. Entre como cliente@teste.com
2. Adicione "Camiseta básica" (R$ 49,90) ao carrinho
3. Aplique o cupom TESTE100
4. Escolha frete Expresso (R$ 15,00)
**Resultado esperado:** total R$ 15,00 (só o frete)
**Resultado obtido:** total -R$ 34,90
**Frequência:** 5 de 5 tentativas
**Evidência:** captura de tela, HAR da requisição POST /carrinho/cupom
**Impacto:** pedido é criado com valor negativo; afeta qualquer cupom de 100%- Passos mínimos
- Corte tudo que não muda o resultado. Cinco passos certeiros valem mais que vinte.
- Esperado e obtido
- Sempre os dois. "Está errado" não diz qual seria o certo.
- Evidência
- Captura ou vídeo curto, mensagem do console, requisição da aba Network, id de log ou de pedido.
- Frequência
- "Sempre" e "1 em 10" levam a investigações bem diferentes.
Severidade e prioridade
Severidade é o tamanho do estrago. Prioridade é a urgência de corrigir, que também depende do negócio. Um erro de digitação no logo é pouco severo e pode ser prioridade alta na véspera do lançamento.
| Nível | Quando usar | Exemplo |
|---|---|---|
| Crítica | Perda de dados, falha de segurança ou sistema fora do ar | Pagamento cobrado duas vezes |
| Alta | Uma função principal não funciona e não há alternativa | Não dá para finalizar a compra no Safari |
| Média | Funciona com dificuldade ou há alternativa | Filtro ignora a ordenação |
| Baixa | Visual ou texto, sem impedir o uso | Botão desalinhado em 320 px |
Antes de enviar
- Procurei se já existe um relato do mesmo problema.
- Reproduzi de novo seguindo só os passos que escrevi.
- O título descreve o problema e a condição, não só a tela.
- Informei ambiente, versão e dados usados.
- Escrevi o resultado esperado e o obtido.
- Anexei evidência e removi dados pessoais e senhas dela.
- Um relato descreve um problema só.