Saltar al contenido principal

INV-003 — Trazabilidad de lotes y series (cierre RF-INV-003-04 + integridad transaccional)

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

Resultado de la validación de INV-003 (Lotes y Series) y de las correcciones aplicadas. Antes de esta entrega, la implementación cubría el registro y la exigencia de lote/serie, pero no la consulta del historial (RF-INV-003-04) y arrastraba un bug de integridad en la contabilidad de trazabilidad.


📋 Estado por requerimiento​

RFAntesAhora
RF-INV-003-01 (registrar lote/serie)✅✅
RF-INV-003-02 (trazabilidad completa)⚠️ bug transaccional✅ (fix de atomicidad)
RF-INV-003-03 (exigir en recepción y despacho)✅✅
RF-INV-003-04 (historial por lote/serie)❌✅
RF-INV-003-05 (salud/farmacéutico)⚠️ parcial⚠️ parcial (pendiente FEFO/INVIMA)

🔧 Cambios​

1. Fix P0 — atomicidad de la trazabilidad (RF-INV-003-02)​

MovimientosInventarioService.aplicarTrazabilidad() operaba con los repositorios globales (this.loteRepository / this.serieRepository) dentro de dataSource.transaction(...). Eso rompía la atomicidad: si la transacción revertía, los cambios de lote/serie quedaban persistidos, dejando el inventario descuadrado.

Ahora la contabilidad de lote/serie se ejecuta con el EntityManager de la transacción, por lo que movimiento + stock + lote/serie se confirman o revierten juntos.

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

Además, findOne(id) de un movimiento ahora carga las relaciones lote y serie (antes solo lo hacía findAll), para que el detalle conserve la trazabilidad.

2. Migración del esquema INV-003 (P0)​

No existía migración para el esquema de trazabilidad. Se agregó 007-create-lotes-series.ts (idempotente):

  • productos.requiere_lote, productos.requiere_numero_serie.
  • Tablas lotes y series (con FKs RESTRICT/SET NULL e índices).
  • movimientos_inventario.id_lote, movimientos_inventario.id_serie.

Esto permite un deploy limpio con synchronize:false.

3. Historial de movimientos por lote y serie (RF-INV-003-04)​

Nuevos endpoints (roles Administrador, Almacenista, Auxiliar inventario; 404 si el lote/serie no existe):

MétodoRutaDescripción
GET/api/lotes/:id/movimientosMovimientos de un lote (más recientes primero)
GET/api/series/:id/movimientosMovimientos de un número de serie

Archivos: lotes-series.service.ts, lotes.controller.ts, series.controller.ts.


🧪 Verificación​

  • Backend npm run build: sin errores.
  • Backend npm test: 103 pruebas (10 suites) ✅.
    • Nuevas suites: movimientos-inventario.service.spec.ts (atomicidad + RF-003-03) y lotes-series.service.spec.ts (alta con series + historial RF-003-04).
  • ESLint: limpio.
  • Migración 007 ejecutada correctamente.

⚠️ Pendiente (RF-INV-003-05)​

Para el dominio salud/farmacéutico aún falta: FEFO, bloqueo/alertas de vencimiento por lote, registro sanitario/INVIMA y trazabilidad hacia el destino.