发生了什么

网点是面向用户换电的服务门店。柜里的电池不够时,运维要从别处把电池调进来,为此在系统里开一张调度工单:填网点、类目(这张工单调的是电池)、方向(调入或调出),再填开始时间和结束时间。工单建好后处于进行中,运维线下把电池搬到位,再到工单操作端把工单点完成。

工单下面挂调度记录。每调入一颗电池,就在这张工单上记一条,写明电池编号。运维的绩效按这些记录结算,用的唯一主键是“工单编号 + 电池编号”:同一张工单里的同一颗电池只算一次,换一张工单就另算一次。

原来的做法是反查。工单完成后约半小时,工单程序拿这张工单的运维、网点、开始时间和结束时间,去供应链系统查这个人在这个网点这段时间里的换电记录,查到几条就写几条调度记录。也就是说,时间窗在这套做法里承担了“这批电池归这张工单”的判断。

8 月下旬,手工创建调度工单的流程增加了电池类目,创建时的校验逻辑也跟着做了调整。此后同一网点可以连续创建多张同类目、时间互相重叠的进行中工单,创建环节没有拦下来。这次一名运维在同一网点建了 5 张同类目的调入工单,时间窗互相覆盖,实际只调入 2 颗电池,5 张工单都点了完成。

结果 5 张工单都查到了那 2 颗电池的换电记录,每张各写 2 条调度记录。绩效按工单编号加电池编号统计,得到 5 × 2 = 10 条单据,而实际调入只有 2 颗。

本质

问题不在换电记录本身,而在两处:创建工单时没有限制重叠,写调度记录时用了一个不能确定归属的条件。

  1. 调度记录是“这张工单执行了哪几次换电”的凭据。原流程用“运维 + 网点 + 时间窗”去反查,这个条件只能说明这段时间这个人在这个网点换过这些电池,不能说明这些电池是为哪张工单换的。
  2. 创建环节没有拦住同一网点同类目的第二张、第三张进行中工单。这次 5 张工单的开始和结束时间互相重叠,都处于进行中。
  3. 5 张工单完成时,程序分别用各自的时间窗去查换电记录。2 颗电池的换电时刻落在每一个时间窗内,所以 5 次查询返回的是同样的 2 条记录。
  4. 程序把查到的记录逐条写成“当前这张工单”的调度记录,没有核对这条换电记录是否已经属于另一张工单。于是一次换电事实被 5 张工单各记了一遍。
  5. 绩效统计的主键是工单编号 + 电池编号,跨工单不去重。5 张工单各 2 条,合计 10 条,数量被放大了 5 倍。

一句话概括:时间窗只能圈出一个范围,不能证明这批电池属于哪张工单;范围一重叠,同一批记录就被反复记账。

修复方向有两步。第一步补创建校验:网点已有进行中的该电池类目调入或调出工单时,不允许再手工创建,这样同一网点同类目在任一时刻只有一张进行中工单,后面的匹配才有唯一落点。第二步换掉调度记录的来源:不再在工单完成后回查换电记录,改为监听运维的取还电消息,按操作人、电池类目、网点匹配进行中的工单,把这次取还的电池记到对应工单上。记录把这两项列为已完成的处理方案,没有给出上线时间和验证结果,修复上线状态待确认;已经多记的调度记录和绩效单据如何处理,也没有交代。另外创建校验是先查再建,并发提交时两张工单仍可能同时通过,还需要唯一约束或锁兜底,记录没有说明是否加了。

下面两段 Java 为脱敏教学示例,用于对比“按时间窗反查”和“按消息匹配”,不代表实际项目源码或已上线实现。

错误代码

// 手工创建电池类目调度工单:只校验必填项,不看该网点是否已有进行中的同类目工单
public String createManualOrder(ManualOrderRequest req) {
    if (req.getSiteId() == null || req.getCategory() == null) {
        throw new BizException("参数缺失");
    }
    // 为什么错:没有拦住同网点同类目的进行中工单,5 张时间重叠的工单都建了出来
    return orderRepository.insert(Order.from(req, OrderStatus.RUNNING));
}

// 工单完成后,按运维 + 网点 + 时间窗回查换电记录,逐条写调度记录
public void fillDispatchRecords(String orderId) {
    Order order = orderRepository.get(orderId);
    List<SwapRecord> records = supplyChainClient.querySwapRecords(
            order.getOperatorId(), order.getSiteId(),
            order.getBeginTime(), order.getEndTime());
    // 为什么错:时间窗只是范围,同一批电池会被每张重叠工单各查一次
    for (SwapRecord record : records) {
        dispatchRepository.insert(orderId, record.getBatteryId());
    }
}

修复代码示例

// 修复一:创建前校验,同网点同类目已有进行中工单就不再允许建单
@Transactional
public String createManualOrder(ManualOrderRequest req) {
    boolean running = orderRepository.existsRunning(req.getSiteId(), req.getCategory());
    if (running) {
        throw new BizException("该网点此电池类目已有进行中的调度工单");
    }
    return orderRepository.insert(Order.from(req, OrderStatus.RUNNING));
}

// 修复二:改为消费取还电消息,按操作人 + 类目 + 网点落到唯一进行中工单
@MessageListener(topic = "battery.take-return")
public void onTakeReturn(TakeReturnMessage msg) {
    Order order = orderRepository.findRunning(
            msg.getOperatorId(), msg.getSiteId(), msg.getCategory());
    if (order == null) {
        return; // 没有对应工单的取还电不记账
    }
    dispatchRepository.insertIfAbsent(order.getId(), msg.getBatteryId()); // 同一工单同一颗电池只记一次
}

下次遇到这些场景要警惕

  • 给手工建单增加新类目或调整创建校验时:先定下“同网点同类目最多允许几张进行中工单”,再用同一网点、同一类目连续建两张时间重叠的工单,确认第二张被拦住,而不是两张都进入进行中。
  • 用“人 + 地点 + 时间段”这类范围条件把外部流水挂到业务单据上时:造两张时间窗重叠的单据并各完成一次,看同一批流水是否被两边都记上;只有能对上唯一凭据(例如一次取还电事件)才适合直接记账。
  • 绩效或结算按“单据编号 + 资源编号”统计时:拿实际资源数乘单据数核对总数,确认跨单据不会重复计数;总数对不上要回查归属规则,而不是只调统计口径。
  • 把回查改成消息监听后:补一条没有对应工单的取还电消息,确认它被丢弃而不是记到别的工单上;再补一条重复投递的消息,确认同一工单同一颗电池只有一条记录。