Snapshot (base do mês)

Contexto

A Orbio trabalha com snapshots mensais para garantir reprodutibilidade e consistência.

O que é um snapshot

• É a versão mensal da base de dados.
• Aparece nas respostas como snapshot (ex.: 2026-01).
• A data do snapshot aparece como snapshot_date (ex.: 2026-01-31).
• O snapshot ativo pode ser consultado em GET /v1/status (ver Status).

Por que existe

• Reprodutibilidade: mesmos filtros + mesmo snapshot → mesma lista.
• Auditoria: facilita comparar resultados ao longo do tempo.
• Estabilidade: evita mudanças inesperadas durante a execução.

Implicações

• Dados não são "em tempo real".
• Para comparar períodos, execute buscas com snapshots diferentes.