El onboarding es el asistente que aparece una vez, justo después de crear la cuenta.
Son 5 pasos — cuando terminas, llegas al
panel de resumen (/overview) y el wizard no
vuelve a aparecer.
Qué es#
Un flujo guiado (/onboarding) que aprovisiona todo lo que un workspace necesita
para funcionar: registro de la empresa, elección de plan, MFA obligatorio y la creación
real de los datasets medallion en el datalake. El progreso se guarda en cada paso — si
cierras la pestaña, vuelves a donde te quedaste.
Para qué sirve#
- Pasar de cero a un datalake aprovisionado sin tocar infraestructura de nube.
- Garantizar, ya en la entrada, las dos cosas innegociables: MFA activo y aislamiento por workspace (dataset dedicado).
Quién lo hace y cuándo#
- Quien crea la cuenta y completa el onboarding se vuelve dueño (owner) del workspace.
- Se ejecuta una única vez por workspace. Una vez completado (
onboardingCompletedAt), el acceso a/onboardingredirige directo a/overview. - En un entorno de demostración (sin cobro/nube configurados), el aprovisionamiento y el cobro son simulados — no se genera ningún cobro real.
Los 5 pasos#
| # | Paso | Qué sucede |
|---|---|---|
| 1 | Empresa | Nombre, segmento y CPF/CNPJ (validados en tiempo real). Si ya llenaste un simulador o pedido, los campos vienen precargados a partir del correo. |
| 2 | Plan | Elección del plan y del método de pago (Pix, Boleto (comprobante bancario) o Tarjeta de crédito). Sin cobro configurado, entra en modo demostración. |
| 3 | Seguridad (MFA) | Escanea el código QR con la app autenticadora (Google Authenticator, Authy, 1Password…) y confirma el código de 6 dígitos. Etapa obligatoria — hay una clave manual junto al QR como alternativa. |
| 4 | Datalake | La plataforma crea, en tiempo real, los datasets medallion (prd_aurora_bronze, prd_aurora_silver, prd_aurora_gold) en el datalake. Sigues cada modificación paso a paso. |
| 5 | Finalizar | Resumen (empresa, plan, MFA: Activado, datasets creados) y aceptación obligatoria de los Términos de Uso y de la Política de Privacidad, registrada con fecha y versión. |
En los pasos 2 (Plan) y 3 (MFA) hay un botón Volver para corregir datos (por ejemplo, un CPF/CNPJ). Los pasos de aprovisionamiento y finalización no vuelven atrás.
Requisitos previos#
- Una cuenta autenticada (Google, correo/contraseña o SSO corporativo, cuando esté activado para tu organización).
- Una app autenticadora TOTP para el MFA.
Resultado esperado#
- El paso 5 muestra 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 verifican la salud profunda con
GET /api/health?deep=1.
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 (prefijo
aurora). Al aceptar los términos, los tres datasets medallion están creados y ella ve
el panel vacío, listo para conectar la primera fuente.
Límites y costos#
- Crear cuenta, organización y workspace: R$ 0.
- Aprovisionar datasets consume recursos de nube; el valor mostrado antes del cobro es una estimación — el valor cobrado es el de la factura.
- El aprovisionamiento crea los datasets de tu workspace en el datalake; en el entorno de demostración es simulado.
Seguridad#
- MFA obligatorio en toda cuenta (política de seguridad).
- Aislamiento por workspace desde la creación: cada workspace tiene un dataset dedicado.
- Aceptación de los términos registrada con fecha y versión (registro de auditoría).
Errores comunes#
| 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 es simulado |
Relacionados#
Última revisión: 2026-09-08.