Saltar al contenido principal

SREQ-UX-04 · Tour guiado de Reportes de Almacén

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

La pantalla de reportes cambia según lo que se elija: dos de los cinco reportes filtran por estado y área, uno añade tipo de movimiento y estadística mensual, y la vista previa puede estar con datos o vacía. El tour se compone con ese estado, así que no resalta nunca un control que no está.

🧭 Pasos base (siempre)​

#AnclajeControl
1reportes.contenidoLos cinco reportes, filtros y exportación
2reportes.boton.graficas«Ver gráficas»: abre el panel estadístico en otra pestaña
3reportes.boton.ayudaEl (?)
4reportes.tiposLa card «Tipo de Reporte»
5–9reportes.tipo.requests-details, .dispatch-requests, .inventory-movements, .stock-loads, .current-inventoryUna por tarjeta, con lo que cambia en cada reporte
10–13reportes.filtros, .filtros.titulo, .filtros.fecha-inicio, .filtros.fecha-finLa card en una fila, el embudo con «Filtros» y el rango
16–18reportes.boton.actualizar, .boton.pdf, .boton.excelFiltros aplicados solo al actualizar; exportación condicionada a que haya filas
19–20reportes.vista, .vista.buscarLa vista previa y el buscador en memoria
21–22.vista.resumen, .vista.tabla (con datos) o .vista.vacio (sin datos)Resumen y tabla, o el aviso

🔀 Filtros propios del reporte​

ReporteSe añadenTotal
Solicitudes y Detallesfiltros.estado, filtros.area22 con datos / 21 sin datos
Despacho de Solicitudesfiltros.estado, filtros.area22 / 21
Movimientos de Inventariofiltros.tipo + card mensual (5 pasos: card, producto, área, año y «Refrescar»)26 / 25
Cargas de Stock—20 / 19
Estado Actual del Inventario—20 / 19

Sin pasos de titulo ni subtitulo: el recorrido va de control en control. El guion viejo de tres pasos (reportes.detalle, contenido y menú) queda reemplazado.

🧱 La card de filtros, en una sola fila​

Antes: CardHeader con el título y un icono de calendario, y debajo una fila de controles. Ahora un único CardContent en flex flex-wrap items-end con el embudo + «Filtros» como primer elemento, seguido de las dos fechas, los filtros del reporte y los botones actualizar / PDF / Excel. El título y su descripción de cabecera se sustituyen por un texto para lectores de pantalla.

🛠️ Cambios​

  • src/components/reports/warehouse-reports.tsx — anclajes de botones, tarjetas de tipo, filtros, vista previa y estadística mensual; botón (?) con useTourOpcional; card de filtros en una fila con título e icono; aria-hidden en los iconos decorativos.
  • src/config/tours.ts — pasosReportes(estado); el módulo reportes pasa a activo.
  • src/config/tours.spec.ts — lista canónica, composición del guion y excepción documentada para los anclajes reportes.tipo.* (se componen desde el catálogo de tarjetas).
  • src/components/__tests__/reportes-tour.test.tsx (nuevo) — 4 pruebas.

✅ Verificación​

  • reportes-tour.test.tsx: 4/4 en verde (fila única con los siete controles, anclajes completos, «1 / 21» en solicitudes sin datos y «1 / 25» al cambiar a movimientos).
  • tours.spec.ts: 27/27 en verde, incluido el chequeo cruzado de anclajes activos.
  • tsc --noEmit limpio; ESLint sin errores (quedan los exhaustive-deps previos del archivo).

📄 Requerimiento: SREQ-UX-04: Tour guiado por funcionalidad