46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
# 6.12 字典管理
|
||
|
||
:::tip 概述
|
||
字典管理页维护 gin_dict + gin_dict_item 两表：字典定义与字典项。它是字典机制（[5.11 字典模块](/zh/core/dict.html)）的数据维护入口，变更自动联动缓存失效。
|
||
:::
|
||
|
||
## 功能清单
|
||
|
||
### 字典（dict）
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| Page / Detail / Add / Update / Delete / BatchDelete | 字典定义维护 |
|
||
| RefreshCache | 手动刷新字典缓存（运维兜底） |
|
||
| AliasList / AliasInfo | 按别名批量/单个取字典项（业务侧常用入口） |
|
||
|
||
### 字典项（dict_item）
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| Page / Detail / Add / Update / Delete / BatchDelete | 字典项维护 |
|
||
| QuickList | 按字典编码快速取全部字典项（前端下拉数据源） |
|
||
|
||
## 缓存联动
|
||
|
||
字典项变更（Add/Update/Delete/BatchDelete）自动删除对应 `dict:{code}` 缓存键，下次读取回源重建——管理页保存即生效，无需重启。RefreshCache 用于缓存异常时的手动兜底。
|
||
|
||
## 字典项变更的影响面
|
||
|
||
字典值改动会即时影响：
|
||
|
||
- 后端 SerializeMaps 回填的 `{field}Text` 显示名
|
||
- 前端下拉/标签的选项文案
|
||
- 导出文件中的翻译列
|
||
|
||
改字典前评估正在使用的模块（尤其对外导出格式）。
|
||
|
||
## 管理界面
|
||
|
||
`data/dict`：字典列表 + 明细面板（字典项行内维护 + 排序 + 启停）。
|
||
|
||
## 相关
|
||
|
||
- [5.11 字典模块](/zh/core/dict.html)（机制）
|
||
- [8.6 字典数据接口](/zh/api-spec/dict-api.html)（契约）
|