4 min leitura • Guide 489 of 877
Integração de Workflow Git
Conectar atividade Git à gestão de projetos cria rastreabilidade completa de requisitos até código. A integração nativa Git do GitScrum automaticamente vincula commits, branches e pull requests a tarefas, fornecendo visibilidade em tempo real do progresso de desenvolvimento sem atualizações manuais de status.
Benefícios da Integração Git
| Sem Integração | Com Integração |
|---|---|
| Atualizações manuais de status | Automático de atividade Git |
| Sem rastreabilidade | Commits vinculados a tarefas |
| Troca de contexto | Única fonte de verdade |
| Entrada de info duplicada | Sincronizado automaticamente |
| Review sem contexto | PR mostra tarefa relacionada |
Workflow Git com GitScrum
WORKFLOW DE DESENVOLVIMENTO INTEGRADO
1. PEGAR TAREFA
┌─────────────────────────────────────────────────┐
│ Dev se atribui à tarefa GS-456 │
│ Tarefa: "Adicionar autenticação de usuário" │
│ Status: A Fazer → Em Progresso │
└─────────────────────────────────────────────────┘
│
▼
2. CRIAR BRANCH
┌─────────────────────────────────────────────────┐
│ git checkout -b feature/GS-456-user-auth │
│ │
│ GitScrum detecta: Branch vinculada à GS-456 │
│ Status: Atualizado automaticamente │
└─────────────────────────────────────────────────┘
│
▼
3. COMMIT COM REFERÊNCIA
┌─────────────────────────────────────────────────┐
│ git commit -m "GS-456: Add login endpoint" │
│ git commit -m "GS-456: Add auth middleware" │
│ │
│ GitScrum: Commits aparecem na timeline tarefa │
└─────────────────────────────────────────────────┘
│
▼
4. ABRIR PULL REQUEST
┌─────────────────────────────────────────────────┐
│ PR Title: "GS-456: User authentication" │
│ Description: Vincula à tarefa automaticamente │
│ │
│ GitScrum: PR vinculado, status → Em Review │
└─────────────────────────────────────────────────┘
│
▼
5. MERGE & COMPLETAR
┌─────────────────────────────────────────────────┐
│ PR mergeado para main │
│ │
│ GitScrum: Status → Done │
│ Histórico completo preservado │
└─────────────────────────────────────────────────┘
Convenções de Nomenclatura de Branch
PADRÕES DE NOMENCLATURA DE BRANCH
FORMATO: <tipo>/<task-id>-<descrição-curta>
EXEMPLOS:
┌─────────────────────────────────────────────────┐
│ feature/GS-123-user-authentication │
│ bugfix/GS-456-fix-login-error │
│ hotfix/GS-789-security-patch │
│ refactor/GS-101-cleanup-api │
└─────────────────────────────────────────────────┘
PREFIXOS DE TIPO:
• feature/ - Novas features
• bugfix/ - Correções de bug
• hotfix/ - Emergência produção
• refactor/ - Melhoria de código
• docs/ - Documentação
• test/ - Adições de teste
Formato de Mensagem de Commit
CONVENTIONAL COMMITS COM TASK ID
FORMATO:
<task-id>: <tipo>: <descrição>
EXEMPLOS:
┌─────────────────────────────────────────────────┐
│ GS-123: feat: add user registration endpoint │
│ GS-123: test: add registration tests │
│ GS-456: fix: resolve null pointer in login │
│ GS-789: docs: update API documentation │
└─────────────────────────────────────────────────┘
TIPOS:
• feat - Nova feature
• fix - Correção de bug
• docs - Documentação
• style - Formatação
• refactor - Reestruturação de código
• test - Testes
• chore - Manutenção
Automação de Status
REGRAS DE AUTOMAÇÃO
TRIGGER AÇÃO
─────────────────────────────────────────────────
Branch criada → Tarefa → Em Progresso
PR aberto → Tarefa → Em Review
PR aprovado → Tarefa → Aprovado
PR mergeado → Tarefa → Done
Branch deletada → Cleanup referências
CONFIGURAÇÃO NO GITSCRUM:
Settings → Integrations → Git → Automation Rules