POS — Dashboard
¿Qué es?
El Dashboard es la pantalla principal de resumen del negocio. Se accede desde el ítem "Dashboard" en el sidebar (ícono de gráfica de barras), cuya URL es .../dashboard.
Solo es visible para empleados con el permiso audit_log:read (por defecto: roles owner, admin, manager). Los cajeros y meseros no lo ven en el sidebar.
---
Ubicación y layout
La pantalla tiene un encabezado superior con:
- Título: nombre de la empresa y fecha actual (ej. "miércoles, 16 de abril")
- Botón "Actualizar" (ícono de recarga): refresca manualmente todos los datos
- Botón "Nueva venta" (ícono de carrito): acceso directo a
/home-products
Debajo del encabezado hay una cuadrícula de tarjetas de métricas y gráficas que se actualiza automáticamente cada 30 segundos.
El dashboard se filtra por la sucursal activa seleccionada en el selector superior. Si no hay sucursal seleccionada, muestra datos de toda la empresa.
---
Fila de KPIs (tarjetas superiores)
Seis tarjetas pequeñas en una fila responsiva (2 columnas en móvil, 4 en tablet, 6 en pantalla grande):
| Tarjeta | Qué muestra | Detalle adicional |
|---|---|---|
| Ventas hoy | Suma total de ventas del día en moneda local | Número de órdenes del día (excluye canceladas) |
| Pendientes | Órdenes en estado pending (esperando cocina) | Enlace "Ver →" a /orders |
| Preparando | Órdenes en estado preparing | Enlace "Ver →" a /orders |
| Listas | Órdenes en estado ready (listas para entregar) | Enlace "Ver →" a /orders-ready |
| Ticket promedio | Promedio de total por orden (solo órdenes confirmadas) | Subtítulo "órdenes confirmadas" |
| Canal | Desglose de órdenes por tipo | En mesa / Para llevar / Domicilio con conteos |
Las tarjetas de Pendientes, Preparando y Listas cambian de color (amarillo, azul, verde respectivamente) cuando tienen órdenes activas, para llamar la atención del encargado.
---
Ventas por método de pago
Tarjeta con lista de ventas agrupadas por forma de pago. Muestra:
- Ícono del método (billetera para efectivo, tarjeta para débito/crédito, flechas para transferencia, regalo para cortesía)
- Nombre del método y número de órdenes entre paréntesis
- Monto total a la derecha
- Fila de total general al final con línea separadora
Métodos posibles: Efectivo, Débito, Crédito, Transferencia, Cortesía.
---
Cajas abiertas
Tarjeta lateral que muestra los turnos de caja actualmente abiertos en la sucursal. Para cada turno:
- Nombre de la caja registradora
- Balance inicial del turno
- Tiempo transcurrido desde la apertura (ej. "Hace 2h 15m")
Incluye enlace "Gestionar →" que va a /cash-register.
Si no hay turnos abiertos, muestra "No hay turnos abiertos".
---
Gráficas de barras
Dos tarjetas con mini-gráficas de barras:
Órdenes por hora (hoy)
- 24 barras verticales, una por hora (0h a 23h)
- La altura de cada barra es proporcional al número de órdenes en esa hora
- Útil para identificar las horas pico del negocio
Ventas últimos 7 días
- Una barra por día (lunes, mar, mié, etc.)
- Altura proporcional al monto total de ventas ese día
- Permite ver tendencias semanales de un vistazo
---
Top artículos hoy
Lista ordenada de los artículos más vendidos en el día. Para cada artículo:
- Número de posición (1, 2, 3...)
- Nombre del artículo
- Cantidad vendida en unidades y monto recaudado (ej. "12 uds · $840")
- Barra de progreso horizontal proporcional al artículo más vendido
Solo incluye artículos de órdenes en estados delivered o preparing/ready (confirmadas).
---
Órdenes recientes
Lista de las últimas órdenes del día con:
- Número de orden (ej. #42)
- Etiqueta de estado con color (Por aprobar / Pendiente / Preparando / Listo / Entregado / Cancelado)
- Tipo de orden y número de mesa si aplica
- Total de la orden
- Tiempo transcurrido (ej. "5m", "2h")
Enlace "Ver todas →" que navega a /orders.
---
Comportamiento de carga
Mientras los datos cargan, cada sección muestra skeletons (placeholders grises animados) con la misma forma que tendrán los datos reales. El botón "Actualizar" dispara una recarga manual en cualquier momento.