liufumingren aedd815e17 feat(order.packing): 新增打包任务模块 list/get/setEndTime/forceRecord 方法及视频 CDN URL 拼接
- 新增 order.packing.list: 打包任务列表查询,支持分页/筛选/排序,关联工作台/视频/运单

- 新增 order.packing.get: 打包任务详情查询

- 新增 order.packing.setEndTime: 设置结束时间,未完成任务自动标记为已完成

- 新增 order.packing.forceRecord: 强制重新录制,推送打印服务

- pack_task_video Model status 从 TINYINT 改为 STRING(20) 匹配 DB ENUM

- 视频 URL 拼接 CDN 前缀: http://w{warehouseId}-c{computerId}.o.gztbyc.com{videoPath}

- 录制电脑从 wms_print_computer(is_recording=true) + Redis 在线校验获取

- 更新 methods/system.json 与 methods/changes/system.json 文档
2026-07-27 03:41:24 +08:00

95 lines
3.5 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';
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_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;