Saltar al contenido principal

Avatar de usuario en PostgreSQL — fuera de MongoDB

El guardado de la foto de perfil del usuario (REQ-UX-09) usaba MongoDB Atlas (colección avatares_usuarios) para almacenar las imágenes. Como el cluster Atlas ahora solo lo es para ideas, novedades y mejoras (REQ-FBK-01), el mecanismo de avatares quedó inoperante en entornos sin MONGODB_URI (o con Atlas pausado) y no tenía por qué seguir dependiendo de él: la imagen propia de un usuario es un dato transaccional del dominio de usuarios, no una novedad.

Cambios​

API (ccf-almacen-api)​

ArchivoCambio
src/domains/usuarios/entities/avatar-usuario.entity.tsNuevo. Entidad AvatarUsuario → tabla avatares_usuarios: id_avatar SERIAL PK, id_usuario INTEGER UNIQUE FK ON DELETE CASCADE, nombre_archivo, nombre_almacenado (único, con prefijo de timestamp), tipo_mime, tamano_archivo, datos BYTEA (la imagen en base), fecha_subida, fecha_actualizacion. Mismo patrón de binario-en-base que la firma electrónica (TEC-014, ADR-022) y el almacén de imágenes de veterinaria (vete_imagenes).
src/domains/usuarios/avatar-usuario.service.tsReescrito. guardarAvatar hace upsert por id_usuario en avatares_usuarios y luego actualiza usuarios.avatar con la ruta pública /api/usuarios/avatar/:id?v=<timestamp> (mismo contrato para el cliente: sin cambio). obtenerAvatar, eliminarAvatar y establecerPredefinido operan sobre la nueva tabla. Cero código de MongoDB (ya no importa MongoAlmacenService ni lanza ServiceUnavailableException por falta de Atlas).
src/domains/usuarios/usuarios.module.tsQuita RetroalimentacionModule de imports y registra AvatarUsuario en TypeOrmModule.forFeature.
src/database/migrations/1792730422549-CreateAvataresUsuarios.tsNueva migración (ejecutada): crea avatares_usuarios + índice idx_avatares_usuarios_usuario. Reversible (DROP TABLE).
src/domains/usuarios/avatar-usuario.service.spec.ts8 pruebas reescritas contra repositorios TypeORM mockeados (antes mockeaban la colección Mongo); todas en verde.

Los endpoints no cambiaron: POST/PATCH/DELETE /api/usuarios/me/avatar y GET /api/usuarios/avatar/:id (público, Cache-Control: max-age=31536000, immutable) mantienen el mismo contrato HTTP; solo cambió el respaldo.

Web (ccf-almacen-web)​

ArchivoCambio
src/components/general-dashboard/profile.tsxRediseño del panel «Mi Perfil» para que cabe en una sola pantalla sin scrolleo: (1) encabezado de perfil compacto a ancho completo; (2) una sola fila de 3 columnas en desktop (md:grid-cols-3) — izquierda: Foto de perfil + Contacto; centro: Detalles de cuenta + cambio de contraseña + Estado de la cuenta; derecha: Seguridad (2FA) a toda la altura. El contenedor usa flex-1 min-h-0 para repartir la altura disponible y las tarjetas flex-1 crecen para completar la fila; en mobile queda de una columna con scroll natural. Sin cambio en la lógica — solo layout y tipografía compacta (text-xs/11px en etiquetas).

Verificación​

  • npm run build (API): limpio. npm test avatar-usuario: 8/8 en verde.
  • Migración ejecutada contra ccf_almacen (PostgreSQL): tabla e índice creados; la base pasó de 55 a 56 migraciones aplicadas.
  • npm run build (web): 74/74 páginas generadas; la primera falló por un .next a medias (truca conocida del armazón) y quedó verde tras Remove-Item -Recurse .next.
  • Pendiente de validar contra la instancia real: subir un avatar por la UI y confirmar que GET /api/usuarios/avatar/:id sirve la imagen servida desde PostgreSQL (antes dependía de Atlas).

Archivos clave​

  • ccf-almacen-api/src/domains/usuarios/entities/avatar-usuario.entity.ts
  • ccf-almacen-api/src/domains/usuarios/avatar-usuario.service.ts
  • ccf-almacen-api/src/domains/usuarios/usuarios.module.ts
  • ccf-almacen-api/src/database/migrations/1792730422549-CreateAvataresUsuarios.ts
  • ccf-almacen-web/src/components/general-dashboard/profile.tsx