Integração Git Desconectada da Gestão de Projetos

Quando repositórios Git e gestão de projetos vivem em mundos separados, equipes perdem visibilidade sobre qual código suporta quais tarefas. GitScrum integra com GitHub, GitLab e Bitbucket para conectar commits, branches e pull requests.

O Problema da Desconexão

Git separado da gestão de projetos cria fricção:

• Atualizações manuais — Marcar tarefas completas após merges
• Contexto perdido — Sem visibilidade de quais commits suportam quais tarefas
• Esforço duplicado — Escrever descrições de PR e atualizações de tarefas
• Lacunas de auditoria — Rastrear features a requisitos originais
• Sobrecarga de relatórios — Correlacionar manualmente código e progresso

Integrações Git do GitScrum

Conecte seus repositórios ao GitScrum:

Plataformas Suportadas

O Que É Conectado

• Commits vinculados a tarefas via ID de tarefa na mensagem de commit
• Branches rastreados por tarefa
• Pull/Merge Requests visíveis na timeline de tarefa
• Mudanças de status refletidas automaticamente

Configurando Integração Git

Setup do GitHub

1. Ir para Configurações do Projeto → Integrações
2. Selecionar GitHub
3. Autenticar com OAuth
4. Selecionar repositórios para conectar
5. Configurar opções de sync

Setup do GitLab

1. Ir para Configurações do Projeto → Integrações
2. Selecionar GitLab
3. Inserir token de acesso pessoal
4. Selecionar projetos para conectar
5. Configurar notificações webhook

Setup do Bitbucket

1. Ir para Configurações do Projeto → Integrações
2. Selecionar Bitbucket
3. Autenticar com OAuth
4. Selecionar repositórios para conectar
5. Configurar opções de sync

Vinculando Commits a Tarefas

Use IDs de tarefa em mensagens de commit para vincular:

Formato de Mensagem de Commit

git commit -m "Add user authentication [GS-234]"

Formatos Alternativos

# Forma curta
git commit -m "Fix login bug #234"

# Com descrição
git commit -m "Implement OAuth flow

Adds Google OAuth support for user authentication.
Closes GS-234"

# Múltiplas tarefas
git commit -m "Refactor auth module [GS-234] [GS-235]"

O Que Aparece no GitScrum

Tarefa #234: Implementar login OAuth
├── Status: Em Progresso
├── Atividade Git:
│   ├── Commit abc123: "Add user authentication [GS-234]"
│   ├── Branch: feature/oauth-login
│   └── PR #45: "OAuth Implementation" (Aberto)
└── Última atualização: 5 minutos atrás

Tracking de Branches

GitScrum rastreia branches associados a tarefas:

Convenção de Nomes de Branch

feature/GS-234-oauth-login
bugfix/GS-456-login-error
hotfix/GS-789-security-patch

Visibilidade de Branch

• Ver branches ativos por tarefa
• Rastrear status do branch (aberto, merged, deletado)
• Ver histórico de branch na timeline de tarefa

Integração de Pull Requests

Visibilidade de PRs em Tarefas

Quando PRs referenciam IDs de tarefa:

Tarefa #234: Implementar login OAuth
├── Pull Requests:
│   └── #45: "OAuth Implementation"
│       ├── Status: Aberto
│       ├── Autor: @developer
│       ├── Revisores: @senior-dev
│       ├── Checks: ✓ Todos passando
│       └── Comentários: 3

Atualizações Automáticas de Status

Configure auto-transições:

• PR aberto → Tarefa move para "Em Review"
• PR merged → Tarefa move para "Done"
• PR fechado → Tarefa retorna para "Em Progresso"

Timeline de Atividade

Cada tarefa mostra atividade Git cronologicamente:

Tarefa #234: Implementar login OAuth
Timeline:
├── Dez 18, 10:00 — PR #45 merged por @senior-dev
├── Dez 18, 09:30 — PR #45 aprovado por @senior-dev
├── Dez 17, 16:00 — PR #45 aberto por @developer
├── Dez 17, 15:45 — Commit def456: "Add OAuth callback handling"
├── Dez 17, 14:00 — Commit abc123: "Add OAuth initialization"
├── Dez 16, 10:00 — Branch feature/GS-234-oauth-login criado
└── Dez 15, 09:00 — Tarefa criada por @pm

Vinculação Bidirecional

Do GitScrum para Git

• Ver commits, branches, PRs nos detalhes da tarefa
• Clicar para ir ao GitHub/GitLab/Bitbucket
• Ver status de PR e comentários de review

Do Git para GitScrum

• Adicionar links para tarefas em descrições de PR
• Ver contexto de tarefa ao revisar PRs
• Acessar requisitos de tarefa do histórico de commits

Melhores Práticas

Padrões de Mensagens de Commit

1. Incluir ID de tarefa — Todo commit referencia uma tarefa
2. Ser descritivo — Explicar o quê e por quê
3. Manter atômico — Uma mudança lógica por commit
4. Usar formato convencional — type(scope): message [task-id]

Estratégia de Branches

1. Usar ID de tarefa no nome do branch — Vinculação automática
2. Manter branches de vida curta — Merge frequentemente
3. Deletar após merge — Repositório limpo

Workflow de PRs

1. Referenciar tarefa no título ou descrição do PR
2. Usar template de PR que solicite link de tarefa
3. Revisar requisitos da tarefa antes de aprovar

Oportunidades de Automação

Auto-Mover Tarefas em Eventos Git

Notificações Webhook

Enviar eventos Git para GitScrum:

• Pushes de commits
• Mudanças de status de PR
• Criação/deleção de branches
• Solicitações de review

Soluções Relacionadas

• Integração de gestão de projetos com GitHub
• Automação de workflow com GitLab
• Otimização de workflow de desenvolvedor