Saltar al contenido principal

UX-001 — Búsqueda Avanzada

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

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​

RFEntregable
RF-UX-001-01Búsqueda avanzada con filtros múltiples en inventario, movimientos, solicitudes y productos
RF-UX-001-02Combinar filtros por texto, categoría, ubicación, estado y otros atributos
RF-UX-001-03Guardar los filtros favoritos para reutilizarlos
RF-UX-001-04Resultados 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 con QueryBuilder. 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 en shared/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/resumen para 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ón useState del proyecto.

🔎 Filtros por pantalla​

PantallaFiltros
Productostexto, categoría, presentación, almacén, ubicación (zona), estado, nivel de stock, ABC, orden
Solicitudestexto, estado, tipo, prioridad, oficina, fechas, orden por columna
Movimientostexto, tipo, producto, categoría, almacén, zona, fechas, orden (cursor)
Dashboardigual 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_unitario está 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).
  • tsc EXIT 0, nest build EXIT 0 y next lint EXIT 0 en API y web.
  • Migración 036 aplicada sobre la base real.

📚 Documentación​

  • Manual: docs/manuales/dashboard/busqueda-avanzada.md
  • Spec: docs/mejoras/ux-001-busqueda-avanzada.md