SREQ-UX-04 · Tour guiado de Movimientos de Inventario
· 3 min de lectura
Movimientos de Inventario concentra la trazabilidad completa del almacén —quién movió qué, cuándo
y con qué efecto en el stock— y una búsqueda avanzada de nueve campos que casi nadie termina de
descubrir. Ahora tiene tour guiado al detalle, lanzado desde el icono (?) junto a «Exportar
CSV».
🧭 Dieciocho pasos fijos
| # | Anclaje | Qué explica |
|---|---|---|
| 1 | movimientos.contenido | La pantalla: estadísticas, búsqueda, listado y detalle |
| 2 | movimientos.titulo | El registro de todo lo que entró, salió o se ajustó |
| 3 | movimientos.subtitulo | Criterios de búsqueda y filtrado en servidor |
| 4 | movimientos.boton.estadisticas | El ojo: muestra u oculta las métricas (se guarda) |
| 5 | movimientos.boton.exportar | Icono de descarga: CSV de lo cargado; deshabilitado sin datos |
| 6 | movimientos.boton.ayuda | El (?): repite el recorrido y abre el panel de filtros |
| 7-11 | movimientos.metrica.* | Una por tarjeta: total, entradas, salidas, ajustes y productos, con su icono y color |
| 12 | movimientos.filtros.toggle | Embudo, contador de filtros activos y chevron |
| 13 | movimientos.filtros.guardados | Marcador: guardar, aplicar, predeterminar y eliminar |
| 14 | movimientos.filtros.aplicar | Lupa: envía los filtros al servidor |
| 15 | movimientos.filtros.limpiar | Deshacer: restablece todo |
| 16 | movimientos.lista | La tarjeta del listado, con su contador |
| 17 | movimientos.lista.vacio | El estado «No hay movimientos» |
| 18 | movimientos.detalle | La tarjeta de detalle (con aviso si no hay selección) |
➕ Hasta dieciséis pasos más cuando el elemento existe
| Anclaje | Cuándo |
|---|---|
movimientos.filtros.buscar | Panel desplegado |
movimientos.filtros.tipo | Panel desplegado |
movimientos.filtros.producto | Panel desplegado |
movimientos.filtros.categoria | Panel desplegado |
movimientos.filtros.almacen | Panel desplegado |
movimientos.filtros.zona | Panel desplegado |
movimientos.filtros.fecha-desde | Panel desplegado |
movimientos.filtros.fecha-hasta | Panel desplegado |
movimientos.filtros.orden | Panel desplegado |
movimientos.lista.item | Hay movimientos (icono del tipo, producto, etiqueta, fecha, hora, usuario, cantidad, efecto en stock, ubicación y referencia) |
movimientos.cargar-mas | Quedan páginas por cursor |
movimientos.detalle.tipo | Hay un movimiento seleccionado |
movimientos.detalle.producto | Hay un movimiento seleccionado |
movimientos.detalle.datos | Hay un movimiento seleccionado |
movimientos.detalle.cambio | Hay un movimiento seleccionado |
movimientos.detalle.adicional | Hay un movimiento seleccionado |
movimientos.error | La consulta falló |
Recorrido completo: 34 pasos. El detalle muestra el estado vacío de la lista cuando no hay movimientos y la fila real cuando los hay, así que nunca apunta a un hueco.
🛠️ Cambios
src/pages/inventory-movements.tsx— botón(?), anclajes por sección/campo/icono yiniciarTour('movimientos', pasos)con el guion armado desde el estado real.src/components/inventory/inventory-movement-list.tsxy...-detail.tsx— anclajes del listado, la primera fila, el estado vacío y las cinco secciones del detalle.src/components/common/filters/filter-panel.tsx— nuevos propsabierto/onAbiertoChange(control externo opcional) para que el tour pueda desplegar el panel; sin ellos conserva su estado interno, así que las demás pantallas no cambian.src/config/tours.ts—pasosMovimientos(estado)y el módulomovimientosactivo.
✅ Verificación
movimientos-tour.test.tsx(nuevo): composición del guion (18 base y 34 completo), anclajes en el DOM, el(?)lanzando el recorrido y el panel abriéndose («1 / 27»), y «1 / 32» con una fila seleccionada.tours.spec.ts: chequeo cruzado de los 34 anclajes activos y composición del guion.tscy ESLint limpios.
📄 Documento del requerimiento: SREQ-UX-04: Tour guiado por funcionalidad.
