UX-001 — Búsqueda Avanzada
Implementación de la mejora UX-001 (Búsqueda Avanzada), dentro de 7. Experiencia de Usuario. Las consultas de inventario, movimientos, solicitudes y productos pasan de filtros sueltos, incompletos y mayormente en el cliente a una búsqueda avanzada de servidor, con filtros favoritos por usuario y resultados paginados y ordenables.
📋 Alcance
| RF | Entregable |
|---|---|
| RF-UX-001-01 | Búsqueda avanzada con filtros múltiples en inventario, movimientos, solicitudes y productos |
| RF-UX-001-02 | Combinar filtros por texto, categoría, ubicación, estado y otros atributos |
| RF-UX-001-03 | Guardar los filtros favoritos para reutilizarlos |
| RF-UX-001-04 | Resultados con paginación y ordenamiento |
⚙️ Cómo funciona
- Filtrado en el servidor: nuevos DTO de filtros que extienden
PaginationDto(sin tocar el DTO base) y consultas conQueryBuilder. El orden se resuelve contra una lista blanca por dominio; un campo inválido cae al orden por defecto. - Búsqueda de texto (
ILIKE) centralizada enshared/filtros/filtros.util.ts. - Filtros favoritos: tabla
filtros_guardados(jsonb, por usuario y ámbito) con un dominio propio y aislamiento por usuario; máximo 20 por pantalla y uno predeterminado por ámbito. - Dashboard de inventario: nuevo
GET /api/movimientos-inventario/estadistica/resumenpara que las métricas respondan al filtro y no a la página cargada. - Frontend: panel de filtros reutilizable (
FilterPanel/FilterField) y menú de favoritos (SavedFiltersMenu) en las cuatro pantallas, manteniendo el patrónuseStatedel proyecto.
🔎 Filtros por pantalla
| Pantalla | Filtros |
|---|---|
| Productos | texto, categoría, presentación, almacén, ubicación (zona), estado, nivel de stock, ABC, orden |
| Solicitudes | texto, estado, tipo, prioridad, oficina, fechas, orden por columna |
| Movimientos | texto, tipo, producto, categoría, almacén, zona, fechas, orden (cursor) |
| Dashboard | igual que movimientos + paginación y orden |
🗄️ Base de datos
Migración 036-create-filtros-guardados con la tabla filtros_guardados
(id_filtro, id_usuario, ambito, nombre, filtros jsonb, es_predeterminado,
creado_en, actualizado_en), FK a usuarios con ON DELETE CASCADE y UNIQUE
(id_usuario, ambito, nombre). Ejecutada y registrada en ccf_almacen.
🐛 Defecto corregido de paso
El controlador de movimientos solo exponía @Get('paginated'), pero el cliente de cursor de
TEC-003 llamaba a GET /api/movimientos-inventario?modo=cursor, que no existía. Se añade la
ruta base @Get() (offset + cursor + filtros) y se conserva /paginated como alias.
Seguridad (TEC-007): no se permite ordenar por precio;
precio_unitarioestá cifrado en reposo.
✅ Verificación
- Suite API: 884 pruebas / 89 suites / 0 fallos (incluye 23 nuevas de filtros y favoritos).
- Suite web: 78 pruebas / 19 suites / 0 fallos (incluye 4 de los componentes de filtros).
tscEXIT 0,nest buildEXIT 0 ynext lintEXIT 0 en API y web.- Migración
036aplicada sobre la base real.
📚 Documentación
- Manual:
docs/manuales/dashboard/busqueda-avanzada.md - Spec:
docs/mejoras/ux-001-busqueda-avanzada.md
