Fluxo de Trabalho do Git

Implemente estratégias de ramificação e fluxos de trabalho de pull request eficazes para colaboração em equipe.

Quando Usar Esta Habilidade

Use esta habilidade quando:

• Estabelecer fluxos de trabalho de Git para a equipe
• Implementar estratégias de ramificação
• Configurar processos de pull request
• Configurar gerenciamento de releases
• Melhorar práticas de revisão de código

Pré-requisitos

• Git instalado
• Hospedagem de repositório (GitHub, GitLab, Bitbucket)
• Conhecimento básico de Git

Estratégias de Ramificação

Desenvolvimento Baseado em Trunk (Trunk-Based Development)

Ideal para: Implantação contínua, equipes pequenas, CI/CD maduro

main ─────●─────●─────●─────●─────●─────●─────●
          │     │     │     │     │     │
          └─●   └─●   └─●   └─●   └─●   └─●
         feature branches (short-lived)

# Create short-lived feature branch
git checkout main
git pull origin main
git checkout -b feature/add-login

# Work and commit frequently
git add .
git commit -m "feat: add login form"

# Keep branch updated
git fetch origin
git rebase origin/main

# Merge quickly (same day ideally)
git checkout main
git pull origin main
git merge feature/add-login
git push origin main
git branch -d feature/add-login

Fluxo do GitHub (GitHub Flow)

Ideal para: Entrega contínua, aplicações web

main ─────●─────●───────────●─────────────●─────●
          │           ↑           ↑       ↑
          └───●───●───┘           │       │
              feature/login       │       │
                                  │       │
          └───●───●───●───●───────┘       │
              feature/dashboard           │
                                          │
          └───●─────────────────────────┘
              hotfix/security-patch

# Create feature branch from main
git checkout main
git pull origin main
git checkout -b feature/user-dashboard

# Push and create PR
git push -u origin feature/user-dashboard

# After review, merge via PR (squash recommended)
# Delete branch after merge

GitFlow

Ideal para: Releases agendados, produtos versionados

main     ────────●────────────────●──────────────●
                 ↑                ↑              ↑
release  ────────┼────●───●──────┼──────────────┼
                 │    │   │      │              │
develop  ───●────●────┼───●──●───●───●───●───●──┼
            │         │      │       │   │      │
feature  ───┴─────────┘      │       │   │      │
                             │       │   │      │
hotfix   ────────────────────┴───────┼───┼──────┘
                                     │   │
feature  ────────────────────────────┴───┘

# Initialize GitFlow
git flow init

# Start feature
git flow feature start user-auth

# Finish feature (merges to develop)
git flow feature finish user-auth

# Start release
git flow release start 1.0.0

# Finish release (merges to main and develop)
git flow release finish 1.0.0

# Hotfix
git flow hotfix start security-fix
git flow hotfix finish security-fix

Convenções de Commit

Commits Convencionais (Conventional Commits)

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

Tipos:

• feat: Nova funcionalidade
• fix: Correção de bug
• docs: Documentação
• style: Formatação
• refactor: Reestruturação de código
• test: Adição de testes
• chore: Manutenção

Exemplos:

git commit -m "feat(auth): add OAuth2 login support"
git commit -m "fix(api): handle null response from payment service"
git commit -m "docs: update API documentation for v2 endpoints"
git commit -m "refactor(db): optimize user query performance"

# Breaking change
git commit -m "feat(api)!: change response format for user endpoint

BREAKING CHANGE: The user endpoint now returns an object instead of array"

Modelo de Mensagem de Commit

# Create template file ~/.gitmessage
# Subject line (50 chars max)

# Body (72 chars per line max)
# - What changed
# - Why it changed
# - Any side effects

# Footer
# Fixes #123
# Co-authored-by: Name <email>

# Configure Git to use template
git config --global commit.template ~/.gitmessage

Fluxo de Trabalho de Pull Request

Modelo de PR

<!-- .github/pull_request_template.md -->
## Descrição
Breve descrição das alterações

## Tipo de Alteração
- [ ] Correção de bug (alteração não quebrável)
- [ ] Nova funcionalidade (alteração não quebrável)
- [ ] Alteração quebrável
- [ ] Atualização de documentação

## Testes
- [ ] Testes unitários adicionados/atualizados
- [ ] Testes de integração adicionados/atualizados
- [ ] Testes manuais realizados

## Checklist
- [ ] O código segue as diretrizes de estilo do projeto
- [ ] Auto-revisão realizada
- [ ] Documentação atualizada

…