1.7 KiB
1.7 KiB
5.13 系统参数管理
:::tip 概述 参数是扁平单表的键值存储（gin_param），适合存放彼此独立、无需分组的系统参数。读取按 code 定位，变更走管理界面并留操作日志。 :::
表结构
gin_param
├── code 参数键（全局唯一，小写下划线命名）
├── value 参数值
├── name 参数名称（管理界面展示）
├── remark 备注（取值说明、单位、默认值）
└── 公共审计列
典型参数
| code 形态 | 用途 |
|---|---|
| 协议/版本类 | 用户协议版本号、前端最低版本 |
| 开关类 | 独立的小功能开关 |
| 联系方式 | 客服电话、邮箱 |
| 提示文案 | 注册须知、免责声明文本 |
与配置管理的选型
- 成组配置（站点配置一组、业务开关一组）→ 配置管理（gin_config 分组树）
- 独立参数（一个 code 一个值）→ 参数管理（gin_param 扁平表）
两者都是数据库键值，禁止把运维级配置（端口/密钥/DSN）放进来。
业务侧使用
标准五方法经 ModuleSpec 声明；按 code 读取走列表/详情接口。参数变更即时生效（无缓存失效问题——读侧直查），但高频读取场景建议在 service 层加进程内缓存并主动失效。
管理界面
参数管理页见 6.13 参数管理。
命名规约
- code 全局唯一，小写下划线，尽量带模块前缀
- value 一律字符串存储（数字/布尔由消费方转换）
- 修改参数属于运营操作，权限节点按"参数管理"粒度控制