0061. Imagen global de usuario¶
Estado: Aceptado
Fecha: 2026-11-06
Módulo(s) afectado(s): app/domains/usuarios/, alembic/versions/, tests/
Contexto¶
El usuario es global en la plataforma y no pertenece a una empresa única. Se necesita persistir una imagen de usuario sin mezclar la metadata con el servicio que administra objetos y URLs temporales.
Decisión¶
Se crea identidad.mae_usuarios_img con los metadatos del archivo y su
object_key interno para S3/R2. La tabla no lleva empresa_id. Cada imagen
referencia a su usuario mediante usuario_id y el usuario conserva imagen_id
como referencia a la imagen activa. La relación inversa usa una FK compuesta
(mae_usuarios.id, mae_usuarios.imagen_id) hacia
(mae_usuarios_img.usuario_id, mae_usuarios_img.id), para impedir que un
usuario seleccione la imagen de otro usuario. imagen_id permanece nullable.
La migración resuelve el ciclo de claves foráneas en tres pasos: crea la tabla
con la FK a mae_usuarios, agrega imagen_id nullable a mae_usuarios y crea
la FK inversa al final. El índice único parcial sobre usuario_id y
deleted_at IS NULL permite conservar historial lógico y una sola imagen
vigente por usuario. La condición de que la imagen elegida esté activa
(is_activo = true y deleted_at IS NULL) se valida transaccionalmente en el
servicio; una FK no puede garantizar una condición parcial sobre la fila
referenciada.
No se generan URLs prefirmadas ni se implementa integración con
core-svc-documentos en este cambio.
Consecuencias¶
- Identidad puede leer y relacionar los metadatos de la imagen sin almacenar una URL temporal.
- El servicio de documentos seguirá siendo responsable del objeto y de las URLs prefirmadas.
- La FK compuesta mantiene coherentes
imagen_idy elusuario_idde la fila elegida a nivel de base de datos. - El servicio debe validar transaccionalmente
is_activoydeleted_atantes de asignar la imagen, porque esa condición parcial no pertenece a una FK.