主题
地区数据
SYS-AREA-01 | 模块
system| 提供省市县树与 IP 归属地解析,供地址选择与登录地展示使用。
1. 使用角色与场景
角色:终端用户、开发者
- 表单选择所在城市
- 登录日志显示 IP 归属地
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| GET | /system/area/tree | — | 获得地区树 | AreaController#L29 |
| GET | /system/area/get-by-ip | — | 获得 IP 对应的地区名 | AreaController#L37 |
| GET | /system/area/tree | — | 获得地区树 | AppAreaController#L27 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/ip/AreaController.java#L29 |
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/app/ip/AppAreaController.java#L27 |
4. 数据表
无独立表,数据存于缓存、文件或配置。
5. 机制与配置
- 内置 area.csv 与 ip2region.xdb,不依赖数据库表
- 启动时加载为内存树
6. 常见问题与排查
- xdb 文件缺失时 IP 解析降级为空,不报错
7. 关联
- 需求原件:01-04-组织架构
- 相关卡片:SYS-LOG-01