8 min leitura • Guide 864 of 877
Vincular tarefas a repositórios GitHub, GitLab e Bitbucket
Conectar tarefas a repositórios de código elimina a lacuna entre gerenciamento de projetos e trabalho real de desenvolvimento. Quando commits, branches e pull requests se vinculam diretamente a tarefas, equipes obtêm visibilidade completa sobre quais mudanças de código correspondem a quais requisitos—sem mais adivinhações ou rastreamento manual.
Visão Geral da Integração Git
| Plataforma | Método de Conexão | Recursos |
|---|---|---|
| GitHub | OAuth + Webhook | Commits, PRs, branches, issues |
| GitLab | OAuth + Webhook | Commits, MRs, branches |
| Bitbucket | OAuth + Webhook | Commits, PRs, branches |
Configurar Integração Git
CONECTAR SEU REPOSITÓRIO
════════════════════════
PASSO 1: ACESSAR CONFIGURAÇÕES DE INTEGRAÇÃO
─────────────────────────────────────
GitScrum → Projeto → Configurações → Integrações
├── Selecionar "GitHub" / "GitLab" / "Bitbucket"
├── Clicar em "Conectar"
└── Autorizar acesso do GitScrum
PASSO 2: SELECIONAR REPOSITÓRIO
─────────────────────────────────────
Após autorização:
├── Lista de repositórios aparece
├── Selecionar repositório do projeto
├── Configurar webhook automaticamente
└── Status de conexão: "Conectado"
PASSO 3: CONFIGURAR COMPORTAMENTO
─────────────────────────────────────
Configurações opcionais:
├── Padrão de nomes de branches
├── Formato de mensagens de commit
├── Template de descrição de PR
└── Mover automático no merge
VERIFICAÇÃO:
─────────────────────────────────────
┌─────────────────────────────────────┐
│ Integração GitHub │
│ ──────────────────────────────── │
│ Repositório: acme/dashboard │
│ Status: ✓ Conectado │
│ Última sincronização: 2 min atrás │
│ │
│ [Desconectar] [Atualizar] [Config] │
└─────────────────────────────────────┘
Vincular Commits a Tarefas
CONVENÇÕES DE MENSAGENS DE COMMIT
═════════════════════════════════
REFERENCIAR TAREFA NO COMMIT:
─────────────────────────────────────
Incluir ID da tarefa na mensagem de commit:
git commit -m "Adicionar validação de pagamento #task-123"
git commit -m "Corrigir bug de login [GS-456]"
git commit -m "Implementar endpoint de API (Task: 789)"
GitScrum automaticamente:
├── Detecta referência da tarefa
├── Vincula commit à tarefa
├── Mostra commit na atividade da tarefa
└── Atualiza linha do tempo da tarefa
COMMIT APARECE NA TAREFA:
─────────────────────────────────────
┌─────────────────────────────────────────────────┐
│ Tarefa: Implementar validação de pagamentos │
├─────────────────────────────────────────────────┤
│ ATIVIDADE │
│ │
│ 🔀 Commit vinculado 2 min atrás│
│ "Adicionar validação de pagamento #task-123"│
│ por joao@acme.co │
│ → main (a4f2b1c) │
│ │
│ 💬 Comentário adicionado 1 hora atrás│
│ "Começando implementação agora" │
│ │
└─────────────────────────────────────────────────┘
MELHORES PRÁTICAS:
─────────────────────────────────────
✓ Sempre referenciar ID da tarefa nos commits
✓ Usar formato consistente em toda equipe
✓ Incluir ID da tarefa na primeira linha
✓ Adicionar contexto no corpo do commit
Nomenclatura de Branches para Vinculação
CONVENÇÕES DE NOMES DE BRANCHES
═══════════════════════════════
FORMATOS RECOMENDADOS:
─────────────────────────────────────
feature/task-123-validacao-pagamentos
bugfix/GS-456-erro-login
hotfix/789-correcao-seguranca-critica
Estrutura:
├── tipo/ → feature, bugfix, hotfix
├── task-id → coincide com tarefa GitScrum
└── descricao → resumo legível
VINCULAÇÃO AUTOMÁTICA DE BRANCHES:
─────────────────────────────────────
Quando branch contém ID da tarefa:
├── GitScrum detecta criação do branch
├── Vincula branch à tarefa
├── Mostra status do branch na tarefa
└── Rastreia ciclo de vida do branch
VISUALIZAÇÃO DA TAREFA COM BRANCH:
─────────────────────────────────────
┌─────────────────────────────────────────────────┐
│ Tarefa: Validação de pagamentos │
├─────────────────────────────────────────────────┤
│ STATUS │
│ ────── │
│ Coluna: Em Progresso │
│ Branch: feature/task-123-validacao-pagamentos │
│ ↳ 3 commits à frente do main │
│ PR: #42 (Aberto - Pronto para revisão) │
│ │
└─────────────────────────────────────────────────┘
Integração de Pull Requests
VINCULAR PULL REQUESTS A TAREFAS
════════════════════════════════
TEMPLATE DE DESCRIÇÃO DE PR:
─────────────────────────────────────
## Resumo
Implementa lógica de validação de pagamentos.
## Tarefa Relacionada
Closes #task-123
## Mudanças
- Adicionado middleware de validação
- Atualizadas respostas da API
- Adicionados testes unitários
## Testes
- [x] Testes unitários passando
- [x] Testes manuais completos
DETECÇÃO DO GitScrum:
─────────────────────────────────────
Quando PR é aberto:
├── Detecta referência da tarefa
├── Vincula PR à tarefa
├── Mostra status do PR na tarefa
└── Atualiza com mudanças do PR
CICLO DE VIDA DO PR NA TAREFA:
─────────────────────────────────────
┌─────────────────────────────────────┐
│ Pull Request #42 │
│ ────────────────── │
│ Status: Aberto │
│ Revisões: 1/2 aprovadas │
│ Checks: ✓ Todos passando │
│ Mergeável: Sim │
│ │
│ [Ver no GitHub] │
└─────────────────────────────────────┘
Atualizações Automáticas de Tarefas
AUTOMATIZAR FLUXO COM EVENTOS GIT
═════════════════════════════════
AUTOMAÇÃO DE COLUNA: NO MERGE DE PR
─────────────────────────────────────
Config. Projeto → Board → Config. Coluna → Done
Gatilho de automação:
├── Quando: Pull Request mergeado
├── Ação: Mover tarefa para esta coluna
├── Adicional: Auto-arquivar após 7 dias
Resultado:
├── Desenvolvedor mergeia PR
├── Tarefa move para Done automaticamente
├── Não precisa atualização manual
└── Status do projeto sempre preciso
FLUXO DE AUTOMAÇÃO:
─────────────────────────────────────
Desenvolvedor GitScrum
│ │
│ Criar branch │
│ feature/task-123-... │
├──────────────────────────►│ Branch vinculado
│ │
│ Push commits │
│ "Fix validação #123" │
├──────────────────────────►│ Commits vinculados
│ │
│ Abrir Pull Request │
│ │
├──────────────────────────►│ PR vinculado
│ │ Tarefa → Em Revisão
│ │
│ Mergear PR │
│ │
├──────────────────────────►│ Tarefa → Done
│ │ (automático)
│ │
Projetos Multi-Repositório
TRABALHAR COM MÚLTIPLOS REPOS
═════════════════════════════
CENÁRIO: FRONTEND + BACKEND
─────────────────────────────────────
Projeto: Plataforma E-commerce
├── Repo 1: acme/frontend (React)
├── Repo 2: acme/backend (Node.js)
└── Repo 3: acme/mobile (React Native)
CONFIGURAÇÃO:
─────────────────────────────────────
1. Conectar todos os repos ao mesmo projeto
2. Usar referências de tarefas consistentes
3. Rastrear trabalho multi-repo em uma só tarefa
TAREFA COM MÚLTIPLOS REPOS:
─────────────────────────────────────
┌─────────────────────────────────────────────────┐
│ Tarefa: Implementar fluxo de checkout │
├─────────────────────────────────────────────────┤
│ CÓDIGO VINCULADO │
│ │
│ acme/frontend │
│ ├── Branch: feature/task-123-checkout │
│ ├── Commits: 5 │
│ └── PR: #67 (Mergeado) │
│ │
│ acme/backend │
│ ├── Branch: feature/task-123-checkout-api │
│ ├── Commits: 8 │
│ └── PR: #45 (Aberto) │
│ │
└─────────────────────────────────────────────────┘
Visibilidade e Relatórios
DADOS GIT NOS RELATÓRIOS DO PROJETO
═══════════════════════════════════
MÉTRICAS POR TAREFA:
─────────────────────────────────────
Para cada tarefa:
├── Total de commits
├── Contribuidores
├── Linhas alteradas (+/-)
├── Tempo do primeiro commit até merge
└── Tempo de resposta de revisão
MÉTRICAS DO PROJETO:
─────────────────────────────────────
Em todo o projeto:
├── Commits por sprint
├── PRs abertos/mergeados/fechados
├── Tempo médio para merge
├── Churn de código por feature
└── Atividade de contribuidores
RELATÓRIO DE SPRINT COM DADOS GIT:
─────────────────────────────────────
┌─────────────────────────────────────────────────┐
│ Sprint 24 - Atividade de Código │
├─────────────────────────────────────────────────┤
│ │
│ Commits: 127 │
│ Pull Requests: 18 (16 mergeados, 2 abertos) │
│ Contribuidores: 5 │
│ Linhas Adicionadas: 2.340 │
│ Linhas Removidas: 890 │
│ │
│ Revisão PR Média: 4,2 horas │
│ Tempo Merge Médio: 6,8 horas │
│ │
└─────────────────────────────────────────────────┘
Passos de Implementação no GitScrum
GUIA COMPLETO DE CONFIGURAÇÃO
═════════════════════════════
PASSO 1: CONECTAR REPOSITÓRIO
─────────────────────────────────────
Config. Projeto → Integrações
├── Selecionar provedor (GitHub/GitLab/Bitbucket)
├── Autorizar OAuth
├── Selecionar repositório
└── Verificar conexão
PASSO 2: CONFIGURAR CONVENÇÕES DA EQUIPE
─────────────────────────────────────
Acordar:
├── Nomes de branches: tipo/task-id-descricao
├── Formato de commit: "Mensagem #task-id"
├── Template de PR com referência à tarefa
└── Documentar na wiki do projeto
PASSO 3: CONFIGURAR AUTOMAÇÕES
─────────────────────────────────────
Config. Board → Automações de Coluna
├── "Em Revisão" → Quando PR aberto
├── "Done" → Quando PR mergeado
└── Habilitar notificações
PASSO 4: TREINAR A EQUIPE
─────────────────────────────────────
Compartilhar com desenvolvedores:
├── Como referenciar tarefas
├── Convenções de nomes de branches
├── Comportamento esperado das automações
└── Benefícios da vinculação
PASSO 5: MONITORAR E REFINAR
─────────────────────────────────────
Após 1-2 sprints:
├── Verificar precisão da vinculação
├── Revisar gatilhos de automação
├── Coletar feedback da equipe
└── Ajustar convenções conforme necessário
Melhores Práticas
- Nomenclatura consistente - Usar nomes padrão de branches com IDs de tarefas
- Referenciar nos commits - Sempre incluir ID da tarefa nas mensagens de commit
- Templates de PR - Criar templates que peçam referência à tarefa
- Automatizar transições - Configurar movimentações de coluna em eventos de PR
- Conectar todos os repos - Vincular todos os repositórios do projeto para visibilidade completa
- Treinar a equipe - Garantir que todos conheçam as convenções
- Revisar regularmente - Verificar se a vinculação funciona como esperado
- Documentar convenções - Armazenar padrões da equipe no NoteVault