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.
Textsin límite — innecesario; el tope del path es acotado (~254) y unvarcharcon 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→varcharmás ancho, sin reescritura de datos). - Se suma la migración
20261007_001(aplicar conalembic 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.codigoycfg_modulos.codigo: son códigos cortos (no paths), no se tocan.