Inventario veterinario unificado con el modelo de almacén
El panel Inventario de farmacia y tienda y toda su funcionalidad vivían sobre un modelo
de datos propio (vete_productos + vete_movimientos_inventario), en paralelo al del
almacén (productos + stock_almacen + movimientos_inventario + lotes). Eran dos
catálogos y dos libros mayores para el mismo tipo de activo. Este cambio los une: la
clínica pasa a ser consumidora del modelo de productos e inventarios del almacén.
El problema en concreto
| Concepto | Antes (clínica) | Antes (almacén) |
|---|---|---|
| Producto | vete_productos | productos + categorias + presentaciones |
| Stock | columna stock en el producto | stock_almacen por producto y bodega |
| Lote / vencimiento | en la fila del producto | tabla lotes (1 producto, N lotes) |
| Kardex | vete_movimientos_inventario | movimientos_inventario (con bodega y lote) |
| Stock negativo | permitido | bloqueado |
Consecuencias: un mismo medicamento podía existir dos veces con existencias distintas, el lote obligaba a duplicar el producto por cada compra, y el valor del inventario no era comparable entre el almacén y la clínica.
Qué cambió
Base de datos
- Almacenes de la clínica:
Farmacia VeterinariayTienda Veterinaria, marcados conalmacenes.es_veterinaria. Delimitan el inventario de la clínica sin duplicar productos: un producto es uno solo y su stock vive por bodega. - Stock negativo por almacén:
almacenes.permitir_stock_negativo. Los dos almacenes de la clínica lo tienen activo (una atención no se bloquea por falta de existencias); el resto del almacén sigue estricto, ahora con un trigger enstock_almacenque reemplaza alCHECK (stock_actual >= 0). - Catálogos compartidos: las categorías veterinarias (Vacuna, Medicamento, Desparasitante, Alimento, Accesorio, Otro — y Aseo, que ya existía) y las presentaciones que faltaban (DOSIS, TABLETA, CAPSULA, FRASCO, SOBRE, TUBO, POMO, MG, G, OTRO).
- Se retiran
vete_productosyvete_movimientos_inventario(estaban vacías: la migración de REQ-DAT-01 no trajo productos). Las referencias clínicas (vete_vacunas_aplicadas,vete_desparasitaciones_aplicadas) apuntan ahora aproductos. - Vista de compatibilidad
vete_productos: expone el contrato de lectura que usaba la app de la clínica (producto + stock de sus bodegas + lote más próximo) sobre las tablas únicas. Es solo de lectura.
API (ccf-almacen-api)
- El panel de inventario veterinario (
/api/veterinaria/inventario*) desaparece: el panel usa ahora la API del almacén (/api/productos,/api/movimientos-inventario,/api/lotes,/api/almacenes,/api/categorias,/api/presentaciones). - Nuevo
GET /api/productos/resumen-inventario?idAlmacen=con los KPIs de una bodega (conteos por semáforo, vencimientos y valor del inventario con el precio descifrado). GET /api/lotesaceptaidAlmacenyestado(vencido/por_vencer, condias), para resolver el semáforo de vencimiento de una página completa en una consulta.PATCH /api/productos/:id/stockadmitestockMinimo(el umbral es de la bodega, no del producto).- Roles:
VeterinarioyAuxiliar veterinariapueden registrar movimientos y leer lotes, pero solo en los almacenes de la clínica (403 en cualquier otra bodega). - El tablero de la clínica toma su tarjeta de inventario de los almacenes veterinarios.
App de la clínica (sean-api)
- Nuevo
src/db/inventario-pg.js: único punto de escritura del inventario, con SQL explícito sobreproductos,stock_almacen,lotesymovimientos_inventario. La entrada con lote crea el lote y alimenta sus existencias; la categoría decide la bodega (farmacia o tienda). - Los mapas de columnas
productosymovimientos-inventarioapuntan a la vista y a la tabla unificadas. Los controladores aceptan los identificadores enteros del catálogo (y siguen aceptando los_idde 24 hex históricos). revertirPorReferencia(anular una vacuna o desparasitación) ahora repone el stock por el mismo camino y atribuye el movimiento a quien anula.
Panel web
- Selector de Bodega (Farmacia / Tienda) y KPIs por bodega.
- Alta de producto con entrada con lote cuando hay stock inicial; el lote y el vencimiento se registran en las entradas.
- La baja inactiva el producto (conserva kardex y lotes).
Impacto
- Un solo catálogo y un solo kardex: el inventario de la clínica es una vista por bodega del inventario del almacén.
- El valor del inventario es comparable entre áreas y el reporte de vencimientos usa la tabla de lotes real.
- Sin cambio de contrato para la app móvil de la clínica: se conservan los campos y se aceptan los identificadores antiguos.
Verificación
- Migraciones
058,059y060aplicadas sobreccf_almacencon respaldo previo. - Flujo completo contra la API real: alta de producto → lote → entrada → resumen → salida que deja stock negativo en farmacia → rechazo de esa salida en el almacén general → 403 de un auxiliar veterinario fuera de su ámbito.
sean-api: humo de catálogo e inventario (prueba-catalogo-inventario-postgres.js) y consumo clínico con reverso (prueba-inventario-consumo-clinico.js) en verde.ccf-almacen-api: 1390 pruebas en verde (3 suites con fallos previos, ajenos a este cambio);tsclimpio en API y web.
Archivos clave
- API:
src/database/migrations/1780000000058-InventarioVeterinarioUnificado.ts,…0059-StockNegativoPorAlmacen.ts,…0060-VistaCompatibilidadProductosVeterinaria.ts,src/domains/productos/productos.service.ts(resumenInventario),src/domains/stock-almacen/stock-almacen.service.ts(admiteStockNegativo),src/domains/veterinaria/services/inventario-veterinaria.service.ts. - Web:
src/api/inventario-veterinaria.ts,src/components/veterinaria/veterinaria-inventario.tsx. - Clínica:
sean-api/src/db/inventario-pg.js,src/lib/inventario.js,src/controllers/inventario.controller.js. - Decisión: ADR-026 en
ccf-almacen-framework/ARCHITECTURE.md.