- 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
60 lines
2.2 KiB
JavaScript
60 lines
2.2 KiB
JavaScript
'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;
|
||
}
|
||
},
|
||
};
|