SREQ-UX-04 · Tour guiado de Clasificación ABC
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
| # | Anclaje | Control |
|---|---|---|
| 1 | clasificacion-abc.contenido | Presentación del Pareto (único paso de contexto) |
| 2 | clasificacion-abc.boton.recalcular | Flecha circular: recálculo manual de todos los productos |
| 3 | clasificacion-abc.boton.ayuda | El (?) de la pantalla |
| 4–8 | clasificacion-abc.criterios, .porcentaje-a, .porcentaje-b, .dias, .boton.guardar | La card de criterios y sus tres campos, más la calculadora de «Guardar y recalcular» |
| 9–13 | clasificacion-abc.filtros, .filtros.titulo, .filtros.buscar, .filtros.boton.buscar, .filtros.categoria | La card de filtros en una fila: embudo, título, buscador con lupa, botón y selector ABC |
| 14 | clasificacion-abc.cargando | Indicador de carga (solo mientras consulta) |
| 15–16 | clasificacion-abc.productos, .productos.tabla | La card de resultados y su tabla |
| 17 | clasificacion-abc.productos.encabezado | Las seis columnas |
| 18–24 | clasificacion-abc.productos.fila, .producto, .sku, .abc, .valor, .porcentaje, .fecha | Anatomía de una fila, celda por celda |
| 25 | clasificacion-abc.paginacion | Anterior/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(?)conuseTourOpcional; card de filtros propia en una fila con título e icono;aria-hiddenen iconos decorativos.src/config/tours.ts—pasosClasificacionAbc(estado)y el móduloclasificacion-abcactivo.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
