SREQ-UX-04 · Tour guiado de Reportes de Almacén
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)
| # | Anclaje | Control |
|---|---|---|
| 1 | reportes.contenido | Los cinco reportes, filtros y exportación |
| 2 | reportes.boton.graficas | «Ver gráficas»: abre el panel estadístico en otra pestaña |
| 3 | reportes.boton.ayuda | El (?) |
| 4 | reportes.tipos | La card «Tipo de Reporte» |
| 5–9 | reportes.tipo.requests-details, .dispatch-requests, .inventory-movements, .stock-loads, .current-inventory | Una por tarjeta, con lo que cambia en cada reporte |
| 10–13 | reportes.filtros, .filtros.titulo, .filtros.fecha-inicio, .filtros.fecha-fin | La card en una fila, el embudo con «Filtros» y el rango |
| 16–18 | reportes.boton.actualizar, .boton.pdf, .boton.excel | Filtros aplicados solo al actualizar; exportación condicionada a que haya filas |
| 19–20 | reportes.vista, .vista.buscar | La 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
| Reporte | Se añaden | Total |
|---|---|---|
| Solicitudes y Detalles | filtros.estado, filtros.area | 22 con datos / 21 sin datos |
| Despacho de Solicitudes | filtros.estado, filtros.area | 22 / 21 |
| Movimientos de Inventario | filtros.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(?)conuseTourOpcional; card de filtros en una fila con título e icono;aria-hiddenen los iconos decorativos.src/config/tours.ts—pasosReportes(estado); el móduloreportespasa a activo.src/config/tours.spec.ts— lista canónica, composición del guion y excepción documentada para los anclajesreportes.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 --noEmitlimpio; ESLint sin errores (quedan losexhaustive-depsprevios del archivo).
📄 Requerimiento: SREQ-UX-04: Tour guiado por funcionalidad
