Saltar a contenido

0041. Perfil propio: editar mis datos

Estado: Aceptado Fecha: 2026-10-05 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/usuarios/, tests/unit/auth/, docs/adr/

Nota (ADR 0067): mae_personas_juridicas es hoy mae_personas_comerciales y la ruta /juridicas es /comerciales. Este ADR conserva los nombres de su fecha.

Contexto

El usuario no tiene forma de editar sus propios datos: sólo el admin puede, vía PUT /api/v1/usuarios/{usuario_id} (por path). Pero los datos del usuario viven en dos lugares —la cuenta (mae_usuarios) y su entidad (mae_personas o mae_personas_juridicas, patrón party del ADR 0025)— y el tipo lo define mae_entidades.tipo_entidad. Cada tipo tiene campos distintos: la persona natural tiene nombres, apellidos, fecha de nacimiento, género, teléfono, dirección; la jurídica, razón social, nombre comercial, país y ciudad.

El cambio de contraseña ya existe y ya es una cosa aparte (POST /api/v1/auth/cambiar-password, ADR 0035).

Decisión

Se agregan dos endpoints protegidos por JWT (get_current_user), bajo /api/v1/auth:

Endpoint Qué hace
GET /api/v1/auth/perfil Devuelve la cuenta + la entidad, con la forma según el tipo
PATCH /api/v1/auth/perfil Edita sólo los campos del tipo del usuario

Reglas:

  • La identidad sale del token: nadie edita a otro.
  • Persona natural edita nombres, apellidos, fecha_nacimiento, genero_id, telefono, direccion. Persona jurídica edita nombre, nombre_comercial, pais_id, ciudad_id.
  • Los campos del otro tipo se rechazan con 422.
  • identificacion y tipo_identificacion_id no son editables: los administra el admin.
  • email es el único campo compartido: se muestra uno solo, priorizando el de la entidad (mae_personas.email); al editarlo se sincroniza también mae_usuarios.email por fondo (el formulario no lo pide dos veces). En persona jurídica la entidad no tiene columna email, así que es el de la cuenta.
  • Se validan las referencias (genero_id, pais_id, ciudad_id deben existir y estar activas): una referencia inválida es 422, no un 500.
  • Sigue separado del cambio de contraseña (ADR 0035).

Alternativas descartadas

  • Reusar PUT /usuarios/{usuario_id} — es administrativo y recibe el usuario_id por path: un usuario podría editar a otro.
  • Un endpoint sin validar el tipo — permitiría mandar campos que no aplican (p. ej. nombre_comercial a una persona natural).
  • Meter el cambio de contraseña en el perfil — ya existe aparte (ADR 0035); mezclarlo complica el contrato.
  • Exponer identificacion/tipo_identificacion_id como editables — son datos que sólo el admin gestiona.

Consecuencias

  • OpenAPI suma 2 endpoints bajo /api/v1/auth.
  • email queda sincronizado entre la cuenta y la entidad natural al editarlo.
  • Los campos no editables quedan intactos aunque viajen en el body (se ignoran porque el service no los pasa al repository).
  • El perfil devuelve sólo los campos del tipo (unión discriminada por tipo_entidad): en natural no aparece nombre_comercial; en jurídica no aparecen nombres/apellidos.

Qué no cubre

  • Imagen de perfil: es otra decisión (almacenamiento del binario).
  • Cambio de contraseña: ADR 0035.
  • Editar rol, empresas o sucursales: son administrativos.