Modelo de bug report em português

01

O modelo para copiar

Selecione o bloco e cole no campo de descrição do chamado. Os colchetes são o que você troca; o resto pode ficar como está.

Título: [onde]: [o que acontece] ao [condição]
Ambiente: [versão] · [navegador e sistema] · [homologação ou produção] · [usuário de teste]
Pré-condição: [o que precisa existir antes do passo 1]
Passos:
1. [um verbo por passo]
2. [o nome exato do que foi clicado]
3. [...]
Esperado: [o que deveria acontecer]
Obtido: [o que aconteceu]
Evidência: [vídeo] · [print com o texto do erro] · [horário com fuso]
Frequência: [sempre, ou X de Y tentativas]
Impacto: [quem é afetado, e como]

Use, copie e adapte à vontade, inclusive dentro da sua empresa.

02

Os sete campos, com o exemplo que volta e o que não volta

O exemplo é o mesmo nos sete: um checkout que recusa o pagamento quando o cupom está vencido.

1. 1

   Título

   Onde, o que acontece e em que condição. É a linha que decide se alguém abre o chamado.

   Volta: «Checkout não funciona». Não volta: «Checkout: pagamento recusado ao aplicar cupom vencido».

2. 2

   Ambiente

   A versão do sistema, o navegador e o sistema operacional, se foi em homologação ou em produção, e o usuário de teste. Em branco, quem corrige testa no ambiente dele, e lá funciona.

3. 3

   Pré-condição

   O que precisa existir antes do passo 1: carrinho com dois itens, cupom PROMO2025 vencido, usuário sem cartão salvo. O bug que «só acontece comigo» quase sempre depende de um estado que só você tinha.

4. 4

   Passos

   Um verbo por passo, com o nome exato do que foi clicado.

   Volta: «Aplicar o cupom e finalizar». Não volta: «1. Abrir o carrinho. 2. Digitar PROMO2025 em Cupom. 3. Clicar em Aplicar. 4. Clicar em Finalizar pedido».

5. 5

   Esperado e obtido

   Os dois, lado a lado. Fato se corrige; opinião se discute.

   Volta: «Está estranho, não funciona direito». Não volta: «Esperado: a loja avisa que o cupom venceu. Obtido: erro genérico no pagamento».

6. 6

   Evidência

   O vídeo do momento, o print com o texto exato do erro e o horário com o fuso. O horário é o que mais ajuda: leva quem corrige direto ao trecho certo do log.

7. 7

   Frequência e impacto

   Se acontece sempre ou quantas vezes em quantas tentativas, e quem é afetado. É o que faz o time decidir entre corrigir agora e na próxima entrega.

   Não volta: «Intermitente: 3 de 5 tentativas. Todo cliente com cupom vencido fica sem finalizar a compra».

03

Os três erros que fazem o bug voltar

• Título que não diz onde está o problema. Quem faz a triagem lê dezenas por dia, e «não funciona» vai para o fim da fila.
• Pular o passo «óbvio». Óbvio para quem executou: é o estado que só você tinha, e que ninguém mais reproduz.
• Evidência sem o horário. Sem ele, quem corrige procura o erro no log do dia inteiro.

04

Perguntas frequentes