0024. CRUD de navegación — quinto slice: cfg_variables_sistemas¶
Estado: Aceptado Fecha: 2026-09-29 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/navegacion/, tests/unit/navegacion/
Contexto¶
El ADR 0023 agregó cfg_menu_acciones y con eso la cadena de dependencias de
la navegación quedó completa. Este ADR agrega la tabla independiente del
dominio: cfg_variables_sistemas, las variables de configuración por
empresa (moneda base, zona horaria, umbrales, etc.). No depende de ninguna
otra tabla del dominio: solo de empresa_id, y por eso se entrega al final.
Decisión¶
Se implementa el CRUD de cfg_variables_sistemas bajo
/api/v1/navegacion/variables:
GET /api/v1/navegacion/variableslista las variables activas ordenadas porclave;GET /api/v1/navegacion/variables/{variable_id}devuelve una por suidUUID.POST /api/v1/navegacion/variablescrea con201;PUT /api/v1/navegacion/variables/{variable_id}actualiza parcialmente;DELETE /api/v1/navegacion/variables/{variable_id}elimina lógicamente con204.- Validaciones del
POSTy delPUT: empresa_iddebe existir enmae_empresas→404«Empresa no encontrada».clavees única por(empresa_id, clave)(constraint decfg_variables_sistemas) → si se duplica,409«Ya existe una variable con esa clave para la empresa».tipo_datotienedefault"string"(coincide con elserver_defaultde la tabla): el cliente puede omitirlo y la variable se guarda como texto.
Alternativas descartadas¶
- Tipar el
valorsegúntipo_dato— el valor se guarda comoTexty eltipo_datodocumenta cómo interpretarlo; forzar coerción en el service acoplaría el CRUD al consumo (frontend, reportes) y rompería valores existentes. - Mezclar las variables con la configuración global de la plataforma — las
variables de
cfg_variables_sistemasson por empresa (llevanempresa_idy RLS): la configuración global queda fuera de este dominio.
Consecuencias¶
- Cierra los slices del dominio
navegacion: aplicaciones (ADR 0020), módulos (ADR 0021), menú (ADR 0022), acciones (ADR 0023) y variables (este ADR). - OpenAPI del servicio suma 5 endpoints.
- El prefijo
/api/v1/navegacionqueda completo; cualquier tabla nueva del dominio requerirá su propio ADR.