Saltar al contenido principal

REQ-DAT-01 Migración del dominio veterinario a PostgreSQL (Fase A y marco web)

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

El dominio de la clínica veterinaria «sean-pets» (pacientes, clientes, historia clínica, agenda, cartera, farmacia y configuración) pasa de MongoDB a PostgreSQL, en la base ccf_almacen, con el prefijo vete_. Esta primera fase deja los datos migrados y verificados; la conmutación del código de las aplicaciones es la Fase B.

Qué cambió​

  • 37 tablas nuevas vete_* (30 de entidad + 6 puente + vete_contadores) y veterinaria_envios_documento renombrada a vete_envios_documento (38 en total).
  • Cada tabla conserva el _id de MongoDB en mongo_id y usa id_<entidad> como clave primaria.
  • Las referencias son claves foráneas (85 en total) y los arrays de referencias se normalizaron en tablas puente.
  • Los subdocumentos clínicos (checklist, triaje, monitoreo, evolución) se conservan como jsonb documentado; los catálogos del código se replicaron como CHECK.
  • 189 índices y únicos parciales (una sola lista de precios activa, turnos reservados únicos por médico/fecha/hora, código de referido único).

Por qué​

El dominio vivía en un esquema implícito, sin integridad referencial ni auditoría de estructura, y obligaba a mantener dos sistemas. PostgreSQL aporta claves foráneas, restricciones, índices y evidencia reproducible. MongoDB queda para lo que no es dominio transaccional: ideas, novedades y mejoras.

Verificación​

La migración se ejecutó y verificó con 299/299 documentos convertidos en filas, comparación campo a campo, huella SHA-256 por entidad y 0 claves foráneas huérfanas.

La auditoría del origen encontró 31 referencias huérfanas (documentos eliminados): la fila de negocio se conserva y la referencia se migra como NULL, quedando reportada. También se corrigió que evidencias.medicoId apunta a vete_medicos (el modelo lo declaraba contra Usuario, pero los datos usan el _id de Medico).

Seguridad de la operación​

  • Respaldo previo: dump de PostgreSQL + dump completo de MongoDB + conteos + manifiesto con SHA-256.
  • Reversa: script que elimina el esquema y desregistra las migraciones sin tocar MongoDB, más la restauración completa desde el respaldo.
  • Evidencia SQL regenerada (148 tablas) con datos anonimizados; el generador aborta si detecta datos personales residuales.

Archivos clave​

  • ccf-almacen-api/database/migracion-veterinaria/esquema.js — especificación única.
  • ccf-almacen-api/src/database/migrations/052-crear-esquema-veterinaria.ts.
  • ccf-almacen-api/src/domains/veterinaria/entities/vete/* — entidades TypeORM.
  • ccf-almacen-framework/DATOS/VETERINARIA/* — inventario, mapeo, runbook y plan de Fase B.
  • ccf-almacen-wiki/docs/manuales/veterinaria/migracion-a-postgresql.md — runbook operativo.

Estado de la Fase B​

El marco web de almacén (ccf-almacen-api, módulo veterinaria) ya tiene sus diez servicios leyendo y escribiendo PostgreSQL: calificaciones/NPS, mascotas, clientes, catálogo, agenda, inventario, cartera, personal, documentos y resumen del tablero. El patrón es un puerto con dos adaptadores (Mongo y PostgreSQL) y una fábrica que decide según VETERINARIA_FUENTE (mongo por defecto). La cobertura es de 96 pruebas de la capa de datos (61 unitarias + 35 de integración) y 118 pruebas del módulo en verde.

Pendiente: conmutar sean-api (Express + Mongoose) conservando sus endpoints, y sin purgar MongoDB por ahora.