Saltar a contenido

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/modulos lista los módulos activos, y GET /api/v1/navegacion/modulos/{modulo_id} devuelve uno por su id UUID.
  • POST /api/v1/navegacion/modulos crea con 201; PUT /api/v1/navegacion/modulos/{modulo_id} actualiza parcialmente; DELETE /api/v1/navegacion/modulos/{modulo_id} elimina lógicamente con 204.
  • Validaciones del POST y del PUT:
  • empresa_id debe existir en mae_empresas → si no, 404 «Empresa no encontrada».
  • aplicacion_id debe existir en cat_aplicaciones → si no, 404 «Aplicación no encontrada».
  • codigo es único por (empresa, aplicación) (constraint de cfg_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_id del token vendrá después (ADR de auth pendiente) y el CRUD ya valida la existencia de la empresa contra mae_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/navegacion queda reservado para los slices siguientes.