Saltar a contenido

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/variables lista las variables activas ordenadas por clave; GET /api/v1/navegacion/variables/{variable_id} devuelve una por su id UUID.
  • POST /api/v1/navegacion/variables crea con 201; PUT /api/v1/navegacion/variables/{variable_id} actualiza parcialmente; DELETE /api/v1/navegacion/variables/{variable_id} elimina lógicamente con 204.
  • Validaciones del POST y del PUT:
  • empresa_id debe existir en mae_empresas → 404 «Empresa no encontrada».
  • clave es única por (empresa_id, clave) (constraint de cfg_variables_sistemas) → si se duplica, 409 «Ya existe una variable con esa clave para la empresa».
  • tipo_dato tiene default "string" (coincide con el server_default de la tabla): el cliente puede omitirlo y la variable se guarda como texto.

Alternativas descartadas

  • Tipar el valor según tipo_dato — el valor se guarda como Text y el tipo_dato documenta 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_sistemas son por empresa (llevan empresa_id y 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/navegacion queda completo; cualquier tabla nueva del dominio requerirá su propio ADR.