Automatizando Status de Tarefa com Merges PR

Desenvolvedores não deveriam ter que atualizar status de tarefa manualmente após merge de código. Integração Git do GitScrum automaticamente move tarefas através de estágios de fluxo de trabalho baseado em atividade PR, mantendo estado de projeto preciso sem overhead de desenvolvedor.

O Problema de Atualização Manual

Configurando Integração Git

Configuração de Conexão

CONFIGURAÇÃO DE INTEGRAÇÃO GIT
══════════════════════════════

Passo 1: Conectar Repositório
─────────────────────────────
Plataforma: GitHub / GitLab / Bitbucket
Repositório: company/product
Autenticação: OAuth ou Personal Access Token

Passo 2: Configurar Padrão ID de Tarefa
───────────────────────────────────────
Padrão: #(\d+)
Exemplos correspondem: #123, #456
Alternativo: TASK-(\d+) para formato TASK-123

Passo 3: Habilitar Webhooks
───────────────────────────
Eventos para rastrear:
├── Branch criado
├── Pull request aberto
├── Pull request aprovado
├── Pull request merged
└── Pull request fechado

Regras de Automação

REGRAS DE AUTOMAÇÃO
═══════════════════

REGRA 1: Branch Criado
──────────────────────
Gatilho: Nome de branch contém ID de tarefa
Ação: Move tarefa para "Em Progresso"
Exemplo: feature/#123-user-auth → Tarefa #123 para Em Progresso

REGRA 2: PR Aberto
──────────────────
Gatilho: Descrição PR contém ID de tarefa
Ação: 
├── Move tarefa para "Em Revisão"
├── Link PR para tarefa
└── Notifica revisor atribuído

REGRA 3: PR Aprovado
────────────────────
Gatilho: PR recebe aprovações necessárias
Ação: Adiciona label "approved" para tarefa

REGRA 4: PR Merged
──────────────────
Gatilho: PR merged para main/master
Ação: Move tarefa para "Feito"

REGRA 5: PR Fechado Sem Merge
─────────────────────────────
Gatilho: PR fechado sem merging
Ação: Move tarefa de volta para "Em Progresso"

Linkando PRs para Tarefas

Em Nomes de Branch

CONVENÇÕES DE NOMEAÇÃO DE BRANCH
════════════════════════════════

Formato: type/#task-id-short-description

Exemplos:
├── feature/#123-user-authentication
├── bugfix/#456-login-redirect-loop
├── hotfix/#789-security-patch
└── refactor/#234-cleanup-auth-module

GitScrum extrai: #123, #456, #789, #234

Em Descrições PR

TEMPLATE DE DESCRIÇÃO PR
════════════════════════

## Descrição
Breve descrição de mudanças

## Tarefas Relacionadas
Closes #123
Related to #124

## Tipo
- [x] Feature
- [ ] Bug fix
- [ ] Refactor

## Checklist
- [x] Testes adicionados
- [x] Documentação atualizada

---

GitScrum detecta: #123, #124

Integração de Fluxo de Trabalho

Fluxo Completo

FLUXO DE TRABALHO DE DESENVOLVEDOR
══════════════════════════════════

1. Pegue tarefa #123 do quadro
   └── Tarefa já em "Ready"

2. Crie branch: feature/#123-user-auth
   └── Tarefa auto-move para "Em Progresso"

3. Escreva código, commit, push
   └── Tarefa fica em "Em Progresso"

4. Abra PR mencionando #123
   └── Tarefa auto-move para "Em Revisão"
   └── PR linked para tarefa

5. Revisor aprova
   └── Tarefa labeled "approved"

6. Faça merge PR
   └── Tarefa auto-move para "Feito"
   └── PR mostra como merged na tarefa

Nenhuma atualização manual de status necessária!

Múltiplas Tarefas por PR

PR MULTI-TAREFA
═══════════════

Descrição PR:
"Implementa sistema de autenticação de usuário

Closes #123 (fluxo auth)
Closes #124 (reset senha)
Related #125 (futuro: 2FA)"

Resultado:
├── #123 → Feito (quando merged)
├── #124 → Feito (quando merged)
└── #125 → Inalterado (related, não closed)

Troubleshooting

Problemas Comuns

GUIA DE TROUBLESHOOTING
═══════════════════════

TAREFA NÃO ATUALIZANDO?
───────────────────────
Verifique:
├── Formato ID de tarefa correto? (#123 não #123)
├── Webhook habilitado?
├── Repositório conectado?
└── Veja logs de integração em settings

TAREFA ERRADA ATUALIZADA?
─────────────────────────
Verifique:
├── ID de tarefa correto em branch/PR?
├── Múltiplas tarefas com mesmo padrão ID?
└── Override manual disponível

PR NÃO LINKADO?
───────────────
Corrija:
├── Edite descrição PR para adicionar ID de tarefa
├── Ou link manualmente da página de tarefa
└── Automação aciona na atualização de descrição

Melhores Práticas

Para Automação Suave

1. Nomeação consistente de branch — Reforce com hooks Git
2. Sempre inclua ID de tarefa — Em branch ou descrição PR
3. Uma tarefa por branch — Quando possível para clareza
4. Use palavras-chave — "Closes", "Fixes", "Resolves" para auto-close
5. Revise logs de integração — Pegue problemas cedo

Anti-Patterns

EVITE ESTES:
✗ Branches sem IDs de tarefa
✗ Erros de digitação em IDs de tarefa
✗ Atualizações manuais de status (derrota propósito)
✗ Ignorando automações falhadas
✗ Múltiplas tarefas não relacionadas em um PR

Soluções Relacionadas

• Como integrar gerenciamento de tarefa com fluxo de trabalho git
• Conectando commits GitHub para tarefas automaticamente
• Automatizando processos de revisão de código