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_juridicases hoymae_personas_comercialesy la ruta/juridicases/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 editanombre,nombre_comercial,pais_id,ciudad_id. - Los campos del otro tipo se rechazan con
422. identificacionytipo_identificacion_idno son editables: los administra el admin.emailes el único campo compartido: se muestra uno solo, priorizando el de la entidad (mae_personas.email); al editarlo se sincroniza tambiénmae_usuarios.emailpor fondo (el formulario no lo pide dos veces). En persona jurídica la entidad no tiene columnaemail, así que es el de la cuenta.- Se validan las referencias (
genero_id,pais_id,ciudad_iddeben existir y estar activas): una referencia inválida es422, no un500. - Sigue separado del cambio de contraseña (ADR 0035).
Alternativas descartadas¶
- Reusar
PUT /usuarios/{usuario_id}— es administrativo y recibe elusuario_idpor path: un usuario podría editar a otro. - Un endpoint sin validar el tipo — permitiría mandar campos que no aplican
(p. ej.
nombre_comerciala 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_idcomo editables — son datos que sólo el admin gestiona.
Consecuencias¶
- OpenAPI suma 2 endpoints bajo
/api/v1/auth. emailqueda 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 aparecenombre_comercial; en jurídica no aparecennombres/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.