平台功能（自研）可视化配置
可视化配置
「系统管理 → 系统配置」把原先散落在 application.yml、参数管理、数据库脚本里的运行参数，收成一个带页签的可视化页面。多数配置保存后立即生效，不需要重启宿主。
系统设置 · 分类页签（截图占位）
/images/docs/settings-tabs.png建议 1920 × 1080，截出网站、安全、登录、邮件、号码认证等页签。
页签与数据来源
| 页签 | 数据来源 | 保存后生效方式 |
|---|---|---|
| 网站 | sys_config（config_category = website） | 刷新前台页面即可 |
| 安全 | sys_config（security） | 下一次校验 / 登录时 |
| 登录 | sys_config（login） | 下一次获取验证码时 |
| 邮箱 | sys_config（email） | 下一次发信时（每次实时读取） |
| 号码认证 | sys_phone_verify_config | 下一次发码 / 校验时 |
| 短信 | 页面占位 | 功能尚未开放 |
| 存储 | sys_oss_config | 下一次上传时 |
| 客户端 | sys_client | 下一次登录 / 鉴权时 |
系统配置页本身只维护运行参数；应用级别的站点配置（如
gallery.*、mall.*）由各应用通过/open/<appCode>/config暴露，见能力开放。
页面结构
每个页签都遵循同一套交互：
- 查看态：字段只读，底部显示「编辑」。
- 编辑态：可修改、可「取消」或「保存」。
- 恢复默认：把当前页签的配置重置为后端登记的
default_value，不会删除配置项。 - 说明文字：每个配置项下方展示
remark，解释取值范围和影响。
这套交互由 SettingForm 统一实现，新增页签时只需要提供字段与配置 key。
权限
| 权限标识 | 作用 |
|---|---|
system:settings:list | 进入系统配置页 |
system:settings:website | 网站配置 |
system:settings:security | 安全配置 |
system:settings:login | 登录配置 |
system:settings:email | 邮箱配置 |
system:settings:sms | 短信配置 |
system:phoneVerifyConfig:list | 号码认证配置 |
system:settings:storage | 存储配置 |
system:settings:client | 客户端管理 |
配置页的保存接口复用参数管理的 system:config:edit；号码认证、存储、客户端各自使用独立权限。
配置优先级
同一个参数可能同时出现在 yml 与数据库：
- 数据库配置优先（页面修改的值）；
- yml 作为首次启动的兜底；
- 代码里的常量/默认值只在两者都缺失时使用。
邮件是典型例子：application.yml 里仍有 mail.*，但 MailConfig 每次发信都从 sys_config 读取，所以页面改完不需要重启。
安全提醒
mail.pass、accessKeySecret、secretKey、clientSecret都是敏感字段，列表接口默认不返回明文；查看明文需要单独的「查看密钥」权限。- 演示环境截图、工单、文档里不要贴真实密钥。
- 生产环境修改邮件、号码认证、存储配置后，建议立即发一条测试消息 / 上传一个文件验证。