2026-05-17 21:51:46 +08:00

264 lines
8.7 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');
/**
* 系统方法层: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';
const _noNeedLog = 'getReceivingList,get,addDetail,deleteDetail,detailChange,bindStore,bindDetailProduct,queryReceivingLogs';
const _noNeedAuth = 'getReceivingList,get,addDetail,deleteDetail,detailChange,cancel,completeReceiving,bindStore,bindDetailProduct,rejectReceiving,reviewReceiving,queryReceivingLogs';
this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth);
}
/**
* 收货单列表查询(system method 包装层)。
* @param {Object} data 请求体
* @param {Object} [data.pagination] 分页参数
* @param {Object} [data.where] 筛选条件
* @return {Promise<Object>} 统一成功包装响应
*/
async getReceivingList(data) {
const { service } = this;
const { pagination, sort } = data;
const { where } = this.prepareWhereContext(data, {
specialFieldMap: {
quickWhere: {
bucket: 'quick',
},
},
});
const result = await service.systems.storage.receiving.getReceivingList(where, pagination, sort);
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,
});
}
}
module.exports = configService;