Notas de versão e mudanças

Selo de estado: Preview — esta página descreve o formato e a disciplina de versões e mudanças. Hoje (teto Preview, sem SLA), não há um histórico público de releases GA: publicamos o formato e o estado atual, sem inventar changelog. Atualizado em 2026-09-08.

Como o ingestia.io identifica versões, comunica mudanças e preserva a compatibilidade — para você planejar integrações com segurança.

Formato da versão#

Cada build carrega uma versão determinística por commit, no formato v1.<dia-do-ano>.<commits-no-dia>, com o hash do commit e o horário de build. Exemplo (sintético): v1.251.2 · commit 4a4ec2f · 2026-09-08T11:29:31Z.

• A versão é auto-gerada no build (não é editada à mão).
• Serve para rastrear qual build está no ar e correlacionar com o suporte.
• Não é um número de release comercial com SLA (o limite atual do produto é Preview).

Fonte da verdade de estado#

O estado de cada capacidade (GA-candidato/Preview/Roadmap/etc.) vem da matriz de estados do produto (matriz de estados do produto) e é refletido no badge de cada página desta documentação. Mudança de estado = mudança de doc no mesmo release — a doc nunca "adianta" um estado que o código não sustenta.

Acompanhe o estado consolidado em Status e limitações.

Compatibilidade e formatos versionados (N−1)#

Formatos que viajam entre versões — widgets, filtros, tema, estado de URL e token de embed — usam envelopes com versão e um decoder N−1 obrigatório:

• Um leitor mais novo sempre consegue ler o formato da versão anterior.
• Um campo desconhecido nunca é descartado silenciosamente na leitura.
• Ao subir uma versão de formato, o decoder anterior é mantido.

Isso significa que links compartilhados, dashboards salvos e tokens de embed continuam válidos através de atualizações.

Mudanças que quebram compatibilidade (breaking changes)#

Quando uma mudança puder afetar integrações, a política é:

• Preferir aditivo: novos campos/opções em vez de remover/renomear.
• Sinalizar o estado: o badge da página muda junto (ex.: de Preview para Roadmap se algo for adiado).
• Comunicar pelo suporte: clientes de superfícies Preview (API/OData, embed, SSO/SCIM) são orientados a acompanhar avisos, pois não há SLA hoje.
• Schema de banco é aditivo: mudanças de schema são aditivas e versionadas (migrations), sem quebrar leituras existentes.

Migrações#

• Formatos de conteúdo (widget/filtro/tema/URL/embed): migração automática na leitura via decoder N−1 — você não precisa reescrever nada.
• Schema de metadados (banco de controle): migrations versionadas aplicadas pela plataforma; nada de ação manual do cliente.
• Dado de negócio (datalake): governado pelo cliente (controlador) — ver Governança e LGPD.

Descontinuação (deprecação)#

• Recursos descontinuados recebem o badge Descontinuado na doc; evite depender deles.
• Recursos ainda não construídos ficam como Roadmap (ex.: CDC verdadeiro, Amazon S3, puxar bucket GCS do cliente, webhooks públicos, API de escrita, chave de API por membro) — ver Status e limitações.

Como saber "o que mudou para mim"#

1. Confira o badge de estado da página da capacidade que você usa.
2. Consulte Status e limitações para o quadro geral.
3. Para integrações, monitore o comportamento das rotas /api/v1 (o formato de erro e os limites estão em Erros e limites).

Limites desta página#

• Sem changelog público GA hoje — a disciplina existe, mas não publicamos um histórico versão-a-versão como compromisso.
• Sem SLA de aviso prévio para mudanças em superfícies Preview.

Relacionados#

• Status e limitações
• Central de Suporte
• Erros, limites e rate limit
• Governança e LGPD

Última revisão: 2026-09-08. Estado & evidência: versão determinística por commit; compatibilidade N−1 dos formatos versionados; estado por matriz de estados do produto. Limite atual do produto = Preview.