Saltar a contenido

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: id con uuidv7() por defecto en base, Python >=3.14,<4.0 y ruff en py314.
  • La empresa del request sale sólo del access token de identidad, validado contra su JWKS. Se elimina la cabecera X-Empresa-Id del 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).