Saltar al contenido principal

SREQ-UX-04 · Tour guiado de Conteos cíclicos

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

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​

#AnclajeControl
1conteos.contenidoPresentación del flujo (único paso de contexto)
2conteos.offlineFranja de modo sin conexión (solo si aparece)
3conteos.boton.recargarFlecha circular: refresca sin perder filtros
4conteos.boton.nuevoSigno más: abre el formulario de programación
5conteos.boton.ayudaEl (?) de la pantalla
6-9conteos.filtros, .filtros.titulo, .filtros.estado, .filtros.almacenLa card en una fila, el embudo con «Filtros», estado y almacén
10-12conteos.cargando, .error, .vacioEstados de la consulta
13-14conteos.tabla, .tabla.encabezadoTabla y sus siete columnas
15-22conteos.tabla.fila, .codigo, .almacen, .alcance, .periodicidad, .fecha, .estado, .boton.detalleAnatomía de la fila, celda por celda, y «Ver detalle»
23conteos.paginacionTotal, «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 cicloBotones incluidos
ProgramadoIniciar, Cancelar
En procesoRegistrar conteo, Cancelar
Contado (con líneas sobre el umbral)Preparar reconteo, Guardar reconteo, Generar ajustes, Cerrar ciclo
Contado / AjustadoGenerar 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-hidden en iconos decorativos.
  • src/config/tours.ts — pasosConteos, pasosNuevoConteo y pasosDetalleConteo; módulo conteos activo.
  • 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 --noEmit limpio 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