'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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ async completeReceiving(data) { const { service } = this; const result = await service.systems.storage.receiving.completeReceiving(data); return this.success('ok', result); } } module.exports = configService;