发生了什么

电池是租给客户使用的资产。一块电池登记在一个客户名下,同时登记着归属城市。客户到期不归还,业务上叫“到期未归还”;这类电池由识别程序挑出来,生成一张“找回工单”,一线运维按这张工单去跟进,把电池收回。

两个系统各管一段。资产系统里的电池台账记录每块电池在谁名下、是不是到期没还,运营看台账就知道哪些电池该找;工单系统负责把要处理的事派给一线,运营看工单列表就知道今天该去找什么。

正常时两边应该对得上:台账里出现一块到期未归还的电池,工单系统里就有一张指着它的找回工单。

这次对不上。有一座城市的运营人员看到,该市的两块电池在台账里显示到期未归还,客户也还是原客户,但工单系统的找回工单按电池去查,查不到任何记录。一线看到的是一张空列表,没有人知道要去找这两块电池。

原因在开放范围。到期未归还的识别和建单只对直营城市开放,判断依据是一份由运营提供的直营城市名单。按处理结论,这座城市应当在直营范围内,但那份名单里没有它。识别程序读到这座城市不在名单内,就把整座城市跳过了,工单自然没有生成。

这个问题单的处理结论是已完成,修复动作是把这座城市补进直营城市配置。已经漏掉的两块电池是补建工单还是走人工处理、补完之后有没有验证,记录没有写,修复上线状态待确认。

本质

这里有两个各自成立的判断,凑在一起给出了相反结论。

第一个判断在资产侧:只要电池过了归还期限还在客户名下,台账就显示到期未归还。这个判断不看城市,也不看有没有工单。

第二个判断在工单侧,分三步:

  1. 识别程序处理到期未归还数据时,先从配置里读出一份直营城市名单,把它当作“哪些城市要管”的完整答案。
  2. 逐块检查到期未归还的电池,取电池登记的归属城市去名单里比对。
  3. 城市不在名单里,就直接跳过这块电池,既不生成工单,也不打日志、不计数、不报错。

名单是运营人工提供的,和城市实际的直营范围之间没有任何比对或校验,城市新开或范围调整时它不会自己更新。

于是这次三步全部走通,却得到空结果:该市不在名单里,整座城市的到期未归还电池在建单环节被过滤干净,一块也没识别出来。资产侧照常展示那两块电池,名单缺一项,整座城市的电池就从建单流程里静默消失了。

关键在于这个开关缺省方向是“不开放”。名单里没有,程序默认这座城市不需要管,而不是默认需要人工确认;跳过发生在循环内部,不留任何痕迹,所以从工单列表上完全看不出曾经有一批电池走到这里又被丢掉。名单靠人维护、缺项靠人发现,这是方案层面的选择,也是这次问题归到产品方案上的原因:判断“是不是直营”本可以按城市的实际归属来问,却做成了需要人工同步的一份静态清单。

已确认的修复是把该市补进直营城市配置。把名单外的城市统计出来并给出提示,是让下一次漏配能被看见的一种做法,属于修复方向,不代表已经实施。存量两块电池的补单和验证情况仍待确认。

错误代码

// 识别程序:按直营城市名单圈定范围,名单外城市直接跳过
public void generateRecoveryOrders() {
    // 名单来自运营提供的一份配置,程序把它当成完整的城市集合
    Set<String> directCities = cityConfig.getDirectCityCodes();
    List<Battery> overdue = batteryRepo.listOverdueNotReturned();

    for (Battery battery : overdue) {
        String city = battery.getCityCode();
        if (!directCities.contains(city)) {
            // 为什么错:名单少一个城市,这座城市的电池就整批被丢掉,
            // 且不记录、不计数,没有人能发现这里漏了一批
            continue;
        }
        recoveryOrderRepo.createIfAbsent(battery);  // 写找回工单
    }
}

// 资产侧展示:只看到期,不看城市名单
public List<Battery> listOverdueForConsole() {
    // 为什么错:这里不做同样的过滤,页面上有、工单里没有,两处结果相反
    return batteryRepo.listOverdueNotReturned();
}

修复代码示例

// 修复:名单按配置补全,名单外的城市不再静默丢弃
public void generateRecoveryOrders() {
    // 已确认的修复动作:在直营城市配置里补上漏掉的城市
    Set<String> directCities = cityConfig.getDirectCityCodes();
    List<Battery> overdue = batteryRepo.listOverdueNotReturned();
    Set<String> uncoveredCities = new HashSet<>();

    for (Battery battery : overdue) {
        String city = battery.getCityCode();
        if (!directCities.contains(city)) {
            // 先收集起来,不再直接丢弃
            uncoveredCities.add(city);
            continue;
        }
        recoveryOrderRepo.createIfAbsent(battery);
    }

    // 有到期未归还电池却不在名单内,说明名单和实际范围可能又不一致了
    if (!uncoveredCities.isEmpty()) {
        log.warn("城市不在直营名单内,未生成找回工单: {}", uncoveredCities);
    }
}

配置项的键名、名单的维护方式是示意;listOverdueNotReturned 的筛选条件和工单去重规则仍需按各业务约定细化。这段示例只处理“名单缺项要看得见”,不等于已经实施的修复。

下次遇到这些场景要警惕

  • 功能按城市、门店或业务线名单开放:上线前把名单和实际范围逐条对一遍,确认名单是完整集合,而不是某次口头同步的快照。
  • 新开城市或调整直营范围:随后跑一次识别,直接查该市到期未归还的电池有没有生成工单,不要只看台账页面上有没有数据。
  • 程序里出现“不在名单内就 continue”:给这条分支加计数或告警,让跳过变成看得见的数字;静默跳过等于把漏配藏起来。
  • 同一件事在两个系统各算一次:分别查展示侧和动作侧的口径,确认它们用的是同一套范围条件,避免一边显示待处理、一边没有可执行单据。