Como Reportar um Bug de Forma Eficaz

O objetivo de um reporte de bug não é apenas informar que algo está errado, mas fornecer todas as ferramentas necessárias para que o desenvolvedor possa corrigi-lo sem precisar fazer perguntas extras.

A Anatomia de um Excelente Bug Report

Para que um ticket seja claro e acionável, ele deve seguir esta estrutura padronizada no Jira:

1. Título Claro e Conciso (O "Onde" e o "O quê")

O título deve resumir o problema e o local.

• ❌ Ruim: O botão não funciona.

• ✅ Bom: [Checkout] Botão "Finalizar Compra" não responde ao clique no Safari Mobile.

2. Ambiente e Versão

Informe onde o erro acontece para que o dev não perca tempo testando no lugar errado.

• Ambiente: Homologação, Produção, Staging.

• Dispositivo/Browser: iPhone 13 (iOS 17), Chrome v120, etc.

• Versão do App: (Ex: v2.4.1).

3. Passos para Reproduzir

Seja específico. Imagine que quem vai ler nunca viu a tela antes.

1. Acesse a URL https://app.neppo.com.br/login.

2. Insira um e-mail válido e uma senha incorreta.

3. Clique no botão "Entrar".

4. Observe que o sistema carrega infinitamente em vez de exibir erro.

4. Resultado Esperado vs. Resultado Atual

Isso elimina qualquer dúvida sobre a regra de negócio.

• Esperado: O sistema deve exibir a mensagem "Usuário ou senha inválidos".

• Atual: O sistema fica travado com o ícone de carregamento (spinner) ativo.

5. Evidências (Obrigatório)

Imagens e vídeos valem mais que mil palavras.

• Prints: Para erros visuais ou de texto.

• Vídeos (Loom/Screen Record): Para erros de fluxo ou comportamento.

• Logs/Console: Se for um erro técnico, anexe o log do console (F12) ou o erro da API (Network tab).

Classificação: Severidade e Prioridade

Sempre utilize a régua que definimos no nosso documento de [Severidade vs. Prioridade]. Isso ajuda o PO a triar o backlog rapidamente.

💡 Dicas para um QA de Elite

• Teste mais de uma vez: Antes de abrir o bug, tente reproduzir o erro novamente para garantir que não foi uma instabilidade momentânea da sua internet.

• Isolamento: Tente identificar se o erro acontece apenas com um usuário específico ou com todos. Isso ajuda o dev a descartar problemas de banco de dados.

• Seja Objetivo, não Crítico: Foque no problema técnico. Em vez de "A tela está horrível", use "O layout da tela X está desalinhado em resoluções 1366x768".

Template para copiar e colar (Jira/Markdown)