5 min leitura • Guide 636 of 877
Criando relatórios de bug efetivos
Relatórios de bug efetivos contêm as informações que desenvolvedores precisam para reproduzir, entender e corrigir problemas rapidamente. Os recursos de rastreamento de bug do GitScrum ajudam equipes a padronizar relatórios de bug, garantir captura consistente de informações e agilizar o caminho do relatório à resolução.
Estrutura de relatório de bug
Componentes essenciais
TEMPLATE DE RELATÓRIO DE BUG:
┌─────────────────────────────────────────────────────────────┐
│ TITLE: [Ação] causa [Problema] em [Área] │
│ Exemplo: "Clicar 'Salvar' causa perda de dados no perfil" │
├─────────────────────────────────────────────────────────────┤
│ │
│ SEVERIDADE: 🔴 Crítico / 🟠 Alto / 🟡 Médio / 🟢 Baixo │
│ │
│ AMBIENTE: │
│ • Browser/Dispositivo: Chrome 120, Windows 11 │
│ • Versão do App: 2.4.1 │
│ • Tipo de Conta: Usuário premium │
│ │
│ PASSOS PARA REPRODUZIR: │
│ 1. Navegar para Configurações > Perfil │
│ 2. Mudar nome de exibição para "Test User" │
│ 3. Clicar botão "Salvar" │
│ 4. Observar mensagem de erro │
│ │
│ COMPORTAMENTO ESPERADO: │
│ Perfil deve salvar e mostrar mensagem de sucesso │
│ │
│ COMPORTAMENTO ATUAL: │
│ Erro "Falha ao salvar" aparece, mudanças são perdidas │
│ │
│ ANEXOS: │
│ • [Screenshot do erro] │
│ • [Log do console] │
│ • [Captura de requisição de rede] │
└─────────────────────────────────────────────────────────────┘
Diretrizes de severidade
NÍVEIS DE SEVERIDADE DE BUG:
┌─────────────────────────────────────────────────────────────┐
│ NÍVEL │ CRITÉRIOS │ RESPOSTA │
├──────────┼─────────────────────────────┼───────────────────┤
│ 🔴 Crítico│ • App inutilizável │ Corrigir imediatamente │
│ │ • Perda de dados │ Release no mesmo dia │
│ │ • Vulnerabilidade de segurança│ │
├──────────┼─────────────────────────────┼───────────────────┤
│ 🟠 Alto │ • Funcionalidade principal quebrada│ Corrigir neste sprint │
│ │ • Workaround difícil │ Fila de prioridade │
│ │ • Muitos usuários afetados │ │
├──────────┼─────────────────────────────┼───────────────────┤
│ 🟡 Médio │ • Funcionalidade degradada │ Agendar em │
│ │ • Workaround existe │ sprint futuro │
│ │ • Alguns usuários afetados │ │
├──────────┼─────────────────────────────┼───────────────────┤
│ 🟢 Baixo │ • Inconveniência menor │ Backlog │
│ │ • Problema cosmético │ Corrigir quando possível│
│ │ • Ocorrência rara │ │
└─────────────────────────────────────────────────────────────┘
Relatórios de bug de qualidade
Passos de reprodução
PASSOS DE REPRODUÇÃO BONS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ ✅ BOM: │
│ 1. Logar como usuário "test@example.com" │
│ 2. Navegar para Dashboard > Relatórios │
│ 3. Selecionar intervalo de datas: 1 Jan - 31 Jan, 2024 │
│ 4. Clicar "Gerar Relatório" │
│ 5. Aguardar relatório carregar (cerca de 5 segundos) │
│ 6. Clicar "Exportar PDF" │
│ Resultado: Erro "Exportação falhou" aparece │
│ │
│ ❌ RUIM: │
│ "Exportação PDF não funciona" │
│ │
│ ❌ TAMBÉM RUIM: │
│ "Ir para relatórios e tentar exportar" │
│ │
│ DICAS: │
│ • Ser específico sobre ações │
│ • Incluir quaisquer dados necessários │
│ • Notar timing se relevante │
│ • Mencionar se é intermitente │
└─────────────────────────────────────────────────────────────┘
Evidências de suporte
ANEXOS ÚTEIS:
┌─────────────────────────────────────────────────────────────┐
│ TIPO │ QUANDO INCLUIR │
├───────────────────┼────────────────────────────────────────┤
│ Screenshot │ Bugs visuais, mensagens de erro │
│ Gravação de vídeo │ Interações complexas, problemas de timing│
│ Logs do console │ Erros JavaScript, avisos │
│ Captura de rede │ Falhas de API, requisições lentas │
│ Logs de erro │ Problemas do lado servidor │
│ Arquivo HAR │ Trace completo de rede │
│ Dados de exemplo │ Bugs específicos de dados │
└───────────────────────────────────────────────────────────────┘
NO GITSCRUM:
• Arrastar e soltar anexos na tarefa
• Link para gravações de tela
• Colar imagens diretamente na descrição
• Anexar arquivos de log
Workflow de bug
Ciclo de vida do bug
WORKFLOW DE STATUS DE BUG:
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│ Novo │→ │ Triagem│→ │ Corrigindo│→ │ Testando│→ │ Fechado│
└────────┘ └────────┘ └────────┘ └────────┘ └────────┘
│ │ │ │ │
│ │ │ │ │
↓ ↓ ↓ ↓ ↓
Enviado Priorizado Atribuído Verificado Lançado
& atribuído desenvolvedor correção funciona
TRANSIÇÕES POSSÍVEIS:
• Triagem → Fechado (Não é bug / Não será corrigido / Duplicado)
• Testando → Corrigindo (Correção não funcionou, reabrir)
• Qualquer → Fechado (Não será corrigido com explicação)
Processo de triagem de bug
CHECKLIST DE REUNIÃO DE TRIAGEM:
┌─────────────────────────────────────────────────────────────┐
│ │
│ PARA CADA NOVO BUG: │
│ │
│ 1. VALIDAR │
│ □ É reproduzível? │
│ □ É duplicado? │
│ □ É realmente um bug (não pedido de funcionalidade)? │
│ │
│ 2. AVALIAR │
│ □ Qual é a severidade? │
│ □ Quantos usuários afetados? │
│ □ Existe workaround? │
│ │
│ 3. PRIORIZAR │
│ □ Onde se encaixa no backlog? │
│ □ Deve interromper trabalho atual? │
│ □ Qual sprint agendar? │
│ │
│ 4. ATRIBUIR │
│ □ Quem tem contexto? │
│ □ Quem tem capacidade? │
└─────────────────────────────────────────────────────────────┘