Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-09-08

Conceptos esenciales

El vocabulario de ingestia.io — organización, workspace, dataset, fuente, pipeline, modelo, panel e informe — en una página.

En esta página (7)

Esta página define, una sola vez, las palabras que aparecen en todo el resto de la documentación. Léela antes de seguir con el recorrido — después todo va más rápido.

Estructura y acceso#

  • Cuenta (usuario): tu identidad de inicio de sesión (Google, correo/contraseña o SSO corporativo, cuando esté activado). Una persona participa en varios workspaces.
  • Organización: capa puramente administrativa que agrupa N workspaces (útil para agencias, BPO y grupos con varios CNPJ). La organización NO da acceso a datos — quien administra la org (org_admin) no ve automáticamente los datos de ningún workspace.
  • Workspace: la unidad de aislamiento real. Cada workspace tiene su propio datalake, sus personas, su plan y su facturación. El acceso a datos siempre exige participación (membership) en el workspace específico.
  • Rol (RBAC): lo que puedes hacer — 5 niveles de workspace (owner ⊇ admin ⊇ member ⊇ viewer) + org_admin. Fail-closed: un rol desconocido se vuelve viewer. Consulta Roles (RBAC).
  • Permisos finos: claves booleanas del miembro (ejecutar pipeline, ejecutar queries, exportar, ver PII…) que refinan el rol.

Datos (Ingestia Data)#

  • Fuente: de dónde llegan los datos — un archivo (CSV/Excel), un bucket, una base de datos o un servicio externo (ERP, Ads, CRM).
  • Landing zone: área de entrada de archivos de la plataforma, donde la fuente deposita el dato crudo antes de volverse tabla.
  • Dataset: el conjunto de tablas del workspace en el datalake. Cada workspace tiene un prefijo propio (ej.: aurora) y tres datasets medallion: <prefixo>_bronze, <prefixo>_silver, <prefixo>_gold.
  • Medallion (Bronze/Silver/Gold): las tres capas del datalake — Bronze (crudo, como llegó), Silver (limpio y estandarizado), Gold (datamart listo para BI).
  • Pipeline (fuente + transformaciones): la receta que lleva el dato desde la landing hasta Gold. Los pasos escritos en lenguaje natural se compilan a SQL de forma determinística y versionada (con ejecución paralela de verificación y rollback).
  • Freshness: la antigüedad del dato — cuándo se actualizó por última vez.
  • Control de costo: tope de bytes por consulta que evita facturas sorpresa.

Análisis (ingestia.bi)#

  • Modelo semántico: la capa central de relaciones, medidas y fórmulas (en portugués, estilo DAX) reutilizada por todos los paneles. Anclar la IA aquí es lo que da respuestas confiables.
  • Medida: un cálculo reutilizable (ej.: "Facturación" = suma de valor).
  • Visual / widget: cada gráfico, tabla o KPI dentro de un panel.
  • Panel (dashboard): la pantalla de visualización sobre Gold o el modelo. Tiene estado versionado (envoltorio con versión + decoder N−1).
  • Snapshot: el retrato materializado del panel/informe en un instante. Es lo que sirve la página pública — lectura barata, sin costo de procesamiento para el dueño.
  • Informe: un documento (panel + narrativa) generado y enviado, típicamente programado, con versión pública inmutable.
  • Certificación: el sello de "número oficial, ya revisado" que el dueño pone en una tabla, panel o informe. Consulta Linaje.

Explicación y automatización (Ingestia AI)#

  • Determinístico: cálculos puros (anomalía, previsión, alerta) que corren en nuestro servidor. No envían datos a un LLM, costo cero, resultado reproducible.
  • Con LLM (Anthropic): text-to-SQL, Q&A, insights y narrativa — pasan por control de egress y presupuesto.
  • Procedencia: las tablas/columnas/medidas que la IA usó para responder — es como verificas un número.

Distribución#

  • Enlace privado (/d/<slug>): dirección imposible de adivinar, noindex — "público para quien tiene el enlace".
  • Panel público (/painel/<slug>): contenido de web abierta, indexable — para quien QUIERE divulgarlo.
  • Snapshot de informe (/r/<slug>): versión pública inmutable del informe (el número enviado es el número de la página). Consulta Enlaces públicos y snapshots.

Facturación y límites#

  • Créditos de uso: saldo en R$ que cubre el consumo de nube (procesamiento + IA).
  • Franquicia mensual: créditos incluidos en el plan, acreditados una vez por ciclo.
  • Entitlements: límites por plan (informes programados, destinatarios, modos de actualización). Consulta Consumo y cuotas.
  • Verificación de acceso ("regla del dinero"): incluso con el rol correcto, una acción cara (refresh, exportación, IA, informe) se bloquea si la suscripción está atrasada. Consulta Suspensión.

Relacionados#


Última revisión: 2026-09-08.

Enlaces relacionados