主题
字典数据
SYS-DICT-02 | 模块
system| 维护字典类型下的具体取值,并给 App 端提供只读接口。
1. 使用角色与场景
角色:管理员、终端用户
- 给「项目状态」加「进行中/已归档」
- App 启动时批量拉取字典
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/dict-data/create | system:dict:create | 新增字典数据 | DictDataController#L41 |
| PUT | /system/dict-data/update | system:dict:update | 修改字典数据 | DictDataController#L49 |
| DELETE | /system/dict-data/delete | system:dict:delete | 删除字典数据 | DictDataController#L57 |
| DELETE | /system/dict-data/delete-list | system:dict:delete | 批量删除字典数据 | DictDataController#L66 |
| GET | /system/dict-data/list-all-simple | — | 获得全部字典数据列表 | DictDataController#L75 |
| GET | /system/dict-data/simple-list | — | 获得全部字典数据列表 | DictDataController#L75 |
| GET | /system/dict-data/page | system:dict:query | 获得字典类型的分页 | DictDataController#L84 |
| GET | /system/dict-data/get | system:dict:query | /查询字典数据详细 | DictDataController#L92 |
| GET | /system/dict-data/export-excel | system:dict:export | 导出字典数据 | DictDataController#L101 |
| GET | /system/dict-data/type | — | 根据字典类型查询字典数据信息 | AppDictDataController#L33 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/dict/DictDataController.java#L41 |
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/app/dict/AppDictDataController.java#L33 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/dict/DictDataDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_dict_data | DictDataDO |
5. 机制与配置
- 后台维护 + App 只读两套接口
- EasyExcel 导出时通过 DictFormat 把值翻译成标签
6. 常见问题与排查
- 字典值改动后需清缓存,否则下拉框仍是旧值
7. 关联
- 需求原件:01-06-数据字典
- 相关卡片:SYS-DICT-01