参数设置
功能定位
参数设置维护系统运行参数和业务配置，例如初始密码策略、注册开关、OSS 预览开关和企业基本信息。参数变更可能影响全局行为，必须谨慎。
图 8-6 系统内置参数与自定义配置
适用角色
超级管理员、系统管理员和运维人员。
页面入口
系统管理 → 参数设置（/system/config）。
参数分类
| 分类 | 示例 | 影响 |
|---|---|---|
| 系统内置 | 用户初始密码、注册开关、OSS 预览开关 | 认证、账号和文件访问行为 |
| 自定义配置 | 企业编码、企业全称、简称、英文名、法人、注册资本、成立日期 | 页面展示、报表抬头和品牌信息 |
操作步骤
- 按参数名称或键名搜索目标参数。
- 打开编辑，确认参数键、当前值、备注和影响范围。
- 修改后保存，并点击“刷新缓存”使多节点立即生效。
- 涉及认证、注册、文件访问或外部地址的参数，先在测试环境验证。
- 对关键参数保留变更记录：修改人、时间、原值、新值和回滚方式。
- 导出参数清单用于备份，但导出文件不得包含真实密钥或口令。
输入与输出
输入是参数键和值；输出是运行时配置、缓存刷新结果和操作审计。
宏澜家电示例
将企业全称设置为“宏澜家电智造集团股份有限公司”，简称“宏澜集团”，英文名用于登录页和报表抬头。初始密码参数只设置复杂度策略，不在文档中记录真实密码。
客户应用演示：调整报表默认查询时间范围
业务情境： 业务反馈报表默认打开最近 30 天，希望改为最近 90 天。
第一步：进入“系统管理 → 参数设置”
进入“系统管理 → 参数设置”，搜索报表相关参数。
第二步：记录原值、参数键名和影响范围
记录原值、参数键名和影响范围，确认不是敏感配置。
第三步：修改参数值并填写变更原因
修改参数值并填写变更原因，保存。
第四步：点击刷新缓存
点击刷新缓存，重新打开业务报表验证默认范围。
第五步：若结果不符合预期
若结果不符合预期，按记录恢复原值。
最终结果与效果
报表默认查询范围更新为 90 天，页面行为和变更记录一致。
操作提示： 不要修改数据库口令、密钥和第三方地址等基础设施参数；变更前先备份原值。
常见问题
修改参数后没有生效。 点击“刷新缓存”，必要时重启相关服务。
参数值显示被脱敏。 截图和页面会对敏感值脱敏；实际值只对授权管理员可见。
误改关键参数。 立即回滚到原值并刷新缓存，再检查登录、注册和文件访问。
开发人员参考
- 接口：
/system/config、/system/config/{configId}、/system/config/refreshCache - 权限：
system:config:list、system:config:add、system:config:edit、system:config:remove、system:config:export - 参数缓存于 Redis；系统内置参数不应随意删除。
- 密钥类配置应使用环境变量或密钥管理，不应存入普通参数表。