Cómo filtrar estados KDS
Reduce temporalmente el tablero KDS de Marea Gran Via a los productos en Solicitados, Enviados, En preparación o Listos. El filtro solo cambia lo que se ve en pantalla; no modifica tickets, productos ni estados de producción.
En este artículo
El filtro de estados ayuda al equipo de cocina a concentrarse en la parte del servicio que necesita revisar en ese momento: pedidos recién solicitados, enviados a cocina, en preparación o listos para servir.
Es una acción local de la pantalla KDS. La cabecera conserva los contadores de todos los productos relevantes y el tablero se reduce al instante, sin guardar cambios en la URL, el backend ni el almacenamiento local.
Antes de empezar
- Haber iniciado sesión con Grupo Marea Demo y la ubicación Marea Gran Via seleccionada.
- Tener acceso al KDS mediante `kds:view`, `kds:use` o `kds:manage` en la ubicación.
- Tener KDS activo en los ajustes del TPV de la ubicación.
- Abrir `/:orgId/:locationId/kds` con una `service_session` activa y tickets abiertos.
- Para ver un cambio visual, la sesión debe tener productos de cocina en `draft`, `sent`, `preparing` o `ready`.
Instrucciones
- 1.
Abre el tablero KDS
Entra en el KDS de Marea Gran Via. La pantalla valida la organización, la ubicación, los permisos KDS y el ajuste activo del TPV antes de cargar el servicio activo y sus tickets abiertos.
- 2.
Revisa los filtros de la cabecera
La cabecera muestra Solicitados, Enviados, En preparación y Listos. Cada opción incluye un contador calculado sobre todos los productos de cocina relevantes antes de aplicar el filtro activo.
- 3.
Selecciona uno o varios estados
Toca los estados que quieres mantener visibles. Por ejemplo, deja activo solo En preparación para centrarte en los productos que ya están en cocina, o combina Enviados y En preparación para revisar la cola inmediata.
- 4.
Comprueba el cambio de vista
El tablero se recalcula al momento y cada cuenta enseña solo los productos cuyo `production_status` coincide con los filtros activos. No aparece ningún botón de guardar porque la acción no persiste datos.
- 5.
Mantén al menos un estado activo
Si intentas desmarcar el último estado seleccionado, la pantalla conserva la selección anterior. Para cambiar a otro único estado, activa primero el nuevo y después desactiva el anterior.
- 6.
Interpreta las cuentas vacías
Una cuenta puede seguir visible aunque no tenga productos en el estado filtrado. En ese caso muestra Esta cuenta no tiene productos en el estado seleccionado, porque la cuenta conserva productos KDS relevantes en otros estados.
Validaciones y límites
- Los únicos filtros visibles del KDS son `draft`, `sent`, `preparing` y `ready`.
- Los estados `served` y `cancelled` quedan fuera del tablero KDS y no se presentan como filtros.
- La interfaz no permite dejar la selección de estados vacía.
- El filtro no llama a un endpoint propio ni modifica `ticket_items.production_status`.
- Los tickets cerrados o anulados no aparecen en el tablero.
- Con acceso KDS sin `tpv:use`, la consulta de tickets queda restringida al servicio activo.
Resultado esperado
El operador reduce el ruido visual del KDS y trabaja con el estado que necesita, manteniendo el contexto del servicio activo y sin alterar ningún dato de producción.