El rol Administrador es el nivel de acceso más alto del sistema CUSCATLECO. Un usuario con este rol puede operar cualquier módulo de la aplicación: desde configurar el menú y gestionar al personal hasta consultar los registros de auditoría y generar reportes de ventas. Por su naturaleza, debe asignarse únicamente a personal de confianza con responsabilidades de supervisión o administración del establecimiento.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/AbyssDevs/CUSCATLECO/llms.txt
Use this file to discover all available pages before exploring further.
Acceso al panel
El Administrador accede a su panel exclusivo en la siguiente URL:ver_admin. Cualquier intento de acceso sin ese permiso redirige al usuario a /403.
Permisos asignados
El rol Administrador agrupa 16 permisos que cubren la totalidad de los módulos del sistema.General
General
| Permiso | Descripción |
|---|---|
ver_dashboard | Ver el panel principal con resumen de actividad |
ver_admin | Acceder al panel de administración |
Usuarios y Roles
Usuarios y Roles
| Permiso | Descripción |
|---|---|
gestionar_usuarios | Crear, editar y desactivar cuentas de empleados |
gestionar_roles | Asignar y modificar los roles de los usuarios |
Menú
Menú
Pedidos
Pedidos
| Permiso | Descripción |
|---|---|
crear_pedido | Registrar nuevos pedidos desde cualquier mesa o para llevar |
ver_pedidos | Ver el listado completo de pedidos y su historial |
actualizar_estado_pedido | Cambiar el estado de un pedido manualmente |
Facturación
Facturación
| Permiso | Descripción |
|---|---|
generar_factura | Emitir facturas electrónicas de tipo Consumidor Final o Crédito Fiscal |
Reportes
Reportes
| Permiso | Descripción |
|---|---|
ver_reportes | Consultar reportes de ventas, pedidos y estadísticas del restaurante |
Reservaciones y Clientes
Reservaciones y Clientes
| Permiso | Descripción |
|---|---|
gestionar_reservaciones | Crear, confirmar y cancelar reservaciones |
gestionar_clientes | Ver y administrar clientes registrados y sus rangos de fidelidad |
Mesas
Mesas
| Permiso | Descripción |
|---|---|
gestionar_mesas | Crear y eliminar mesas del restaurante |
listar_mesas | Ver el estado actual de todas las mesas |
Auditoría
Auditoría
| Permiso | Descripción |
|---|---|
ver_auditoria | Consultar el registro de auditoría con todas las acciones del sistema |
Capacidades principales
Gestión de usuarios y empleados
El Administrador puede crear cuentas para nuevos empleados, asignarles uno o más roles, y desactivar cuentas cuando sea necesario. El acceso a las rutas de empleados en la API está protegido directamente por el permisogestionar_usuarios:
Gestión del menú
Puede agregar nuevas categorías y platillos, modificar precios, subir imágenes y marcar platillos como no disponibles temporalmente. Cada cambio en el menú queda registrado enauditoria_log con los datos anteriores y nuevos.
Gestión de mesas
Tiene acceso completo a la configuración de mesas: puede crear nuevas mesas, definir su capacidad y ubicación (Zona Interior, Terraza, Barra, Salón VIP), y eliminarlas cuando dejen de estar en servicio. También puede ver el estado en tiempo real de todas las mesas.Pedidos y facturación
Puede crear pedidos, actualizar su estado en cualquier punto del flujo (Pendiente → EnPreparacion → Listo → Entregado → Cerrado) y generar facturas electrónicas tanto de tipo Consumidor Final como Crédito Fiscal.
Reportes
Es el único rol con acceso al módulo de reportes, donde puede consultar estadísticas de ventas, pedidos por período, platillos más vendidos y desempeño general del restaurante.Registro de auditoría
El Administrador puede revisar el log completo de auditoría (auditoria_log), que registra cada acción relevante en el sistema: quién la realizó, en qué módulo, qué entidad fue afectada, y los valores anteriores y nuevos en formato JSON.
Flujo de trabajo típico
Iniciar sesión
Ingresar con credenciales de Administrador en la pantalla de login. El sistema valida las credenciales, carga los permisos en la sesión y redirige a
/admin.Revisar el dashboard
Al entrar al panel, el Administrador ve un resumen de la actividad reciente: pedidos activos, mesas ocupadas y notificaciones pendientes.
Gestionar usuarios
Desde el módulo de empleados, puede crear o editar cuentas y asignar roles según las responsabilidades de cada persona.
Configurar el menú
En el módulo de menú, agrega o actualiza platillos, ajusta precios y gestiona la disponibilidad del catálogo.
Supervisar operaciones
Monitorea pedidos en curso, verifica el estado de las mesas y atiende cualquier incidencia operativa.
Volver a Roles y Acceso