Versionamento

A API é versionada via Asp.Versioning. A versão faz parte do caminho da rota.

Como funciona

/v1/ocorrencias   →  versão 1
/v2/ocorrencias   →  versão 2
/v3/ocorrencias   →  versão 3

Cobertura por versão

Versão	Escopo
v1	Superfície principal — 45 controllers. Todo o cadastro, ativos, atividades, relatórios, usuários.
v2	Atividades, Correções, Ocorrências, Prioridades, Unidades.
v3	Ocorrências e Correções (domínios mais evoluídos).

Estratégia de evolução

As versões mais novas concentram-se nos domínios mais quentes — Ocorrências e Correções. Recursos de cadastro permanecem majoritariamente em v1.

Como a lógica de negócio vive na camada de service (não nos controllers), o mesmo comportamento costuma ser compartilhado entre versões. Exemplo: a validação de ocorrência típica protege POST /vN/ocorrencias em v1, v2 e v3 simultaneamente.

Recomendação

• Para ocorrências e correções, prefira v3.
• Para os demais recursos, use v1.
• Sempre fixe a versão explicitamente na URL; não dependa de default.