销售 5 段电子围栏应用优化技术评审会议纪要
会议时间：2026-06-03
会议摘要：本次评审了销售 5 段电子围栏应用优化方案，核心决策为将电子围栏绘制与行政区划数据查询拆分为两个独立接口以提升性能，并明确了行政区划名称反查匹配的数据关联策略。
一、需求背景
当前营销活动中心的销售 5 段管理页面需展示电子围栏及对应的省市县乡数据，同时查证明细、流向分类等报表的相关字段数据源需要进行切换。现有方案在性能和数据准确性方面存在优化空间。
二、技术方案
2.1 接口拆分设计
原有方案：电子围栏绘制与行政区划数据查询为单一接口，响应较慢。
优化方案：拆分为 两个独立接口，按需调用。
┌─────────────────────────────────────────────┐
│ 前端（销售5段管理页面） │
│ │
│ ┌──────────────────┐ ┌──────────────────┐ │
│ │ 接口A：围栏绘制 │ │ 接口B：行政区划 │ │
│ │ (geoJSON/坐标) │ │ (省市县乡数据) │ │
│ └────────┬─────────┘ └────────┬─────────┘ │
│ │ │ │
└───────────┼─────────────────────┼───────────┘
▼ ▼
┌───────────┐ ┌───────────┐
│ 围栏服务 │ │ 主数据服务 │
└───────────┘ └───────────┘2.2 上级层级兜底逻辑
围栏绘制接口增加层级降级查询能力：
| 当前层级 | 查询优先级 | 兜底策略 |
|---|---|---|
| 乡（镇） | 优先取乡级 | 取不到 → 自动取县级 |
| 县 | 优先取县级 | 取不到 → 自动取市级 |
| 市 | 优先取市级 | 取不到 → 自动取省级 |
| 省 | 仅省级 | 无上级时返回空 |
目的：避免因某一层级行政区划缺失导致整个围栏无法展示。
2.3 数据关联方案
扫码场景中获取的是中文行政区划名称（非编码），需通过反查主数据进行匹配：
扫码 → 获取中文地名(如"北京市朝阳区") → 反查 division 表 → 匹配电子围栏数据关键表：division 表（主数据行政区划映射表）
三、涉及变更范围
| 变更类型 | 变更内容 | 影响模块 |
|---|---|---|
| 页面改造 | 销售 5 段管理页新增围栏及行政区划展示 | 前端 |
| 报表字段切换 | 查证明细、流向分类等报表字段数据源切换 | 报表服务 |
| 后端接口 | 新增/改造围栏绘制接口、行政区划查询接口 | 后端 |
| 数据关联 | division 表反查逻辑实现 | 数据层 |
四、风险与关注点
| 风险项 | 描述 | 影响 |
|---|---|---|
| 中文名称反查不匹配 | 通过中文地名反查可能出现重复（如"新城"多市均有）或缺失 | 围栏数据匹配失败 |
| 在途数据不一致 | B 端出货明细表中存在在途数据，新旧数据源切换后可能产生不一致 | 报表数据准确 |
五、待办事项
| 序号 | 待办内容 | 责任人 | 状态 |
|---|---|---|---|
| 1 | 与传熙老师沟通，补充方案中关于中文名称反查行政区划时可能出现的数据不匹配（如重复或缺失）的情况及处理方式 | 韩冬冬 | ⏳ 待跟进 |
| 2 | 确认并处理 B 端出货明细表中，因在途数据导致新旧数据源切换后可能出现的数据不一致问题 | 韩冬冬 | ⏳ 待跟进 |
六、结论
- 接口拆分方案通过：围栏绘制与行政区划查询分离，性能可预期提升。
- 层级兜底逻辑确认：取不到当前层级自动升级至上一级。
- 数据反查策略待完善：需韩冬冬补充中文名称反查的异常处理方案。