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)
- PR → lint + testes automatizados
- Build → imagem Docker → GHCR
- Deploy automático em staging
- 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
/healthrespondendo em staging (API + BFF) - Observabilidade baseline —
/metrics(Prometheus) + OpenTelemetry no API; smoke CD emcd.yml— ver OBSERVABILITY_BASELINE.md