Fase 52: Fundação Técnica e CI/CD

Duração: 4 semanas (28 dias úteis)
Prioridade: 🔴 P0 (Bloqueador de produção)
Onda: S0 — Fundação técnica
Depende de: Fases 1–4 (observabilidade, testes)
Estimativa Total: 112 horas
Status: ✅ Completo (2026-07-01)
Handoff: Plano Operacional


Objetivo

Estabelecer a cadeia de entrega do código ao ambiente executável: pipelines CI/CD, registry de imagens, ambientes dev/staging e gestão de segredos — pré-requisito para qualquer território em produção.


Entregas

Pipeline de aplicação (app · api · cockpit)

  1. PR → lint + testes automatizados
  2. Build → imagem Docker → GHCR
  3. Deploy automático em staging
  4. Gate manual → promoção prod

Ambientes

Ambiente Uso Promoção
dev Branch/PR, dados sintéticos Automático por PR
staging Integração, e2e, sandbox PSP Verde nos testes
prod Multi-instância por território Aprovação + gate backup

Ferramentas (referência)

  • GitHub Actions, GHCR, GitHub Secrets
  • Prometheus + Grafana + OpenTelemetry (baseline)
  • PostgreSQL gerenciado, Object Storage + CDN

Critérios de aceite

  • Todo PR dispara build + testes; merge bloqueado se falhar (CI + branch protection recomendado)
  • Imagem versionada publicada no GHCR a cada merge em main
  • Staging recebe deploy automático (deploy-staging.yml); prod exige gate (deploy-production.yml)
  • Secrets não aparecem em logs nem no repositório — ver CI_CD_PIPELINE.md
  • Health check /health respondendo em staging (API + BFF)
  • Observabilidade baseline — /metrics (Prometheus) + OpenTelemetry no API; smoke CD em cd.yml — ver OBSERVABILITY_BASELINE.md

Referências