Git Pie: A Arte Ancestral do Versionamento 🥧 Help

Feature Branch Workflow

Imagine que cada nova funcionalidade é como uma nova cena do American Pie - precisa ser filmada separadamente antes de entrar no filme final!

Como Funciona?

mainfeature/loginfeature/perfil0-82731dc1-b05566f2-957ba213-2e3aea24-cb92d905-870d5037-31b31a3

Regras do Jogo

1. Uma Branch por Feature

Main

feature/login

feature/perfil

feature/chat

Pull Request

2. Processo de Review

MainReviewerDevMainReviewerDevCria BranchDesenvolvePull RequestCode ReviewFeedbackAjustesAprova & Merge

Anatomia de uma Feature Branch

main │ ├── feature/login │ ├── commit: "Adiciona form" │ ├── commit: "Valida campos" │ └── commit: "Integra API" │ ├── feature/perfil │ ├── commit: "Layout base" │ └── commit: "Upload foto" │ └── feature/chat └── commit: "MVP chat"

Fluxo de Trabalho

1. Iniciando uma Feature

git checkout -b feature/nova-funcionalidade

2. Desenvolvimento

mainfeature/nova0-cdc8ebdinicialwipajustesfinaliza

3. Mantendo Atualizado

MainFeature BranchMainFeature Branchgit pull origin mainAtualiza BranchResolve Conflitos

Boas Práticas

1. Nomes de Branches

✅ feature/adiciona-login ✅ feature/perfil-usuario ✅ feature/chat-tempo-real ❌ feature/f1 ❌ nova-coisa ❌ mudancas-jim

2. Commits Organizados

mainfeature/login0-c010613feat: form basefeat: validaçãotest: casos loginfix: feedback erro

Pull Requests

Estrutura Ideal

📝 Pull Request: Adiciona Sistema de Login ✨ O que foi feito: - Form de login responsivo - Validação de campos - Integração com API - Testes unitários 🔍 Como testar: 1. Checkout na branch 2. npm install 3. npm run test 4. Teste manual do form 📸 Screenshots: [imagens do antes/depois]

Resolução de Conflitos

Simples

Complexo

Conflito Detectado

Tipo?

Resolve Local

Consulta Time

Testa

Commit Resolution

Dicas de Sobrevivência

1. Mantenha as Features Pequenas

Grande Feature ❌ ├── 2 semanas ├── 50 arquivos └── Difícil review Features Menores ✅ ├── 2-3 dias ├── 5-10 arquivos └── Review tranquilo

2. Review Checklist

Code ReviewFuncionalidadeQualidadeTestesDocumentaçãoRequisitos OKCasos de UsoClean CodePerformanceUnitáriosIntegraçãoComentáriosREADME

Métricas de Sucesso

📊 Indicadores Saudáveis Tempo de Branch ┌────────────┐ 2-3 dias |██████░░░░░░| ✅ Tamanho do PR ┌────────────┐ 200-400 linhas |████░░░░░░░░| ✅ Taxa de Aprovação ┌────────────┐ Primeira review |████████░░░░| ✅

Conclusão

Feature Branch Workflow é como dirigir na sua própria pista: você tem liberdade para desenvolver no seu ritmo, mas sempre seguindo as regras de trânsito para chegar seguro ao destino!

Feature BranchIsolamentoQualidadeColaboraçãoDesenvolvimento SeguroExperimentosCode ReviewTestesFeedbackConhecimento
21 abril 2025