97 lines
3.8 KiB
JavaScript
97 lines
3.8 KiB
JavaScript
'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<Object>} 统一成功包装响应
|
||
*/
|
||
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<Object>} 统一成功包装响应
|
||
*/
|
||
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<Object>} 统一成功包装响应
|
||
*/
|
||
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<Object>} 统一成功包装响应
|
||
*/
|
||
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;
|