Saltar al contenido principal

SREQ-UX-04 · Tour guiado de Órdenes de compra

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

La pantalla de órdenes es corta pero con reglas: cada estado habilita un botón distinto y toda transición pide confirmación. El recorrido va control a control —sin gastar pasos en títulos ni textos— y añade un mini-tour dentro del diálogo de confirmación.

🧭 Veintiún pasos en la pantalla​

#AnclajeControl
1ordenes-compra.contenidoLa cadena generada → enviada → confirmada → recibida (y cancelada)
2ordenes-compra.boton.recargarFlecha circular: refresca sin perder filtro ni página
3ordenes-compra.boton.ayudaEl (?) de la pantalla
4–6ordenes-compra.filtros, .filtros.titulo, .filtros.estadoLa card en una fila, el embudo con «Filtros» y los cinco estados
7–9ordenes-compra.cargando, .error, .vacioEstados de la consulta
10–11ordenes-compra.tabla, .tabla.encabezadoTabla y sus siete columnas
12–19ordenes-compra.tabla.fila, .numero, .proveedor, .tipo, .estado, .monto, .fecha, .accionesAnatomía de la fila, celda por celda
20.tabla.boton.enviar, .boton.confirmar, .boton.cancelar, .tabla.texto.recepcionadaSolo los que el estado de las filas permite
21ordenes-compra.paginacion«Página X de Y» y Anterior/Siguiente

Sin órdenes el recorrido queda en 7 pasos (pantalla + estado vacío) y con error en 7. No hay pasos de titulo ni subtitulo.

✅ La confirmación tiene su propio recorrido​

Cada transición abre una modal con título, descripción, (si es cancelación) el motivo y dos botones. El (?) dentro del diálogo la recorre con la modal abierta:

AcciónPasosQué explica
Enviar / Confirmar3El diálogo, «Volver» y el botón de la acción
Cancelar4Además, el campo «Motivo», obligatorio: sin él la acción se rechaza

🧱 El filtro deja de estar suelto​

Antes era un div con un único Select sin card ni nombre. Ahora es una card con un CardContent en flex flex-wrap items-end: embudo + «Filtros» como primer elemento y el selector de estado a su lado, con id/Label asociados. Misma lógica: cambiar el estado consulta y vuelve a la página 1.

🛠️ Cambios​

  • src/pages/ordenes-compra.tsx — data-tour-modulo="ordenes-compra", anclajes de botones, filtros, tabla/celdas, marca «Recepcionada», paginación y confirmación; dos (?) (pantalla y diálogo); card de filtros en una fila con título e icono; aria-hidden en iconos decorativos.
  • src/config/tours.ts — pasosOrdenesCompra(estado) (21) y pasosConfirmacionOrden(estado) (3-4); módulo ordenes-compra activo.
  • src/config/tours.spec.ts — lista canónica y composición de ambos guiones.
  • src/components/__tests__/ordenes-compra-tour.test.tsx (nuevo) — 6 pruebas.

✅ Verificación​

  • ordenes-compra-tour.test.tsx: 6/6 en verde (fila única de filtros, anclajes completos, «1 / 21», «1 / 7» sin órdenes, confirmación de cancelación «1 / 4» y de envío «1 / 3» sin campo de motivo).
  • tours.spec.ts: 23/23 en verde, con el chequeo cruzado de los 27 anclajes activos.
  • tsc --noEmit limpio y ESLint sin avisos en los archivos tocados.

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