Primer contacto con la plataforma: crear la cuenta, entender la jerarquía Organización → Workspace, activar el MFA y aprovisionar tu datalake.
Conceptos#
- Cuenta (usuario): tu identidad de inicio de sesión (Google, correo/contraseña o SSO corporativo, cuando esté activado). Una persona puede participar 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 concede
acceso a datos — quien administra la estructura de la org (rol
org_admin) no ve automáticamente los datos de ningún workspace. - Workspace: la unidad de aislamiento real. Cada workspace tiene su propio datalake (dataset dedicado), sus personas, su plan y su facturación. El acceso a datos siempre exige participación (membership) en el workspace específico.
Disponibilidad#
- Planes: todos (Starter → Enterprise). La capa de Organización y el modelo de workspace son núcleo — ningún plan está "recortado" en estos recursos.
- Región: Brasil (São Paulo).
Permisos#
- Quien crea la cuenta y completa el onboarding se vuelve dueño (owner) del workspace.
- Los roles de workspace (5 niveles) y el rol de organización (
org_admin) se detallan en Roles (RBAC). - El MFA es obligatorio para toda cuenta (política de seguridad) — no es opcional.
Configuración (paso a paso)#
El onboarding tiene 5 pasos:
- Empresa — nombre, segmento y CPF/CNPJ (validados). Si ya llenaste un simulador o pedido antes, los campos vienen precargados.
- Plan — elige el plan y el método de pago (Pix, Boleto o Tarjeta). Sin cobro configurado, el entorno entra en modo demostración (no se genera ningún cobro real).
- MFA (obligatorio) — escanea el código QR con tu app autenticadora (Google Authenticator, Authy, 1Password…) y confirma el código de 6 dígitos.
- Aprovisionar datalake — la plataforma crea, en tiempo real, los datasets
medallion (
prd_aurora_bronze,prd_aurora_silver,prd_aurora_gold) en el datalake. - Finalizar — revisión de lo que se configuró y aceptación de los Términos de Uso y de la Política de Privacidad (registrada con fecha y versión).
Después de finalizar, llegas al panel (/overview).
Validación (cómo confirmar que funcionó)#
- El paso 5 muestra un resumen: empresa, plan, MFA: Activado y los datasets
creados (ej.:
prd_aurora_bronze, prd_aurora_silver, prd_aurora_gold). - En el panel, el workspace aparece con el nombre de la empresa y el prefijo del dataset.
- Los operadores de la plataforma verifican la salud profunda con
GET /api/health?deep=1(cubre la infraestructura aprovisionada).
Ejemplo#
La dueña Maria crea la cuenta de Comércio Aurora Ltda, elige el plan
Growth, activa el MFA y aprovisiona el workspace Aurora Varejo con prefijo
aurora. Al final, los tres datasets medallion están creados y ella ve el panel
vacío, listo para conectar la primera fuente.
Costo#
- Crear cuenta, organización y workspace: R$ 0.
- Aprovisionar datasets en el datalake consume recursos de nube; el valor mostrado antes del cobro es una estimación — el valor cobrado es el de la factura. Consulta Consumo y cuotas.
Seguridad#
- MFA obligatorio en toda cuenta.
- Aislamiento por workspace: cada workspace tiene un dataset dedicado; las queries están
limitadas al workspace (
<prefixo>_bronze/silver/gold). - Cifrado en tránsito y en reposo; IAM con mínimo privilegio.
- La organización no filtra datos entre workspaces:
org_adminadministra la estructura, nunca los datos.
Límites#
- Un workspace = un datalake aislado. No se comparten datasets entre workspaces.
- El número de conexiones, creadores y visualizadores lo define el plan (consulta Planes).
- El aislamiento entre clientes es fail-closed: sin el alcance del workspace, la consulta se rechaza.
Solución de problemas#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| CPF/CNPJ rechazado en el paso 1 | dígitos inválidos | revisa el documento; el campo valida en tiempo real |
| "Modo demostración" en el paso 2 | cobro no configurado en el entorno | esperado en el entorno de demostración — ningún cobro real |
| El QR del MFA no aparece | falla temporal al generarlo | usa la clave manual que se muestra junto al QR |
| El aprovisionamiento no termina | infraestructura de nube no disponible | inténtalo de nuevo; en demo el aprovisionamiento es simulado |
Próximos pasos: Conectar la primera fuente.