Saltar a contenido

Usuarios y roles

Qu3ntas permite crear varios usuarios para el mismo negocio, cada uno con un rol que determina a que pantallas y acciones tiene acceso. El control de permisos funciona en dos capas: la interfaz oculta lo que no corresponde al rol, y en la nube PostgreSQL aplica restricciones adicionales a nivel de base de datos.


Roles del sistema

La siguiente tabla resume los seis roles predefinidos y sus permisos por defecto.

Rol Descripcion Permisos por defecto
Administrador Acceso total. Configura el negocio, gestiona usuarios, ve reportes y opera caja. Todos los modulos
Contador Acceso financiero y contable. No opera caja ni cambia configuracion sensible. Reportes, gastos, cartera, clientes, productos, inventario, nomina, cotizaciones, empresas
Cajero Vende, cobra y registra gastos. Sin acceso a reportes ni configuracion. Vender (POS), salon y comandas, caja, gastos, clientes, productos, cotizaciones, cartera
Mesero Toma pedidos y los manda a cocina. No cobra ni ve dinero. Salon y comandas, pantalla de cocina, clientes
Cocina Solo la pantalla de cocina (KDS): preparar, listo y entregado. Pantalla de cocina
Solo lectura Consulta sin poder modificar nada. Reportes, cartera

El administrador siempre conserva acceso total

No se pueden quitar permisos al rol Administrador. Esto garantiza que siempre haya alguien que pueda configurar el sistema completo.

Permisos disponibles

Cada modulo del sistema se controla de forma independiente:

Permiso Que controla
Vender (POS) Acceso al punto de venta para facturar
Salon y comandas Abrir mesas, tomar la comanda y enviarla a cocina
Pantalla de cocina Marcar pedidos como preparado, listo o entregado
Anular / notas credito Emitir notas credito y debito
Gastos Registrar y consultar gastos
Caja Abrir y cerrar turnos de caja, ver cuadre
Inventario / insumos Gestionar existencias, entradas y salidas
Clientes Crear y editar clientes
Productos / menu Crear y editar productos o platos
Nomina Liquidar sueldos y ver fichas de empleados
Reportes Consultar informes de ventas, gastos y utilidad
Cartera Ver cuentas por cobrar
Cotizaciones Crear y enviar cotizaciones
Ajustes / configuracion Cambiar datos del negocio, impresora, integraciones
Usuarios Crear, editar y desactivar otros usuarios
Empresas Gestionar varias empresas o sedes

Personalizar permisos por rol

El administrador puede modificar la matriz de permisos para adaptarla al negocio.

  1. Ve a Ajustes y selecciona la pestana Usuarios y permisos.
  2. En la tarjeta Roles y permisos veras una tabla con los roles en las columnas y los permisos en las filas.
  3. Activa o desactiva cada casilla segun lo que necesites.
  4. Haz clic en Guardar cambios y confirma.

Los cambios se aplican de inmediato. Los usuarios con el rol afectado veran la nueva configuracion al recargar la app.

Restaurar valores originales

Si personalizaste los permisos y quieres volver al preset original, haz clic en Restaurar preset antes de guardar.


Crear un usuario

  1. Ve a Ajustes y selecciona la pestana Usuarios y permisos.
  2. Haz clic en el boton Nuevo usuario.
  3. Completa el formulario:

    • Nombre: el nombre que vera el equipo (ej. "Maria Cajera").
    • Email: correo electronico. Se usa para iniciar sesion en la nube.
    • Rol: selecciona uno de los seis roles disponibles. Debajo del selector aparece una descripcion del rol elegido.
    • PIN (opcional): un codigo numerico de 4 digitos para ingreso rapido en la app de escritorio. Si lo dejas vacio, el usuario entra sin PIN.
  4. Haz clic en Crear.


Cambiar el rol de un usuario

  1. En la tabla de usuarios, busca la columna Rol del usuario que quieres modificar.
  2. Abre el selector desplegable y elige el nuevo rol.
  3. Confirma el cambio en el dialogo que aparece.

No puedes cambiar tu propio rol

Para evitar que un administrador se bloquee a si mismo, no se permite cambiar el rol del usuario con el que estas logueado.


PIN de acceso rapido

El PIN permite que varios usuarios compartan el mismo equipo y cambien de turno sin cerrar sesion. Es comun en mostradores donde un cajero sale y otro entra.

Asignar o cambiar el PIN

  1. En la tabla de usuarios, haz clic en el boton PIN junto al usuario.
  2. Escribe el nuevo PIN numerico.
  3. Haz clic en Guardar.

Quitar el PIN

  1. Haz clic en PIN junto al usuario.
  2. Deja el campo vacio.
  3. Haz clic en Guardar. El usuario entrara sin necesidad de PIN.

Desactivar un usuario

Cuando un empleado deja el negocio o no debe seguir accediendo:

  1. En la tabla de usuarios, haz clic en el icono de encendido/apagado junto al usuario.
  2. Confirma la desactivacion.

El usuario desactivado aparece atenuado en la lista y no puede iniciar sesion.

Para reactivarlo, repite el proceso y confirma la activacion.

Desactivar, no eliminar

No se pueden eliminar usuarios que ya tienen actividad registrada (ventas, gastos, etc.). Desactivalos en su lugar para mantener la trazabilidad.


Registro de actividad

Debajo de la tabla de usuarios se muestra el Registro de actividad (audit log) con las ultimas 50 acciones: quien hizo que, sobre que entidad, y cuando. Esto permite rastrear operaciones como creacion de facturas, cambios de precios o eliminacion de productos.


Permisos en la base de datos (nube)

Cuando el negocio opera en la nube con Supabase, los permisos no solo controlan la interfaz: PostgreSQL aplica un rol de base de datos (cuad_rol_admin, cuad_rol_cajero, etc.) antes de ejecutar cada consulta. Esto significa que aunque alguien abra la consola del navegador, no podra acceder a datos que su rol no permite.

En particular:

  • Las tablas de nomina (empleado, nomina_periodo, nomina_item) solo son accesibles para los roles administrador y contador.
  • El rol solo lectura tiene permisos de SELECT unicamente.
  • El administrador tiene acceso total a todas las tablas del esquema del negocio.