INV-002 — Consulta de inventario por almacén (cierre RF-INV-002-05)
· 2 min de lectura
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
| RF | Estado previo | Estado 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étodo | Ruta | Descripción |
|---|---|---|
GET | /api/almacenes/:id/inventario | Inventario 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 (404si no) y devuelve{ idAlmacen, nombre, totalProductos, totalUnidades, productos[] }, donde cada producto incluyesku,nombreProducto,unidadMedida,categoria,stockActual,stockMinimoyenAlerta.
Filtro por almacén en el reporte de inventario
ReporteFiltrosDto: nuevo campoidAlmacen.ReportesService.getInventarioActualReporte(): al recibiridAlmacen, haceinnerJoinconstock_almacende esa bodega y expone el stock de esa bodega (no el consolidado) enstockActual/stockMinimo.GET /api/reportes/inventario-actual?idAlmacen=1.
💻 Frontend (ccf-almacen-web)
models/almacen.entity.ts: tiposInventarioAlmaceneInventarioAlmacenProducto.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 buildsin errores;npm test→ 94 pruebas (8 suites) ✅; ESLint limpio. - Frontend:
npx tsc --noEmitsin 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:
| Suite | Casos añadidos | Qué protege |
|---|---|---|
almacenes.service.spec.ts | create (nombre duplicado → 409), remove (bloqueo con dependencias / borrado sin ellas), getResumen (totales), getInventario | Evita bodegas repetidas, borrados con inventario y totales incorrectos |
stock-almacen.service.spec.ts | sumarPorProducto (consolidado de todas las bodegas + caso vacío) | Evita que el stock consolidado se muestre mal |
reportes.service.spec.ts | getInventarioActualReporte con idAlmacen (stock de esa bodega) y sin filtro | Evita 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).
