Saltar al contenido principal

INV-004 — Reporte de vencimientos unificado con lotes (stock vigente)

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

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):

  1. Lotes con stock vigente — lotes.activo = true, cantidadDisponible > 0 y fechaVencimiento dentro de la ventana. El stock mostrado es cantidadDisponible del lote y se incluye el codigoLote.
  2. 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/limit y los filtros (diasAnticipacion, idProducto, idCategoria, search).

Frontend​

  • ProductoProximoAVencer ahora incluye idLote/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) incluye codigoLote y stockActual opcionales.
  • El mensaje indica el lote cuando aplica: Producto X (SKU: Y) — Lote L vence el … (N días restantes).
  • AlertasModule importa ReportesModule; ya no registra la entidad MovimientoInventario.

🧪 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.