SREQ-UX-04 · Tour guiado de Conteos cíclicos
Conteos cíclicos no es una pantalla de consulta: es un flujo de cinco estados donde cada fase habilita botones distintos. Por eso el tour no se queda en la superficie —va control a control— y se divide en tres recorridos: la pantalla, el formulario de programación y el detalle del ciclo.
🧭 Pantalla: 19 pasos, sin títulos ni textos
| # | Anclaje | Control |
|---|---|---|
| 1 | conteos.contenido | Presentación del flujo (único paso de contexto) |
| 2 | conteos.offline | Franja de modo sin conexión (solo si aparece) |
| 3 | conteos.boton.recargar | Flecha circular: refresca sin perder filtros |
| 4 | conteos.boton.nuevo | Signo más: abre el formulario de programación |
| 5 | conteos.boton.ayuda | El (?) de la pantalla |
| 6-9 | conteos.filtros, .filtros.titulo, .filtros.estado, .filtros.almacen | La card en una fila, el embudo con «Filtros», estado y almacén |
| 10-12 | conteos.cargando, .error, .vacio | Estados de la consulta |
| 13-14 | conteos.tabla, .tabla.encabezado | Tabla y sus siete columnas |
| 15-22 | conteos.tabla.fila, .codigo, .almacen, .alcance, .periodicidad, .fecha, .estado, .boton.detalle | Anatomía de la fila, celda por celda, y «Ver detalle» |
| 23 | conteos.paginacion | Total, «página X de Y», Anterior/Siguiente |
Sin ciclos el recorrido queda en 9 pasos (pantalla + estado vacío) y con error en 9 (pantalla +
aviso). No hay pasos dedicados a conteos.titulo ni conteos.subtitulo, tal como se pidió: el foco
está en los controles.
🧾 Programación: 9 a 10 pasos
(?) dentro de «Programar ciclo de conteo», con la modal abierta (el motor del tour se pinta por
encima del diálogo):
conteos.nuevo → .almacen → .alcance → .producto (alcance producto) o .nivel (alcance
ubicación) → .periodicidad → .fecha → .umbral → .observaciones → .boton.cancelar →
.boton.programar.
🔍 Detalle: hasta 14 pasos, según el estado
(?) dentro del detalle del conteo:
conteos.detalle → .tabla → .encabezado → .fila → .producto (con la etiqueta roja
«Recontar») → .sistema → .contado (campo editable solo en «en proceso») → .diferencia →
.recontado → .acciones → y los botones que correspondan:
| Estado del ciclo | Botones incluidos |
|---|---|
| Programado | Iniciar, Cancelar |
| En proceso | Registrar conteo, Cancelar |
| Contado (con líneas sobre el umbral) | Preparar reconteo, Guardar reconteo, Generar ajustes, Cerrar ciclo |
| Contado / Ajustado | Generar ajustes, Cerrar ciclo |
Así el tour nunca resalta un botón que el usuario no tiene delante.
🧱 Filtros: de dos selectores sueltos a una card
El bloque era un div con dos Select sin título. Ahora es una card con un único CardContent
en flex flex-wrap items-end: embudo + «Filtros» como primer elemento y los dos campos con flex-1
y ancho máximo. Misma lógica: cada cambio consulta al servidor y reinicia la página.
🛠️ Cambios
src/pages/conteos.tsx—data-tour-modulo="conteos", anclajes de control, tres botones(?)(pantalla, alta y detalle), card de filtros en una fila con título e icono,aria-hiddenen iconos decorativos.src/config/tours.ts—pasosConteos,pasosNuevoConteoypasosDetalleConteo; móduloconteosactivo.src/config/tours.spec.ts— módulo activo y composición de los tres guiones (19/9, 9-10, 6-14 pasos).src/components/__tests__/conteos-tour.test.tsx(nuevo) — 6 pruebas.
✅ Verificación
conteos-tour.test.tsx: 6/6 en verde (fila única de filtros, anclajes, «1 / 19», «1 / 9», formulario «1 / 9» y detalle «1 / 14»).tours.spec.ts: 17/17 en verde.tsc --noEmitlimpio y ESLint sin avisos.
🔎 Observación detectada (no corregida)
En el detalle, las cantidades de reconteo se capturan en el mismo campo «Contado», que solo se renderiza como input con el ciclo en proceso. Cuando el ciclo ya está contado —el único estado en el que aparecen «Preparar reconteo» y «Guardar reconteo»— no hay campo donde digitar el reconteo, de modo que «Guardar reconteo» envía líneas con cantidad vacía. Queda anotado para una iteración funcional (no entra en el alcance de este tour).
📄 Requerimiento: SREQ-UX-04: Tour guiado por funcionalidad
