# 5.13 系统参数管理

:::tip 概述
参数是扁平单表的键值存储（gin_param），适合存放彼此独立、无需分组的系统参数。读取按 code 定位，变更走管理界面并留操作日志。
:::

## 表结构

```text
gin_param
├── code    参数键（全局唯一，小写下划线命名）
├── value   参数值
├── name    参数名称（管理界面展示）
├── remark  备注（取值说明、单位、默认值）
└── 公共审计列
```

## 典型参数

| code 形态 | 用途 |
|---|---|
| 协议/版本类 | 用户协议版本号、前端最低版本 |
| 开关类 | 独立的小功能开关 |
| 联系方式 | 客服电话、邮箱 |
| 提示文案 | 注册须知、免责声明文本 |

## 与配置管理的选型

- **成组配置**（站点配置一组、业务开关一组）→ 配置管理（gin_config 分组树）
- **独立参数**（一个 code 一个值）→ 参数管理（gin_param 扁平表）

两者都是数据库键值，禁止把运维级配置（端口/密钥/DSN）放进来。

## 业务侧使用

标准五方法经 ModuleSpec 声明；按 code 读取走列表/详情接口。参数变更即时生效（无缓存失效问题——读侧直查），但高频读取场景建议在 service 层加进程内缓存并主动失效。

## 管理界面

参数管理页见 [6.13 参数管理](/zh/modules/param.html)。

## 命名规约

- code 全局唯一，小写下划线，尽量带模块前缀
- value 一律字符串存储（数字/布尔由消费方转换）
- 修改参数属于运营操作，权限节点按"参数管理"粒度控制

## 下一步

→ [5.14 操作日志](/zh/core/operation-log.html)