Saltar al contenido principal

INV-002 — Consulta de inventario por almacén (cierre RF-INV-002-05)

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

Cierre del hueco detectado en la validación de INV-002 (Almacenes Múltiples): el inventario ya se podía consultar de forma consolidada, pero faltaba el filtrado por almacén (RF-INV-002-05).


📋 Contexto​

RFEstado previoEstado ahora
RF-INV-002-01 (múltiples almacenes)✅✅
RF-INV-002-02 (stock por almacén)✅✅
RF-INV-002-03 (transferencias)✅✅
RF-INV-002-04 (estados + stock)✅✅
RF-INV-002-05 (consolidado / por almacén)⚠️ Parcial✅

Antes solo existían: el consolidado (productos.stockActual = SUM), el resumen agregado por bodega y el desglose por producto. No había un endpoint para listar el inventario de una bodega concreta.


🔧 Backend (ccf-almacen-api)​

Nuevo endpoint​

MétodoRutaDescripción
GET/api/almacenes/:id/inventarioInventario de la bodega: productos con su stock, mínimo y estado de alerta (RF-INV-002-05)
  • AlmacenesService.getInventario(id): valida que el almacén exista (404 si no) y devuelve { idAlmacen, nombre, totalProductos, totalUnidades, productos[] }, donde cada producto incluye sku, nombreProducto, unidadMedida, categoria, stockActual, stockMinimo y enAlerta.

Filtro por almacén en el reporte de inventario​

  • ReporteFiltrosDto: nuevo campo idAlmacen.
  • ReportesService.getInventarioActualReporte(): al recibir idAlmacen, hace innerJoin con stock_almacen de esa bodega y expone el stock de esa bodega (no el consolidado) en stockActual/stockMinimo.
  • GET /api/reportes/inventario-actual?idAlmacen=1.

💻 Frontend (ccf-almacen-web)​

  • models/almacen.entity.ts: tipos InventarioAlmacen e InventarioAlmacenProducto.
  • api/almacenes.ts: getInventarioAlmacen(id).
  • components/almacenes/resumen-almacen-card.tsx: además del resumen, muestra la lista de inventario de la bodega seleccionada (SKU, producto, categoría, stock, mínimo y estado Normal / En alerta).

📚 Documentación (ccf-almacen-wiki)​

  • Manual Gestionar Almacenes actualizado con la sección Consultar el inventario de una bodega.

🧪 Verificación​

  • Backend: npm run build sin errores; npm test → 94 pruebas (8 suites) ✅; ESLint limpio.
  • Frontend: npx tsc --noEmit sin errores; ESLint limpio.

Pruebas unitarias (cierre de cobertura INV-002)​

Se completaron los huecos de cobertura detectados, con pruebas esenciales (no granulares), orientadas a evitar problemas al usuario final:

SuiteCasos añadidosQué protege
almacenes.service.spec.tscreate (nombre duplicado → 409), remove (bloqueo con dependencias / borrado sin ellas), getResumen (totales), getInventarioEvita bodegas repetidas, borrados con inventario y totales incorrectos
stock-almacen.service.spec.tssumarPorProducto (consolidado de todas las bodegas + caso vacío)Evita que el stock consolidado se muestre mal
reportes.service.spec.tsgetInventarioActualReporte con idAlmacen (stock de esa bodega) y sin filtroEvita mostrar el stock de la bodega equivocada en el reporte

Cobertura por RF: RF-01 ✅, RF-02 ✅, RF-03 ✅, RF-04 ✅, RF-05 ✅ (por almacén + consolidado + reporte).