发生了什么

换电业务里的电池是平台的一项重要资产,每颗电池有唯一编号,档案里除了型号、状态,还登记着它归哪个城市的运营团队负责,这个字段叫运营城市,用于资产盘点、调拨和找回时的归属。电池内部有定位模块,会周期性上报位置,系统把上报的坐标换算成它最后一次出现在哪个城市,得到最后定位城市。两个字段来源不同:一个是登记出来的归属,一个是设备报上来的实际位置。

电池丢失或者需要回收时,系统会生成一张找回工单,交给现场人员按照定位去找。工单上有一个城市字段,这张单进哪个城市的工单池、由哪个城市的现场人员处理,都由它决定。正常流程是:电池需要找回,系统生成工单并把城市定为电池实际所在的城市,该城市的现场人员在自己的工单池里看到这张单,按定位到现场处理,处理完工单关闭。工单城市是这条流程的路由依据,定错了,单就进不了能干活的队伍。

这次的电池,档案上的运营城市是甲市,最后定位城市是乙市。业务人员看到找回工单开在甲市名下,和定位对不上,到产品问题群里请人帮忙核对。也就是说,按城市派工这条路在这里断了:甲市的现场人员到乙市去找这颗电池并不现实,而乙市能处理的人手里没有这张单,只能由人先在群里发现问题,再手工核对、改派。

已确认的影响是工单归属城市和电池实际所在城市不一致,现场处理只能靠人工核对改派;涉及多少颗电池没有统计。

本质

问题出在生成找回工单时,城市字段取的是哪个值。

  1. 电池在系统里同时有运营城市和最后定位城市两个值。运营城市是资产档案上的登记值,不会随着定位上报自动变化。
  2. 这次这颗电池的最后定位已经落在乙市,档案上的运营城市还是甲市,两个值分开了。电池只要不在登记的那个城市,两个值就会分开;平时两者相同,所以平时看不出问题。
  3. 生成找回工单的程序只读了电池档案里的运营城市,把工单城市直接写成甲市,从头到尾没有看最后定位城市,也没有判断两者是否一致。
  4. 工单带着甲市进入甲市的工单池,派给甲市的现场人员。甲市人员到不了乙市,真正能到现场的乙市团队看不到这张工单。
  5. 结果是一张有城市、有负责范围却没人能执行的工单,只能靠业务人员在群里反馈,由人核对后改派。

一句话说,这张工单的派单城市取错了字段:用资产归属代替了电池实际所在,而这两个值在跨城市之后会分开。

修复方向是:找回工单的城市改成按电池最后定位城市生成,定位城市取不到时再退回运营城市兜底。产品侧已经提出这个优化需求,尚未看到排期和上线记录,修复上线状态待确认。

只要工单是按城市、网点这类归属维度派给具体队伍的,派单城市就必须取接收方真正干活的位置,不能用资产归属字段代替。

错误代码

// 电池需要找回时生成一张工单,工单城市决定它由哪个城市的现场人员处理
public RecoveryOrder createRecoveryOrder(String batteryNo) {
    Battery battery = batteryMapper.selectByNo(batteryNo);
    RecoveryOrder order = new RecoveryOrder();
    order.setBatteryNo(batteryNo);

    // 为什么错:工单城市取的是资产档案上的运营城市。这个字段是登记值,
    // 电池被带到别的城市后它不会跟着变,工单于是进了运营城市的工单池,
    // 而电池实际已经不在这个城市,该城市的现场人员无法执行
    order.setCityCode(battery.getOperationCityCode());

    order.setStatus(WAIT_DISPATCH);
    order.setCreateTime(new Date());
    recoveryOrderMapper.insert(order);
    return order;
}

修复代码示例

public RecoveryOrder createRecoveryOrder(String batteryNo) {
    Battery battery = batteryMapper.selectByNo(batteryNo);
    RecoveryOrder order = new RecoveryOrder();
    order.setBatteryNo(batteryNo);
    // 改:派单城市改成电池最后一次定位所在城市,工单跟着电池实际位置走
    order.setCityCode(resolveDispatchCity(battery));
    order.setStatus(WAIT_DISPATCH);
    order.setCreateTime(new Date());
    recoveryOrderMapper.insert(order);
    return order;
}

// 改:以实际位置为准,只有在拿不到定位城市时才退回运营城市兜底
private String resolveDispatchCity(Battery battery) {
    BatteryLocation last = locationMapper.selectLastLocated(battery.getBatteryNo());
    if (last != null && last.getCityCode() != null && !last.getCityCode().isEmpty()) {
        return last.getCityCode();
    }
    return battery.getOperationCityCode();
}

代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

下次遇到这些场景要警惕

  • 按城市、网点、门店等归属维度派发任务时:先确认"谁去现场处理"是按哪个字段划分的,再检查生成任务时取的是不是这个字段。构造一条归属甲市、定位在乙市的数据生成工单,看它进的是哪个城市的工单池。
  • 给资产增加跨区域流转场景时(调拨、跨城使用):把归属城市和实际位置做成对不上的数据,把所有按城市过滤的入口跑一遍——工单池、任务列表、统计报表——确认不会出现工单有归属却没人能执行的情况。
  • 修这类取错字段的规则时:不要只改生成工单的一处。先列出所有用运营城市做过滤、统计、权限判断的地方,确认派单城市改成定位城市后,这些地方的预期结果仍然成立,避免改一处、别处对不上。
  • 电池定位可能缺失或长时间不更新时:用一颗没有定位记录的电池生成找回工单,确认有兜底城市、工单能正常落到某个队伍,而不是城市为空导致无人处理。