Saltar al contenido principal

Refactor — se elimina el N+1 en la cobertura de bodegas

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

Refactor interno del endpoint GET /api/solicitudes/:id/almacenes-disponibles. Sin cambios de comportamiento ni de contrato.


🐌 El problema​

Al calcular qué bodega puede cubrir una solicitud, se consultaba el stock una vez por cada combinación bodega × línea:

for (const almacen of almacenes) {
for (const detalle of detalles) {
const stock = await this.stockAlmacenRepository.findOne({ ... }); // ← N+1
}
}

Con 3 bodegas y 2 líneas son 6 consultas; el coste crece multiplicando, justo cuando más bodegas existen (que es el escenario de INV-002).


⚡ La solución​

Una única consulta con los productos implicados, indexada en memoria por (producto, almacén) — el mismo patrón que ya usa el motor de despacho multicriterio de la Fase 3:

const stocks = await this.stockAlmacenRepository.find({
where: idsProductos.map((idProducto) => ({ idProducto })),
});

const stockPorClave = new Map<string, number>();
for (const stock of stocks) {
stockPorClave.set(`${stock.idProducto}-${stock.idAlmacen}`, stock.stockActual);
}

De 6 consultas a 1 en el ejemplo, y de O(bodegas × líneas) a O(1) consultas.


🛡️ Cómo se garantizó que no cambia nada​

Por tratarse de un refactor, se siguió este orden:

  1. Primero las pruebas, escritas contra el código anterior: 9 pruebas que fijan el contrato (los campos totalDetalles/detallesCubiertos/cubre, el orden por cobertura, el uso de cantidadAprobada, las líneas ya entregadas, el filtro de bodegas activas). Todas pasaron contra la versión vieja.
  2. Luego el refactor.
  3. Las mismas 9 pruebas, sin tocar una línea, siguen pasando → no hay regresión.

Después se añadieron 3 pruebas más que fijan el refactor en sí (que la consulta sea una sola y que solo se pidan los productos pendientes).


⚠️ Dos trampas que el refactor tuvo que resolver​

  1. where: [] con arreglo vacío. Si ninguna línea necesitara stock (todo ya entregado), construir el where con una lista vacía podría traer todo el stock o fallar. Se añadió la guarda de no consultar cuando no hay productos pendientes, y una prueba que lo fija.
  2. Pedir solo lo necesario. Solo se consulta el stock de productos con líneas pendientes; las líneas ya cubiertas se resuelven sin tocar la base.

✅ Verificación​

MétricaValor
Suites4
Pruebas61 (todas pasan)
npm run build0
npm run lint0

Archivo afectado: src/domains/solicitudes/solicitudes.service.ts (método getAlmacenesDisponibles). Pruebas: src/domains/solicitudes/solicitudes.service.spec.ts.