Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Organización y workspaces

En esta página (10)

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 (acciones org.*).
  • org_admin NO 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)#

  1. Crea la organización (nombre; slug y dueño opcionales).
  2. Vincula workspaces existentes a la organización (solo los asocia; no mueve datos).
  3. Asigna el rol org_admin a quien va a administrar la estructura.
  4. 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íntomaCausa probableQué hacer
org_admin no ve los datos de un workspacecomportamiento esperadoagrega a la persona como miembro del workspace
"Organización distinta — acción denegada"el recurso pertenece a otra orgopera dentro de la org correcta (aislamiento)
El workspace no aparece en la listapersona sin membresíaconfirma la membresía activa en ese workspace
"Contexto de organización ausente"acción org.* sin org en el contextoaccede por la org correcta

Próximos pasos: Usuarios, grupos y permisos.

Enlaces relacionados