This page defines, once, the words that appear throughout the rest of the documentation. Read it before moving on to the journey — after that everything goes faster.
Structure and access#
- Account (user): your login identity (Google, email/password, or corporate SSO, when enabled). One person can belong to several workspaces.
- Organization: a purely administrative layer that groups N workspaces
(useful for agencies, BPOs, and groups with multiple CNPJs). The organization does NOT grant access to
data — whoever administers the org (
org_admin) does not automatically see the data of any workspace. - Workspace: the real unit of isolation. Each workspace has its own datalake, its people, its plan, and its billing. Access to data always requires membership in the specific workspace.
- Role (RBAC): what you can do — 5 workspace levels
(
owner⊇admin⊇member⊇viewer) +org_admin. Fail-closed: an unknown role becomesviewer. See Roles (RBAC). - Fine-grained permissions: boolean member flags (run pipeline, run queries, export, see PII…) that refine the role.
Data (Ingestia Data)#
- Source: where data comes from — a file (CSV/Excel), a bucket, a database, or an external service (ERP, Ads, CRM).
- Landing zone: the platform's file entry area, where the source drops raw data before it becomes a table.
- Dataset: the workspace's set of tables in the datalake. Each workspace has
its own prefix (e.g.,
aurora) and three medallion datasets:<prefixo>_bronze,<prefixo>_silver,<prefixo>_gold. - Medallion (Bronze/Silver/Gold): the three datalake layers — Bronze (raw, as it arrived), Silver (clean and standardized), Gold (datamart ready for BI).
- Pipeline (source + transformations): the recipe that takes data from landing to Gold. Steps written in plain language are compiled into SQL in a deterministic, versioned way (with a parallel verification run and rollback).
- Freshness: the age of the data — when it was last updated.
- Cost guard: a per-query byte ceiling that prevents surprise bills.
Analysis (ingestia.bi)#
- Semantic model: the central layer of relationships, measures, and formulas (in Portuguese, DAX-style) reused by every dashboard. Grounding AI here is what produces reliable answers.
- Measure: a reusable calculation (e.g., "Revenue" = sum of
valor). - Visual / widget: each chart, table, or KPI inside a dashboard.
- Dashboard (painel): the visualization screen over Gold or the model. Its state is versioned (envelope with a version + N−1 decoder).
- Snapshot: the materialized picture of the dashboard/report at a point in time. It's what the public page serves — cheap to read, with no processing cost for the owner.
- Report: a document (dashboard + narrative) generated and sent, typically scheduled, with an immutable public version.
- Certification: the "official number, already reviewed" badge that the owner places on a table, dashboard, or report. See Lineage.
Explanation and automation (Ingestia AI)#
- Deterministic: pure calculations (anomaly, forecast, alert) running on our server. They don't send data to an LLM, zero cost, reproducible results.
- With LLM (Anthropic): text-to-SQL, Q&A, insights, and narrative — they go through egress control and budget.
- Provenance: the tables/columns/measures the AI used to answer — it's how you check a number.
Distribution#
- Private link (
/d/<slug>): an unguessable,noindexaddress — "public to whoever has the link". - Public dashboard (
/painel/<slug>): open-web, indexable content — for those who WANT to publicize it. - Report snapshot (
/r/<slug>): the immutable public version of the report (the number sent is the number on the page). See Public links and snapshots.
Billing and limits#
- Usage credits: a balance in BRL that covers cloud consumption (processing + AI).
- Monthly allowance: credits included in the plan, credited once per cycle.
- Entitlements: limits per plan (scheduled reports, recipients, refresh modes). See Usage and quotas.
- Access check ("the money rule"): even with the right role, an expensive action (refresh, export, AI, report) is blocked if the subscription is past due. See Suspension.
Related#
Last reviewed: 2026-09-08.