Saltar al contenido principal

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​

ConceptoAntes (clínica)Antes (almacén)
Productovete_productosproductos + categorias + presentaciones
Stockcolumna stock en el productostock_almacen por producto y bodega
Lote / vencimientoen la fila del productotabla lotes (1 producto, N lotes)
Kardexvete_movimientos_inventariomovimientos_inventario (con bodega y lote)
Stock negativopermitidobloqueado

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 Veterinaria y Tienda Veterinaria, marcados con almacenes.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 en stock_almacen que reemplaza al CHECK (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_productos y vete_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 a productos.
  • 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/lotes acepta idAlmacen y estado (vencido / por_vencer, con dias), para resolver el semáforo de vencimiento de una página completa en una consulta.
  • PATCH /api/productos/:id/stock admite stockMinimo (el umbral es de la bodega, no del producto).
  • Roles: Veterinario y Auxiliar veterinaria pueden 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 sobre productos, stock_almacen, lotes y movimientos_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 productos y movimientos-inventario apuntan a la vista y a la tabla unificadas. Los controladores aceptan los identificadores enteros del catálogo (y siguen aceptando los _id de 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, 059 y 060 aplicadas sobre ccf_almacen con 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); tsc limpio 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.