Skip to content

地区管理 ​

一句话:本页提供内置的行政区划树(省 / 市 / 区县)与一个 IP 归属地查询小工具。地区数据是系统自带的只读数据,本页没有增删改。

功能在哪 ​

  • 菜单路径:系统管理 → 地区管理
  • 地址栏路由:/system/area
  • 权限:无独立权限标识——能看到菜单就能用(IP 查询按钮也不额外鉴权)

地区管理:展开「中国」后的省份列表 + IP 查询弹窗(租户管理员视角)

界面认识 ​

区域作用
工具条只有一个「IP 查询」按钮
列表虚拟滚动的树表,两列:编号 / 地名。默认只展示根节点,点行首三角逐级展开(中国 → 省 → 市 → 区县)

编号是有规律的

省级编号以 0000 结尾(如 110000 北京市、320000 江苏省),市级以 00 结尾(如 320100 南京市)。业务表里存地区时通常存这个编号,界面再按编号翻译成地名。

常用操作 ​

查 IP 归属地 ​

  1. 点「IP 查询」;
  2. 输入 IPv4 地址(必填,空提交报「IP 地址不能为空」);
  3. 点「确定」,「地址」框只读展示结果(如 江苏省 南京市),提示「查询成功」。

IP 查询:114.114.114.114 → 江苏省 南京市(租户管理员视角)

查询走后端本地库,不联网

归属地解析在服务端用内置 IP 库完成,断外网也能查;结果是区县级精度的估算值,运营商机房 IP 可能落到省会。

浏览行政区划 ​

纯浏览:逐级展开即可。数据由系统初始化写入,本页不提供新增/修改/删除——需要维护地区数据属于后端数据初始化范畴,不在界面能力内。

字段说明 ​

字段必填校验说明
IP是「IP 地址不能为空」;非法格式由后端报错仅 IPv4
地址—只读展示查询结果

视角对照 ​

视角看到什么
所有能进系统管理的角色同一份只读地区树与 IP 查询
套餐受限租户 aoteman@test套餐未勾该菜单时侧边栏无入口

进阶 ​

  • 字典管理:下拉选项的源头;地区是树形结构化数据,与字典是两套体系,别混用;
  • 业务侧(如收货地址选择器)按编号取地区树,接口与本页同源。

常见问题 ​

Q:为什么没有「新增」按钮? A:地区数据是内置只读数据。本页的定位是「查」而不是「维护」。

Q:IP 查询结果和实际不符? A:本地 IP 库为区县级估算;新分配的 IP 段、NAT 出口 IP 都可能偏差。需要精确归属请结合业务侧风控数据。

Q:列表第一行只有「中国」? A:树默认折叠到根。点行首三角展开,或用本页数据接口直接取某一级。