211 lines
6.8 KiB
JavaScript
211 lines
6.8 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';
|
||
const _noNeedLog = 'getReceivingList,get,addDetail,deleteDetail,detailChange,bindStore,bindDetailProduct';
|
||
const _noNeedAuth = 'getReceivingList,get,addDetail,deleteDetail,detailChange,cancel,completeReceiving,bindStore,bindDetailProduct';
|
||
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 saveReceiving(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.storage.receiving.saveReceiving(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);
|
||
}
|
||
|
||
/**
|
||
* 新增一条收货明细(默认空模板)。
|
||
* @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);
|
||
}
|
||
}
|
||
module.exports = configService;
|