La Organización es una capa administrativa por encima del workspace, para agencias, BPO y grupos multi-CNPJ (varias empresas) que gestionan varios clientes/empresas.
Conceptos#
- Organización: agrupa N workspaces. Es puramente estructural — administra qué workspaces existen y quién los administra, sin conceder nunca acceso a los datos de ninguno de ellos.
- Workspace: unidad real de aislamiento (datalake dedicado, personas, plan, facturación). El acceso a los datos siempre exige membresía en el workspace.
- Portafolio multi-CNPJ: dentro del modelo, es posible organizar múltiples CNPJ (identificadores de empresa de Brasil), apps y audiencias.
Disponibilidad#
- Planes: todos. La capa de organización es núcleo.
- Funcionamiento: modelo cubierto por pruebas automáticas.
Permisos#
org_admin(rol de organización): administra la estructura — crea/vincula workspaces, gestiona miembros de la org, ajusta la configuración de la org (accionesorg.*).org_adminNO tiene acceso automático a los datos de ningún workspace. Para ver datos, necesita ser miembro/owner de ese workspace específico.- La verificación de organización es fail-closed: contexto de org ausente → denegado; organización distinta de la del recurso objetivo → denegado (aislamiento entre orgs).
Configuración (paso a paso)#
- Crea la organización (nombre; slug y dueño opcionales).
- Vincula workspaces existentes a la organización (solo los asocia; no mueve datos).
- Asigna el rol
org_admina quien va a administrar la estructura. - Para dar acceso a los datos de un workspace, agrega a la persona como miembro de ese workspace (ver Usuarios y permisos).
Vincular/desvincular un workspace queda auditado y nunca borra el workspace ni sus
datos — desvincular solo suelta el vínculo (organizationId = null).
Validación#
- La vista administrativa de la org lista todos los workspaces de la org.
- La vista "solo con acceso" lista únicamente los workspaces donde la persona es owner o miembro activo/invitado — lo que comprueba el anti-cross-access.
- Los vínculos aparecen en el registro de auditoría (
organization.attach/organization.detach).
Ejemplo#
El Grupo Aurora (organización) tiene dos workspaces: Aurora Varejo y
Aurora Atacado. João es org_admin: crea y vincula workspaces y gestiona quién los
administra, pero no ve los datos de ventas de ninguno de los dos — para eso,
tendría que ser miembro del workspace. Maria es miembro solo de Aurora Varejo: al listar
la org, recibe únicamente Aurora Varejo.
Costo#
- Crear/gestionar la organización y los vínculos: R$ 0 (no consume procesamiento).
Seguridad#
- El aislamiento entre organizaciones y entre workspaces es fail-closed.
- La org no es un atajo a los datos: separación estricta entre "administrar la estructura" y "acceder a los datos".
- Todo cambio estructural se audita y tiene alcance en el workspace afectado.
Límites#
- La organización no comparte datasets entre workspaces.
- Cada workspace tiene su propio datalake; un cliente nunca lee los datos de otro. El diseño es fail-closed.
Solución de problemas#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
org_admin no ve los datos de un workspace | comportamiento esperado | agrega a la persona como miembro del workspace |
| "Organización distinta — acción denegada" | el recurso pertenece a otra org | opera dentro de la org correcta (aislamiento) |
| El workspace no aparece en la lista | persona sin membresía | confirma la membresía activa en ese workspace |
| "Contexto de organización ausente" | acción org.* sin org en el contexto | accede por la org correcta |
Próximos pasos: Usuarios, grupos y permisos.