# 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.