Saltar a contenido

0020. CRUD de navegación — primer slice: cat_aplicaciones

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

Contexto

El dominio navegacion tiene 5 tablas con una cadena de dependencias: cat_aplicaciones → cfg_modulos → cfg_menu → cfg_menu_acciones, más cfg_variables_sistemas independiente. Este ADR abre el dominio con la raíz de la cadena: cat_aplicaciones, el catálogo global de aplicaciones (sin empresa_id, sin RLS, ADR 0012 transversal).

Decisión

Se implementa el CRUD de cat_aplicaciones bajo /api/v1/navegacion/aplicaciones:

  • GET /api/v1/navegacion/aplicaciones lista las aplicaciones activas, y GET /api/v1/navegacion/aplicaciones/{aplicacion_id} devuelve una por su id UUID.
  • POST /api/v1/navegacion/aplicaciones crea con 201; PUT /api/v1/navegacion/aplicaciones/{aplicacion_id} actualiza parcialmente; DELETE /api/v1/navegacion/aplicaciones/{aplicacion_id} elimina lógicamente con 204.
  • Es global: no lleva empresa_id ni RLS, como el resto de los catálogos globales (ADR 0008 y ADR 0012 transversal).
  • El codigo es único (constraint de cat_aplicaciones): el service lo valida antes de escribir y el router traduce el duplicado en 409.
  • El router de navegación se monta en app/main.py con el prefijo /api/v1/navegacion. Los slices siguientes (módulos, menú, acciones y variables) agregarán rutas al mismo router.

Alternativas descartadas

  • Esperar a la capa de autenticación — cat_aplicaciones es un catálogo global público: no depende del token ni de la empresa del usuario, así que no hay nada que esperar.
  • Implementar el dominio completo en un slice — la cadena de FKs (cat_aplicaciones → cfg_modulos → cfg_menu → cfg_menu_acciones) lo hace demasiado grande para una sola revisión: se entrega por partes, abriendo con la raíz.

Consecuencias

  • Desbloquea cfg_modulos (ADR 0021): ya puede validar su referencia a aplicación contra un CRUD real.
  • OpenAPI del servicio suma 5 endpoints.
  • El prefijo /api/v1/navegacion queda reservado para los slices siguientes.