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.
- Ve a Ajustes y selecciona la pestana Usuarios y permisos.
- En la tarjeta Roles y permisos veras una tabla con los roles en las columnas y los permisos en las filas.
- Activa o desactiva cada casilla segun lo que necesites.
- 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¶
- Ve a Ajustes y selecciona la pestana Usuarios y permisos.
- Haz clic en el boton Nuevo usuario.
-
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.
-
Haz clic en Crear.
Cambiar el rol de un usuario¶
- En la tabla de usuarios, busca la columna Rol del usuario que quieres modificar.
- Abre el selector desplegable y elige el nuevo rol.
- 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¶
- En la tabla de usuarios, haz clic en el boton PIN junto al usuario.
- Escribe el nuevo PIN numerico.
- Haz clic en Guardar.
Quitar el PIN¶
- Haz clic en PIN junto al usuario.
- Deja el campo vacio.
- 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:
- En la tabla de usuarios, haz clic en el icono de encendido/apagado junto al usuario.
- 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
SELECTunicamente. - El administrador tiene acceso total a todas las tablas del esquema del negocio.