Estratégia de branches: pipeline de promoção com back-merge · 4 branches = 4 ambientes
O código sobe degrau a degrau rumo à produção (promoção) e as correções descem de volta (back-merge). Nenhum degrau é pulado.
| Branch | Ambiente | Equipe dona | Commit direto? | Pergunta-chave |
|---|---|---|---|---|
| dev/Alpha | Desenvolvimento | Alpha — novos recursos | ✅ via feature/* | "O recurso funciona?" |
| dev/Stable | Integração | Stable — testes iniciais + correções | ✅ correções | "Está integrado e estável?" |
| dev/qa | Homologação | QA externa — só testa | ❌ só leitura | "Está aprovado p/ produção?" |
| main | Produção | Deploy — release | ❌ só merge/hotfix | "Está no ar?" |
Dois ciclos completos de release (v2 e v3) com os casos eventuais embutidos: features paralelas, feature descartada, feature flag, bug em QA e hotfix de produção.
Desenvolvimento na Alpha. Equipe Alpha cria A, B e G dark via feature/*. G é grande e sobe atrás de feature flag desligada.
Feature freeze → Alpha → Stable. Fim do sprint: tag de freeze + PR dev/Alpha → dev/Stable. A Stable puxa o ponto congelado.
Estabilização (fix1). Problemas de integração são corrigidos na própria Stable.
Back-merge Stable → Alpha (crítico). fix1 desce imediatamente; a Alpha segue com C sobre base limpa.
Promoção Stable → qa. Testes verdes → deploy em homologação; QA externa inicia os testes formais.
Bug em QA (qafix1). QA não escreve código: fix na Stable → re-promove para qa e desce imediatamente por back-merge para a Alpha.
Sign-off e release. dev/qa → main, tag v2.0, deploy. G vai para produção apagada — risco zero.
Back-merge em cascata. main → Stable → Alpha: o invariante é restaurado.
Novas features + flag ON. Alpha cria D e liga a flag de G — sem big-bang merge.
Feature descartada. E é revertida na Alpha, antes do freeze — nunca chega à Stable.
Hotfix de produção (v2.0.1). Corrige direto em main e desce em cascata main → qa → Stable → Alpha.
Freeze do v3. Alpha congela (D, G on, C, sem E). Stable integra (fix2) e devolve por back-merge; Alpha segue com F.
Release v3. Stable → qa → aprovação → main com tag v3.0 + back-merge em cascata.
Só entram no freeze as dev-completas; as demais ficam para o próximo trem de release.
Cortada na Alpha, antes do freeze → não propaga aos ambientes a jusante.
G viaja "dark" pelas releases e é ativada quando pronta — desacopla deploy de release.
QA reporta → correção na Stable → re-promove. A QA nunca commita.
Bug crítico não sobe a escada: corrige em main e desce para todos.
| Movimento | Direção | Gatilho | Quem executa | Mecanismo |
|---|---|---|---|---|
Alpha → Stable | ⬆ promover | Feature freeze (fim de sprint) | Stable puxa | PR dev/Alpha → dev/Stable |
Stable → Alpha | ⬇ back-merge | Toda correção na Stable | Alpha integra | merge diário dev/Stable → dev/Alpha |
Stable → qa | ⬆ promover | Lote estável, testes verdes | Deploy | PR + deploy homologação |
qa → Stable | ⬇ bounce | Bug achado pela QA | Stable corrige | fix na Stable → re-promove |
qa → main | ⬆ promover | Sign-off formal da QA | Deploy | PR dev/qa → main + tag + deploy |
main → qa → Stable → Alpha | ⬇ cascata | Release ou hotfix | Deploy + cascata | back-merge em cadeia |
Mantido pelos back-merges. É isto que impede a Alpha de editar código antigo já estabilizado: ela já tem a versão corrigida antes de continuar. Se o invariante quebrar, faltou um back-merge.
dev/Alphafeature/* por recursoqamain/qa intocáveismain → cascatamain ⊆ qa ⊆ Stable ⊆ Alpha.main e desce em cascata para todos.