Saltar al contenido principal

Veterinaria — PostgreSQL como única fuente y tarjetas con cuadrícula

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

Al abrir Clientes y mascotas desde el tablero de «SEAN Veterinaria» aparecía el aviso «Sin conexión con la base de la clínica». El módulo seguía arrastrando la etapa de conmutación de REQ-DAT-01: VETERINARIA_FUENTE tenía mongo como valor por defecto y el diagnóstico del API consultaba MongoDB (SEAN_MONGO_URI / SEAN_MONGO_DB). En un despliegue sin MongoDB —o con el API inalcanzable— el módulo se declaraba caído aunque todos los datos ya estaban en PostgreSQL.

Qué cambió​

Backend: una sola fuente, sin conmutación​

  • Se retiraron SeanMongoService, SeanMongoModule, el selector veterinaria-fuente.ts y las diez implementaciones MongoDB de los repositorios (*-mongo.repositorio.ts).
  • Cada token (CLIENTES_REPOSITORIO, MASCOTAS_REPOSITORIO, …) apunta ahora con useExisting a su adaptador de PostgreSQL (vete_*). No hay rama alternativa ni variable de entorno que decida la fuente.
  • GET /api/veterinaria/estado comprueba PostgreSQL (SELECT 1) y responde base: "ccf_almacen (vete_*)". Ya no se abre ninguna conexión a MongoDB al arrancar.
  • .env y .env.example dejan de declarar SEAN_MONGO_* y VETERINARIA_FUENTE.
  • Los identificadores públicos se conservan: el mongo_id heredado (24 hex) o el id entero de las filas nuevas, así que el contrato de la API y la app móvil no cambian.

Frontend: aviso honesto y tarjetas del panel​

  • El aviso de conexión explica que la clínica vive en PostgreSQL (ccf_almacen, vete_*) y qué revisar (DB_HOST, DB_PORT, DB_DATABASE, migraciones), en lugar de pedir variables de MongoDB. También se corrigió el texto del tour guiado.
  • Las tarjetas de estadísticas de los tableros de veterinaria (Veterinaria, Inventario y Cartera) adoptan el patrón «card + cuadrícula» del panel de Inicio (REQ-UX-02): degradado de tonos 700–900, marca de agua .card-grid-watermark, icono decorativo y jerarquía por tamaño y peso. Los tonos se eligieron para que el texto blanco cumpla contraste AA.

Verificación​

  • npx tsc --noEmit limpio en ccf-almacen-api y ccf-almacen-web.
  • Pruebas del módulo de veterinaria: 15 suites, 121 pruebas en verde (35 de integración omitidas por defecto, que requieren base).
  • Los archivos retirados quedaron respaldados en backups/veterinaria-sin-mongodb_2026-10-30_12-35-52/ (el repositorio no usa git).

Para tener en cuenta​

  • Si un despliegue tenía VETERINARIA_FUENTE=mongo, esa variable ahora no tiene efecto: el módulo siempre lee PostgreSQL. Retírala del entorno para evitar confusión.
  • La reversa del esquema (npm run db:veterinaria:revertir) sigue disponible, pero ya no existe una ruta de código que lea MongoDB desde el almacén.