参数设置

功能定位

参数设置维护系统运行参数和业务配置，例如初始密码策略、注册开关、OSS 预览开关和企业基本信息。参数变更可能影响全局行为，必须谨慎。

图 8-6　系统内置参数与自定义配置

适用角色

超级管理员、系统管理员和运维人员。

页面入口

系统管理 → 参数设置（/system/config）。

参数分类

分类	示例	影响
系统内置	用户初始密码、注册开关、OSS 预览开关	认证、账号和文件访问行为
自定义配置	企业编码、企业全称、简称、英文名、法人、注册资本、成立日期	页面展示、报表抬头和品牌信息

操作步骤

1. 按参数名称或键名搜索目标参数。
2. 打开编辑，确认参数键、当前值、备注和影响范围。
3. 修改后保存，并点击“刷新缓存”使多节点立即生效。
4. 涉及认证、注册、文件访问或外部地址的参数，先在测试环境验证。
5. 对关键参数保留变更记录：修改人、时间、原值、新值和回滚方式。
6. 导出参数清单用于备份，但导出文件不得包含真实密钥或口令。

输入与输出

输入是参数键和值；输出是运行时配置、缓存刷新结果和操作审计。

宏澜家电示例

将企业全称设置为“宏澜家电智造集团股份有限公司”，简称“宏澜集团”，英文名用于登录页和报表抬头。初始密码参数只设置复杂度策略，不在文档中记录真实密码。

客户应用演示：调整报表默认查询时间范围

业务情境： 业务反馈报表默认打开最近 30 天，希望改为最近 90 天。

第一步：进入“系统管理 → 参数设置”

步骤图 49-01　第1步：进入“系统管理 → 参数设置”。红框标出进入系统管理 → 参数设置。

进入“系统管理 → 参数设置”，搜索报表相关参数。

第二步：记录原值、参数键名和影响范围

步骤图 49-02　第2步：记录原值、参数键名和影响范围。红框标出记录原值、参数键名和影响范围。

记录原值、参数键名和影响范围，确认不是敏感配置。

第三步：修改参数值并填写变更原因

步骤图 49-03　第3步：修改参数值并填写变更原因。红框标出修改参数值并填写变更原因。

修改参数值并填写变更原因，保存。

第四步：点击刷新缓存

步骤图 49-04　第4步：点击刷新缓存。红框标出点击刷新缓存。

点击刷新缓存，重新打开业务报表验证默认范围。

第五步：若结果不符合预期

步骤图 49-05　第5步：若结果不符合预期。红框标出若结果不符合预期。

若结果不符合预期，按记录恢复原值。

最终结果与效果

报表默认查询范围更新为 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；系统内置参数不应随意删除。
• 密钥类配置应使用环境变量或密钥管理，不应存入普通参数表。