字典管理

功能定位

字典管理统一维护枚举值和显示标签，例如用户性别、菜单状态、通知类型、操作类型和设备类型。它保证页面下拉框、表格标签和后端校验使用同一套编码。

图 8-5　字典类型与字典数据

适用角色

系统管理员、开发人员和业务配置人员。

页面入口

系统管理 → 字典管理（/system/dict）。

页面结构

• 左侧为字典类型：字典名称、字典类型、备注和操作。
• 右侧为字典数据：字典标签、键值、排序、备注、状态和操作。
• 工具按钮支持新增、修改、删除、导出和刷新缓存。

操作步骤

1. 先在左侧搜索字典名称或类型，确认是否已有同类字典。
2. 新增字典类型时填写名称、类型编码和备注；类型编码一经使用不要随意更改。
3. 在右侧新增字典数据，填写标签、键值、排序、样式和状态。
4. 键值必须与数据库、接口和历史数据保持一致；修改键值可能导致旧数据无法翻译。
5. 保存后点击“刷新缓存”，再刷新页面验证下拉框和标签。
6. 删除字典前检查是否仍被菜单、表单、报表或历史数据引用。

输入与输出

输入是字典类型、标签、键值和排序；输出是统一的下拉选项、状态标签和接口枚举。

宏澜家电示例

“订单状态”字典包含待付款、已付款、已发货、已完成、已取消和已退货。报表按字典标签显示中文，后端仍保存稳定键值；新增“部分退货”状态时先评估历史报表分组。

客户应用演示：维护“销售渠道”字典

业务情境： 业务新增直营、经销、电商和工程渠道，需要在筛选器和表单中统一显示。

第一步：进入“系统管理 → 字典管理”

步骤图 48-01　第1步：进入“系统管理 → 字典管理”。红框标出进入系统管理 → 字典管理。

进入“系统管理 → 字典管理”，搜索“销售渠道”。

第二步：新增字典项

步骤图 48-02　第2步：新增字典项。红框标出新增字典项。

新增字典项，填写标签、键值、排序和状态。

第三步：保存后刷新使用该字典的页面

步骤图 48-03　第3步：保存后刷新使用该字典的页面。红框标出保存后刷新使用该字典的页面。

保存后刷新使用该字典的页面，检查下拉选项。

第四步：确认历史数据仍能正确映射

步骤图 48-04　第4步：确认历史数据仍能正确映射。红框标出确认历史数据仍能正确映射。

确认历史数据仍能正确映射，必要时补充兼容值。

第五步：通知相关报表和看板负责人进行显示核对

步骤图 48-05　第5步：通知相关报表和看板负责人进行显示核对。红框标出通知相关报表和看板负责人进行显示核对。

通知相关报表和看板负责人进行显示核对。

最终结果与效果

所有引用该字典的筛选项和表单统一显示新增渠道，键值保持稳定。

操作提示： 不要随意修改历史键值；停用比删除更安全。

常见问题

修改字典后页面仍显示旧值。 点击“刷新缓存”并重新登录；浏览器可能仍缓存旧字典。

删除字典提示被引用。 先查找菜单、表单和报表引用，改用停用。

同一字典出现重复键值。 键值在字典类型内必须唯一，合并前先迁移历史数据。

开发人员参考

• 接口：/system/dict/type、/system/dict/data、/system/dict/type/refreshCache
• 权限：system:dict:list、system:dict:add、system:dict:edit、system:dict:remove、system:dict:export
• 字典数据缓存于 Redis；写入后需刷新缓存，避免多节点读到旧值。
• 前后端通过字典类型编码读取，不在页面硬编码中文标签。