Skip to content

Roles y permisos ​

¿Cómo funciona el sistema de roles? ​

Cada usuario tiene un rol distinto en cada empresa a la que pertenece. El rol se asigna en el momento de añadir al usuario a la empresa (manualmente o por invitación) y determina qué puede hacer dentro de esa empresa.

Esta página cubre la jerarquía de "quién puede asignar qué rol a quién". Para quién queda como dueño de una empresa nueva, la diferencia entre empresa por defecto vs. empresa propia, y quién puede borrar una empresa, ver Ciclo de vida de la propiedad de una empresa.

Los cuatro roles ​

RolNivel¿Qué puede hacer?
ownerMáximoTodo: gestionar miembros, invitaciones, configuración de empresa
adminAltoLo mismo que owner en el día a día
memberMedioLeer y escribir recursos de la empresa
viewerBajoSolo lectura

¿Dónde vive el rol? ​

El JWT emitido en el login lleva un claim de rol, pero la autorización no confía en esa foto. En cada petición el strategy de autenticación vuelve a resolver la membresía actual del usuario en la empresa seleccionada y usa el rol de esa membresía. Consecuencias:

  • Cambiar el rol de un miembro, quitar la membresía o desactivar la empresa tiene efecto en la siguiente petición, sin esperar a que el usuario cierre sesión.
  • Los claims role/companyId del token se usan para elegir qué empresa resolver, no como fuente de verdad de la autorización.
  • No hay una consulta de rol por handler: la resolución es parte del paso de autenticación, así que el costo es una lectura de membresía por petición.

Cambiar el rol de un miembro ​

El rol no se puede cambiar directamente. El flujo es:

  1. Eliminar al miembro de la empresa (DELETE /companies/:id/users/:userId).
  2. Volver a añadirlo con el nuevo rol (POST /companies/:id/users).

¿Quién puede hacer qué? ​

AcciónOwnerAdminMemberViewer
Ver empresas y usuarios✅✅✅✅
Crear/editar empresas✅✅❌❌
Eliminar empresas✅❌❌❌
Gestionar miembros (asignando member/viewer)✅✅❌❌
Gestionar miembros (asignando owner/admin)✅❌❌❌
Crear y revocar invitaciones✅✅❌❌
Modificar configuración del sistema✅✅❌❌

Jerarquía al asignar roles

Un admin puede añadir miembros, pero solo con rol member o viewer. Solo un owner puede otorgar el rol owner o admin a otro miembro (POST /companies/:id/users) — de lo contrario un admin podría auto-promoverse. Ver Empresas → Añadir un miembro.

La misma regla aplica a las invitaciones (POST /companies/:id/invitations): un admin solo puede invitar con rol member/viewer. Se revalida otra vez al aceptar la invitación (GET /invitations/accept), usando el rol actual de quien la creó — por si fue degradado después de crearla y antes de que se aceptara. Ver Invitaciones.

Al quitar un miembro (DELETE /companies/:id/users/:userId) rige la misma jerarquía : un admin no puede quitar a un owner/admin, y nadie — ni un owner ni

un super admin — puede dejar la empresa sin al menos un owner (409). Ver Empresas → Eliminar un miembro.

Un super admin de plataforma (isSuperAdmin === true) se salta la jerarquía de roles (puede otorgar o quitar OWNER/ADMIN en cualquier empresa), pero no la protección del último owner en la baja. Ver Usuarios → Super admin.

La primera asignación de owner no pasa por esta jerarquía

Cuando alguien crea una empresa (POST /companies, o el registro con companyName — ver Ciclo de vida de la propiedad de una empresa), queda como owner de esa empresa automáticamente, sin que nadie tenga que "otorgarle" el rol. La jerarquía de esta página regula asignaciones posteriores a miembros ya existentes o nuevos, no la membresía inicial del creador.