六、字典与地区
菜单入口:系统管理 → 字典与地区。
字典管理维护全系统通用的枚举值(下拉选项、状态标签),地区管理提供中国行政区划树。两者都是"配一次、处处用"的基础数据。
6.1 字典管理
菜单入口:系统管理 → 字典管理。
维护系统所有下拉框/状态标签的取值来源,分两层:字典类型(如"用户性别")和其下的字典数据(男/女/未知)。
页面操作:
- 查询:按字典名称、字典类型、状态、创建时间过滤,搜索执行、重置清空条件;
- 新增:填写字典分组、字典名称、字典类型(唯一标识,如
system_user_sex)、状态、备注; - 修改(行内):编辑字典类型基本信息;
- 数据(行内):进入该字典类型的数据维护页,增删改字典标签、字典键值、排序、回显样式(如 tag 颜色:默认/主要/成功/警告/危险);
- 删除(行内)/ 批量删除:删除字典类型;删除字典类型会级联删除其下全部字典数据,请谨慎操作;
- 导出:导出当前字典类型清单(Excel)。
| 列 | 说明 |
|---|---|
| 字典分组 / 字典编号 | 所属分组与内部编号 |
| 字典名称 | 显示名称,如"用户性别" |
| 字典类型 | 唯一标识,业务代码按此引用,如 system_user_sex |
| 状态 / 备注 / 创建时间 | 启停、说明、建档时间 |

字典数据维护要点:
| 字段 | 说明 |
|---|---|
| 字典标签 | 下拉框/列表中显示的文本(如"男") |
| 字典键值 | 存库的实际值(如 1),修改键值会影响历史数据回显,一般只增不改 |
| 字典排序 | 显示顺序 |
| 回显样式 | 列表页标签颜色(tag 样式) |
业务规则:
- 字典类型一旦被业务使用,不建议修改"字典类型"标识本身(业务代码按类型取值);
- 修改字典数据后,已打开的页面可能仍显示旧值,刷新浏览器页面后生效;
- 新增枚举值(如新增一种单据状态)是最常见的运维操作:在对应字典类型下新增一条字典数据即可,无需改代码。
数据变动:写入字典类型表与字典数据表(
system_dict_type/system_dict_data)。字典被全系统业务页面的下拉框、列表状态列引用(用户性别、单据状态、审批结果等);删除字典类型会级联删除其数据,导致引用它的下拉框显示为空值。
6.2 地区管理
菜单入口:系统管理 → 地区管理。
以树形展示中国行政区划(省 → 市 → 区县),供全系统地址选择组件引用。
页面操作:
- IP 查询:输入 IP 地址,根据 IP 定位其所属地区;
- 查看全部:展示全部省市区树,可逐级展开浏览。

业务规则:
- 地区数据由后端预置(中国行政区划),一般只读查询,不提供页面新增/编辑;如需扩展(如海外地区或新区划调整),需由后端导入数据;
- 各业务模块的"省/市/区"级联地址选择组件均来源于此数据源;
- 页面无删除操作,避免误删导致历史地址数据无法回显。
数据变动:本页面为只读查询,不产生数据写入。地区数据(
system_area)被客户档案、供应商、员工籍贯、办公地点等所有含地址的模块引用。
