Gestión de Usuarios y Roles

¿Qué es un usuario?

Un usuario es una persona que accede al sistema con sus credenciales (usuario y contraseña). Cada usuario tiene asignados uno o más roles que determinan exactamente qué puede ver y hacer dentro de la aplicación.

Módulo Usuarios

Listado de usuarios

Ingresá desde el menú principal → Configuración → Usuarios.

La tabla muestra:

Columna	Descripción
ID	Identificador interno
Nombre / Apellido	Datos personales
Usuario	Nombre de login (único)
Email	Correo electrónico
Estado	`Activo` / `Inactivo`
Sucursal	Sucursal principal asignada
Roles	Roles que tiene el usuario
Acciones	Menú `⋯` con opciones

Filtros disponibles

Usá el panel Filtros de Búsqueda (colapsable) para filtrar por:

Nombre
Apellido
Usuario (login)
Email
Estado (Activo / Inactivo / Todos)

Presioná Buscar para aplicar o Limpiar para restablecer.

Crear un usuario nuevo

En la lista, presioná + Nuevo Usuario.
Completá los datos del formulario:

Información personal

Campo	Obligatorio	Descripción
Nombre	✅	Nombre del usuario
Apellido	✅	Apellido del usuario
Usuario	✅	Nombre de login (único en el sistema)
Email	✅	Dirección de correo electrónico
Contraseña	✅	Contraseña de acceso
Observaciones	No	Notas internas sobre el usuario

Asignación de sucursales y roles

Campo	Obligatorio	Descripción
Sucursales	✅	Una o más sucursales a las que tiene acceso
Sucursal principal	✅	La que se selecciona por defecto al ingresar
Roles	✅	Uno o más roles que definen sus permisos
Rol principal	✅	Determina el menú y dashboard que ve al entrar

¿Por qué hay “principal”?
Un usuario puede operar en varias sucursales o tener permisos de varios roles. La opción principal indica cuál es la vista predeterminada cuando inicia sesión.

Estado

Marcar Usuario Activo para que pueda ingresar al sistema.
Desmarcar bloquea el acceso sin eliminar la cuenta.

Presioná Guardar.

Editar un usuario

Buscá el usuario en la lista.
Hacé clic en ⋯ → Editar.
Modificá los campos que necesitás.

Cambio de contraseña en edición

Por seguridad, el campo de contraseña aparece deshabilitado en la pantalla de edición.
Para cambiar la contraseña:

Marcá la opción Cambiar contraseña.
El campo se habilitará y podrás ingresar la nueva contraseña.

Activar / Desactivar un usuario

Desde el menú ⋯ de la lista:

Activar: el usuario puede iniciar sesión nuevamente.
Desactivar: el usuario queda bloqueado (no se elimina, sus datos se conservan).

Caso de uso: Un empleado que deja la empresa. Se desactiva su usuario en lugar de eliminarlo, para conservar el historial de operaciones que realizó.

Módulo Roles

¿Qué es un rol?

Un rol es un conjunto de permisos reutilizable. En lugar de asignar permisos uno a uno a cada usuario, se define el rol una vez y luego se asigna a los usuarios que corresponda.

Por ejemplo: el rol Cajero podría tener permisos para hacer ventas y manejar caja, pero no para modificar precios ni ver reportes.

Listado de roles

Ingresá desde el menú principal → Configuración → Roles.

La tabla muestra:

Columna	Descripción
ID	Identificador interno
Nombre	Nombre técnico: `ROLE_VENDEDOR`
Alias	Nombre legible: “Vendedor”
Alcance	Nivel de datos que puede ver
Permisos	Cantidad de permisos asignados
Estado	`Activo` / `Inactivo`
Acciones	Menú `⋯` con opciones

Tipos de roles (badges en la tabla)

Badge	Significado
🛡️ Sistema	Creado automáticamente por la app. No se puede eliminar, pero sus permisos sí pueden modificarse.
⭐ Super Admin	Tiene todos los permisos del sistema. No puede editarse ni eliminarse. Se asigna automáticamente a nuevos permisos que se agreguen al sistema.
(sin badge)	Rol personalizado, creado por el negocio. Puede editarse y eliminarse.

Filtros disponibles

Nombre (técnico)
Alias
Búsqueda general (texto libre)

Crear un rol nuevo

En la lista de roles, presioná + Nuevo Rol.
Completá la sección Información del Rol:

Campo	Obligatorio	Descripción
Nombre	✅	Formato técnico: `ROLE_VENDEDOR` (mayúsculas, números y guion bajo). Único en el sistema.
Alias	✅	Nombre legible: “Vendedor”. Único en el sistema.
Alcance	✅	Nivel de información que puede ver el usuario (ver tabla abajo)

Alcances disponibles

Alcance	Qué ve el usuario
Usuario	Solo sus propias operaciones y datos
Sucursal	Todo lo de la sucursal a la que pertenece
Sistema	Todo el sistema, todas las sucursales

En la sección Permisos, seleccioná los permisos usando el árbol interactivo.
- Los permisos están agrupados por recurso (Productos, Ventas, Clientes, etc.)
- Podés marcar un grupo completo o permisos individuales.
- El contador muestra cuántos permisos están seleccionados.
Presioná Guardar.

Entender los permisos

Cada permiso sigue el formato RECURSO_ACCIÓN.

Acciones estándar

Acción	Qué permite
`LIST`	Ver el listado / tabla
`READ`	Ver el detalle de un registro
`CREATE`	Crear nuevos registros
`UPDATE`	Editar registros existentes
`DELETE`	Eliminar registros
`EXPORT`	Exportar datos
`IMPORT`	Importar datos

Permisos especiales

Permiso	Descripción
`VENTA_FACTURAR`	Emitir facturas electrónicas (AFIP)
`AFIP_CONSULTAR`	Consultar datos en AFIP
`AFIP_CONFIG`	Modificar configuración de AFIP
`ROLE_ASSIGN_PERMISSION`	Asignar permisos a roles
`REPORTE_VENTAS`	Ver reportes de ventas

Ver detalle de un rol

Desde el menú ⋯ → Ver detalle.
Se abre un panel lateral con todos los permisos asignados, agrupados por recurso.

Editar un rol existente

En la lista, hacé clic en ⋯ → Editar.
Podés cambiar el alias, el alcance y los permisos.
El nombre técnico no se puede cambiar una vez creado.
Los roles marcados como Sistema pueden tener sus permisos modificados.
El rol Super Admin no se puede modificar de ninguna forma.

Relación entre Usuarios y Roles

Un usuario puede tener varios roles

Si un usuario tiene el rol Vendedor y también el rol Caja, tendrá todos los permisos de ambos roles combinados.

El Rol principal define la experiencia de inicio

Cuando el usuario inicia sesión, el sistema muestra el menú y dashboard correspondientes al rol principal. El usuario puede cambiar el rol activo (si tiene más de uno) desde el perfil o menú de sesión.

Los permisos se acumulan

Rol Vendedor:    VENTA_CREATE + VENTA_LIST + PRODUCTO_LIST
Rol Supervisor:  VENTA_LIST + REPORTE_VENTAS + PRODUCTO_UPDATE

Usuario con ambos roles:
  → VENTA_CREATE + VENTA_LIST + PRODUCTO_LIST + REPORTE_VENTAS + PRODUCTO_UPDATE

Ejemplos de roles típicos

Rol	Alias	Alcance	Permisos típicos
`ROLE_ADMIN`	Administrador	Sistema	Todos
`ROLE_SUPERVISOR`	Supervisor	Sucursal	Ventas, reportes, precios, stock
`ROLE_VENDEDOR`	Vendedor	Sucursal	Ventas, presupuestos, clientes, productos (solo leer)
`ROLE_CAJERO`	Cajero	Usuario	Ventas, caja (apertura/cierre), cobros
`ROLE_DEPOSITO`	Depósito	Sucursal	Stock, ajustes, transferencias, proveedores
`ROLE_READONLY`	Solo lectura	Sistema	LIST y READ en todos los módulos, sin CREATE/UPDATE/DELETE

Preguntas frecuentes

¿Puedo eliminar un usuario?
No, los usuarios no se eliminan para preservar el historial. Se desactivan.

¿Puedo eliminar un rol que está asignado a usuarios?
El sistema no lo permite mientras haya usuarios con ese rol activo. Primero reasigná los usuarios.

¿Qué pasa si un rol del sistema se queda sin permisos?
Podés vaciar sus permisos si lo necesitás, pero el rol no se elimina.

¿Un usuario inactivo consume licencias?
Depende de la configuración del sistema. Consultá con el administrador.

¿Puedo crear varios roles con el mismo nombre técnico?
No. El nombre (ROLE_...) y el alias deben ser únicos en toda la aplicación.