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:
| Bloque | Qué fija |
|---|---|
| Listado | Carga, 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ón | Estado y almacén, reinicio a página 1, meta y navegación Anterior/Siguiente |
| Programación | Alcance 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 |
| Detalle | Carga del detalle, líneas con sistema/contado/diferencia/recontado, motivo, y acciones por estado |
| Ejecución | Programado: 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 |
| Errores | Mensaje 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
useQueryde 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
withiny 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 estadoreconteoPreparado.ccf-almacen-web/src/hooks/use-conteos.ts— contrato de consultas y acciones.