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 vuelveviewer. 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#
- Visión general de la plataforma
- El recorrido completo (hasta 30 min)
- Cuenta, organización y workspace
Última revisión: 2026-09-08.