WMS_MAIN/app/lib/lock_guard.js
liufumingren 3817948b35 feat(order): 锁定订单作业门禁与订单列表 lock_status 转 Y/N
- lock_guard: 新增 isLockedOrderStatus,lock_status 非 none 一律视为已锁定
- 储位分配(allocatePicking)跳过锁定订单,skipped_reason=locked
- 快递分配(createWaybillCodePipeline、wave.batchAllocateExpress)跳过锁定订单并返回 skipped_locked_order_ids
- 抓取波次 singleFetchByIds 排除锁定订单并返回 excluded_locked_order_ids
- 自动加团(delivery_order)锁定订单跳过自动分配快递/储位/自动加团
- 订单列表 normalizeOrderListItem 统一 lock_status 输出 Y/N(none→N,其余→Y)
- 同步 methods/system.json、methods/changes/system.json 文档
2026-08-18 16:25:12 +08:00

30 lines
988 B
JavaScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
/**
* 订单锁定状态共享定义。
*
* wms_order_delivery.lock_status 枚举(order_delivery.js / order_delivery_factory.js)实际取值为:
* none / warehouse / store。
*
* 业务约定:锁定状态只要不是 'none'(即被仓库或货主锁定的订单),一律视为"已锁定",
* 禁止继续执行仓储作业(分配储位/分配快递/抓取波次/自动加团等),
* 已锁定订单一律跳过。
*/
const LOCK_STATUS_NONE = 'none';
/**
* 判断订单锁定状态是否属于"已锁定"。
* 空值/NULL 归一化为 none 处理;除此之外任何非 none 状态(含 warehouse/store)均视为已锁定。
* @param {*} status 锁定状态值。
* @return {boolean} 是否已锁定。
*/
function isLockedOrderStatus(status) {
const normalizedStatus = String(status || '').trim() || LOCK_STATUS_NONE;
return normalizedStatus !== LOCK_STATUS_NONE;
}
module.exports = {
LOCK_STATUS_NONE,
isLockedOrderStatus,
};