Documentos-Unicos/deploy/versionamento.md

Deploy — Versionamento e saúde

Situação: como a versão é definida e onde ela aparece; como checar saúde.

Versão

• A versão é definida pela tag git (vX.Y.Z) — não se escreve versão à mão em arquivo (não existe mais constants.ts/update-version.js).
• commit/build são carimbados no build da imagem (imutáveis); version/environment são injetados no deploy em runtime (a partir da tag).
• Em DEV a versão aparece como dev (não há release); o número só existe em produção.

Onde a versão aparece (tudo em runtime, lendo /api/version)

• vX.Y.Z fixo no canto inferior direito de toda página.
• Tela de Configurações → "Sobre o sistema".
• O frontend não embute versão — consome GET /api/version. Fonte única = backend.

Endpoints

• GET /api/version → { name, version, commit, build, environment }.
• GET /api/health → { status, version, commit, environment, uptime_s, checks }.
  • banco é crítico: se cair → status: down + HTTP 503.
  • cache é opcional: se cair → status: degraded (HTTP 200); disabled se desligado.