Saltar a contenido

0023. Modelo unificado de permisos: una acción por sujeto

Estado: Complementado por ADR 0026 Fecha: 2026-09-23 Autor: Duval Alcivar Módulo(s) afectado(s): svc-identidad (core_sigfa), todos los servicios que validan permisos en el JWT Complementado por: ADR 0026 - implementación de rel_usuario_accion y jerarquía resuelta en el service

Contexto

El modelo anterior tenía dos rutas de autorización paralelas que nunca se hablaban entre sí: (A) rel_usuario_permiso → cat_permisos, y (B) rel_usuario_menu / rel_usuario_menu_accion → cfg_menu / cfg_menu_acciones. cat_permisos duplicaba la forma de cfg_menu_acciones (codigo, nombre, menu_id) y rel_usuario_permiso registraba el mismo hecho que rel_usuario_menu_accion. Además, rel_usuario_menu_accion.menu_id era derivable de accion_id y su clave única lo excluía, lo que permitía guardar un menú inconsistente. Por último, cat_tipos_usuario no era utilizable como rol.

Decisión

Se colapsa todo en una sola tabla rel_usuario_accion. La concesión se hace a nivel de acción (no de página). El sujeto es polimórfico: usuario_id XOR tipo_usuario_id, garantizado por el CHECK (num_nonnulls(usuario_id, tipo_usuario_id) = 1). cat_tipos_usuario pasa a ser el catálogo de roles (crece agregando filas). El permiso efectivo es la unión de las acciones del rol y de las excepciones individuales del usuario. La jerarquía de navegación (accion_id → cfg_menu_acciones.menu_id → cfg_menu.padre_id → cfg_modulos → cat_aplicaciones) es derivada con una consulta recursiva, nunca almacenada. Dos índices únicos parciales impiden concesiones duplicadas por sujeto.

Diagrama ER del modelo de permisos de core.identidad

Alternativas descartadas

  • Mantener ambas rutas — perpetúa la doble fuente de verdad y la posibilidad de menús inconsistentes.
  • Dos tablas separadas, rel_usuario_accion + rel_tipo_usuario_accion — duplica la lógica de resolución y de índices sin aportar nada que un sujeto polimórfico no resuelva.
  • Conservar cat_permisos como catálogo genérico de permisos para operaciones que no son de UI — no hace falta hoy porque todo permiso mapea a una acción de menú; se puede revisar si aparecen operaciones solo de backend.

Consecuencias

  • Elimina 4 tablas (cat_permisos, rel_usuario_permiso, rel_usuario_menu, rel_usuario_menu_accion) y agrega 1 (rel_usuario_accion).
  • Reemplaza a los ADR 0007, 0014 y 0015; en el caso de 0007 solo sus tablas de permisos, ya que cat_tipos_usuario sigue vigente como catálogo de roles.
  • Las especificaciones de tabla en docs-sql se actualizaron (relacion/0004-rel_usuario_accion.md, revisión Alembic 0032).
  • Cambia la composición del claim permisos en login/JWT: los permisos ahora provienen de rel_usuario_accion.