Nordix Code — Fluxo do Código

Estratégia de branches: pipeline de promoção com back-merge · 4 branches = 4 ambientes

1A escada de maturidade

O código sobe degrau a degrau rumo à produção (promoção) e as correções descem de volta (back-merge). Nenhum degrau é pulado.

dev/Alpha🔧 Desenvolvimento
dev/Stable🧪 Integração
dev/qa✅ Homologação
main🚀 Produção
⮕ promoção sobe em checkpoints aprovados
⇠ back-merge correções descem imediatamente
BranchAmbienteEquipe donaCommit direto?Pergunta-chave
dev/AlphaDesenvolvimentoAlpha — novos recursos✅ via feature/*"O recurso funciona?"
dev/StableIntegraçãoStable — testes iniciais + correções✅ correções"Está integrado e estável?"
dev/qaHomologaçãoQA externa — só testa❌ só leitura"Está aprovado p/ produção?"
mainProduçãoDeploy — release❌ só merge/hotfix"Está no ar?"

2Diagrama mestre — do v1 ao v3

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.

Ciclo da release v2main 🚀dev/qa ✅dev/Stable 🧪dev/Alpha 🔧Ciclo da release v3 — com casos eventuaismain 🚀dev/qa ✅dev/Stable 🧪dev/Alpha 🔧v1.0ABG darkfix1Cqafix1v2.0⋯⋯⋯⋯⋯⋯⋯⋯D + G onEE revertedhotfixv2.0.1fix2Fv3.0promoção (sobe)back-merge (desce)
A, B features do v2 G dark feature longa, sobe com flag OFF fix1/fix2 estabilização na Stable qafix1 bug da QA corrigido na Stable C, F features iniciadas após back-merge D + G on feature do v3 + flag de G ligada E → E reverted feature descartada antes do freeze hotfix correção emergencial em produção

3Narração fase a fase

🟦 Ciclo da release v2

1

Desenvolvimento na Alpha. Equipe Alpha cria A, B e G dark via feature/*. G é grande e sobe atrás de feature flag desligada.

2

Feature freeze → Alpha → Stable. Fim do sprint: tag de freeze + PR dev/Alpha → dev/Stable. A Stable puxa o ponto congelado.

3

Estabilização (fix1). Problemas de integração são corrigidos na própria Stable.

4

Back-merge Stable → Alpha (crítico). fix1 desce imediatamente; a Alpha segue com C sobre base limpa.

5

Promoção Stable → qa. Testes verdes → deploy em homologação; QA externa inicia os testes formais.

6

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.

7

Sign-off e release. dev/qa → main, tag v2.0, deploy. G vai para produção apagada — risco zero.

8

Back-merge em cascata. main → Stable → Alpha: o invariante é restaurado.

🟩 Ciclo da release v3 — com casos eventuais

9

Novas features + flag ON. Alpha cria D e liga a flag de G — sem big-bang merge.

10

Feature descartada. E é revertida na Alpha, antes do freeze — nunca chega à Stable.

11

Hotfix de produção (v2.0.1). Corrige direto em main e desce em cascata main → qa → Stable → Alpha.

12

Freeze do v3. Alpha congela (D, G on, C, sem E). Stable integra (fix2) e devolve por back-merge; Alpha segue com F.

13

Release v3. Stable → qa → aprovação → main com tag v3.0 + back-merge em cascata.

4Casos eventuais de features

a) Features paralelas

Só entram no freeze as dev-completas; as demais ficam para o próximo trem de release.

dev/Alphafeature/Afeature/Bfeature/Xfreeze 🧊incompleta — não entra no freeze, fica p/ próxima releasesó features dev-completas

b) Feature descartada

Cortada na Alpha, antes do freeze → não propaga aos ambientes a jusante.

maindev/AlphabaseEE revertedmerge sem efeito de E

c) Feature de longa duração + feature flag

G viaja "dark" pelas releases e é ativada quando pronta — desacopla deploy de release.

main 🚀dev/qadev/Stabledev/AlphaG dark 🚩 offv2.0G no código, porém OFFreleases depoisv3.0flag ON → G ativa

d) Bug encontrado na QA

QA reporta → correção na Stable → re-promove. A QA nunca commita.

dev/qa ✅dev/Stabledev/Alpha🐞 bug encontradoreportaqafixre-promoveback-mergea QA nunca commita

e) Hotfix de produção

Bug crítico não sobe a escada: corrige em main e desce para todos.

main 🚀dev/qadev/Stabledev/Alpha🚨 bug críticohotfixv2.0.1cascata: todos recebem a correçãodeploy imediato

5Promoção × Back-merge

main 🚀 Deploydev/qa ✅ QAdev/Stable 🧪 Stabledev/Alpha 🔧 Alpha1️⃣ freeze2️⃣ deploy→QA3️⃣ sign-offback-merge / hotfixback-mergeback-merge
Setas cheias ⮕ promoção: código sobe em checkpoints com aprovação Setas tracejadas ⇠ back-merge: correções descem imediatamente após cada fix

6Gatilhos — quando ocorre cada migração

MovimentoDireçãoGatilhoQuem executaMecanismo
Alpha → Stable⬆ promoverFeature freeze (fim de sprint)Stable puxaPR dev/Alpha → dev/Stable
Stable → Alpha⬇ back-mergeToda correção na StableAlpha integramerge diário dev/Stable → dev/Alpha
Stable → qa⬆ promoverLote estável, testes verdesDeployPR + deploy homologação
qa → Stable⬇ bounceBug achado pela QAStable corrigefix na Stable → re-promove
qa → main⬆ promoverSign-off formal da QADeployPR dev/qa → main + tag + deploy
main → qa → Stable → Alpha⬇ cascataRelease ou hotfixDeploy + cascataback-merge em cadeia

7A Regra de Ouro (o invariante)

Toda branch de desenvolvimento contém tudo o que existe nas branches mais próximas da produção
main ⊆ dev/qa ⊆ dev/Stable ⊆ dev/Alpha

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.

8Checklist por equipe

🔧 Alpha

  • Parte sempre da dev/Alpha
  • Um feature/* por recurso
  • Sobe incompleto atrás de flag
  • Integra back-merges no dia

🧪 Stable

  • Puxa só o freeze
  • Corrige na própria Stable
  • Back-merge após cada fix
  • Sinaliza prontidão p/ qa

✅ QA

  • Não commita
  • Reporta bugs à Stable
  • Aprova/reprova o lote
  • Testa o que está em qa

🚀 Deploy

  • main/qa intocáveis
  • Promove só com sign-off
  • Tag + deploy + cascata
  • Hotfix em main → cascata

9Regras de ouro

🔼 Sobe um degrau por vezAlpha → Stable → qa → main.
🔽 Correção desce na horaBack-merge no mesmo dia.
🧊 Promoção só em ponto congeladoNunca "no meio do trabalho".
✋ QA não escreve códigoBugs voltam para a Stable.
🔒 main e qa são intocáveisSó recebem merge.
🧬 Invariantemain ⊆ qa ⊆ Stable ⊆ Alpha.
🚩 Feature flagsDesacoplam deploy de release e reduzem divergência.
🚨 HotfixCorrige em main e desce em cascata para todos.