diff --git a/app/model/store.js b/app/model/store.js index 089a1e5..57cd65c 100644 --- a/app/model/store.js +++ b/app/model/store.js @@ -39,7 +39,7 @@ module.exports = app => { require_sync: true, require_print: true, require_pick: true, - allow_same_day_outbound: false, + exclude_same_day_outbound: true, same_day_outbound_deadline_time: '06:00', same_day_outbound_release_time: '22:00', }); @@ -269,7 +269,7 @@ module.exports = app => { require_sync: parsed.require_sync !== false, require_print: parsed.require_print !== false, require_pick: parsed.require_pick !== false, - allow_same_day_outbound: normalizeBooleanFlag(parsed.allow_same_day_outbound, 'auto_outbound_rules.allow_same_day_outbound') === true, + exclude_same_day_outbound: normalizeBooleanFlag(parsed.exclude_same_day_outbound, 'auto_outbound_rules.exclude_same_day_outbound') !== false, same_day_outbound_deadline_time: sameDayOutboundDeadlineTime, same_day_outbound_release_time: sameDayOutboundReleaseTime, }; diff --git a/app/schedule/auto_outbound_order.js b/app/schedule/auto_outbound_order.js index 5a20f1e..da7c38a 100644 --- a/app/schedule/auto_outbound_order.js +++ b/app/schedule/auto_outbound_order.js @@ -15,11 +15,11 @@ * * 各条件是否必须可由仓库配置独立控制。 * - * 当天订单限制(allow_same_day_outbound,默认 false): - * 未开启时,在当天放开时间(same_day_outbound_release_time,默认北京时间 22:00)前, + * 当天订单限制(exclude_same_day_outbound,默认 true): + * 开启时,在当天放开时间(same_day_outbound_release_time,默认北京时间 22:00)前, * 北京时间当天「允许当天出库最后时间」(same_day_outbound_deadline_time,默认 06:00) * 起复核(recheck_time)的订单不自动出库; - * 到达放开时间后当天复核订单恢复自动出库。开启则全程不受限制。 + * 到达放开时间后当天复核订单恢复自动出库。关闭则全程不受限制。 */ module.exports = { schedule: { diff --git a/app/service/systems/order_auto_outbound.js b/app/service/systems/order_auto_outbound.js index 8bcbf44..eeb3342 100644 --- a/app/service/systems/order_auto_outbound.js +++ b/app/service/systems/order_auto_outbound.js @@ -117,15 +117,15 @@ class OrderAutoOutboundService extends MainService { * - {boolean} [rules.require_sync] 是否要求已同步(sync_status='fin') * - {boolean} [rules.require_print] 是否要求已打印(print_status='fin') * - {boolean} [rules.require_pick] 是否要求已拣货(pick_status='fin') - * - {boolean} [rules.allow_same_day_outbound] 是否允许当天复核订单当天出库(默认 false); - * 为 false 时,在到达当天放开时间(same_day_outbound_release_time,默认北京时间 22:00)前, + * - {boolean} [rules.exclude_same_day_outbound] 是否不出库当天复核订单(默认 true); + * 为 true 时,在到达当天放开时间(same_day_outbound_release_time,默认北京时间 22:00)前, * 北京时间当天「允许当天出库最后时间」(same_day_outbound_deadline_time,默认 06:00)起复核(recheck_time)的订单当天不参与自动出库; * recheck_time 早于该最后时间或为 null 的订单不受影响; * 到达放开时间后当天复核订单恢复自动出库。 * - {string} [rules.same_day_outbound_deadline_time] 允许当天出库最后时间(HH:mm,默认 '06:00'), - * 复核时间早于该时间的订单不受「出库当天订单」关闭的影响。 + * 复核时间早于该时间的订单不受「不出库当天订单」开启的影响。 * - {string} [rules.same_day_outbound_release_time] 当天放开时间(HH:mm,默认 '22:00'), - * 仅在 allow_same_day_outbound 为 false 时生效。 + * 仅在 exclude_same_day_outbound 为 true 时生效。 * @return {Object} Sequelize where 条件对象。 */ buildAutoOutboundWhere(rules) { @@ -141,11 +141,11 @@ class OrderAutoOutboundService extends MainService { where.recheck_status = 'fin'; } - // 未开启「出库当天订单」时:当天到达放开时间(默认北京时间 22:00)前, + // 开启「不出库当天订单」(默认开启)时:当天到达放开时间(默认北京时间 22:00)前, // 排除当天「允许当天出库最后时间」(默认 06:00)起复核的订单(recheck_time 为 null 不排除); // 到达放开时间后不再限制当天复核订单,当天即可出库。 // 注意:应用按 UTC 读写 DATETIME,recheck_time 存储为 UTC 时刻,边界需按北京时间(UTC+8)换算。 - if (rules.allow_same_day_outbound !== true) { + if (rules.exclude_same_day_outbound !== false) { const now = new Date(); const releaseUtc = this.buildSameDayReleaseUtc(now, rules.same_day_outbound_release_time); if (now.getTime() < releaseUtc.getTime()) { @@ -223,7 +223,7 @@ class OrderAutoOutboundService extends MainService { * 计算「允许当天出库最后时间」边界(UTC 时刻)。 * * 边界为北京时间当天配置时刻(默认 06:00,UTC+8): - * - recheck_time(UTC 存储)早于该边界 → 不受「出库当天订单」关闭影响,当天允许自动出库; + * - recheck_time(UTC 存储)早于该边界 → 不受「不出库当天订单」开启影响,当天允许自动出库; * - recheck_time 晚于或等于该边界 → 在到达当天放开时间前不自动出库, * 到达放开时间(默认 22:00)后放开。 * @@ -274,8 +274,8 @@ class OrderAutoOutboundService extends MainService { /** * 计算北京时间当天「放开时间」对应的 UTC Date。 * - * 仅在未开启「出库当天订单」时使用:当前时刻早于该边界时, - * 当天 06:00 后复核的订单不自动出库;晚于或等于该边界时放开。 + * 仅在开启「不出库当天订单」时使用:当前时刻早于该边界时, + * 当天最后时间之后复核的订单不自动出库;晚于或等于该边界时放开。 * * @param {Date} [now] 当前时刻(默认 new Date())。 * @param {string} [timeText] 放开时间(HH:mm,默认 22:00)。 diff --git a/app/service/systems/setting/warehouse.js b/app/service/systems/setting/warehouse.js index 677d997..0fc89c2 100644 --- a/app/service/systems/setting/warehouse.js +++ b/app/service/systems/setting/warehouse.js @@ -226,7 +226,7 @@ const WAREHOUSE_SETTING_FIELDS = Object.freeze([ key: 'auto_outbound_rules', name: '自动出库规则', type: 'object', - default: Object.freeze({ enabled: false, require_recheck: true, require_pack: true, require_weigh: true, require_sync: true, require_print: true, require_pick: true, allow_same_day_outbound: false, same_day_outbound_deadline_time: '06:00', same_day_outbound_release_time: '22:00' }), + default: Object.freeze({ enabled: false, require_recheck: true, require_pack: true, require_weigh: true, require_sync: true, require_print: true, require_pick: true, exclude_same_day_outbound: true, same_day_outbound_deadline_time: '06:00', same_day_outbound_release_time: '22:00' }), required: false, description: '满足条件自动标记出库。全部条件满足时自动标记待出库', item_keys: Object.freeze([ @@ -237,9 +237,9 @@ const WAREHOUSE_SETTING_FIELDS = Object.freeze([ Object.freeze({ key: 'require_sync', name: '需已同步', type: 'flag', required: false, description: '是否要求 sync_status=fin' }), Object.freeze({ key: 'require_print', name: '需已打印', type: 'flag', required: false, description: '是否要求 print_status=fin' }), Object.freeze({ key: 'require_pick', name: '需已拣货', type: 'flag', required: false, description: '是否要求 pick_status=fin' }), - Object.freeze({ key: 'allow_same_day_outbound', name: '出库当天订单', type: 'flag', required: false, description: '是否允许当天复核的订单当天自动出库' }), - Object.freeze({ key: 'same_day_outbound_deadline_time', name: '允许当天出库最后时间', type: 'string', required: false, default: '06:00', maxLength: 5, min: '00:00', max: '23:59', description: '复核时间早于该时间的订单不受「出库当天订单」关闭的影响,格式 HH:mm,不能大于当天放开时间' }), - Object.freeze({ key: 'same_day_outbound_release_time', name: '当天放开时间', type: 'string', required: false, default: '22:00', maxLength: 5, min: '00:00', max: '23:59', description: '未开启「出库当天订单」时,当天到达该时间后不再限制当天复核订单的自动出库,格式 HH:mm' }), + Object.freeze({ key: 'exclude_same_day_outbound', name: '不出库当天订单', type: 'flag', required: false, default: true, description: '开启后,在当天放开时间前,「允许当天出库最后时间」之后复核的订单不自动出库,到达当天放开时间后恢复' }), + Object.freeze({ key: 'same_day_outbound_deadline_time', name: '允许当天出库最后时间', type: 'string', required: false, default: '06:00', maxLength: 5, min: '00:00', max: '23:59', description: '复核时间早于该时间的订单不受「不出库当天订单」开启的影响,格式 HH:mm,不能大于当天放开时间' }), + Object.freeze({ key: 'same_day_outbound_release_time', name: '当天放开时间', type: 'string', required: false, default: '22:00', maxLength: 5, min: '00:00', max: '23:59', description: '开启「不出库当天订单」时,当天到达该时间后不再限制当天复核订单的自动出库,格式 HH:mm' }), ]), }), Object.freeze({