Refactor — se elimina el N+1 en la cobertura de bodegas
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:
- 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 decantidadAprobada, las líneas ya entregadas, el filtro de bodegas activas). Todas pasaron contra la versión vieja. - Luego el refactor.
- 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
where: []con arreglo vacío. Si ninguna línea necesitara stock (todo ya entregado), construir elwherecon 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.- 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étrica | Valor |
|---|---|
| Suites | 4 |
| Pruebas | 61 (todas pasan) |
npm run build | 0 |
npm run lint | 0 |
Archivo afectado: src/domains/solicitudes/solicitudes.service.ts (método getAlmacenesDisponibles).
Pruebas: src/domains/solicitudes/solicitudes.service.spec.ts.
