Saltar al contenido principal

Conteos cíclicos — pruebas unitarias y corrección del reconteo

La pantalla Operaciones › Inventarios › Conteos cíclicos (/conteos) programa y ejecuta conteos de inventario por almacén, producto o ubicación. Ahora tiene 30 casos de prueba y, al escribir el flujo de reconteo, apareció un defecto real: «Preparar reconteo» no habilitaba la captura de cantidades y «Guardar reconteo» enviaba ceros.

1. Suite nueva (30 casos)​

ccf-almacen-web/src/__tests__/conteos-gestion.test.tsx:

BloqueQué fija
ListadoCarga, error del servidor, vacío, código/almacén/alcance/periodicidad/fecha y los seis estados (programado, en proceso, contado, ajustado, cerrado, cancelado), bodega de respaldo, recargar y modo offline
Filtros y paginaciónEstado y almacén, reinicio a página 1, meta y navegación Anterior/Siguiente
ProgramaciónAlcance almacén sin campos extra; producto y ubicación con su campo obligatorio; fecha y almacén obligatorios; periodicidad, umbral y observaciones; payload exacto por alcance; estado «Programando…»; error y cancelación
DetalleCarga del detalle, líneas con sistema/contado/diferencia/recontado, motivo, y acciones por estado
EjecuciónProgramado: iniciar/cancelar. En proceso: captura de cantidades, rechazo de negativas, registro y error. Contado: preparar reconteo, captura solo de líneas marcadas, guardar reconteo y error. Ajustado: generar ajustes y cerrar. Cerrado: sin acciones
ErroresMensaje del servidor en acciones y en el registro

2. Defecto corregido: el reconteo no permitía capturar cantidades​

«Preparar reconteo» solo limpiaba el estado y mostraba un aviso, pero las líneas seguían sin input porque la captura solo se renderizaba en estado en_proceso. «Guardar reconteo» leía entonces cantidades vacías y enviaba 0 en todas las líneas marcadas.

Ahora «Preparar reconteo» activa reconteoPreparado y la columna «Contado» muestra un input, solo en las líneas con requiereReconteo, con la etiqueta accesible «Cantidad recontada para …». Al guardar con éxito se limpian las cantidades y se desactiva la captura; al cerrar el detalle también se reinicia.

La prueba «preparar reconteo habilita la captura y guarda solo las líneas marcadas» fija el comportamiento: aparece el input de la línea marcada, no aparece el de la línea sin marcar y el cuerpo enviado contiene únicamente esa línea con la cantidad capturada.

3. Patrón de las pruebas​

  • Se monta la página real y se mockean los hooks de conteos, almacenes, inventario y el useQuery de niveles; conectividad, tour y avisos también se controlan.
  • Las acciones por estado se verifican por el id enviado y por el toast resultante.
  • Las filas del detalle se acotan con within y se localizan por el nombre del producto.
  • No hay pruebas de solo instantánea ni aserciones sobre clases de estilo.

4. Cómo verificarlo​

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

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

Archivos clave​

  • ccf-almacen-web/src/__tests__/conteos-gestion.test.tsx — suite de la página.
  • ccf-almacen-web/src/pages/conteos.tsx — programación, detalle, reconteo y ajustes; corrección del estado reconteoPreparado.
  • ccf-almacen-web/src/hooks/use-conteos.ts — contrato de consultas y acciones.