Saltar al contenido principal

Órdenes de compra — pruebas unitarias de estados y cancelación

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

La pantalla Operaciones › Compras › Órdenes de compra (/ordenes-compra) lista las órdenes generadas por punto de reorden o creadas a mano y permite avanzar su estado hasta Confirmada para poder recepcionar la mercancía (COM-002). Ahora tiene 24 casos de prueba.

1. Qué se cubre​

ccf-almacen-web/src/__tests__/ordenes-compra-gestion.test.tsx (24 casos):

BloqueQué fija
ListadoEspera, error con mensaje del servidor (incluido el arreglo de mensajes), vacío, número/proveedor/tipo/estado/monto/fecha, importe omitido por permisos («—»), monto 0 como importe real y fecha ausente («—»)
Acciones por estadoGenerada → Enviar + Cancelar; Enviada → Confirmar + Cancelar; Confirmada → solo Cancelar; Recibida → «Recepcionada»; Cancelada → sin acciones
Filtros y paginaciónFiltro por estado con reinicio a página 1, paginación en servidor por totalItems y recarga
ConfirmaciónEnviar, Confirmar y Cancelar (motivo obligatorio y recortado), éxito con su mensaje, error del servidor, «Volver» sin mutar y botón deshabilitado mientras guarda
TourSin proveedor no se pinta; con motor inicia ordenes-compra; aviso si no está listo; tour propio del diálogo de confirmación

2. Patrón de las pruebas​

  • Se mockean los hooks de React Query (useOrdenesCompra, useCambiarEstadoOrdenCompra), el toast del registro shadcn y el contexto de tour; la página se monta completa.
  • Las mutaciones se resuelven invocando onSuccess/onError desde el mock de mutate, que es exactamente lo que hace React Query al terminar.
  • Los importes se afirman con expresiones sobre el número (/1\.500\.000/) porque el espaciado de Intl puede variar; el campo omitido se comprueba por la celda completa.
  • El Select de filtro declara aria-label, así que se localiza por rol y nombre.

3. Cómo verificarlo​

cd ccf-almacen-web
npx jest src/__tests__/ordenes-compra-gestion.test.tsx
# Test Suites: 1 passed, 1 total
# Tests: 24 passed, 24 total

npx tsc --noEmit y npx eslint pasan sin errores.

Archivos clave​

  • ccf-almacen-web/src/__tests__/ordenes-compra-gestion.test.tsx — suite de la página.
  • ccf-almacen-web/src/pages/ordenes-compra.tsx — listado, acciones y confirmación.
  • ccf-almacen-web/src/hooks/use-compras.ts — consultas y mutaciones de la orden.
  • ccf-almacen-web/src/models/compras.entity.ts — estados, etiquetas y contratos.