'use strict'; const MainService = require('../../main'); /** * 系统方法层:order.packing(打包任务接口包装层)。 * 主要职责:统一包装系统方法接口,处理权限、日志等公共逻辑,调用底层 service 实现业务功能。 * 注意:当前实现仅为包装层,实际业务逻辑完全依赖底层 service 的方法实现。 */ class OrderPackingMethodService extends MainService { constructor(ctx) { super(ctx); const _noNeedLogin = ''; const _noNeedRight = 'list,get'; const _noNeedLog = 'list,get'; const _noNeedAuth = 'list,get'; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } /** * 打包任务列表查询(仓库侧 system method 包装层)。 * 按仓库维度查询打包任务,支持分页、筛选、排序。 * * @param {Object} data 请求体 * @param {Object} [data.pagination] 分页参数 { page, pageSize } * @param {Object} [data.where] 筛选条件。 * 支持字段:status(任务状态)、pack_mode(打包模式)、waybill_code(运单号)、wave_no(波次号)、 * order_id(订单ID)、workbench_id(工作台ID)、quickWhere(快捷搜索:波次号直接匹配 + 运单号通过express→order→wave链路解析)、 * start_time(开始打包时间范围,{operator:'between', value:[start,end]})、end_time(结束打包时间范围)、create_time(创建时间范围); * start_time_start / start_time_end 为开始时间范围的兼容旧写法。 * @param {Object} [data.sort] 排序参数 { sortField, sortOrder } * @return {Promise} 统一成功包装响应 */ async list(data = {}) { const { service } = this; const { pagination, sort } = data; const { where } = this.prepareWhereContext(data, { specialFieldMap: { quickWhere: { bucket: 'quick', }, }, }); const result = await service.systems.orderPacking.list(where, pagination, sort); return this.success('ok', result); } /** * 打包任务详情查询(仓库侧 system method 包装层)。 * * @param {Object} data 请求体 * @param {number} data.id 打包任务ID * @return {Promise} 统一成功包装响应 */ async get(data = {}) { const { service } = this; const { id } = data; const result = await service.systems.orderPacking.get({ id }); return this.success('ok', result); } /** * 设置打包任务结束时间(仓库侧 system method 包装层)。 * 若任务状态不是已完成,则同步更新状态为已完成。 * 前端默认值逻辑:已有结束时间→当前时间;无结束时间→开始时间+5分钟。 * 结束时间超过仓库配置的打包最大时长上限时,自动截断为上限时间。 * * @param {Object} data 请求体 * @param {number} data.id 打包任务ID * @param {string} data.end_time 结束时间(ISO 8601 或日期字符串) * @return {Promise} 统一成功包装响应 */ async setEndTime(data = {}) { const { service } = this; const { id, end_time } = data; const result = await service.systems.orderPacking.setEndTime({ id, end_time }); return this.success('ok', result); } /** * 强制重新录制打包任务视频(仓库侧 system method 包装层)。 * 将该任务推送到录制电脑,通过打印服务触发重新录制。 * * @param {Object} data 请求体 * @param {number} data.id 打包任务ID * @return {Promise} 统一成功包装响应 */ async forceRecord(data = {}) { const { service } = this; const { id } = data; const result = await service.systems.orderPacking.forceRecord({ id }); return this.success('ok', result); } } module.exports = OrderPackingMethodService;