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.

Uma escala comum de severidade
NívelQuando usarExemplo
CríticaPerda de dados, falha de segurança ou sistema fora do arPagamento cobrado duas vezes
AltaUma função principal não funciona e não há alternativaNão dá para finalizar a compra no Safari
MédiaFunciona com dificuldade ou há alternativaFiltro ignora a ordenação
BaixaVisual ou texto, sem impedir o usoBotã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ó.

Referências

Trilhas relacionadas