Filtrar bandeja de soporte
Acota la bandeja interna de soporte combinando búsqueda por texto, estado y tipo de ticket antes de abrir un caso concreto.
En este artículo
Usa esta guía cuando el equipo de soporte interno necesite reducir la lista de tickets antes de revisar un caso. La bandeja permite buscar por título o descripción y combinar esa búsqueda con filtros de estado y tipo.
Los filtros se aplican al momento. La pantalla muestra el total filtrado, las tarjetas resultantes y los badges de estado y tipo; si no hay coincidencias, muestra el estado vacío correspondiente.
Antes de empezar
- Sesión autenticada en la app interna.
- Permiso de sistema `user-reports:manage`.
- Tickets de soporte existentes si se quiere mostrar una bandeja con resultados; sin coincidencias, la pantalla muestra estado vacío.
Instrucciones
- 1.
Abrir Gestionar tickets
Desde el menú de usuario, abre Gestionar tickets, o entra directamente en `/support-requests`. La entrada solo aparece con `user-reports:manage`; sin permiso, la pantalla directa muestra el aviso de falta de permisos.
- 2.
Buscar por título o descripción
Escribe el texto en Buscar por título o descripción. La pantalla recorta espacios al principio y al final, y no aplica búsqueda textual si el campo queda vacío.
- 3.
Filtrar por estado
Selecciona un estado distinto de Todos los estados para limitar la lista a `open`, `in_progress`, `resolved` o `closed`. El cambio actualiza la bandeja sin botón de aplicar.
- 4.
Filtrar por tipo
Selecciona un tipo distinto de Todos los tipos para ver solo tickets `bug`, `improvement` u `other`. El tipo se combina con la búsqueda y el estado seleccionados.
- 5.
Revisar la lista filtrada
Comprueba el total, las tarjetas de ticket, los badges y el contexto de organización o ubicación. Si no hay `reportId` explícito, la pantalla selecciona el primer resultado disponible.
Validaciones y límites
- La bandeja lista tickets de todos los usuarios, no solo del usuario autenticado.
- La búsqueda se aplica sobre `title` o `description`.
- Todos los estados y Todos los tipos no envían `status` ni `type`.
- El backend recorta `query`, `status` y `type`; `status` y `type` se normalizan a minúsculas.
- Los resultados se ordenan por `created_at DESC, id DESC`.
- La pantalla solicita `page: 1` y `page_size: 50`, sin controles visibles de paginación.
- No hay filtros por reportero, organización, ubicación, fecha, adjuntos ni última actividad, y los filtros no se persisten en la URL.
Resultado esperado
El responsable de soporte ve una bandeja acotada con el total filtrado, los tickets coincidentes y sus etiquetas de tipo y estado. Si la combinación no devuelve tickets, la pantalla confirma que no hay coincidencias.