Roles y permisos

El acceso en neocoop se controla mediante roles. Cada rol agrupa un conjunto de permisos, y a cada usuario se le asignan uno o más roles (ver Configuración y usuarios). Lo que un usuario puede ver y hacer depende exclusivamente de los permisos de sus roles.

Cómo funciona el control de acceso

• Los permisos viajan dentro del token de sesión del usuario.
• Cada módulo (Socios, Préstamos, etc.) valida esos permisos en su servidor antes de responder. Si el usuario no tiene el permiso requerido, la operación se deniega.
• El inicio de sesión es el mismo para todos; lo que cambia es a qué información y acciones llega cada quien.

Configuración inicial

Al instalar, el sistema incluye el usuario administrador (admin) con un rol Administrador ya configurado. Ese rol trae un conjunto de permisos base —Ver Todo, Crear, Actualizar, Eliminar, Configurar, Administrador— además de Aperturar y Cerrar Caja. Es el único rol que trae la instalación base; los demás se crean en el servidor, no desde la interfaz (ver el aviso más abajo).

Los permisos son granulares por módulo. Cada acción de cada módulo está protegida por su propio permiso (por ejemplo, ver préstamos, desembolsar, registrar pagos, operar caja o ver contabilidad). Un rol reúne los permisos que necesita el puesto, y el sistema concede el acceso solo cuando el permiso coincide exactamente con el que exige la operación.

Estado actual de la configuración de permisos

La asignación de permisos por módulo se está terminando de consolidar. El rol Administrador que viene preconfigurado cubre la administración del sistema, pero es posible que algunos accesos a módulos específicos requieran que el administrador ajuste los permisos del rol correspondiente. Si un usuario con el rol adecuado no ve la información esperada, revisa con el administrador la asignación de permisos.

Cómo se administran

Desde Configuración y usuarios, en la sección Usuarios, el administrador asigna uno o más roles a cada cuenta. La columna Roles de la tabla muestra el rol vigente de cada usuario.

Los roles existentes pueden no coincidir con esta guía

La lista de roles sugeridos de más abajo es una recomendación, no un inventario. En el sistema pueden existir roles con otros nombres —por ejemplo Admin o Supervisor de Caja— creados durante la implantación. Antes de asignar, revisa qué roles hay realmente disponibles en el selector de la pantalla de usuarios.

Aún no hay pantalla para crear roles

La interfaz permite hoy asignar roles existentes a los usuarios, pero no existe todavía una pantalla para crear, editar o eliminar roles ni para definir sus permisos. Esos roles se administran directamente en el servidor.

En las configuraciones de Préstamos hay además una pantalla Usuarios y roles del módulo, para asignar o revocar roles locales de Préstamos (Administrador, Supervisor o sin rol). Es independiente de los roles del sistema que se ven arriba.

La columna Usuario aparece vacía

Al momento de documentar, esta pantalla muestra el rol de cada fila pero no el nombre del usuario ni el origen de identidad. Está reportado para corrección.

Roles sugeridos

El sistema no impone una lista de roles. La siguiente es una organización recomendada que puedes crear y ajustar a tu cooperativa; cada rol corresponde a un módulo disponible.

Rol	Alcance principal	Para qué serviría
Administrador General	Todo el sistema	Acceso total. Configura el sistema, gestiona usuarios y opera todos los módulos. Es el rol con el permiso Ver todo.
Auditor	Todos los módulos (solo lectura)	Consulta transversal para fines de auditoría: socios, clientes, préstamos, aportaciones, seguros, solicitudes y reportes.
Oficial de Socios	Módulo de Socios	Registrar y consultar socios y clientes; ver reportes.
Oficial de Crédito	Módulo de Préstamos	Ver clientes, solicitudes y préstamos; desembolsar, registrar pagos y reembolsos; ver reportes.
Oficial de Aportaciones	Módulo de Aportaciones y Cuentas	Consultar aportaciones y ahorros; ver reportes.
Oficial de Seguros	Módulo de Seguros	Consultar y gestionar pólizas, aseguradoras y coberturas; ver reportes.
Cajero	Módulo de Caja	Aperturar, operar y cerrar la caja; registrar cobros y pagos del día.
Contador	Módulo de Contabilidad	Consultar y operar cuentas contables, conciliaciones bancarias, balances y reportes.
Encargado de Dividendos	Módulo de Dividendos	Gestionar los períodos y el cálculo de dividendos; ver reportes.
Consulta	Varios módulos (solo lectura)	Perfil de solo lectura: ver socios, clientes, préstamos y aportaciones.

Sobre las funciones por rol

Las funciones descritas arriba son la intención de cada rol. Se harán efectivas según los permisos que el administrador asigne a cada rol; mientras la configuración por módulo se termina de consolidar, algunos accesos pueden requerir ajustes (ver el aviso anterior).

Quién usa cada módulo

Módulo	Roles sugeridos
Socios	Oficial de Socios · Auditor · Consulta · Administrador General
Préstamos	Oficial de Crédito · Auditor · Consulta · Administrador General
Aportaciones y Cuentas	Oficial de Aportaciones · Auditor · Consulta · Administrador General
Seguros	Oficial de Seguros · Auditor · Administrador General
Caja	Cajero · Auditor · Administrador General
Contabilidad	Contador · Auditor · Administrador General
Dividendos	Encargado de Dividendos · Auditor · Administrador General
Configuración y usuarios	Administrador General

Qué ve cada rol

El menú y los datos que aparecen en pantalla se ajustan a los permisos del rol con el que iniciaste sesión. El rol vigente se muestra en el encabezado, junto al nombre del usuario.

Ejemplo: el mismo módulo con dos roles

Así ve el módulo de Préstamos un Oficial de Crédito —menú con Panel de control, Clientes, Préstamos, Reportes e Inventario:

Y así lo ve un Administrador General, con acceso completo:

El rol Auditor

El Auditor está pensado como consulta transversal: entra a todos los módulos para revisar información sin operar.

El Auditor no ve el selector de módulos

En la configuración actual, el portal Selecciona un módulo aparece vacío para el Auditor: el rol no tiene el permiso que exige el listado de módulos, así que la consulta se deniega y no se muestra ninguna tarjeta. Con el Administrador General el mismo portal lista los módulos con normalidad. Mientras no se ajuste ese permiso, el Auditor debe entrar a cada módulo por su dirección directa. Está reportado para corrección.

Revisa los permisos del Auditor

En la configuración actual, el menú del Auditor en Préstamos incluye secciones que el Oficial de Crédito no ve —Caja registradora y Configuraciones— pese a ser un perfil pensado para solo lectura. Además, algunos totales difieren: en el mismo panel, el Auditor ve Desembolsos en 0, mientras que el Oficial de Crédito y el Administrador General ven 12 desembolsos. Es una consecuencia de que la asignación de permisos por módulo aún se está consolidando: si tu cooperativa usará el Auditor como perfil de solo lectura, conviene revisar y ajustar sus permisos antes de ponerlo en producción.

Buenas prácticas

• Asigna a cada persona solo los roles que necesita para su función.
• Para revisiones y consultas sin capacidad de modificar, crea y usa roles de Auditor o Consulta.
• Revisa periódicamente los usuarios activos y sus roles desde Configuración y usuarios.

Cuentas de servicio

Además de las cuentas de personas, el sistema utiliza cuentas de servicio para las integraciones entre módulos: cada módulo tiene la suya (por ejemplo, NeoCoop Loans, NeoCoop Members, NeoCoop Shares And Accounts, NeoCoop Accounting o MemberPortalService). No corresponden a un usuario humano y no se usan para iniciar sesión de forma manual.