Saltar al contenido principal

Primeras pruebas unitarias del backend (INV-002)

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

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:

  1. Cálculo silencioso — si el resultado es un número y nadie lo revisa a ojo.
  2. Control de acceso — una regresión abre un hueco de seguridad.
  3. 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.
  • obtenerDisponible devuelve 0 sin crear la fila (a diferencia de obtenerOCrear).

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.
  • reemplazarAlmacenes valida 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 -cantidad al origen con movimiento salida; recibir aplica +cantidad al destino con movimiento entrada. 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 cantidadAprobada manda sobre cantidad.
  • 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étricaValor
Suites4
Pruebas61 (todas pasan)
Tiempo~33 s
npm run build0
npm run lint0

📌 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 getAlmacenesDisponibles quedó resuelto en un refactor posterior (ver su changelog).