## Cadência

- Releases incrementais: diárias (dias úteis).
- Releases com breaking change: janela semanal com aviso prévio.
- Hotfix de produção: imediato após validação mínima.

## Semântica de versões

| Tipo | Exemplo | Impacto esperado |
| --- | --- | --- |
| Patch | `2026.03.15-p1` | correções sem alteração de contrato |
| Minor | `2026.03.15-m1` | novas capacidades retrocompatíveis |
| Breaking | `2026.03.15-b1` | alterações de contrato com migração |

## Política de depreciação

<Note title="Janela mínima">Qualquer endpoint com depreciação anunciada mantém-se ativo por pelo menos 90 dias.</Note>

1. Anúncio no changelog com data de remoção.
2. Header de aviso em runtime para clientes afetados.
3. Guia de migração publicado antes da data limite.

## Critérios de release para produção

- ✅ Testes unitários e integração verdes.
- ✅ Migrações reversíveis ou plano de rollback definido.
- ✅ Comunicações de risco distribuídas a suporte e operações.