5 min leitura • Guide 162 of 877
Configurando Integrações Repositório Git
Vincular seus repositórios Git ao GitScrum cria conexões automáticas entre mudanças código e tarefas projeto. Quando desenvolvedores referenciam task IDs em commits ou pull requests, essas atividades aparecem na timeline tarefa, dando a todos visibilidade progresso código sem sair ferramenta project management.
Por Que Integrar Repositórios Git
Benefícios Linking Código-Tarefa
VALOR INTEGRAÇÃO:
┌─────────────────────────────────────────────────────────────┐
│ O QUE INTEGRAÇÃO GIT FORNECE │
├─────────────────────────────────────────────────────────────┤
│ │
│ PARA DESENVOLVEDORES: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ • Vincular commits a tarefas automaticamente ││
│ │ • Ver contexto tarefa em descrições PR ││
│ │ • Auto-atualizar status tarefa no merge ││
│ │ • Sem context switching entre ferramentas ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ PARA PROJECT MANAGERS: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ • Ver progresso código em tarefas ││
│ │ • Saber quando features estão deployed ││
│ │ • Rastrear quais branches relacionam com features ││
│ │ • Verificar completação trabalho via PR merges ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ PARA O TIME: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ • Audit trail completo: tarefa → código → deploy ││
│ │ • Melhores sprint reviews com links código reais ││
│ │ • Debugging mais fácil: encontrar o que mudou ││
│ │ • Compliance: rastrear requirements a implementação ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘
Integração GitHub
Configurando Conexão GitHub
SETUP GITHUB:
┌─────────────────────────────────────────────────────────────┐
│ CONECTANDO GITHUB AO GITSCRUM │
├─────────────────────────────────────────────────────────────┤
│ │
│ PASSO 1: ACESSAR INTEGRAÇÕES │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Navegar para: Project Settings → Integrations ││
│ │ ││
│ │ Integrações Disponíveis ││
│ │ 🐙 GitHub [Conectar] ││
│ │ 🦊 GitLab [Conectar] ││
│ │ 🪣 Bitbucket [Conectar] ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ PASSO 2: AUTENTICAR │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Click "Conectar" e autorizar GitScrum: ││
│ │ ││
│ │ 1. Redireciona para GitHub OAuth ││
│ │ 2. Autorizar aplicação GitScrum ││
│ │ 3. Selecionar repositórios para acessar ││
│ │ 4. Confirmar permissões ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ PASSO 3: SELECIONAR REPOSITÓRIOS │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Escolher quais repos vincular: ││
│ │ ││
│ │ ☑ acme-corp/frontend ││
│ │ ☑ acme-corp/backend-api ││
│ │ ☐ acme-corp/infrastructure ││
│ │ ☑ acme-corp/mobile-app ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘
Vinculando Commits a Tarefas
Referenciar Tarefas em Mensagens Git
LINKING COMMITS:
┌─────────────────────────────────────────────────────────────┐
│ COMO VINCULAR COMMITS A TAREFAS │
├─────────────────────────────────────────────────────────────┤
│ │
│ REFERENCIANDO TASK IDs: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Incluir task ID na mensagem commit: ││
│ │ ││
│ │ Opções formato: ││
│ │ • #123 - Referência simples ││
│ │ • TASK-123 - Com prefixo projeto ││
│ │ • [GS-123] - Formato brackets ││
│ │ ││
│ │ Exemplos: ││
│ │ git commit -m "Add user validation #456" ││
│ │ git commit -m "[TASK-789] Fix login timeout issue" ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ O QUE ACONTECE: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Quando commit é pushed: ││
│ │ ││
│ │ 1. GitScrum recebe notificação webhook ││
│ │ 2. Parseia mensagem commit por referências tarefa ││
│ │ 3. Vincula commit a tarefa(s) referenciada(s) ││
│ │ 4. Mostra commit no feed atividade tarefa ││
│ │ ││
│ │ View tarefa mostra: ││
│ │ 🔗 Alex committed "Add user validation" ││
│ │ main • a8f3c2d • 2 horas atrás ││
│ │ Ver no GitHub → ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘
Integração Pull Request
PRs e Merge Requests
LINKING PR:
┌─────────────────────────────────────────────────────────────┐
│ CONECTANDO PULL REQUESTS A TAREFAS │
├─────────────────────────────────────────────────────────────┤
│ │
│ LINKING AUTOMÁTICO: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Referenciar tarefas no título ou descrição PR: ││
│ │ ││
│ │ Título PR: ││
│ │ "Feature: Dashboard filtering [#234]" ││
│ │ ││
│ │ Descrição PR: ││
│ │ "Este PR implementa funcionalidade filtering ││
│ │ solicitada na task #234. ││
│ │ ││
│ │ Related: #234, #236" ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ EVENTOS LIFECYCLE PR: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ GitScrum rastreia mudanças estado PR: ││
│ │ ││
│ │ 📋 Alex abriu PR #47 "Dashboard filtering" ││
│ │ 💬 Jordan reviewed PR #47 - Changes requested ││
│ │ ✅ Jordan aprovou PR #47 ││
│ │ 🔀 Alex merged PR #47 into main ││
│ │ Tarefa auto-movida para "Done" ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ AUTO-UPDATES STATUS: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Configurar movimento tarefa automático: ││
│ │ ││
│ │ PR opened → Mover tarefa para "In Review" ││
│ │ PR merged → Mover tarefa para "Done" ││
│ │ PR closed → (sem ação ou custom) ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘