INV-004 — Reporte de vencimientos unificado con lotes (stock vigente)
· 2 min de lectura
Refinamiento P2 de INV-004: el reporte de productos próximos a vencer estaba construido sobre
movimientos_inventario.stockFechaVencimiento y mostraba stockDespues (el stock de ese momento, no el
vigente). Ahora se unifica con los lotes (INV-003) y se muestra el stock vigente.
🔧 Cambios
Fuente unificada (ReportesService.getProductosProximosAVencer)
El reporte combina dos fuentes y ordena por fecha de vencimiento (FEFO):
- Lotes con stock vigente —
lotes.activo = true,cantidadDisponible > 0yfechaVencimientodentro de la ventana. El stock mostrado escantidadDisponibledel lote y se incluye elcodigoLote. - Movimientos sin lote — entradas de productos sin control de lote (
movimiento.idLote IS NULL) con vencimiento en la ventana. El stock mostrado es el stock vigente total del producto (SUM(stock_almacen)).
Se excluyen los ítems sin stock vigente.
Rendimiento
- El resultado sigue cacheado (TTL 60 s); la clave de caché se versionó a
…:v2. - El conjunto es acotado (solo lo que vence en la ventana), por lo que la paginación se resuelve en memoria
sobre el conjunto ya filtrado; se mantienen
page/limity los filtros (diasAnticipacion,idProducto,idCategoria,search).
Frontend
ProductoProximoAVencerahora incluyeidLote/codigoLote(opcionales).- La tabla del reporte añade la columna Lote.
✅ Alertas unificadas (mismo origen que el reporte)
AlertaVencimientoService (cron diario + WebSocket) ya no consulta movimientos por su cuenta:
ahora reutiliza ReportesService.getProductosProximosAVencer(), por lo que alertas y reporte comparten
la misma fuente (lotes con stock vigente + movimientos sin lote) y no pueden divergir.
- El evento WebSocket (
AlertaVencimientoEvent) incluyecodigoLoteystockActualopcionales. - El mensaje indica el lote cuando aplica:
Producto X (SKU: Y) — Lote L vence el … (N días restantes). AlertasModuleimportaReportesModule; ya no registra la entidadMovimientoInventario.
🧪 Verificación
- Backend
npm run build: OK. - Backend
npm test: 118 pruebas (13 suites) ✅.- Cobertura INV-004 añadida: filtros + paginación del reporte, caché con TTL 60 s y cache hit, configuración de umbrales (global y por usuario), registro de la fecha de vencimiento en entradas, y emisión de alertas (umbral global broadcast + por usuario persistido).
- Frontend
tsc --noEmit+ ESLint: limpios.
