0036. Alineación con los transversales: Python 3.14, uuidv7 y empresa del JWT¶
Estado: Aceptado
Fecha: 2026-10-07
Autor: Duval Alcivar
Módulo(s) afectado(s): pyproject.toml, app/core/models.py, app/api/deps.py
Modifica a: ADR 0001, ADR 0004, ADR 0006
Evidencia: commit e9a0dfc (2026-10-02) «chore(svc-clientes): Cambio de uuid v7» — en el mismo commit requires-python pasa de >=3.12 a >=3.14 y ruff de py312 a py314; commit 0e10481 (2026-10-07) «validar el jwt de identidad y tomar la empresa del token»; pyproject.toml; app/core/models.py (server_default=text("uuidv7()")); app/api/deps.py.
Contexto¶
El servicio quedó atrás de dos decisiones de plataforma: el transversal 0019 exige identificadores ordenables (uuidv7()), y la regla vigente es que la empresa sale sólo del access token de identidad. El código se alineó, pero los ADR 0001, 0004 y 0006 siguen describiendo el estado anterior.
Decisión¶
- El servicio se alinea con el transversal 0019:
idconuuidv7()por defecto en base, Python>=3.14,<4.0yruffenpy314. - La empresa del request sale sólo del access token de identidad, validado contra su JWKS. Se elimina la cabecera
X-Empresa-Iddel ADR 0006.
Los ADR quedaron viejos por omisión: 0001 fija Python 3.12, 0004 describe gen_random_uuid() y 0006 describe la cabecera provisional. El código ya no hace ninguna de las tres cosas, pero los textos no se actualizaron.
Alternativas descartadas¶
- Mantener Python 3.12 y UUID v4 — el transversal 0019 fija PostgreSQL 18 y
uuid.uuid7()como requisitos del stack. - Mantener la cabecera
X-Empresa-Id— es falsificable y contradice la regla «empresa sólo del JWT».
Consecuencias¶
El servicio exige PostgreSQL 18 y Python 3.14. Los ADR 0001, 0004 y 0006 quedan marcados como modificados y su texto debe leerse con este ADR al lado.
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).