Roles y Permisos

Objetivo Funcional

El módulo de Roles y Permisos permite configurar el sistema de control de acceso del aplicativo. Aquí se definen los permisos específicos que existen en el sistema, se crean roles agrupando permisos relacionados, y se asignan estos roles a los usuarios para controlar qué pueden hacer en la plataforma.

Acceso y navegación

Para acceder a este módulo, sigue la siguiente ruta:

Menú Principal → Parámetros → Roles y Permisos

Módulo crítico

Este módulo controla la seguridad y acceso al sistema. Solo debe ser gestionado por Administradores del Sistema. Cambios incorrectos pueden bloquear el acceso a usuarios o exponer información sensible.

---

Conceptos clave

Antes de trabajar con este módulo, es importante entender:

Permiso

Acción específica que se puede realizar en el sistema.

Ejemplos:

• crear-proyecto
• editar-producto
• eliminar-usuario
• ver-reportes

Rol

Conjunto de permisos agrupados que se asignan a usuarios.

Ejemplos:

• Administrador (todos los permisos)
• Coordinador (gestión de grupo)
• Investigador (gestión propia)

Usuario con Rol

Investigador al que se le asigna uno o más roles.

El usuario hereda automáticamente todos los permisos de sus roles asignados.

---

Estructura del módulo

El módulo está dividido en dos secciones principales:

Roles y Permisos
├── Permisos
│   ├── Crear permiso
│   ├── Editar permiso
│   └── Eliminar permiso
│
└── Roles
    ├── Crear rol
    ├── Asignar permisos a rol
    ├── Editar rol
    └── Eliminar rol

---

Sección 1: Gestión de Permisos

Listado de Permisos

La pestaña de permisos muestra todos los permisos del sistema:

Campo	Descripción
Nombre	Identificador único del permiso (slug)
Descripción	Explicación de qué permite hacer
Módulo	Módulo al que pertenece
Roles	Roles que tienen este permiso
Acciones	Editar, eliminar

Agrupación por módulo

Los permisos se organizan por módulos para facilitar su gestión:

• Proyectos
• Productos
• Entregas
• Usuarios
• Configuración
• etc.

Crear un Nuevo Permiso

1. Acceder a la pestaña Permisos

   En el módulo de Roles y Permisos, selecciona la pestaña “Permisos”.

2. Iniciar creación

   Presiona el botón + Nuevo Permiso.

3. Completar información

   Ingresa los datos del permiso:

   • Nombre: Identificador único en formato slug (requerido)

     • Usa guiones para separar palabras
     • Formato: verbo-modulo o verbo-modulo-detalle
     • Ejemplos: crear-proyecto, editar-producto, eliminar-usuario, ver-reportes-financieros

   • Descripción: Explicación clara de qué permite hacer (requerido)

     • Ejemplos:
       • “Permite crear nuevos proyectos de investigación”
       • “Permite editar productos investigativos propios”
       • “Permite eliminar cualquier usuario del sistema”

   • Módulo: Categoría a la que pertenece (opcional)

     • Ayuda a organizar los permisos
     • Ejemplos: “Proyectos”, “Usuarios”, “Productos”, “Configuración”

4. Guardar permiso

   Presiona Guardar para crear el permiso.

   El permiso quedará disponible para asignarse a roles.

Nomenclatura recomendada

Usa verbos en infinitivo para nombrar permisos:

• Crear: crear-proyecto, crear-producto
• Ver/Listar: ver-proyectos, listar-usuarios
• Editar: editar-proyecto, editar-producto
• Eliminar: eliminar-proyecto, eliminar-usuario
• Aprobar: aprobar-entrega, aprobar-plan-trabajo
• Exportar: exportar-reportes, exportar-datos

Editar un Permiso

1. Localiza el permiso en la tabla
2. Presiona el botón de edición (ícono de lápiz)
3. Modifica la descripción o módulo (el nombre no se puede cambiar)
4. Presiona Actualizar

Eliminar un Permiso

1. Localiza el permiso en la tabla

2. Presiona el botón de eliminación (ícono de basura)

3. Confirma la eliminación

   Eliminación en cascada

   Al eliminar un permiso:

   • Se removerá automáticamente de todos los roles que lo tienen
   • Los usuarios perderán ese privilegio inmediatamente
   • Esta acción es irreversible

   Solo elimina permisos que ya no se utilicen en el sistema.

---

Sección 2: Gestión de Roles

Listado de Roles

La pestaña de roles muestra todos los roles del sistema:

Campo	Descripción
Nombre	Denominación del rol
Permisos	Cantidad de permisos asignados
Usuarios	Cantidad de usuarios con este rol
Acciones	Ver permisos, editar, eliminar

Crear un Nuevo Rol

1. Acceder a la pestaña Roles

   Selecciona la pestaña “Roles” en el módulo.

2. Iniciar creación

   Presiona el botón + Nuevo Rol.

3. Ingresar nombre del rol

   Define un nombre descriptivo para el rol (requerido):

   • Administrador: Control total del sistema
   • Coordinador: Gestiona su grupo de investigación
   • Investigador: Gestiona sus propios productos
   • Evaluador: Revisa y aprueba entregas
   • Consultor: Solo lectura de información

4. Asignar permisos al rol

   Selecciona los permisos que tendrá este rol. Los permisos están organizados por módulos para facilitar la selección.

   Por Módulo

   Expande cada módulo y marca los permisos correspondientes:

   Proyectos

   • ☑ Crear proyecto
   • ☑ Ver proyectos
   • ☑ Editar proyectos propios
   • ☐ Editar cualquier proyecto
   • ☐ Eliminar proyectos

   Productos

   • ☑ Crear producto
   • ☑ Ver productos
   • ☑ Editar productos propios
   • ☐ Eliminar productos
   Selección Rápida

   Usa los botones de selección rápida:

   • Seleccionar todos: Marca todos los permisos
   • Seleccionar módulo: Marca todos de un módulo específico
   • Deseleccionar todos: Desmarca todos los permisos

5. Guardar rol

   Presiona Guardar para crear el rol con los permisos seleccionados.

Modificar Permisos de un Rol

1. Acceder a permisos del rol

   En el listado de roles, haz clic en “Ver permisos” o en el botón de edición del rol.

2. Ajustar permisos

   • Agregar permisos: Marca los checkboxes adicionales
   • Quitar permisos: Desmarca los checkboxes correspondientes

3. Guardar cambios

   Presiona Actualizar para aplicar los cambios.

   Cambios inmediatos

   Los cambios en permisos se aplican inmediatamente. Todos los usuarios con este rol obtendrán o perderán los permisos modificados en tiempo real.

Eliminar un Rol

1. Localiza el rol en la tabla

2. Presiona el botón de eliminación (ícono de basura)

3. Verifica cuántos usuarios tienen este rol

4. Confirma la eliminación

   Eliminación restringida

   No puedes eliminar un rol si:

   • ✗ Hay usuarios asignados a este rol
   • ✗ Es un rol del sistema (Administrador, por ejemplo)

   Solución: Reasigna los usuarios a otros roles antes de eliminar.

---

Roles predefinidos recomendados

1. Administrador

Administrador

Permisos: Todos

Descripción: Control total del sistema. Puede realizar cualquier acción sin restricciones.

Usuarios típicos:

• Director de investigación
• Administrador del sistema
• Personal de TI autorizado

Permisos incluidos:

• ✅ Todos los permisos de configuración
• ✅ Gestión completa de usuarios
• ✅ Creación de períodos y parametrización
• ✅ Acceso a todos los módulos
• ✅ Exportación de datos sensibles

---

2. Lider Grupo

Lider Grupo

Permisos: Gestión de su grupo de investigación

Descripción: Puede administrar proyectos de su grupo, revisar entregas y postularse a convocatorias.

Usuarios típicos:

• Líder de grupo de investigación
• Director de línea de investigación

Permisos incluidos:

• ✅ Ver proyectos de su grupo
• ✅ Ver productos de su grupo
• ✅ Postularse a convocatorias
• ✅ Ver todas las convocatorias
• ❌ Modificar configuración global
• ❌ Gestionar usuarios de otros grupos

---

3. Investigador

Investigador

Permisos: Gestión de su propia producción

Descripción: Puede crear y gestionar sus proyectos, productos y entregas. Solo tiene acceso a su propia información.

Usuarios típicos:

• Docentes investigadores
• Investigadores junior

Permisos incluidos:

• ✅ Crear proyectos
• ✅ Crear productos
• ✅ Crear entregas
• ✅ Ver sus propios datos
• ✅ Postularse a convocatorias
• ❌ Ver datos de otros investigadores
• ❌ Aprobar entregas
• ❌ Acceder a configuración

---

Asignar roles a usuarios

La asignación de roles se realiza desde el módulo de Investigadores:

1. Accede a Investigadores

2. Edita el perfil del investigador

3. En la sección “Roles”, selecciona uno o más roles

4. Guarda los cambios

   Múltiples roles

   Un usuario puede tener múltiples roles simultáneamente. Los permisos se combinan (unión), no se limitan (intersección).

   Ejemplo:

   • Usuario con roles “Investigador” + “Evaluador”
   • Tendrá todos los permisos de ambos roles

---

Matriz de permisos recomendada

Permiso / Módulo	Admin	Lider Grupo	Investigador
Proyectos
Crear proyecto	✅	✅	✅
Ver proyectos	✅ (todos)	✅ (grupo)	✅ (propios)
Editar proyecto	✅	✅ (si autor)	✅ (si autor)
Eliminar proyecto	✅	✅ (si autor)	✅ (si autor)
Productos
Crear producto	✅	✅	✅
Ver productos	✅ (todos)	✅ (grupo)	✅ (propios)
Editar producto	✅	✅	✅
Entregas
Crear entrega	✅	✅	✅
Ver entregas	✅ (todas)	✅ (grupo)	✅ (propias)
Convocatorias
Crear convocatoria	✅	❌	❌
Ver convocatorias	✅ (todas)	✅ (todas)	✅ (abiertas)
Postularse	✅	✅	❌
Usuarios
Crear usuario	✅	❌	❌
Ver usuarios	✅ (todos)	❌	❌
Editar usuario	✅	❌	❌
Configuración
Gestionar períodos	✅	❌	❌
Gestionar roles	✅	❌	❌
Gestionar parámetros	✅	❌	❌

---

Buenas prácticas

1. Principio de mínimo privilegio

   Asigna solo los permisos estrictamente necesarios para cada rol. Es mejor agregar permisos después que dar demasiados al inicio.

2. Documenta cada rol

   Crea un documento que describa:

   • Propósito del rol
   • Usuarios típicos
   • Permisos incluidos
   • Limitaciones

3. Revisa periódicamente

   Audita trimestral o semestralmente:

   • ¿Los roles siguen siendo apropiados?
   • ¿Hay usuarios con permisos innecesarios?
   • ¿Se necesitan nuevos roles?

4. Usa roles, no permisos directos

   Siempre asigna roles a usuarios, nunca permisos individuales. Esto facilita la gestión y mantiene la coherencia.

5. Protege el rol Administrador

   • Limita la cantidad de administradores (máximo 2-3)
   • Usa contraseñas fuertes
   • Habilita autenticación de dos factores si está disponible
   • Monitorea acciones de administradores

---

Errores comunes y soluciones

Error	Causa	Solución
”Permiso duplicado”	Ya existe un permiso con ese nombre	Usa un nombre único
”Rol sin permisos”	No se asignaron permisos al rol	Asigna al menos un permiso antes de guardar
”No se puede eliminar rol”	Hay usuarios con este rol	Reasigna usuarios a otro rol primero
”Usuario sin acceso”	No tiene ningún rol asignado	Asigna al menos un rol al usuario
”Permisos contradictorios”	Usuario tiene múltiples roles conflictivos	Revisa y ajusta los roles asignados

---

Preguntas frecuentes

¿Cuántos roles debo crear?

Entre 4 y 7 roles suelen ser suficientes para la mayoría de instituciones. Demasiados roles complican la administración.

¿Puedo crear permisos personalizados?

Sí, puedes crear todos los permisos que necesites según las funcionalidades de tu sistema y requisitos institucionales.

¿Los cambios en roles afectan usuarios conectados?

Sí, los cambios se aplican inmediatamente. Los usuarios deberán cerrar sesión y volver a iniciarla para que se reflejen completamente.

¿Puedo tener roles jerárquicos?

No directamente. Si necesitas jerarquía, crea roles con permisos progresivos (Investigador Junior → Investigador Senior → Coordinador).