REQ-DAT-01 Migración del dominio veterinario a PostgreSQL (Fase A y marco web)
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) yveterinaria_envios_documentorenombrada avete_envios_documento(38 en total). - Cada tabla conserva el
_idde MongoDB enmongo_idy usaid_<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
jsonbdocumentado; los catálogos del código se replicaron comoCHECK. - 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.