0037. Validación de referencias con el token del usuario¶
Estado: Aceptado
Fecha: 2026-10-26
Autor: Duval Alcivar
Módulo(s) afectado(s): app/adaptadores/http.py
Desvía de: ADR 0012 transversal, sección de service account («los servicios se comunican con service account JWT»)
Evidencia: commit c9bac97 (2026-10-23) adaptador de identidad; commit 4ac7789 (2026-10-26) adaptador de fuerza-ventas; ADRs 0025 y 0026 del servicio; app/adaptadores/http.py (línea que arma Authorization: Bearer).
Contexto¶
Al validar una referencia externa —tipo de identificación y ciudad contra identidad, promotor contra fuerza-ventas— el servicio debe consultar endpoints que exigen el token del usuario. El transversal 0012 pide service account JWT, pero ninguna pieza de la plataforma emite todavía un token de servicio.
Decisión¶
El servicio reenvía el access token del usuario en la cabecera Authorization, con timeout y traducción de fallos a errores de dominio (ServicioNoDisponible, ReferenciaInvalida).
Alternativas descartadas¶
- Service account JWT — requiere que identidad emita y rote credenciales de servicio, decisión que no existe.
- Consultar la base del otro servicio — prohibido por el transversal.
Consecuencias¶
La llamada hereda permisos y expiración del usuario; si el token vence a mitad de la operación, la validación falla. Es una desviación de plataforma: identidad la repite en su ADR 0051 (2026-10-26).
Estos ADR se escribieron después de la implementación; la fecha corresponde al commit que introdujo la decisión, no a la publicación en este sitio (2026-11-09).