Saltar al contenido principal

«Vender» (POS) — 54 pruebas de pantalla y un solo juego de fórmulas

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

La pantalla Operación → Vender (src/pages/pos.tsx, REQ-POS-01/02/03) solo tenía cubiertas las piezas sueltas: las reglas del carrito (utils/pos-carrito.spec.ts), la multiventa (utils/pos-multiventa.spec.ts), el selector de pestañas, la tarjeta de la empresa y las pantallas de administración. La integración de la caja —buscar, cobrar, abrir y cerrar caja, cambiar de venta y emitir el comprobante— no tenía red de seguridad. Esta entrega añade una suite de 54 casos que la cubre de punta a punta.

1. Una suite, toda la pantalla​

ccf-almacen-web/src/__tests__/pos-vender.test.tsx monta pages/pos.tsx completo y sustituye solo la frontera HTTP (api/pos, api/empresa) y los avisos (sonner). Se prueba lo que el cajero ve y hace, no la implementación: los textos, los botones, los diálogos y los cuerpos que viajan al API.

BloqueQué fija
CargaSin bodegas de POS el estado vacío explica qué habilitar; bodega, productos y venta abierta del cajero; aviso de caja cerrada con «Nueva venta» deshabilitado; errores de caja y de búsqueda sin romper la pantalla; Refrescar recarga bodegas, productos y caja sin perder el carrito
Búsqueda y carritoAgregar desde la lista y total con IVA; Enter con el SKU escaneado; filtro «Ver productos con stock»; vista previa y ficha del producto; producto sin stock (botón deshabilitado) o sin precio (aviso); servicios con una tarifa, con varias (diálogo) o por kilo (cantidad decimal); lote y número de serie (diálogo, sin existencias bloquea); tope de stock al subir y al escribir; descuento sobre la base del impuesto; quitar línea y limpiar
Pagos y cobroCobro exacto y denominaciones con cambio; faltante que bloquea Pagar; venta a crédito (exige cliente, limpia pagos y muestra el saldo); correo y observaciones en el cuerpo del cobro; fuera de horario pide confirmación y reintenta; comprobante con tirilla/factura, descarga, envío por correo y anulación con motivo; autocompletado del cliente por documento
CajaApertura con base inicial y su insignia; el arqueo no se puede cerrar con ventas abiertas y lista cuáles; cierre con efectivo contado, observaciones y diferencia
Ventas simultáneasCada pestaña con su estado y su resumen; cambiar de venta sin mezclar carritos; nueva venta por botón y por Alt+N; límite configurado (2 / 2); descarte con motivo (mínimo 5 caracteres) que libera el cupo; atajos Alt+←/→ y Alt+1..9
Últimas ventas«Ver» abre el comprobante consultado; la impresión pide la tirilla 80 mm sin volver a cobrar; estado vacío

2. Lecciones que la suite deja fijadas​

  • Los atajos de la multiventa exigen Alt. El manejador de pages/pos.tsx sale antes de mirar la tecla si falta Alt, así que Alt+1..9 salta de pestaña pero 1 no. La prueba lo deja escrito para que el comportamiento no cambie por accidente.
  • Sin caja no hay venta ni cobro. La regla se anuncia en la pantalla (aviso + title) y la suite comprueba el botón deshabilitado, no solo el error del API.
  • El tope de cantidad avisa. Superar el stock libre (descontando las demás líneas) muestra «Solo hay N…» en vez de recortar en silencio; escribir a mano también se recorta al confirmar.
  • Servicios y productos se validan distinto. Los servicios no llevan stock ni lote/serie y sus importes no llevan IVA; ambos rechazan entrar al carrito si no tienen precio.
  • URL.createObjectURL no existe en jsdom. La suite lo define (con revokeObjectURL) y espía window.open para comprobar la impresión del comprobante.
  • Nombres repetidos. El nombre del producto aparece en la lista, la vista previa, el carrito y los diálogos: las aserciones se acotan con within(...) o con prefijos (/^Jeringa 5 ml/).

3. Hallazgo corregido: las fórmulas del POS tenían dos copias​

La prueba pos-funciones-puras.test.ts redeclaraba redondear, esCorreoValido, mensajeError y las fórmulas de subtotal, impuesto, total, pagos y cambio para comprobarlas. Era una prueba de las copias, no del código: un cambio en pages/pos.tsx no la hacía fallar.

Ahora esas funciones viven en ccf-almacen-web/src/utils/pos-totales.ts y las usan ambos: la pantalla (subtotal, descuento, impuestos, total, pagos, cambio, faltante y saldo a crédito) y la suite, que pasó de 20 a 34 casos al probar el módulo real (incluye moneda, calcularDescuentoTotal y el impuesto sobre la base descontada). El comportamiento es el mismo: las fórmulas se movieron literalmente, no se reescribieron.

4. Hallazgo corregido: la suite completa era intermitente​

En una ejecución con la máquina cargada, productos-catalogo.test.tsx falló en 20 casos con «Unable to find role="menu"». Ejecutado solo pasaba 43/43, y con la suite completa volvía a fallar de forma intermitente: no era un defecto del catálogo, sino el segundo de espera que Testing Library aplica por defecto a un findBy* bajo la carga de 170 archivos en paralelo.

jest.setup.ts fija ahora configure({ asyncUtilTimeout: 4000 }). El margen no cambia el resultado de las pruebas rápidas y queda lejos del testTimeout de 20 s por caso.

5. Verificación​

cd ccf-almacen-web
npx jest src/__tests__/pos-vender.test.tsx src/__tests__/pos-funciones-puras.test.ts
# Tests: 88 passed, 88 total

npx jest # suite completa
# Test Suites: 170 passed, 170 total
# Tests: 1569 passed, 1569 total

npx tsc --noEmit, npx eslint de los archivos tocados y npm run build quedan limpios. npm run build cierra con la comprobación de REQ-SEC-17 en verde.

Archivos clave​

  • ccf-almacen-web/src/__tests__/pos-vender.test.tsx — suite de pantalla de «Vender».
  • ccf-almacen-web/src/utils/pos-totales.ts — cálculos, formato y mensajes reales del POS.
  • ccf-almacen-web/src/__tests__/pos-funciones-puras.test.ts — prueba el módulo anterior.
  • ccf-almacen-web/src/pages/pos.tsx — importa los cálculos (sin cambio de comportamiento).
  • ccf-almacen-web/jest.setup.ts — margen de espera de findBy* bajo carga.
  • ccf-almacen-wiki/docs/desarrollo/pruebas-frontend-web.md — inventario de suites del frontend.