Saltar a contenido

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_id y el usuario_id de la fila elegida a nivel de base de datos.
  • El servicio debe validar transaccionalmente is_activo y deleted_at antes de asignar la imagen, porque esa condición parcial no pertenece a una FK.