行政区划管理
行政区划维护系统内置的省 / 市 / 区县区划树(sys_region_code 表),供 RegionTreeSelect 组件与含 region_code 字段的业务表做数据范围过滤。后端为 SysRegionController,接口前缀 /system/region。
功能入口
登录管理后台后,点击左侧菜单 平台管理 > 基础配置 > 行政区划。
区划树
- 左侧树形展示区划层级,支持搜索、新增子级、编辑、删除。
- 区划由
code唯一标识(如150102)。
虚拟组织节点
虚拟组织节点 code 以 ALL 结尾(如 150100ALL),代表「本级 + 全部下级」的聚合范围,用于数据权限按行政区划聚合查询:
- 选择
150100ALL:匹配150100本级及其所有下级区划。 - 选择普通区划
150102:精确匹配该区划。
前端 RegionTreeSelect 中虚拟组织节点不可选中,仅作聚合维度使用。
刷新缓存
区划数据变更后,点击「刷新缓存」即时生效(POST /system/region/refreshCache),避免业务查询读到旧区划。
注意事项
- 区划编码是数据权限与业务表
region_code过滤的关键,删除前确认无业务数据引用。 - 虚拟组织节点只作查询聚合,不用于精确落库。
相关文档
- 数据权限配置 — 行政区划数据范围
- RegionTreeSelect 组件
