Saltar al contenido principal

Gestión de Roles

¿Qué son los Roles?​

Los Roles definen qué puede hacer cada persona en el sistema. Por ejemplo, un vendedor solo necesita acceso al punto de venta, mientras que un administrador puede ver todo.

Con los roles puedes:

  • ✅ Controlar quién ve qué información
  • ✅ Definir qué acciones puede realizar cada empleado
  • ✅ Organizar mejor tu equipo de trabajo
  • ✅ Mantener la seguridad de tu negocio

¿Cómo entrar?​

En el menú lateral, busca "Gestión de Usuarios" y luego "Roles".

Pantalla Principal​

Cuando entres verás:

Botones Principales​

  • Exportar: Descarga la lista de roles en Excel o PDF
  • Crear Nuevo Rol: Agrega un nuevo rol al sistema

Buscar y Filtrar​

  • Escribe en el buscador para encontrar un rol por nombre o descripción
  • Ordena la lista por nombre, descripción o fecha
  • Elige cuántos roles ver por página (10, 25, 50 o 100)

Lista de Roles​

Verás una tabla con:

  • Nombre: Cómo se llama el rol (Ej: "Vendedor", "Supervisor")
  • Código: Identificador único del rol
  • Descripción: Qué hace este rol
  • Permisos: Cuántos accesos tiene asignados
  • Fecha: Cuándo se creó
  • Acciones: Botones para ver, editar o eliminar

Crear un Nuevo Rol​

Paso a Paso​

  1. Click en "Crear Nuevo Rol"

  2. Completa la información básica:

Nombre del Rol ⭐ (obligatorio)

  • Dale un nombre claro
  • Ejemplos: "Vendedor", "Administrador", "Supervisor de Almacén"

Código ⭐ (obligatorio)

  • Código corto en MAYÚSCULAS
  • Sin espacios
  • Ejemplos: "SELLER", "ADMIN", "WAREHOUSE_SUPERVISOR"

Descripción ⭐ (obligatorio)

  • Explica qué hace este rol
  • Ejemplo: "Encargado de realizar ventas diarias en el punto de venta"

Pantalla Inicial ⭐ (obligatorio)

  • ¿A dónde debe ir esta persona cuando inicie sesión?
  • Ejemplo: Un vendedor debería ir directo al Punto de Venta (POS)
  1. Selecciona los permisos:

En el lado derecho verás todas las secciones del sistema. Para cada una puedes dar:

  • Ver: La persona puede ver la información
  • Crear: Puede agregar nuevos registros
  • Editar: Puede modificar información existente
  • Eliminar: Puede borrar registros
  • Exportar: Puede descargar reportes

💡 Tip: Marca el checkbox principal de una sección para seleccionar todos sus permisos

  1. Click en "Guardar"

Reglas Importantes​

  • ✅ Debes seleccionar al menos 1 permiso
  • ✅ Solo las secciones con permiso "Ver" pueden ser pantalla inicial
  • ✅ El código debe ser único (no puede repetirse)

Ver y Editar un Rol​

Ver Detalles​

  • Click en el ícono de "Ver" (👁️) para ver toda la información del rol
  • Verás todos los permisos asignados organizados por sección

Editar un Rol​

  • Click en el ícono de "Editar" (✏️)
  • Puedes cambiar:
    • Nombre y descripción
    • Pantalla inicial
    • Agregar o quitar permisos
  • Click en "Guardar" para aplicar los cambios

Eliminar un Rol​

  1. Click en el ícono de "Eliminar" (🗑️)
  2. Aparece un mensaje preguntando si estás seguro
  3. Click en "Confirmar" para eliminar o "Cancelar" para no hacer nada

⚠️ Importante: No puedes eliminar un rol que tiene usuarios asignados. Primero debes cambiar esos usuarios a otro rol.

Exportar Roles​

Puedes descargar la lista completa de roles para imprimirla o guardarla.

¿Cómo exportar?​

  1. Click en el botón "Exportar"

  2. Elige el formato:

    • Excel: Para editar o analizar en hojas de cálculo
    • PDF: Para imprimir o compartir

  3. (Opcional) Filtra por fechas:

    • Fecha desde: ¿Desde cuándo?
    • Fecha hasta: ¿Hasta cuándo?

  4. El archivo se descarga automáticamente

¿Qué incluye la exportación?​

  • Nombre de cada rol
  • Código
  • Descripción
  • Cantidad de permisos
  • Fecha de creación

Ejemplos Prácticos​

Ejemplo 1: Crear Rol de Vendedor​

Este rol es para personas que solo hacen ventas en el mostrador.

Configuración:

  • Nombre: "Vendedor"
  • Código: "SELLER"
  • Descripción: "Encargado de realizar ventas en el punto de venta"
  • Permisos:
    • 🏪 POS: Ver, Vender a crédito
    • 👥 Clientes: Ver
    • 📦 Productos: Ver
    • 📄 Facturas: Ver
  • Pantalla Inicial: POS (Punto de Venta)

Ejemplo 2: Crear Rol de Supervisor de Inventario​

Este rol es para quien administra productos y stock.

Configuración:

  • Nombre: "Supervisor de Inventario"
  • Código: "INV_SUPERVISOR"
  • Descripción: "Administra productos, categorías y movimientos de inventario"
  • Permisos:
    • 📦 Productos: Ver, Crear, Editar, Exportar
    • 📂 Categorías: Ver, Crear, Editar, Eliminar
    • 🏢 Almacenes: Ver
    • 📊 Movimientos: Ver
  • Pantalla Inicial: Productos

Ejemplo 3: Crear Rol de Cajero​

Este rol es para quien maneja el efectivo.

Configuración:

  • Nombre: "Cajero"
  • Código: "CASHIER"
  • Descripción: "Realiza ventas y maneja caja"
  • Permisos:
    • 🏪 POS: Ver
    • 👥 Clientes: Ver
    • 📦 Productos: Ver
    • 💰 Caja: Abrir, Cerrar, Gastos menores
  • Pantalla Inicial: POS

Consejos Importantes​

✅ Buenas Prácticas​

  1. Da solo los permisos necesarios

    • No todo el mundo necesita eliminar o exportar
    • Un vendedor solo necesita vender, no modificar precios

  2. Usa nombres claros

    • "Vendedor de Mostrador" es mejor que "Rol 1"
    • "Supervisor de Almacén" dice exactamente qué hace

  3. Códigos fáciles de entender

    • Usa MAYÚSCULAS y guiones bajos
    • "WAREHOUSE_MANAGER" es más claro que "WM123"

  4. Pantalla inicial correcta

    • Vendedor → Punto de Venta
    • Contador → Dashboard
    • Almacenista → Inventario

  5. Describe bien el rol

    • Explica claramente qué hace esa persona
    • Ayuda a entender los permisos después

❌ Evita Estos Errores​

  1. ❌ Dar todos los permisos a todos
  2. ❌ Usar códigos confusos o duplicados
  3. ❌ Dejar la descripción vacía
  4. ❌ Eliminar roles que están en uso
  5. ❌ Asignar permisos sin pensar en el trabajo real

Problemas Comunes y Soluciones​

"Ya existe un rol con ese código"​

¿Por qué pasa? El código que escribiste ya lo está usando otro rol.
Solución: Usa un código diferente. Ejemplo: En lugar de "ADMIN", prueba "ADMIN_VENTAS"

"Debe seleccionar al menos un permiso"​

¿Por qué pasa? No marcaste ningún permiso.
Solución: Selecciona al menos una sección con el permiso "Ver"

"Debe seleccionar una pantalla principal"​

¿Por qué pasa? No elegiste dónde debe ir el usuario al iniciar sesión.
Solución: Elige una pantalla que tenga el permiso "Ver" activado

"No se puede eliminar este rol"​

¿Por qué pasa? Hay usuarios usando este rol actualmente.
Solución: Primero cambia esos usuarios a otro rol, después elimina

"No encuentro la pantalla en el selector"​

¿Por qué pasa? Esa pantalla no tiene el permiso "Ver" marcado.
Solución: Marca el checkbox "Ver" de esa pantalla primero

Preguntas Frecuentes​

¿Puedo tener usuarios sin rol?
No, todos los usuarios deben tener un rol asignado.

¿Puedo cambiar el rol de un usuario después?
Sí, puedes cambiar el rol cuando quieras desde la gestión de usuarios.

¿Los cambios en un rol se aplican de inmediato?
Sí, cuando modificas un rol, todos los usuarios con ese rol obtienen los nuevos permisos inmediatamente.

¿Cuántos roles puedo crear?
Puedes crear todos los roles que necesites.

¿Puedo copiar un rol existente?
Por ahora no, pero puedes crear uno nuevo y configurarlo igual que el anterior.