6.12 参数管理

概述

参数模块（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 字符串，避免拼写漂移