📚 Manual de Usuario

Guías paso a paso para todos los roles del sistema

🔍
🎯
¿Qué es QueuePro?
Visión general del sistema y sus módulos
Inicio ▼
  • 1
    Sistema Multiempresa

    QueuePro permite gestionar múltiples empresas, cada una con sus propias sedes, puntos de cola, servicios y agentes. El acceso es completamente independiente entre empresas.

  • 2
    Módulos principales

    📟 Kiosco/Tótem — El cliente saca su turno. 🖥️ Display — Pantalla en sala de espera. 👤 Consola de Agente — El agente atiende turnos. ⚙️ Administración — Configuración y reportes.

  • 3
    Flujo de atención

    Cliente → Kiosco (saca turno) → Sala de espera (display) → Agente llama turno → Atención → Cierre → Datos en reportes.

💡 Conexión en tiempo realEl sistema usa WebSockets para actualizar el display y la consola del agente al instante, sin necesidad de recargar la página.
🔑
Acceso y roles del sistema
Cómo ingresar y qué puede hacer cada rol
Roles ▼
RolAccesoPuede hacer
🔑 Super AdminTodo el sistemaGestionar empresas, asignar admins, ver todos los reportes, configurar temas
🏢 Admin EmpresaSu empresaGestionar sedes, puntos de cola, servicios, usuarios y temas de su empresa
📍 Supervisor SedeSu sedeVer reportes de su sede, gestionar estaciones y agentes
👤 AgenteConsola de agenteLlamar, atender, transferir y finalizar turnos en su estación
URL de ingreso: /queque/agente/login.php

📟 Kiosco / Tótem

📟
Cómo usar el tótem táctil
Pasos para que el cliente emita su turno
Cliente ▼
  • 1
    Pantalla de bienvenida

    Al llegar, el cliente ve la pantalla de bienvenida con el logo de la empresa y el botón "Solicitar turno". Tocarlo inicia el proceso.

  • 2
    Elegir servicio

    El cliente selecciona el tipo de atención que necesita de la lista de botones con iconos. Los servicios los configura el administrador.

  • 3
    Indicar prioridad

    Se puede indicar una condición especial: Ninguna, Embarazada, Tercera edad o Cliente VIP. Esto determina el orden de atención.

  • 4
    Recibir ticket

    Se muestra el código de turno con un código QR. El cliente puede imprimir el ticket (si hay impresora térmica conectada) o simplemente memorizar el código.

  • 5
    Auto-reset

    Después de N segundos (configurable), la pantalla vuelve a la bienvenida automáticamente para el siguiente cliente.

💡 URL del tótemCada punto de cola tiene su propio código. La URL es: /queque/kiosco/index.php?punto=CODIGO
⚙️
Configurar el kiosco
Cómo personalizar la apariencia del tótem desde Admin
Admin ▼
  • 1
    Ir a Admin → Puntos de Cola

    Desde el menú de administración, acceder a la sección "Puntos de Cola".

  • 2
    Editar el punto de cola

    Click en ✏️ Editar. Se puede configurar: Color primario (afecta botones y QR), Logo URL, Texto de bienvenida y Segundos de auto-reset.

  • 3
    Agregar iconos a servicios

    En Admin → Servicios, se puede asignar un emoji a cada servicio (campo "Icono") para que aparezca en los botones del tótem.

🖥️ Display de Sala de Espera

🖥️
Configurar el display
Layouts, temas y opciones avanzadas del display
Admin ▼
  • 1
    Ir a Admin → Displays

    Desde el menú se accede al CRUD de displays. Cada display tiene un código de acceso único.

  • 2
    Elegir layout

    Hay 3 layouts disponibles: Clásico (llamado + historial), Pantalla completa (solo el turno en grande) y Doble columna (llamados + digital signage).

  • 3
    Elegir tema de color

    3 temas predefinidos: Oscuro (fondo negro), Claro (fondo blanco) y Corporativo (azul marino). Los colores del tema de empresa sobreescriben estos valores.

  • 4
    Digital Signage

    En el campo "Contenido multimedia" se puede poner una URL de imagen, video MP4, o texto. Se muestra en la columna derecha del layout doble columna.

  • 5
    Síntesis de voz

    Si está activada, el display anuncia por audio el número de turno y la estación a la que debe dirigirse el cliente.

URL del display: /queque/display/index.php?d=CODIGO_DISPLAY

👤 Consola de Agente

👤
Iniciar sesión y vincular estación
Primeros pasos en la consola de agente
Agente ▼
  • 1
    Ingresar al sistema

    Ir a /queque/agente/login.php con el usuario y contraseña provistos por el administrador.

  • 2
    Seleccionar estación

    Al ingresar, el sistema pide elegir la estación física donde se va a trabajar. Esta vinculación determina qué nombre aparece en el display cuando se llama un turno.

  • 3
    Panel de atención

    Una vez vinculado, el agente ve el panel con el botón "Llamar siguiente turno" y la información del turno actual.

🔔
Llamar y atender turnos
Flujo completo de atención desde la consola
Agente ▼
  • 1
    Llamar siguiente

    Presionar "📣 Llamar siguiente turno". El display muestra el turno llamado y anuncia el número por voz.

  • 2
    Re-llamar

    Si el cliente no aparece, presionar "🔁 Re-llamar" para anunciarlo nuevamente.

  • 3
    Iniciar atención

    "▶ Iniciar atención" cambia el estado del turno a "en atención" y comienza a contabilizar el TMA.

  • 4
    Finalizar o ausente

    "✅ Finalizar" cierra el turno normalmente. "❌ Ausente" registra que el cliente no se presentó.

  • 5
    Transferir

    Si el cliente necesita otro servicio, "↩ Transferir" redirige el turno a otro punto de cola sin perder su prioridad.

⚠️ Alerta SLASi aparece un banner rojo pulsante, uno o más turnos están superando el tiempo máximo de espera definido para el servicio. Priorizar la atención.

⚙️ Panel de Administración

🏢
Estructura de la organización
Empresas → Sedes → Puntos de Cola → Servicios
Admin ▼
NivelDescripciónEjemplo
🏢 EmpresaOrganización raíz del sistemaBanco Nacional S.A.
📍 SedeOficina o sucursal de la empresaSucursal Centro
🔢 Punto de ColaFila de atención dentro de la sedePlanta Baja · Créditos
⚙️ ServicioTipo de trámite dentro del punto de colaApertura de cuenta
🪑 EstaciónVentanilla física del agenteEstación 3
⚙️
Gestionar servicios y SLA
Configurar tiempos máximos de espera por servicio
Admin ▼
  • 1
    Admin → Servicios

    Cada servicio tiene: nombre, ícono (emoji), tiempo máximo de espera (SLA en minutos) y prioridad base.

  • 2
    Configurar SLA

    El campo "SLA (min)" define cuántos minutos puede esperar un cliente antes de que el sistema active la alerta roja en la consola del agente y el panel admin.

  • 3
    Prioridades

    Los turnos con prioridad "VIP" o "Tercera edad" se colocan antes en la fila para el mismo servicio.

📊 Reportes y Analítica

📊
Dashboard de analítica
KPIs, gráficos y mapa de calor
Supervisor ▼
  • 1
    Admin → Reportes

    El dashboard muestra KPIs en tiempo real: TME (Tiempo Medio de Espera), TMA (Tiempo Medio de Atención), turnos finalizados, ausentismo y más.

  • 2
    Mapa de calor

    El gráfico 7×24 muestra la intensidad de atención por hora del día y día de la semana. Útil para planificar turnos de agentes.

  • 3
    Productividad de agentes

    Tabla con turnos atendidos, TMA promedio y tasa de ausentismo generada por agente.

  • 4
    Filtros

    Se puede filtrar por empresa → sede → punto de cola y rango de fechas. Los datos se actualizan sin recargar la página.

🎨 Temas y Branding

🎨
Aplicar una plantilla de diseño
Galería de 23 plantillas por tipo de industria
Admin ▼
  • 1
    Admin → Temas

    Ir al módulo de temas desde el menú de administración.

  • 2
    Galería de plantillas

    Explorar las 23 plantillas agrupadas por categoría: Finanzas, Salud, Gobierno, Educación, Comercio y más. Cada plantilla muestra una previsualización de colores.

  • 3
    Aplicar plantilla

    Click en "Aplicar" en la plantilla deseada. El cambio se aplica en tiempo real a kiosco, display, consola y admin.

  • 4
    Editor avanzado

    En la pestaña "Editor" se puede ajustar manualmente cada color, la fuente tipográfica y el borde de los botones con previsualización en vivo.

  • 5
    Identidad de la empresa

    En la pestaña "Identidad" se configura el nombre del sistema, logo y favicon que aparecen en todos los módulos.

💡 Permisos de temasEl Super Admin puede editar los temas de cualquier empresa. El Admin Empresa solo puede editar la suya.

❓ Preguntas Frecuentes

❓
¿Qué pasa si el display muestra "sin conexión"?
Solución para problemas de WebSocket
FAQ ▼
  • 1
    El servidor WebSocket puede no estar corriendo

    Ejecutar: php ws_server/server.php en la carpeta del proyecto.

  • 2
    Fallback automático

    Si WebSocket no está disponible, el display cambia automáticamente a polling cada 5 segundos. Los datos siguen actualizándose, pero con un pequeño delay.

❓
¿Cómo agregar una nueva empresa?
Pasos para incorporar una empresa al sistema
FAQ ▼
  • 1
    Ingresar como Super Admin

    Solo el Super Admin puede crear empresas desde Admin → Empresas.

  • 2
    Crear la empresa y asignar admin

    Crear la empresa, luego ir a Usuarios y crear un usuario con rol "Admin Empresa" vinculado a esa empresa.

  • 3
    Asignar plantilla de diseño

    Opcionalmente, ir a Admin → Temas y asignar una plantilla acorde al tipo de industria de la empresa.

❓
¿Cómo imprimir tickets desde el tótem?
Configuración de impresora térmica
FAQ ▼
  • 1
    Impresora térmica compatible

    El ticket del tótem incluye estilos de impresión optimizados para papel de 80mm. El botón "Imprimir" usa la función nativa del navegador.

  • 2
    Configurar como impresora predeterminada

    En el equipo del tótem, configurar la impresora térmica como predeterminada. Ajustar el tamaño de papel a 80mm en la configuración de la impresora.