Skip to content
Docs

This page has not been translated yet — you are reading the Portuguese version. View in Portuguese

PreviewUpdated on 2026-09-08

Conceitos essenciais

O vocabulário do ingestia.io — organização, workspace, dataset, fonte, pipeline, modelo, painel e relatório — em uma página.

On this page (7)

Selo de estado: Preview (limite atual do produto) · Atualizado em 2026-09-08 · Fonte da verdade de estado: matriz de estados do produto.

Esta página define, uma vez só, as palavras que aparecem em todo o resto da documentação. Leia antes de seguir para a jornada — depois tudo fica mais rápido.

Estrutura e acesso#

  • Conta (usuário): sua identidade de login (Google, e-mail/senha ou SSO corporativo em Preview). Uma pessoa participa de vários workspaces.
  • Organização: camada puramente administrativa que agrupa N workspaces (útil para agências, BPOs e grupos multi-CNPJ). A organização NÃO dá acesso a dados — quem administra a org (org_admin) não enxerga automaticamente os dados de nenhum workspace.
  • Workspace: a unidade de isolamento real. Cada workspace tem seu próprio datalake, suas pessoas, seu plano e sua cobrança. Acesso a dados sempre exige participação (membership) no workspace específico.
  • Papel (RBAC): o que você pode fazer — 5 níveis de workspace (owner ⊇ admin ⊇ member ⊇ viewer) + org_admin. Fail-closed: papel desconhecido vira viewer. Ver Papéis (RBAC).
  • Permissões finas: chaves booleanas do membro (executar pipeline, rodar queries, exportar, ver PII…) que refinam o papel.

Dados (Ingestia Data)#

  • Fonte: de onde os dados chegam — um arquivo (CSV/Excel), um bucket, um banco ou um serviço externo (ERP, Ads, CRM).
  • Landing zone: área de entrada de arquivos da plataforma, onde a fonte deposita o dado cru antes de virar tabela.
  • Dataset: o conjunto de tabelas do workspace no datalake. Cada workspace tem um prefixo próprio (ex.: aurora) e três datasets medallion: <prefixo>_bronze, <prefixo>_silver, <prefixo>_gold.
  • Medallion (Bronze/Silver/Gold): as três camadas do datalake — Bronze (cru, como chegou), Silver (limpo e padronizado), Gold (datamart pronto para BI).
  • Pipeline (fonte + transformações): a receita que leva o dado da landing até o Gold. Os passos em português são compilados para SQL de forma determinística e versionada (com execução paralela de conferência e rollback).
  • Freshness: a idade do dado — quando foi atualizado pela última vez.
  • Guarda de custo: teto de bytes por consulta que evita fatura-surpresa.

Análise (ingestia.bi)#

  • Modelo semântico: a camada central de relações, medidas e fórmulas (em português, estilo DAX) reaproveitada por todos os painéis. Aterrar a IA aqui é o que dá respostas confiáveis.
  • Medida: um cálculo reutilizável (ex.: "Faturamento" = soma de valor).
  • Visual / widget: cada gráfico, tabela ou KPI dentro de um painel.
  • Painel (dashboard): a tela de visualização sobre o Gold ou o modelo. Tem estado versionado (envelope com versão + decoder N−1).
  • Snapshot: o retrato materializado do painel/relatório num instante. É o que a página pública serve — leitura barata, sem custo de processamento para o dono.
  • Relatório: um documento (painel + narrativa) gerado e enviado, tipicamente agendado, com versão pública imutável.
  • Certificação: o selo de "número oficial, já revisado" que o dono coloca em uma tabela, painel ou relatório. Ver Linhagem.

Explicação e automação (Ingestia AI)#

  • Determinístico: contas puras (anomalia, previsão, alerta) rodando no nosso servidor. Não mandam dado para um LLM, custo zero, resultado reproduzível.
  • Com LLM (Anthropic): text-to-SQL, Q&A, insights e narrativa — passam por controle de egress e orçamento.
  • Proveniência: as tabelas/colunas/medidas que a IA usou para responder — é como você confere um número.

Distribuição#

  • Link privado (/d/<slug>): endereço não-adivinhável, noindex — "público para quem tem o link".
  • Painel público (/painel/<slug>): conteúdo de web aberta, indexável — para quem QUER divulgar.
  • Snapshot de relatório (/r/<slug>): versão pública imutável do relatório (o número enviado é o número da página). Ver Links públicos e snapshots.

Cobrança e limites#

  • Créditos de uso: saldo em R$ que cobre o consumo de nuvem (processamento + IA).
  • Franquia mensal: créditos inclusos do plano, creditados uma vez por ciclo.
  • Entitlements: limites por plano (relatórios agendados, destinatários, modos de atualização). Ver Consumo e quotas.
  • Verificação de acesso ("regra do dinheiro"): mesmo com papel correto, uma ação cara (refresh, export, IA, relatório) é bloqueada se a assinatura estiver em atraso. Ver Suspensão.

Relacionados#


Última revisão: 2026-09-08. Estado & evidência: estados derivados de matriz de estados do produto. Teto Preview para toda a plataforma.

Related links