GitScrum / Docs
Todas as Boas Práticas

Integração Git com Gestão Projetos | GitHub GitLab GitScrum

Conecte GitHub, GitLab, Bitbucket às tarefas: commits, branches, PRs vinculados automaticamente. GitScrum auto-atualiza status em eventos Git.

6 min de leitura

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

PlataformaRecursos
GitHubCommits, branches, PRs, sync de issues
GitLabCommits, branches, MRs, sync de issues
BitbucketCommits, branches, PRs

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

  • Ir para Configurações do Projeto → Integrações
  • Selecionar GitHub
  • Autenticar com OAuth
  • Selecionar repositórios para conectar
  • Configurar opções de sync

    • Setup do GitLab

  • Ir para Configurações do Projeto → Integrações
  • Selecionar GitLab
  • Inserir token de acesso pessoal
  • Selecionar projetos para conectar
  • Configurar notificações webhook

    • Setup do Bitbucket

  • Ir para Configurações do Projeto → Integrações
  • Selecionar Bitbucket
  • Autenticar com OAuth
  • Selecionar repositórios para conectar
  • 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

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

    • Estratégia de Branches

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

    • Workflow de PRs

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

    • Oportunidades de Automação

    Auto-Mover Tarefas em Eventos Git

    Evento GitTransição de Tarefa
    Branch criadoA Fazer → Em Progresso
    PR abertoEm Progresso → Code Review
    PR aprovadoCode Review → Pronto para Merge
    PR mergedPronto para Merge → Done
    PR fechado (não merged)Code Review → Em Progresso

    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