字典管理

字典管理用于统一管理系统中的枚举数据，如状态、类型等，确保前后端数据一致性。

功能概览

• 字典类型管理
• 字典数据项 CRUD
• 字典缓存
• 批量获取字典

使用场景

系统中很多下拉选项都通过字典管理维护，例如：

字典编码	用途
sys_status	启用/禁用状态
sys_user_sex	用户性别
sys_notice_type	通知类型
sys_todo_priority	待办优先级

操作说明

新增字典类型

1. 进入字典管理页面
2. 点击「新增」按钮
3. 填写字典名称和字典编码
4. 点击「确定」保存

管理字典数据项

1. 在字典列表中点击某个字典的「数据」按钮
2. 在弹出的数据管理界面中新增、编辑或删除字典项
3. 每个字典项包含：标签名、值、排序、状态

前端使用

在 Vue 组件中通过字典 Hook 获取字典数据：

import { useDict } from '@/hooks/dict.hook'

const { dictData, getLabel } = useDict()
const statusOptions = await dictData('sys_status')

// 通过值获取标签
const label = getLabel(statusOptions, 1) // → '启用'

API 接口

字典类型

方法	路径	说明
GET	/sys/dict	获取字典列表
POST	/sys/dict	新增字典
GET	/sys/dict/:code	获取字典详情
PATCH	/sys/dict/:id	更新字典
DELETE	/sys/dict/:code	删除字典
GET	/sys/dict/options	获取字典下拉选项
POST	/sys/dict/options	批量获取多个字典

字典数据项

方法	路径	说明
GET	/sys/dictDetail	获取字典数据列表
POST	/sys/dictDetail	新增字典数据
PATCH	/sys/dictDetail/:id	更新字典数据
DELETE	/sys/dictDetail/:id	删除字典数据