INV-004 — FEFO en despachos (cierre RF-INV-004-01)
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
| RF | Antes | Ahora |
|---|---|---|
| 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:
- El lote debe pertenecer al producto del movimiento (cierra un hueco de INV-003).
- No se despacha un lote vencido →
400con la fecha de vencimiento. - FEFO: si existe otro lote del mismo producto que vence antes y tiene stock suficiente para cubrir
la cantidad, se rechaza el despacho →
409indicando 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 delistarLotes. - ESLint backend y
tsc --noEmit+ ESLint frontend: limpios.
