Primeras pruebas unitarias del backend (INV-002)
Hasta ahora el backend no tenía ninguna prueba (*.spec.ts). Jest estaba configurado, pero no
existía un solo archivo. Se estrena la suite con 61 pruebas y un criterio explícito: cubrir donde
un fallo pasa desapercibido o cuesta caro.
🔧 Primero hubo que arreglar la configuración
El código usa imports absolutos como import { AppLoggerService } from 'src/helpers/logger/logger.service',
que TypeScript resuelve con baseUrl: "./". Jest no lee baseUrl, así que toda prueba que
importara esas entidades moría con:
Cannot find module 'src/domains/usuarios/dto/read-usuario.dto'
Se agregó el mapeo correspondiente a la configuración de Jest:
"moduleNameMapper": { "^src/(.*)$": "<rootDir>/$1" }
Sin esto, ninguna prueba podía ejecutarse: la suite entera era inviable, no es que faltara cobertura.
🎯 Criterio: nada de pruebas de relleno
No se prueban getters, DTOs ni el paso de datos por un map: eso no da solidez, solo infla la suite.
Se priorizó por riesgo real:
- Cálculo silencioso — si el resultado es un número y nadie lo revisa a ojo.
- Control de acceso — una regresión abre un hueco de seguridad.
- Integridad de datos — estados inválidos, signos de movimiento, bodega afectada.
📦 Las cuatro suites
stock-almacen.service.spec.ts — 11 pruebas (la invariante del inventario)
aplicarMovimiento es la única puerta por la que se modifica el stock, y su invariante es sagrada:
el inventario nunca puede quedar negativo.
- Suma en entradas y resta en salidas, devolviendo el antes y el después reales.
- El borde exacto: dejar el stock en cero se permite; intentar dejarlo en -1 se rechaza.
- Cuando rechaza, no persiste nada (lo crítico: que no se guarde un stock negativo).
- El mensaje de error incluye el disponible real.
- Una fila de stock inexistente cuenta como 0, así que cualquier salida se rechaza.
obtenerDisponibledevuelve 0 sin crear la fila (a diferencia deobtenerOCrear).
permisos-almacen.service.spec.ts — 11 pruebas (Fase 4)
Fija la regla de permisos por bodega, que es la regla de control de acceso del sistema:
- El Administrador siempre puede, y se comprueba que ni siquiera consulta la tabla de asignaciones (cortocircuito).
- Sin asignaciones = acceso total (la regla de compatibilidad que evita romper instalaciones).
- Con asignaciones: solo las bodegas asignadas.
- El 403 nombra la bodega y la acción.
reemplazarAlmacenesvalida antes de borrar: si se invirtiera el orden, un ID inválido podría dejar al usuario sin permisos (o peor, con acceso total al quedarse sin asignaciones).
transferencias.service.spec.ts — 14 pruebas (Fase 2 + 4)
- Transiciones inválidas: no cancelar una transferencia en tránsito (la mercancía ya salió), no recibir una pendiente, no reenviar una recibida. Y en todos los casos: el stock no se toca.
- Signo y bodega: enviar aplica
-cantidadal origen con movimientosalida; recibir aplica+cantidadal destino con movimientoentrada. Un error de signo aquí descuadra el inventario. - Permiso denegado ⇒ sin movimiento de stock.
- Validaciones de alta: origen igual a destino, producto repetido, stock insuficiente, almacén inactivo.
solicitudes.service.spec.ts — 25 pruebas (Fases 1 y 3)
Fija el motor multicriterio, incluida la fórmula de puntaje con valores concretos:
- Cobertura total → puntaje 85; con holgura 0,5 → 92,5; penalización por quedar bajo el mínimo → 80. Así, cambiar los pesos rompe una prueba en vez de alterar recomendaciones en silencio.
- Orden descendente por puntaje y marca de
esRecomendado. - El plan de reparto no baja del stock mínimo si otra bodega puede aportar.
- Reporte de faltante y cobertura global cuando el stock total no alcanza.
- Se ignoran las líneas ya entregadas y
cantidadAprobadamanda sobrecantidad. - Es de solo lectura: no persiste nada.
El mismo archivo cubre getAlmacenesDisponibles (Fase 1): el contrato de cobertura por bodega y, tras
el refactor, que el stock se lea en una sola consulta (sin N+1).
✅ Resultado
| Métrica | Valor |
|---|---|
| Suites | 4 |
| Pruebas | 61 (todas pasan) |
| Tiempo | ~33 s |
npm run build | 0 |
npm run lint | 0 |
📌 Pendiente
- La web no tiene infraestructura de pruebas (no hay script
test). Montarla es un cambio mayor; se decidió no hacerlo ahora porque el riesgo está concentrado en la lógica del backend. - El N+1 de
getAlmacenesDisponiblesquedó resuelto en un refactor posterior (ver su changelog).
