0021. CRUD de navegación — segundo slice: cfg_modulos¶
Estado: Aceptado Fecha: 2026-09-29 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/navegacion/, tests/unit/navegacion/
Contexto¶
El ADR 0020 abrió el dominio navegacion con cat_aplicaciones, la raíz de la
cadena de dependencias. Este ADR agrega el siguiente eslabón: cfg_modulos, que
son los módulos de una aplicación por empresa: cada empresa habilita sus
módulos sobre el catálogo global de aplicaciones.
Decisión¶
Se implementa el CRUD de cfg_modulos bajo /api/v1/navegacion/modulos:
GET /api/v1/navegacion/moduloslista los módulos activos, yGET /api/v1/navegacion/modulos/{modulo_id}devuelve uno por suidUUID.POST /api/v1/navegacion/moduloscrea con201;PUT /api/v1/navegacion/modulos/{modulo_id}actualiza parcialmente;DELETE /api/v1/navegacion/modulos/{modulo_id}elimina lógicamente con204.- Validaciones del
POSTy delPUT: empresa_iddebe existir enmae_empresas→ si no,404«Empresa no encontrada».aplicacion_iddebe existir encat_aplicaciones→ si no,404«Aplicación no encontrada».codigoes único por (empresa, aplicación) (constraint decfg_modulos) → si se duplica,409«Ya existe un módulo con ese código para esa empresa y aplicación».- Las referencias se validan consultando las tablas ajenas desde el repository (patrón de sucursales, ADR 0019): el repository es la única capa con acceso a SQLAlchemy, así que validar entre dominios acá no acopla los services.
Alternativas descartadas¶
- Esperar a la capa de autenticación — mismo criterio que los slices
anteriores: el
empresa_iddel token vendrá después (ADR de auth pendiente) y el CRUD ya valida la existencia de la empresa contramae_empresas; cuando la auth exista, el token podrá restringir a la empresa del usuario.
Consecuencias¶
- Desbloquea
cfg_menu(ADR 0022): ya puede validar su referencia a módulo contra un CRUD real. - OpenAPI del servicio suma 5 endpoints.
- El prefijo
/api/v1/navegacionqueda reservado para los slices siguientes.