邮件标题:20260914-技术评审-营销活动中心-查证明细表09-02高德地图异常扫码地址为空修复
晓娜、建新:
已完成针对【查证明细表 09-02 高德地图异常扫码地址为空修复】的技术评审,现将评审结论、风险判断及后续执行安排同步如下,便于各方对齐认知并落实执行。
项目名称: 营销活动中心
评审时间: 2026-09-14
参与评审人: 潘玉平、王建朝、粱健、宋洋
评审结果: 不通过(退回补充影响范围评估后重评)
一、技术方案背景
- 业务场景:2026-09-02 高德地图(逆地理编码)异常,导致扫码查证接口写入 tag_check_detail(扫码查证明细表)时扫码地址相关字段(scan_province_name / scan_city_name / scan_county_name / scan_towns_name / scan_address)为空;需按事故窗口回补 2068 条数据。
二、技术方案要点
- 整体流程:复用现有 job/fix 基础设施(FixThreadTool 时间片并发 + StarRocksStreamLoader 列模式部分更新)→ 按 scan_time 命中分区裁剪查询事故窗口内 5 个目标列任一为空的记录(排除未授权 GPS 无坐标行)→ 逐行用行内经纬度调 RpcLbsService.locationAndPaddingCode 逆地理编码 + 行政区划补齐 → 组装 ScanAddressUpdateDTO 按主键(uuid + trace_code + scan_time)部分更新 5 个目标列;QPS≤5 限流 + 两级缓存(data 侧 @Cacheable / report 侧 Redis)保护高德配额,幂等可重跑。
三、决议事项(待办)
- 补充影响范围评估并写入方案开头:明确哪些能修、哪些不能修(skip 判定)、修复后业务可用程度,含对违规销售表 / 串货表等下游业务的影响结论,由 @潘玉平 负责,与产品 @罗斌、@南林 对齐后补充。
- 影响范围评估结论补充完整、各方共识后,重提评审由 @王建朝 直接过(无需再走完整评审)。
- 执行层面沿用数据修复红线:修复 SQL 全量留痕(传网盘 TXT 链接,非仅示例)、执行前备份、低峰期分批执行(朱老师确认数据量较大对 SR 有冲击),由 @潘玉平 负责。
四、风险提示
- 下游业务影响未共识:查证明细表与违规销售表、串货表等业务存在关联,高德异常期间地址缺失对串货判定等的影响尚未与产品对齐,修复前须先明确。
- 影响范围评估缺口:本次仅按「目标列任一为空 + 有坐标」圈定 2068 条,但「修复不了的影响风险」尚未对外共识(王建朝 9/14 会上要求先共识再修)。
- 不可修复行需业务侧知情:设备未授权 GPS(无坐标)、高德未解析、行政区划补齐失败等行将 skip,不计入修复量,须向业务说明这部分数据无法回补。