7 min leitura • Guide 521 of 877
Como Usar GitScrum para Rastreamento e Resolução de Bugs
Rastreamento efetivo de bugs requer mais que uma lista simples—precisa de workflows de triagem, sistemas de prioridade e caminhos claros de resolução. Workflows customizáveis do GitScrum, labels de severidade e integração Git criam um sistema completo de rastreamento de bugs que conecta issues reportados a correções de código e resoluções verificadas.
Níveis de Severidade de Bugs
| Severidade | Impacto | Tempo de Resposta | Exemplos |
|---|---|---|---|
| Crítico | Sistema fora, perda de dados | Imediato | Login quebrado, pagamento falha |
| Alto | Feature principal quebrada | 24 horas | Export falha, dashboard vazio |
| Médio | Feature degradada | 1 semana | Performance lenta, glitch de UI |
| Baixo | Issue menor | Backlog | Typo, issue cosmético |
Workflow de Rastreamento de Bugs
CICLO DE VIDA DO BUG NO GITSCRUM
1. NOVO BUG REPORTADO
┌─────────────────────────────────────────────────┐
│ Fontes: │
│ ├── Tickets de suporte ao cliente │
│ ├── Testes internos │
│ ├── Monitoramento automatizado │
│ ├── Feedback de usuário │
│ └── Testes de QA │
│ │
│ Status Inicial: [Novo] │
└─────────────────────────────────────────────────┘
│
▼
2. TRIAGEM (dentro de 24h)
┌─────────────────────────────────────────────────┐
│ Ações: │
│ ├── Verificar reprodutibilidade │
│ ├── Atribuir nível de severidade │
│ ├── Verificar duplicatas │
│ ├── Adicionar labels e responsável │
│ └── Definir prioridade │
│ │
│ Status: [Triagem Feita] │
└─────────────────────────────────────────────────┘
│
▼
3. INVESTIGAÇÃO
┌─────────────────────────────────────────────────┐
│ Ações do desenvolvedor: │
│ ├── Reproduzir localmente │
│ ├── Identificar causa raiz │
│ ├── Estimar esforço de correção │
│ └── Documentar findings │
│ │
│ Status: [Em Progresso] │
└─────────────────────────────────────────────────┘
│
▼
4. IMPLEMENTAÇÃO DA CORREÇÃO
┌─────────────────────────────────────────────────┐
│ ├── Correção de código com testes │
│ ├── Code review │
│ ├── Merge para main │
│ └── Deploy para staging │
│ │
│ Status: [Em Review] │
└─────────────────────────────────────────────────┘
│
▼
5. VERIFICAÇÃO
┌─────────────────────────────────────────────────┐
│ ├── QA verifica correção em staging │
│ ├── Reporter original confirma │
│ └── Deploy para produção │
│ │
│ Status: [Verificado] │
└─────────────────────────────────────────────────┘
│
▼
6. FECHADO
┌─────────────────────────────────────────────────┐
│ ├── Notificar stakeholders │
│ ├── Atualizar documentação se necessário │
│ └── Considerar medidas de prevenção │
│ │
│ Status: [Fechado] │
└─────────────────────────────────────────────────┘
Template de Relatório de Bug
ESTRUTURA DE RELATÓRIO DE BUG
┌─────────────────────────────────────────────────┐
│ Título: [Componente] Breve descrição │
│ Exemplo: [Checkout] Pagamento falha para PayPal│
│ │
│ Labels: [bug] [severidade-alta] [pagamentos] │
│ │
│ SEVERIDADE: Alta │
│ PRIORIDADE: P1 │
│ REPORTER: @usuario │
│ AMBIENTE: Produção │
│ │
│ RESUMO: │
│ Uma frase descrevendo o issue. │
│ │
│ PASSOS PARA REPRODUZIR: │
│ 1. Navegue para checkout │
│ 2. Selecione PayPal como método de pagamento │
│ 3. Clique "Completar Pedido" │
│ 4. Observe o erro │
│ │
│ COMPORTAMENTO ESPERADO: │
│ Pagamento deveria ser processado e pedido │
│ confirmado. │
│ │
│ COMPORTAMENTO ATUAL: │
│ Página mostra "Erro de pagamento" e transação │
│ não é concluída. │
│ │
│ DETALHES DO AMBIENTE: │
│ Browser: Chrome 120, macOS 14 │
│ Conta de teste: user@test.com │
│ │
│ LOGS/SCREENSHOTS: │
│ [Anexar evidências] │
│ │
│ IMPACTO NO USUÁRIO: │
│ ~500 usuários afetados estimados. │
│ Bloqueando checkout completo para PayPal. │
└─────────────────────────────────────────────────┘
Priorização e Triagem
MATRIZ DE PRIORIZAÇÃO DE BUGS
Muitos Usuários Afetados
│
┌────────────────────┼────────────────────┐
│ P1: URGENTE │ P0: CRÍTICO │
│ Alta severidade │ Crítica severidade │
│ Muitos afetados │ Bloqueando todos │
│ Próxima sprint │ Interromper agora │
│ │ │
├────────────────────┼────────────────────┤
│ P3: BACKLOG │ P2: PLANEJADO │
│ Baixa severidade │ Média severidade │
│ Poucos afetados │ Poucos afetados │
│ Quando possível │ Planejar sprint │
│ │ │
└────────────────────┴────────────────────┘
Poucos Usuários Afetados
SLA POR PRIORIDADE:
┌─────────────────────────────────────────────────┐
│ P0 (Crítico): Resposta em 1h, fix em 24h │
│ P1 (Urgente): Resposta em 4h, fix em 48h │
│ P2 (Planejado): Na próxima sprint │
│ P3 (Backlog): Quando capacidade permitir │
└─────────────────────────────────────────────────┘
Fluxo de Triagem
PROCESSO DIÁRIO DE TRIAGEM
REUNIÃO DE TRIAGEM (15 min/dia):
┌─────────────────────────────────────────────────┐
│ Participantes: Tech Lead + QA Lead │
│ │
│ Para cada novo bug: │
│ 1. Verificar se é reproduzível │
│ 2. Verificar duplicatas │
│ 3. Atribuir severidade e prioridade │
│ 4. Atribuir responsável │
│ 5. Definir prazo baseado em SLA │
└─────────────────────────────────────────────────┘
CRITÉRIOS DE TRIAGEM:
┌─────────────────────────────────────────────────┐
│ É um bug? │
│ ├── Sim → Continuar triagem │
│ ├── Feature request → Mover para backlog │
│ ├── Duplicata → Linkar e fechar │
│ └── Não reproduzível → Pedir mais info │
│ │
│ Quem deve corrigir? │
│ ├── Time owner do componente │
│ ├── Pessoa com contexto recente │
│ └── Dev de plantão (se crítico) │
└─────────────────────────────────────────────────┘
Métricas de Qualidade
DASHBOARD DE MÉTRICAS DE BUGS
MÉTRICAS DE VELOCIDADE:
┌─────────────────────────────────────────────────┐
│ Tempo Médio para Primeira Resposta: │
│ • Crítico: 45 min (meta: < 1h) ✓ │
│ • Alto: 3h (meta: < 4h) ✓ │
│ • Médio: 1 dia (meta: < 2 dias) ✓ │
│ │
│ Tempo Médio para Resolução: │
│ • Crítico: 18h (meta: < 24h) ✓ │
│ • Alto: 36h (meta: < 48h) ✓ │
│ • Médio: 6 dias (meta: < 7 dias) ✓ │
└─────────────────────────────────────────────────┘
MÉTRICAS DE QUALIDADE:
┌─────────────────────────────────────────────────┐
│ Bugs Abertos por Severidade: │
│ • Crítico: 0 │
│ • Alto: 3 │
│ • Médio: 15 │
│ • Baixo: 28 │
│ │
│ Taxa de Escape (bugs em produção): │
│ • Este mês: 4 bugs │
│ • Mês passado: 6 bugs │
│ • Tendência: ↓ 33% (melhoria!) │
│ │
│ Bugs Recorrentes: 2 (investigar causa raiz) │
└─────────────────────────────────────────────────┘
Integração com Desenvolvimento
CONEXÃO BUG → CÓDIGO → FIX
NO GITSCRUM:
┌─────────────────────────────────────────────────┐
│ Bug #567: Checkout falha para PayPal │
│ │
│ Commits Relacionados: │
│ • abc123 - Fix PayPal callback handling │
│ • def456 - Add PayPal error logging │
│ │
│ Pull Request: │
│ • PR #234 - Fix PayPal checkout (merged) │
│ │
│ Releases: │
│ • v2.3.1 - Fix deployed to production │
└─────────────────────────────────────────────────┘
TEMPLATE DE COMMIT PARA BUGS:
┌─────────────────────────────────────────────────┐
│ fix(payments): resolve PayPal callback issue │
│ │
│ - Fix timeout in PayPal callback handler │
│ - Add retry logic for transient failures │
│ - Improve error logging for debugging │
│ │
│ Fixes #567 │
└─────────────────────────────────────────────────┘