285 lines
9.9 KiB
JavaScript
285 lines
9.9 KiB
JavaScript
'use strict';
|
||
|
||
const MainService = require('../../main');
|
||
/**
|
||
* 系统方法层:storage.receiving(收货单相关接口包装层)。
|
||
* 主要职责:统一包装系统方法接口,处理权限、日志等公共逻辑,调用底层 service 实现业务功能。
|
||
* 注意:当前实现仅为包装层,实际业务逻辑完全依赖底层 service 的方法实现。
|
||
*/
|
||
class configService extends MainService {
|
||
constructor(ctx) {
|
||
super(ctx);
|
||
const _noNeedLogin = '';
|
||
const _noNeedRight = 'getReceivingList,get,addDetail,deleteDetail,detailChange,cancel,completeReceiving,bindStore,bindDetailProduct,rejectReceiving,reviewReceiving,queryReceivingLogs,scanDetail';
|
||
const _noNeedLog = 'getReceivingList,get,addDetail,deleteDetail,detailChange,bindStore,bindDetailProduct,queryReceivingLogs,scanDetail';
|
||
const _noNeedAuth = 'getReceivingList,get,addDetail,deleteDetail,detailChange,cancel,completeReceiving,bindStore,bindDetailProduct,rejectReceiving,reviewReceiving,queryReceivingLogs,scanDetail';
|
||
this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth);
|
||
}
|
||
|
||
/**
|
||
* 收货单列表查询(system method 包装层)。
|
||
* @param {Object} data 请求体
|
||
* @param {Object} [data.pagination] 分页参数
|
||
* @param {Object} [data.where] 筛选条件
|
||
* @param {boolean} [data.filterDepleted=false] 是否过滤掉无可再用量的收货单(所有明细已被其他入库单 committed 绑定占满)
|
||
* @param {number} [data.entry_order_id] 可选,按入库单商品交集过滤:只返回"至少有一条明细的 system_product_id 在入库单明细中"的收货单
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async getReceivingList(data) {
|
||
const { service } = this;
|
||
const { pagination, sort, filterDepleted = false, entry_order_id: entryOrderId } = data;
|
||
const { where } = this.prepareWhereContext(data, {
|
||
specialFieldMap: {
|
||
quickWhere: {
|
||
bucket: 'quick',
|
||
},
|
||
},
|
||
});
|
||
const result = await service.systems.storage.receiving.getReceivingList(where, pagination, sort, { filterDepleted, entry_order_id: entryOrderId });
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 收货单详情查询(分页返回明细)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 收货单ID
|
||
* @param {Object} data.pagination 明细分页参数
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async getReceivingDetail(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.getReceivingDetail(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 批量作废收货单。
|
||
* @param {Object} data 请求体
|
||
* @param {number[]} data.ids 收货单ID数组
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async batchCancelReceiving(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.batchCancelReceiving(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 创建收货单。
|
||
* @param {Object} data 请求体
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async create(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.create(data);
|
||
return this.success('创建失败', result);
|
||
}
|
||
|
||
/**
|
||
* 绑定收货单货主。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 收货单ID
|
||
* @param {number} data.store_id 货主ID
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async bindStore(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.bindStore(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 绑定或改绑收货单明细商品。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.detail_id 收货单明细ID
|
||
* @param {number} data.system_product_id 商品ID
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async bindDetailProduct(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.bindDetailProduct(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 添加收货商品(当前依赖底层 addItem 实现)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 收货单ID
|
||
* @param {Object} data.item 商品信息
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async addItem(data) {
|
||
const { service } = this;
|
||
const { id, item } = data;
|
||
const result = await service.systems.storage.receiving.addItem(id, item);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 删除收货商品(当前依赖底层 removeItem 实现)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 收货单ID
|
||
* @param {number} data.item_id 商品明细ID
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async removeItem(data) {
|
||
const { service } = this;
|
||
const { id, item_id } = data;
|
||
const result = await service.systems.storage.receiving.removeItem(id, item_id);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 保存收货单。
|
||
* @param {Object} data 请求体
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async save(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.save(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 查询收货单完整信息(含明细与图片)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 收货单ID
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async get(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.get(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 新增一条收货明细(支持可选 item)。
|
||
* @param {Object} data 请求体
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async addDetail(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.addDetail(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 删除收货明细。
|
||
* @param {Object} data 请求体
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async deleteDetail(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.deleteDetail(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 修改收货明细字段。
|
||
* @param {Object} data 请求体
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async detailChange(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.detailChange(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 作废收货单(单条)。
|
||
* @param {Object} data 请求体
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async cancel(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.invalid(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 完成收货单并触发入库处理。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 收货单ID
|
||
* @param {string} [data.remark] 完成备注
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async completeReceiving(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.completeReceiving(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 驳回收货单:将已完成收货单恢复为收货中,记录审核人信息与驳回理由。
|
||
* @param {Object} data 请求体
|
||
* @param {number[]} data.ids 收货单ID数组
|
||
* @param {string} [data.remark] 驳回理由(覆盖原备注)
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async rejectReceiving(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.rejectReceiving(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 批量审核收货单。
|
||
* @param {Object} data 请求体
|
||
* @param {number[]} data.ids 收货单ID数组
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async reviewReceiving(data) {
|
||
const { service } = this;
|
||
const { ids } = data || {};
|
||
const result = await service.systems.storage.receiving.reviewReceiving({ ids });
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 查询收货单操作日志(分页)。
|
||
* @param {Object} data 请求体
|
||
* @param {number|string} data.receiving_id 收货单ID
|
||
* @param {Object} [data.pagination] 分页对象,支持 page/pageSize
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async queryReceivingLogs(data = {}) {
|
||
const { ctx, service } = this;
|
||
const requestData = data && typeof data === 'object' ? data : {};
|
||
const pagination = requestData.pagination && typeof requestData.pagination === 'object'
|
||
? requestData.pagination
|
||
: {};
|
||
|
||
const result = await service.systems.operationLog.queryReceivingLogs({
|
||
id: requestData.receiving_id,
|
||
page: pagination.page,
|
||
pageSize: pagination.pageSize || pagination.page_size,
|
||
warehouseId: ctx.user.store_id,
|
||
});
|
||
|
||
return this.success('ok', {
|
||
data: result,
|
||
code: 200,
|
||
});
|
||
}
|
||
|
||
/**
|
||
* PDA 扫码定位收货明细(system method 包装层),返回匹配的明细列表。
|
||
* 同一条码可能匹配到多条收货明细,以列表形式返回所有匹配结果。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.entry_order_id 入库单ID
|
||
* @param {string} data.barcode 扫描条码(商品条码/箱唛/托盘唛/明细ID)
|
||
* @return {Promise<Object>} 统一成功包装响应,含匹配的收货明细列表 { list, total }
|
||
*/
|
||
async scanDetail(data) {
|
||
const { service } = this;
|
||
const { entry_order_id, barcode } = data;
|
||
const result = await service.systems.storage.receiving.scanDetail(entry_order_id, barcode);
|
||
if (result.code !== 200) {
|
||
return this.fail(result.message);
|
||
}
|
||
return this.success('查询成功', result.data);
|
||
}
|
||
|
||
}
|
||
module.exports = configService;
|