INV-003 — Trazabilidad de lotes y series (cierre RF-INV-003-04 + integridad transaccional)
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
| RF | Antes | Ahora |
|---|---|---|
| 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
lotesyseries(con FKsRESTRICT/SET NULLe í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étodo | Ruta | Descripción |
|---|---|---|
| GET | /api/lotes/:id/movimientos | Movimientos de un lote (más recientes primero) |
| GET | /api/series/:id/movimientos | Movimientos 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) ylotes-series.service.spec.ts(alta con series + historial RF-003-04).
- Nuevas suites:
- ESLint: limpio.
- Migración
007ejecutada 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.
