Saltar al contenido principal

SREQ-UX-04 · Tour guiado de Clasificación ABC

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

La clasificación ABC decide qué productos se controlan de cerca (A), cuáles de forma intermedia (B) y cuáles son cola larga (C). Sus dos riesgos son de concepto: los criterios (porcentajes de Pareto y ventana de días) y el momento del cálculo (recalcular a mano). El tour los explica control a control, sin gastar pasos en títulos ni textos.

🧭 Veinticuatro pasos, sin pasos de títulos​

#AnclajeControl
1clasificacion-abc.contenidoPresentación del Pareto (único paso de contexto)
2clasificacion-abc.boton.recalcularFlecha circular: recálculo manual de todos los productos
3clasificacion-abc.boton.ayudaEl (?) de la pantalla
4–8clasificacion-abc.criterios, .porcentaje-a, .porcentaje-b, .dias, .boton.guardarLa card de criterios y sus tres campos, más la calculadora de «Guardar y recalcular»
9–13clasificacion-abc.filtros, .filtros.titulo, .filtros.buscar, .filtros.boton.buscar, .filtros.categoriaLa card de filtros en una fila: embudo, título, buscador con lupa, botón y selector ABC
14clasificacion-abc.cargandoIndicador de carga (solo mientras consulta)
15–16clasificacion-abc.productos, .productos.tablaLa card de resultados y su tabla
17clasificacion-abc.productos.encabezadoLas seis columnas
18–24clasificacion-abc.productos.fila, .producto, .sku, .abc, .valor, .porcentaje, .fechaAnatomía de una fila, celda por celda
25clasificacion-abc.paginacionAnterior/Siguiente, tamaño de página y total

Sin resultados el recorrido queda en 18 pasos (estado vacío en lugar de la anatomía) y mientras carga en 14 (la tabla y la paginación no existen). No hay pasos de titulo ni subtitulo.

🧱 Los filtros dejan de estar escondidos​

Antes eran un div con un input, un botón y un selector dentro de la card de productos, sin nombre. Ahora son una card propia con un único CardContent en flex flex-wrap items-end:

[ 🔻 Filtros ] [ 🔍 Buscar por nombre o SKU… ] [ 🔍 Buscar ] [ Categoría ABC ▾ ]

El embudo y «Filtros» abren la fila —como pedía el requerimiento— y los tres controles la acompañan. Se añadió la lupa dentro del campo y en el botón, y id/Label para que el selector de categoría tenga etiqueta asociada.

🛠️ Cambios​

  • src/pages/clasificacion-abc.tsx — data-tour-modulo="clasificacion-abc", anclajes de controles, cards, columnas y celdas; botón (?) con useTourOpcional; card de filtros propia en una fila con título e icono; aria-hidden en iconos decorativos.
  • src/config/tours.ts — pasosClasificacionAbc(estado) y el módulo clasificacion-abc activo.
  • src/config/tours.spec.ts — lista canónica y composición del guion (24/18/14 pasos).
  • src/components/__tests__/clasificacion-abc-tour.test.tsx (nuevo) — 4 pruebas.

✅ Verificación​

  • clasificacion-abc-tour.test.tsx: 4/4 en verde (fila única con los tres controles, anclajes, «1 / 24» y «1 / 18» sin resultados).
  • tours.spec.ts: 19/19 en verde, incluido el chequeo cruzado de los anclajes activos.
  • ESLint limpio en los archivos tocados.

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