Saltar a contenido

Roles

Por qué importa

Un rol define el nivel general de un usuario en ImmCase: qué módulos puede ver, qué acciones puede ejecutar. Sin roles, todo el equipo tendría acceso a todo — incluyendo configuración del sistema y datos financieros sensibles que no todos deben ver.

ImmCase trae roles base (Super Admin, Admin, Manager, Consultor, etc.) y deja crear roles personalizados según las necesidades de tu consultoría.

Roles base que vienen con ImmCase

  • Super Admin — acceso total a todo, incluyendo configuración del sistema. Bypass de todos los permisos. Asígnalo a 1-2 personas máximo.
  • Admin — acceso a configuración y todos los datos. No tiene el bypass de Super Admin, pero opera con permisos amplios.
  • Manager — gestiona equipos y reportes. No acceso a configuración técnica.
  • Sales Rep / Consultor RCIC — uso diario de casos, aplicantes, comunicación. Sin acceso a configuración.
  • Support Rep — para mesa de ayuda. Casos asignados a soporte, sin acceso amplio.
  • Viewer — solo lectura. Útil para auditores externos.

Crear un rol personalizado

  1. Barra lateral → ConfiguraciónRolesCrear.
  2. Llena:
  3. Nombre del rol (por ejemplo, "Paralegal junior", "Contador externo").
  4. Descripción corta.
  5. Rol padre — heredas permisos de él como base.
  6. Guardar.

Ahora le agregas permisos específicos a través de perfiles. Más en Perfiles.

Jerarquía de roles

Los roles pueden tener rol padre, formando una jerarquía:

Super Admin
  └── Admin
        └── Manager
              ├── Consultor RCIC senior
              │     └── Consultor RCIC junior
              ├── Paralegal senior
              │     └── Paralegal junior
              └── Administrativo

Cuando un rol hereda de otro, recibe sus permisos como base. Puedes agregar más permisos al rol hijo, pero no puede tener menos que el padre (por la herencia).

Esto permite definir "Consultor RCIC junior" como "Consultor RCIC senior pero con menos permisos" agregando restricciones.

Screenshot: árbol de jerarquía de roles con relaciones padre/hijo

Asignar rol a un usuario

Al crear o editar un usuario → campo Rol → elige del catálogo. Cada usuario tiene un rol principal (uno solo).

Para permisos adicionales sin cambiar el rol principal, usa Perfiles (un usuario puede tener varios perfiles).

Modificar un rol existente

Cuidado al modificar un rol que tiene usuarios asignados:

  1. Cualquier cambio afecta inmediatamente a todos los usuarios con ese rol.
  2. Quitar un permiso puede romper flujos en curso (el usuario que estaba editando un caso pierde el botón Guardar).

Mejor práctica:

  • Para cambios pequeños: hazlos en momento de baja actividad.
  • Para cambios grandes: crea un rol nuevo, prueba con un usuario, ajusta, luego migra al resto.

Roles + Spatie por debajo

Para administradores técnicos: ImmCase usa la librería Spatie para roles y permisos. Cada rol mapea a permisos específicos en la base de datos. Si quieres entender el detalle técnico, ver docs/ROLES_PERMISSIONS_PROFILES.md en la documentación del desarrollador.

Ten cuidado con

  • No elimines un rol que tiene usuarios asignados. Reasigna los usuarios a otro rol primero, después elimina.
  • Super Admin no es para todos los que dicen "yo necesito acceso total". Pregunta primero qué necesitan hacer — casi siempre se resuelve con un perfil específico, no con Super Admin.
  • Renombrar un rol no rompe nada, pero confunde a quienes están acostumbrados al nombre viejo. Anuncia el cambio.

A dónde sigue

  • Perfiles — permisos más granulares que se suman al rol.
  • Módulos — qué módulos existen para asignar permisos sobre ellos.