Skip to content

Multi-tenancy ​

¿Qué es? ​

El sistema está diseñado para que varias empresas convivan en la misma instalación sin que sus datos se mezclen. Cada empresa es un "tenant" — un espacio de trabajo completamente separado.

→ Ver también Roles y permisos y Ciclo de vida de la propiedad de una empresa.

Cómo se separan los datos ​

Cuando un usuario hace login, el token JWT indica la empresa elegida para esa sesión. Antes de devolver datos tenant-scoped, el servidor comprueba que el usuario aún tiene una membresía activa en esa empresa y aplica el rol/grants de esa membresía. La empresa del token no sustituye esa comprobación.

Login de Ana en Acme Corp
    │
    ▼
Token: { userId: "...", companyId: "acme-uuid", role: "admin" }
    │
    ▼
GET /users   →  solo devuelve los usuarios de Acme Corp

Cambiar de empresa en una misma sesión ​

Si Ana pertenece a dos empresas, la sesión puede seleccionar cualquiera de sus membresías activas. X-Company-Id solo cambia el contexto después de verificar esa membresía; sin membresía, el servidor rechaza la petición. Lo mismo aplica a un usuario que también sea Super Admin.

La cabecera X-Company-Id no concede acceso

Para un JWT de usuario, la empresa indicada debe tener una membresía UserCompany activa del usuario. Si no, la petición se rechaza; isSuperAdmin no permite seleccionar una empresa ajena. Cuando la cabecera está ausente, el companyId del JWT también requiere una membresía activa.

Un app client (tokenType: app) usa su propio alcance: solo puede seleccionar una empresa vinculada activamente al client. Las API keys siguen ligadas a su empresa y no usan la cabecera para ampliar su alcance. Ver .

Modo empresa única vs. multi-empresa ​

El sistema puede funcionar en dos modos:

ModoConfiguraciónComportamiento
Empresa única (por defecto)multi_company = falseCada usuario solo puede pertenecer a una empresa
Multi-empresamulti_company = trueUn usuario puede ser miembro de varias empresas con roles distintos

Se cambia en tiempo real desde la configuración de la plataforma sin reiniciar el servidor.