Saltar a contenido

0023. CRUD de navegación — cuarto slice: cfg_menu_acciones

Estado: Aceptado Fecha: 2026-09-29 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/navegacion/, tests/unit/navegacion/

Contexto

El ADR 0022 agregó cfg_menu, el tercer eslabón de la cadena de dependencias de la navegación. Este ADR agrega el cuarto: cfg_menu_acciones, las acciones disponibles dentro de cada entrada de menú por empresa. Una acción es la unidad de permiso del frontend: el permiso efectivo de un usuario son las acciones que tiene habilitadas en rel_usuario_accion, así que este CRUD queda como la fuente desde la que esa relación va a validar sus referencias.

Decisión

Se implementa el CRUD de cfg_menu_acciones bajo /api/v1/navegacion/acciones:

  • GET /api/v1/navegacion/acciones lista las acciones activas ordenadas por nombre; GET /api/v1/navegacion/acciones/{accion_id} devuelve una por su id UUID.
  • POST /api/v1/navegacion/acciones crea con 201; PUT /api/v1/navegacion/acciones/{accion_id} actualiza parcialmente; DELETE /api/v1/navegacion/acciones/{accion_id} elimina lógicamente con 204.
  • Validaciones del POST y del PUT:
  • empresa_id debe existir en mae_empresas → 404 «Empresa no encontrada».
  • menu_id debe existir en cfg_menu → 404 «Entrada de menú no encontrada».
  • codigo es único por (menu_id, codigo) (constraint de cfg_menu_acciones) → si se duplica, 409 «Ya existe una acción con ese código en la entrada de menú».
  • metodo_http es opcional y documenta el verbo HTTP asociado a la acción; no participa de ninguna unicidad ni validación de referencia.

Alternativas descartadas

  • Validar acciones contra el frontend en este slice — el mapeo entre acciones y rutas/permisos del frontend vive en el consumo de rel_usuario_accion, no en el CRUD: aquí la acción es un catálogo por empresa, sin reglas de autorización.
  • Exigir metodo_http — la acción es una unidad de permiso, no un endpoint: muchas acciones (por ejemplo, exportar o aprobar) no se mapean a un verbo HTTP único, así que el campo queda opcional.

Consecuencias

  • rel_usuario_accion ya puede validar su referencia a acción contra un CRUD real (el ADR 0023 ya estaba referenciado en models.py como la fuente de la unidad de permiso).
  • OpenAPI del servicio suma 5 endpoints.
  • Queda pendiente solo cfg_variables_sistemas (ADR 0024) para cerrar el dominio de navegación.