'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} 统一成功包装响应 */ 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 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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); } /** * 驳回收货单:将已完成收货单恢复为收货中,记录审核人信息与驳回理由。 * @param {Object} data 请求体 * @param {number[]} data.ids 收货单ID数组 * @param {string} [data.remark] 驳回理由(覆盖原备注) * @return {Promise} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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} 统一成功包装响应 */ 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;