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/aplicacioneslista las aplicaciones activas, yGET /api/v1/navegacion/aplicaciones/{aplicacion_id}devuelve una por suidUUID.POST /api/v1/navegacion/aplicacionescrea con201;PUT /api/v1/navegacion/aplicaciones/{aplicacion_id}actualiza parcialmente;DELETE /api/v1/navegacion/aplicaciones/{aplicacion_id}elimina lógicamente con204.- Es global: no lleva
empresa_idni RLS, como el resto de los catálogos globales (ADR 0008 y ADR 0012 transversal). - El
codigoes único (constraint decat_aplicaciones): el service lo valida antes de escribir y el router traduce el duplicado en409. - El router de navegación se monta en
app/main.pycon 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_aplicacioneses 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/navegacionqueda reservado para los slices siguientes.