1.5 KiB
1.5 KiB
6.12 参数管理
:::tip 概述 参数模块（goframe_param，平台级表）管理系统级扁平键值参数：code 全局唯一（uk_code），标准七件套 CRUD。机制说明见 5.13 系统参数管理，本节给出模块视角。 :::
接口清单
七件套：sys:param:{page|list|detail|add|update|delete|batchDelete}
模块要点
| 要点 | 实现 |
|---|---|
| 唯一性 | UniqueFields{Field:"code"}（与全局 uk_code 一致，无偏差）——Add 前预检 |
| 平台级 | 无租户隔离（全局参数） |
| 消费方式 | 业务按 code 查询取值（低频直接查库） |
| 选择判据 | 简单键值对 → param；结构化表单配置 → config；需重启 → config.yaml |
与 config 模块的对照
| 维度 | param | config + config_item |
|---|---|---|
| 形态 | 扁平 code→value | 分组 + 键值明细（type/options 结构化） |
| 适用 | 运行参数快速读写 | 网站配置等表单化场景 |
| 接口 | 七件套 | 七件套 + web/index + web/save |
| 唯一预检 | 有（spec UniqueFields） | Add 走 CheckUnique（Update 1062 兜底） |
管理建议
- code 命名 snake_case 语义化（default_password / page_size / user_code_prefix）
- 删除是软删（可恢复），但删除前确认无业务引用（param 无引用守卫）
- 高频消费场景（每请求读）建议调用方自建缓存（param 模块无缓存层）
- 新增参数后在代码中以常量引用 code 字符串，避免拼写漂移