Skip to content

行政区划管理

行政区划维护系统内置的省 / 市 / 区县区划树(sys_region_code 表),供 RegionTreeSelect 组件与含 region_code 字段的业务表做数据范围过滤。后端为 SysRegionController,接口前缀 /system/region

功能入口

登录管理后台后,点击左侧菜单 平台管理 > 基础配置 > 行政区划

区划树

  • 左侧树形展示区划层级,支持搜索、新增子级、编辑、删除。
  • 区划由 code 唯一标识(如 150102)。

虚拟组织节点

虚拟组织节点 codeALL 结尾(如 150100ALL),代表「本级 + 全部下级」的聚合范围,用于数据权限按行政区划聚合查询:

  • 选择 150100ALL:匹配 150100 本级及其所有下级区划。
  • 选择普通区划 150102:精确匹配该区划。

前端 RegionTreeSelect 中虚拟组织节点不可选中,仅作聚合维度使用。

刷新缓存

区划数据变更后,点击「刷新缓存」即时生效(POST /system/region/refreshCache),避免业务查询读到旧区划。

注意事项

  • 区划编码是数据权限与业务表 region_code 过滤的关键,删除前确认无业务数据引用。
  • 虚拟组织节点只作查询聚合,不用于精确落库。

相关文档

Forge Admin — 基于 Vue3 + Spring Boot 的企业级后台管理框架