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)
| Archivo | Cambio |
|---|---|
src/domains/usuarios/entities/avatar-usuario.entity.ts | Nuevo. 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.ts | Reescrito. 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.ts | Quita RetroalimentacionModule de imports y registra AvatarUsuario en TypeOrmModule.forFeature. |
src/database/migrations/1792730422549-CreateAvataresUsuarios.ts | Nueva migración (ejecutada): crea avatares_usuarios + índice idx_avatares_usuarios_usuario. Reversible (DROP TABLE). |
src/domains/usuarios/avatar-usuario.service.spec.ts | 8 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)
| Archivo | Cambio |
|---|---|
src/components/general-dashboard/profile.tsx | Rediseñ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.nexta medias (truca conocida del armazón) y quedó verde trasRemove-Item -Recurse .next.- Pendiente de validar contra la instancia real: subir un avatar por la UI y
confirmar que
GET /api/usuarios/avatar/:idsirve la imagen servida desde PostgreSQL (antes dependía de Atlas).
Archivos clave
ccf-almacen-api/src/domains/usuarios/entities/avatar-usuario.entity.tsccf-almacen-api/src/domains/usuarios/avatar-usuario.service.tsccf-almacen-api/src/domains/usuarios/usuarios.module.tsccf-almacen-api/src/database/migrations/1792730422549-CreateAvataresUsuarios.tsccf-almacen-web/src/components/general-dashboard/profile.tsx