Skip to content

六、字典与地区 ​

菜单入口:系统管理 → 字典与地区。

字典管理维护全系统通用的枚举值(下拉选项、状态标签),地区管理提供中国行政区划树。两者都是"配一次、处处用"的基础数据。

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)被客户档案、供应商、员工籍贯、办公地点等所有含地址的模块引用。

📖 相关文档 ​