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 CorpCambiar 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:
| Modo | Configuración | Comportamiento |
|---|---|---|
| Empresa única (por defecto) | multi_company = false | Cada usuario solo puede pertenecer a una empresa |
| Multi-empresa | multi_company = true | Un 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.