参数配置

概述

参数配置（infra_config）是系统级的「键值型」配置中心，用于把分散在代码里的开关与阈值收敛到数据库，便于运维人员在不发版的情况下动态调整。

它同时服务于两类场景：

参数由以下关键属性构成：

参数配置采用「数据库 + Redis + 内存」三级缓存，以兼顾一致性与性能。

要点：

启动时由 ParamsService.init_cache 把全量参数同步进 Redis（infra:config:{tenant_id}:{config_key}），中间件无数据时使用默认值。
创建、修改、删除参数都会同步维护 Redis 缓存；修改与删除还会主动失效对应租户的中间件内存缓存（_invalidate_mid_config_cache），避免最长 60 秒的脏读。
中间件侧通过 get_system_config_for_middleware 读取，带有 60 秒内存缓存并按租户隔离，因此对高频请求几乎零开销。
不可见（visible != 1）的参数在中间件读取时视为「未启用」，自动回退默认值。

以下键名被后端中间件 / 调度器直接消费（见 MIDDLEWARE_CONFIG_KEYS），配置它们即可改变系统运行时行为：

配置键	语义	默认值	说明
demo_enable	演示模式开关	false	开启后非 GET 请求（且不在白名单内）会被拦截
ip_white_list	IP 白名单	[]	演示模式下放行这些 IP 的写操作
ip_black_list	IP 黑名单	[]	命中的客户端直接被拒绝访问
white_api_list_path	API 白名单路径	[]	演示模式下放行的接口路径前缀
operation_log_retention_days	操作日志保留天数	90	日志清理任务的保留窗口

此外，初始化 SQL 还会写入一些业务参数，例如 system.user.init-password（账号初始密码）、system.user.register-enabled（注册开关），这些都可在页面上直接查看与调整。

提示：修改上述内置键的键名是无效的——键名创建后不可变更，更新接口会校验 config_key 保持一致。

所有接口位于 /infra/config，统一响应包裹于 ResponseSchema，需要对应权限码：

约束逻辑（集中在 ParamsService）：

参数配置页面位于 apps/web-ele/src/views/infra/config，采用 Vben 的 useVbenVxeGrid + 弹窗表单模式。

列表字段由 data.ts 的 useGridColumns 定义，搜索表单由 useGridFormSchema 定义，类型与可见性通过字典 INFRA_CONFIG_TYPE、INFRA_BOOLEAN_STRING 渲染。
表单 form.vue 通过 getConfig 回显数据，提交时按是否有 id 自动选择新建或更新。
所有写操作按钮受权限码（如 infra:config:create）控制，无权限时不展示。

典型调用示例：

import { getConfigKey } from '#/api/infra/config';

// 在业务代码中按需读取某个参数值
const value = await getConfigKey('system.user.register-enabled');