配置管理
一句话：把「业务代码里要读的可变取值」集中成参数键值对：代码按「参数键名」取值，运营在本页改「参数键值」即刻生效，不用发版。与字典管理的区别：字典是「一组下拉选项」，配置是「单个可变取值」。
功能在哪
- 菜单路径：基础设施 → 配置管理
- 地址栏路由：
/infra/config - 主要权限：
infra:config:query/create/update/delete/export
界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 查询区 | 参数名称 / 参数键名 / 系统内置 / 创建时间 | 「搜索」「重置」 |
| 工具条 | 整页级动作 | 「新增」「导出」 |
| 列表 | 序号 / 参数分类 / 参数名称 / 参数键名 / 参数键值 / 是否可见 / 系统内置 / 备注 / 创建时间 | 行内「编辑」「删除」 |
| 是否可见列 | 开关即时切换 可见 / 隐藏 | 需要 infra:config:update |
| 系统内置列 | 字典标签：系统内置 / 自定义 | 系统内置的不允许删除 |
常用操作
新增一条参数
- 点「新增」；
- 填「参数分类」——归类标签（如
biz、url），列表里同类参数靠它聚拢； - 填「参数名称」——给人看的说明；
- 填「参数键名」——代码取值的唯一标识，全库不可重复；
- 填「参数键值」——实际生效的取值；
- 「是否可见」选是 / 否（含义见下方提示）；
- 可填备注，点「确定」。
结果：列表多一行；后端按键名立刻读到新值，无需重启。
「是否可见」控制的是前端能不能读
「可见」的参数才允许前端通过「按键名取值」接口读到；设为「否」后，前端请求会被拒绝（提示「获取参数配置失败，原因：不允许获取不可见配置」），但后端代码内部读取不受影响。密钥、内部开关这类不想暴露给浏览器的值，选否。
改值 / 改可见性
- 行内「编辑」可改名称、键值、可见性、备注；参数键名尽量不改——代码按它取值，改了等于换了一个参数，旧键名就读不到值了；
- 「是否可见」列的开关可以直接切 可见 / 隐藏，不用进表单。
删除
行内「删除」，二次确认后删除。「系统内置」列为系统内置的参数删不掉，会提示「不能删除类型为系统内置的参数配置」——它们是平台自身在用的取值，误删会影响功能。
导出
点「导出」，按当前查询条件导出 参数配置.xls，用于交接或审计留档。
字段说明
| 字段 | 必填 | 取值 / 校验 | 说明 |
|---|---|---|---|
| 参数分类 | 是 | 「参数分类不能为空」 | 归类标签 |
| 参数名称 | 是 | 「参数名称不能为空」 | 给人看的说明 |
| 参数键名 | 是 | 「参数键名不能为空」；全库唯一，重复报「参数配置 key 重复」 | 代码取值的唯一标识 |
| 参数键值 | 是 | 「参数键值不能为空」 | 实际生效的取值 |
| 是否可见 | 是 | 是 / 否 | 否 = 前端按键名取值接口拒绝返回 |
| 备注 | 否 | 文本 | 内部说明 |
视角对照
| 视角 | 看到什么 |
|---|---|
超管 admin / 租户管理员 docadmin | 同一份全局参数列表（参数不按租户隔离），可增删改 |
| 套餐未含此菜单的租户 | 侧边栏没有「配置管理」入口 |
| 普通员工 | 无此菜单；其页面里用到参数值的地方只读生效值 |
进阶
- 键名命名建议：
模块.用途的小写点分形式（如sys.user.initPassword），一眼能看出归属，也避免和别人撞键名； - 参数与字典的分工：选项集合（状态、类型）放字典管理；单个开关或阈值（初始密码、域名、超时秒数）放本页；
- 文件上传落到哪种存储，由文件配置的主配置决定，与本页无关。
常见问题
Q：改了键值，多久生效？要重启吗？ A：即刻生效，不需要重启。后端每次按键名读最新值。
Q：键名填重复了会怎样？ A：保存时报「参数配置 key 重复」。键名是全库唯一的，换一个是唯一解。
Q：系统内置的参数能改值吗？ A：能改值、改可见性，只是不能删除（「不能删除类型为系统内置的参数配置」）。改值前确认没有功能依赖原值。
Q：设为「隐藏」的参数，在本页还看得到吗？ A：看得到。可见性只约束前端「按键名取值」接口，不影响本页的管理视图——有 infra:config:query 权限就能看到全部参数。
Q：误删了自定义参数能恢复吗？ A：不能，删除为物理删除且无回收站。重要参数建议先记录键名键值再删，或干脆留着不用。