发生了什么

门店是线下提供服务的点位。客户可以先在用户端小程序里下单,订单代表客户要在某家门店完成的一次履约;门店在后台看到这笔订单,履约完成后点“核销”,表示这一次已经结束。要让这条链路成立,订单上除了客户和订单内容,还必须记清楚“这笔单由哪家门店履约”。门店后台的待核销列表和核销操作,都是按这家门店来找单的。

正常流程是:客户在小程序里选门店和内容下单,订单落库时带上这家门店;门店按本门店查待核销订单,列表里出现这笔单;客户到店,店员核对后核销,这笔单就算履约完成。门店、订单、核销是一条线:订单上没有门店,门店就不知道该核销哪一笔。

这次客户说已经下过单,门店在自己的后台里却查不到,第一反应是这笔单被相邻门店核销了。排查后发现,订单确实已经生成,问题是订单的门店字段是空的:客户用的这个下单入口,从提交到落库都没有带门店信息。订单不属于任何一家门店,门店后台按门店取数,在哪一家都看不到,也就无法核销。

记录只有这一家门店的反馈,没有说明有多少笔订单这样、涉及多少门店。临时处理是让客户按当前城市重新下一单。

本质

一句话:订单在创建时没有写入门店归属,门店后台只按门店归属取数,空归属的订单不属于任何门店,因此所有门店都查不到,也没法核销。

  1. 订单的归属门店只有一个写入点:下单。客户在小程序提交后,下单程序生成订单,写入客户、城市和订单内容,门店字段留空。这个入口的产品流程里就没有“选门店、定门店”这一步,不是某次改动把参数传丢了。
  2. 门店后台的待核销列表按当前登录门店过滤,只取门店字段等于本门店的订单。这是门店日常取数的正常口径,过滤条件本身没有写错。
  3. 订单的门店为空,“等于本门店”这个条件永远不成立,这笔单不出现在任何门店的结果集里。门店看到的“没有”,实际是“不属于我”,两个不同的结论被同一个空列表盖住了。
  4. 门店要核销只能从列表进入,列表里没有这笔单,就没有可核销的对象。客户侧的下单记录是存在的,所以从用户端看不出异常,只有门店这一端断了。
  5. 让客户重新下单,只是把这一笔重新走一遍入口;如果入口仍然不带门店,同样的单还会再产生。

下单成功不等于门店能履约:订单缺了归属门店,它在每一家门店的后台里都不存在。

修复方向是两头对齐:下单时确定门店归属,客户没选就按城市落到默认服务门店,落不出来就拦住下单并提示;在补齐之前,门店后台要能按城市或客户信息查到这批无归属订单,由门店认领并回填门店后再核销。存量无归属订单也要单独筛出来补归属。记录里提到门店后台的交互优化排在后续迭代,具体实现和上线状态待确认。

错误代码

// 下单:小程序只提交客户、城市和订单内容,门店字段始终为空
public Order createOrder(CreateOrderCmd cmd) {
    Order order = new Order();
    order.setUserId(cmd.getUserId());
    order.setCityId(cmd.getCityId());
    order.setItemId(cmd.getItemId());
    // 为什么错:这个入口的产品流程里没有采集门店,
    // 订单从创建起就不属于任何一家门店
    order.setStoreId(null);
    orderRepository.save(order);
    return order;
}

// 门店后台:待核销列表只按本门店取数
public List<Order> listPendingRedeem(Long storeId) {
    // 为什么错:store_id 为空的订单不满足等值条件,
    // 不会出现在任何一家门店的列表里
    return orderRepository.findByStoreIdAndStatus(storeId, PENDING_REDEEM);
}

修复代码示例

// 修复一:下单时确定门店归属,客户选的门店优先,否则按城市取默认服务门店
public Order createOrder(CreateOrderCmd cmd) {
    Long storeId = cmd.getStoreId() != null
            ? cmd.getStoreId()
            : storeResolver.defaultStoreOf(cmd.getCityId());
    if (storeId == null) {
        // 归不出门店就不放行,避免再产生无归属订单
        throw new BizException("当前城市暂无可用门店,请选择门店后再下单");
    }
    Order order = new Order();
    order.setUserId(cmd.getUserId());
    order.setCityId(cmd.getCityId());
    order.setItemId(cmd.getItemId());
    order.setStoreId(storeId);          // 修复:门店归属随订单一起落库
    orderRepository.save(order);
    return order;
}

// 修复二:门店后台补入口,让无归属订单能被本城市门店认领
public void claim(Long orderId, Long storeId, Long cityId) {
    // 条件更新:门店为空才写入,避免两家门店同时认领同一笔单
    if (orderRepository.bindStoreIfAbsent(orderId, storeId, cityId) == 0) {
        throw new BizException("订单已归属其他门店或不属于当前城市");
    }
}

下次遇到这些场景要警惕

  • 新增下单入口或渠道:先列出订单落库必须带的归属字段,比如门店、城市、商户,逐项确认这个入口都能取到值;再用一笔真实订单在门店后台按门店查一次,不要只看下单接口返回成功。
  • 门店反馈“后台看不到订单”:先按订单号或客户信息查订单记录,确认归属字段是不是空的,再判断是权限、缓存还是被其他门店处理了;这三种原因的处置完全不同。
  • 按归属维度取数的列表:给空归属单独留一个兜底入口或视图,不要让“没有”和“不属于我”共用同一个空结果,否则漏单只能等用户投诉才发现。
  • 临时让用户重下单:确认重下之后订单确实落到了门店,并清点存量无归属订单怎么补归属、补完是否影响已经核销的记录。