Lotes y Series con trazabilidad completa
· 3 min de lectura
Se implementa el control de inventario por lotes y números de serie, con trazabilidad completa de cada movimiento de entrada y salida — requisito clave para el sector salud y farmacéutico.
Qué se entrega
- Tabla
lotes: agrupa unidades del mismo lote con código, fechas de ingreso/vencimiento, cantidad inicial/disponible, precio de compra y referencia del proveedor. - Tabla
series: número de serie único por unidad, asociado a un lote y a un producto, con estado (disponible,vendida,devuelta,danada,vencida). - Trazabilidad de movimientos: las entradas/salidas de inventario se vinculan a un lote y/o número de serie (
movimientos_inventario.id_lote,movimientos_inventario.id_serie), preservando el historial (FKON DELETE SET NULL). - Flags en productos:
requiere_loteyrequiere_numero_seriemarcan los productos que necesitan trazabilidad; el backend valida que las entradas/salidas incluyan la trazabilidad exigida. - Contabilidad automática: al registrar una entrada con lote, se incrementa la cantidad disponible del lote; al registrar una salida, se decrementa (con validación de stock suficiente); para productos serializados se marca la serie como consumida.
- Gestión desde el menú: pantalla Lotes y Series con CRUD de lotes y series, incluyendo filtrado por producto y series asociadas a un lote.
- Formularios de producto: checkboxes para activar el control por lote y/o número de serie.
Tabla de cambios
| Área | Cambio | Archivo / ruta |
|---|---|---|
| Base de datos | migración 006 (tablas lotes, series) | ccf-almacen-api/database/migrations/ |
| Base de datos | migración 007 (flags productos + FK movimientos) | ccf-almacen-api/database/migrations/ |
| Backend | dominio lotes (entidades, DTOs, servicio, controladores) | src/domains/lotes/ |
| Backend | relación lote/serie en movimientos y producto | movimientos-inventario.*, producto.entity.ts |
| Frontend | modelos lote, serie + flags en Producto/Movimiento | src/models/ |
| Frontend | cliente API lotes/series | src/api/lote.ts |
| Frontend | pantalla de gestión jerárquica | src/components/lotes/lotes-management.tsx |
| Frontend | toggles de trazabilidad en formulario de producto | src/components/products/product-form.tsx |
| Frontend | ítem de menú Lotes y Series | src/components/layouts/sidebar/sidebar-option.ts |
| Wiki | manual de usuario y esta nota de cambio | docs/manuales/inventarios/lotes-series.md |
Uso esperado
- Para productos que requieren lote: registrar la entrada indicando el lote; las salidas consumen de la cantidad disponible del lote y quedan trazadas.
- Para productos serializados: registrar la entrada con los números de serie (uno por unidad); las salidas consumen unidad a unidad asociando el número de serie al movimiento de salida.
- Para productos sin trazabilidad: el flujo de inventario funciona como hasta hoy, sin interrupciones.
Próximos pasos
- Integrar selectores de lote/serie en los formularios de cargar stock (entrada) y despacho (salida) para registrar la trazabilidad directamente al crear movimientos.
- Reporte de trazabilidad: ruta de un lote/serie desde su entrada hasta su última salida.
Co-authored-by: CommandCodeBot <noreply@commandcode.ai>