SREQ-UX-04 · Tour guiado de Órdenes de compra
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
| # | Anclaje | Control |
|---|---|---|
| 1 | ordenes-compra.contenido | La cadena generada → enviada → confirmada → recibida (y cancelada) |
| 2 | ordenes-compra.boton.recargar | Flecha circular: refresca sin perder filtro ni página |
| 3 | ordenes-compra.boton.ayuda | El (?) de la pantalla |
| 4–6 | ordenes-compra.filtros, .filtros.titulo, .filtros.estado | La card en una fila, el embudo con «Filtros» y los cinco estados |
| 7–9 | ordenes-compra.cargando, .error, .vacio | Estados de la consulta |
| 10–11 | ordenes-compra.tabla, .tabla.encabezado | Tabla y sus siete columnas |
| 12–19 | ordenes-compra.tabla.fila, .numero, .proveedor, .tipo, .estado, .monto, .fecha, .acciones | Anatomía de la fila, celda por celda |
| 20 | .tabla.boton.enviar, .boton.confirmar, .boton.cancelar, .tabla.texto.recepcionada | Solo los que el estado de las filas permite |
| 21 | ordenes-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ón | Pasos | Qué explica |
|---|---|---|
| Enviar / Confirmar | 3 | El diálogo, «Volver» y el botón de la acción |
| Cancelar | 4 | Ademá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-hiddenen iconos decorativos.src/config/tours.ts—pasosOrdenesCompra(estado)(21) ypasosConfirmacionOrden(estado)(3-4); móduloordenes-compraactivo.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 --noEmitlimpio y ESLint sin avisos en los archivos tocados.
📄 Requerimiento: SREQ-UX-04: Tour guiado por funcionalidad
