«Vender» (POS) — 54 pruebas de pantalla y un solo juego de fórmulas
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.
| Bloque | Qué fija |
|---|---|
| Carga | Sin 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 carrito | Agregar 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 cobro | Cobro 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 |
| Caja | Apertura 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áneas | Cada 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 depages/pos.tsxsale antes de mirar la tecla si faltaAlt, así queAlt+1..9salta de pestaña pero1no. 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.createObjectURLno existe en jsdom. La suite lo define (conrevokeObjectURL) y espíawindow.openpara 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 defindBy*bajo carga.ccf-almacen-wiki/docs/desarrollo/pruebas-frontend-web.md— inventario de suites del frontend.