Saltar a contenido

0043. Ensanchar el código de acción de la navegación

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

Contexto

El código de una acción (cfg_menu_acciones.codigo) no es un código corto: es el path completo dentro del módulo — <codigo_modulo>.<path_menu>.<accion>, por ejemplo seguridad-identidad.navegacion.aplicaciones.conceder (ADR 0029). Es el valor que se concede en rel_usuario_accion y el que viaja en el claim permisos del access token, así que su forma es intencional.

La columna se declaró varchar(50) sin calcular la longitud real de ese path. Con el módulo seguridad-identidad (19) y menús anidados, el path llega a 52 caracteres. Al materializar la plantilla base (alta de empresa, ADR 0034) Postgres aborta el INSERT con StringDataRightTruncationError, y como la plantilla va en la misma transacción que la empresa, la creación falla entera.

Decisión

Se ensancha cfg_menu_acciones.codigo a varchar(255) (migración 20261007_001 + actualización del modelo). 255 es el tope real del path: módulo (50) + tres niveles de menú (50 cada uno) + acción (50) + separadores ≈ 254.

Se agrega un guard en las pruebas: recorre PLANTILLA_BASE y verifica que ningún código de acción exceda el ancho de la columna, para que un crecimiento futuro de la plantilla avise antes de romper en producción.

Alternativas descartadas

  • Acortar el código del módulo (seguridad-identidad → seguridad) — arregla el caso actual sin migración, pero es frágil: cualquier menú más profundo o código más largo vuelve a romper.
  • Recortar el path del código de acción — rompería el contrato: el código es el path completo y es lo que se concede y se verifica.
  • Text sin límite — innecesario; el tope del path es acotado (~254) y un varchar con límite documenta la intención.
  • No tocar y validar en el service — no resuelve: el límite es de la base.

Consecuencias

  • La columna aguanta el path completo; los códigos existentes no cambian (varchar → varchar más ancho, sin reescritura de datos).
  • Se suma la migración 20261007_001 (aplicar con alembic upgrade head).
  • El guard de pruebas protege la plantilla contra futuros códigos largos.
  • Hay que reiniciar el servicio tras aplicar la migración para que el modelo y la base coincidan.

Qué no cubre

  • Cambiar el formato del código de acción: sigue siendo el path completo.
  • cfg_menu.codigo y cfg_modulos.codigo: son códigos cortos (no paths), no se tocan.