WMS_MAIN/app/schedule/auto_outbound_order.js
liufumingren fdec622f2d feat(auto-outbound): 自动出库改为「开关 + 规则数组」,支持多条规则与跨天放行
- subject_config 新增 auto_outbound_enabled(默认 false);auto_outbound_rules 由对象改为数组,
  每项仅含 require_pack / require_weigh / require_sync / exclude_same_day_outbound /
  same_day_outbound_deadline_time / same_day_outbound_release_time
- 固定基线:已复核(recheck_status=fin)+ 已分配储位(storage_status=fin);已打印、已拣货不再校验
- 规则内 AND、规则间 OR(任一命中即出库);空数组不出库且不告警
- 旧对象结构不再兼容:读路径按默认(关闭)处理,写路径返回 400 提示重新配置
- 放行时间支持跨天 00:00~47:59(27:00 = 次日 03:00);按订单复核时间所在北京日计算未放行窗口
- 定时任务与手动触发统一走新规则;自动出库写入操作日志 ORDER_AUTO_OUTBOUND
- 同步 methods/system.json、methods/changes/system.json 与 AI_METHOD_ROUTING.md

涉及接口:setting.warehouse.getSettings / getFieldMeta / saveSettings、outbound.autoOutbound
2026-10-16 05:27:30 +08:00

60 lines
2.2 KiB
JavaScript
Raw 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';
/**
* 自动化出库定时任务。
* 每分钟在单 worker 中扫描一次:当订单满足仓库配置的自动化出库规则时,
* 自动标记出库并将订单状态更新为已完成,同时写入订单操作日志(ORDER_AUTO_OUTBOUND)。
*
* 开关与规则(仓库 subject_config):
* - auto_outbound_enabled:是否启用,默认 false(关闭);
* - auto_outbound_rules:规则数组(空数组时不自动出库),每项规则独立判断,任一命中即出库。
*
* 固定基线条件:已复核(recheck_status='fin')+ 已分配储位(storage_status='fin'),
* 未复核订单一律不自动出库。
*
* 单条规则可选条件(仅校验这三项):
* 1. 已打包:pack_status = 'fin'(require_pack)
* 2. 已称重:wms_order_express.weighing_weight > 0(require_weigh)
* 3. 已同步:sync_status = 'fin'(require_sync)
*
* 当天订单限制(exclude_same_day_outbound,默认 true,按规则独立生效):
* 开启时,在当天放开时间(same_day_outbound_release_time,默认北京时间 22:00)前,
* 北京时间当天「允许当天出库最后时间」(same_day_outbound_deadline_time,默认 06:00)
* 起复核(recheck_time)的订单不自动出库;
* 到达放开时间后当天复核订单恢复自动出库。关闭则全程不受限制。
*/
module.exports = {
schedule: {
interval: '1m',
type: 'worker',
immediate: false,
disable: false,
},
/**
* 执行自动化出库任务。
*
* @param {Object} ctx Egg 上下文。
* @return {Promise<void>} 无返回值。
*/
async task(ctx) {
if (ctx.app._autoOutboundRunning) {
return;
}
ctx.app._autoOutboundRunning = true;
try {
const result = await ctx.service.systems.orderAutoOutbound.executeAutoOutbound();
ctx.logger.info(
`[auto-outbound-order] 本轮自动化出库完成,共处理 ${result && result.totalProcessed || 0} 条订单`
);
} catch (error) {
ctx.logger.error(`[auto-outbound-order] 自动化出库任务执行失败: ${error.message}`);
} finally {
ctx.app._autoOutboundRunning = false;
}
},
};