Saltar al contenido principal

SREQ-UX-04 · Tour guiado de Movimientos de Inventario

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

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​

#AnclajeQué explica
1movimientos.contenidoLa pantalla: estadísticas, búsqueda, listado y detalle
2movimientos.tituloEl registro de todo lo que entró, salió o se ajustó
3movimientos.subtituloCriterios de búsqueda y filtrado en servidor
4movimientos.boton.estadisticasEl ojo: muestra u oculta las métricas (se guarda)
5movimientos.boton.exportarIcono de descarga: CSV de lo cargado; deshabilitado sin datos
6movimientos.boton.ayudaEl (?): repite el recorrido y abre el panel de filtros
7-11movimientos.metrica.*Una por tarjeta: total, entradas, salidas, ajustes y productos, con su icono y color
12movimientos.filtros.toggleEmbudo, contador de filtros activos y chevron
13movimientos.filtros.guardadosMarcador: guardar, aplicar, predeterminar y eliminar
14movimientos.filtros.aplicarLupa: envía los filtros al servidor
15movimientos.filtros.limpiarDeshacer: restablece todo
16movimientos.listaLa tarjeta del listado, con su contador
17movimientos.lista.vacioEl estado «No hay movimientos»
18movimientos.detalleLa tarjeta de detalle (con aviso si no hay selección)

➕ Hasta dieciséis pasos más cuando el elemento existe​

AnclajeCuándo
movimientos.filtros.buscarPanel desplegado
movimientos.filtros.tipoPanel desplegado
movimientos.filtros.productoPanel desplegado
movimientos.filtros.categoriaPanel desplegado
movimientos.filtros.almacenPanel desplegado
movimientos.filtros.zonaPanel desplegado
movimientos.filtros.fecha-desdePanel desplegado
movimientos.filtros.fecha-hastaPanel desplegado
movimientos.filtros.ordenPanel desplegado
movimientos.lista.itemHay movimientos (icono del tipo, producto, etiqueta, fecha, hora, usuario, cantidad, efecto en stock, ubicación y referencia)
movimientos.cargar-masQuedan páginas por cursor
movimientos.detalle.tipoHay un movimiento seleccionado
movimientos.detalle.productoHay un movimiento seleccionado
movimientos.detalle.datosHay un movimiento seleccionado
movimientos.detalle.cambioHay un movimiento seleccionado
movimientos.detalle.adicionalHay un movimiento seleccionado
movimientos.errorLa 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 y iniciarTour('movimientos', pasos) con el guion armado desde el estado real.
  • src/components/inventory/inventory-movement-list.tsx y ...-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 props abierto / 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ódulo movimientos activo.

✅ 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.
  • tsc y ESLint limpios.

📄 Documento del requerimiento: SREQ-UX-04: Tour guiado por funcionalidad.