Saltar al contenido principal

INV-004 — FEFO en despachos (cierre RF-INV-004-01)

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

Resultado de la validación de INV-004 (Fechas de Vencimiento) y de las correcciones aplicadas. El registro de vencimientos, el reporte de próximos a vencer, la vista del dashboard, la configuración de umbrales y el caché/WebSockets ya existían; lo único que faltaba era aplicar FEFO en los despachos.


📋 Estado por requerimiento​

RFAntesAhora
RF-INV-004-01 (registrar vencimiento + FEFO en despachos)⚠️ registro ✅ / FEFO ❌✅ (FEFO aplicado)
RF-INV-004-02 (endpoint próximos a vencer)✅✅
RF-INV-004-03 (vista dashboard + alerta)✅✅
RF-INV-004-04 (umbrales configurables)✅✅
RF-INV-004-05 (caché + paginación + WebSockets)✅✅

🔧 Cambios​

1. FEFO en el despacho (RF-INV-004-01)​

En MovimientosInventarioService.aplicarTrazabilidad() (rama de salida con lote) se añaden tres reglas, todas dentro de la transacción:

  1. El lote debe pertenecer al producto del movimiento (cierra un hueco de INV-003).
  2. No se despacha un lote vencido → 400 con la fecha de vencimiento.
  3. FEFO: si existe otro lote del mismo producto que vence antes y tiene stock suficiente para cubrir la cantidad, se rechaza el despacho → 409 indicando el lote que debe salir primero.

Archivo: src/domains/movimientos-inventario/movimientos-inventario.service.ts.

2. Orden FEFO en el catálogo de lotes (P1)​

LotesSeriesService.listarLotes() ahora ordena por fechaVencimiento ASC (en PostgreSQL los NULL quedan al final), de modo que el selector de lote del despacho sugiere primero el que vence antes.

3. Endpoint de verificación manual de alertas (P1)​

POST /api/alertas/verificar (Administrador, Almacenista) ejecuta verificarVencimientosProximos() y devuelve { alertasEmitidas }, útil para pruebas y disparos fuera del cron diario.

4. UX del despacho (frontend)​

El selector de lote muestra la fecha de vencimiento de cada lote y resalta con ★ FEFO el primero con stock (el próximo a vencer).


🧪 Verificación​

  • Backend npm run build: OK.
  • Backend npm test: 106 pruebas (10 suites) ✅ — nuevas: FEFO (rechaza lote no-FEFO), despacho de lote vencido y orden FEFO de listarLotes.
  • ESLint backend y tsc --noEmit + ESLint frontend: limpios.