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/accioneslista las acciones activas ordenadas pornombre;GET /api/v1/navegacion/acciones/{accion_id}devuelve una por suidUUID.POST /api/v1/navegacion/accionescrea con201;PUT /api/v1/navegacion/acciones/{accion_id}actualiza parcialmente;DELETE /api/v1/navegacion/acciones/{accion_id}elimina lógicamente con204.- Validaciones del
POSTy delPUT: empresa_iddebe existir enmae_empresas→404«Empresa no encontrada».menu_iddebe existir encfg_menu→404«Entrada de menú no encontrada».codigoes único por(menu_id, codigo)(constraint decfg_menu_acciones) → si se duplica,409«Ya existe una acción con ese código en la entrada de menú».metodo_httpes 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_accionya puede validar su referencia a acción contra un CRUD real (el ADR 0023 ya estaba referenciado enmodels.pycomo 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.