'use strict'; const MainService = require('../../main'); /** * 系统方法层:storage.entry(入库单相关接口包装层)。 * 主要职责:统一包装系统方法接口,处理权限、日志等公共逻辑,调用底层 service 实现业务功能。 * 注意:当前实现仅为包装层,实际业务逻辑完全依赖底层 service 的方法实现。 */ class entryService extends MainService { constructor(ctx) { super(ctx); const _noNeedLogin = ''; const _noNeedRight = 'list,get,cancel,getPrintData,getDirectInboundItems,addDirectInboundItem,commitDirectInbound,removeDirectInboundItem,quickInbound,receivingCompare,queryEntryLogs,getReceivingDetailsForBind,reviewEntry,containerList'; const _noNeedLog = 'list,get,getPrintData,reviewEntry,containerList'; const _noNeedAuth = 'list,get,cancel,getPrintData,getDirectInboundItems,addDirectInboundItem,commitDirectInbound,removeDirectInboundItem,bindReceiving,quickInbound,receivingCompare,unbindReceiving,queryEntryLogs,getReceivingDetailsForBind,reviewEntry,containerList'; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } /** * 入库单列表查询。 * @param {Object} data 请求体 * @param {Object} [data.pagination] 分页参数 * @param {Object} [data.where] 动态筛选条件 * @param {Object} [data.sort] 排序参数 * @return {Promise} 统一 success 包装 */ async list(data = {}) { const { service } = this; const { pagination, sort } = data; const { where } = this.prepareWhereContext(data, { specialFieldMap: { quickWhere: { bucket: 'quick', }, }, }); const result = await service.systems.storage.entry.list(where, pagination, sort); return this.success('ok', result); } /** * 查询入库单详情。 * @param {Object} data 请求体 * @param {number} [data.id] 入库单ID * @param {string} [data.entry_order_code] 入库单号 * @return {Promise} 统一 success 包装 */ async get(data = {}) { const { service } = this; const result = await service.systems.storage.entry.get(data); return this.success('ok', result); } /** * 作废入库单。 * 支持传入单个 id 或批量 ids,保持透传给业务层处理。 * @param {Object} data 请求体 * @param {number} [data.id] 单个入库单ID * @param {number[]} [data.ids] 批量入库单ID数组 * @return {Promise} 统一 success 包装 */ async cancel(data = {}) { const { service } = this; const result = await service.systems.storage.entry.cancel(data); return this.success('ok', result); } /** * 获取入库单的导入/PDA 直接入库信息(从 storage.entry 模块暴露)。 * @param {Object} data 请求体 * @param {string} data.entry_order_code 入库单号 * @return {Promise} 统一 success 包装 */ async getDirectInboundItems(data = {}) { const { service } = this; const { entry_order_code } = data || {}; const result = await service.systems.inboundDirectLog.getItems(entry_order_code); return this.success('ok', result); } /** * 按商品增量添加导入/PDA 直接入库记录(从 storage.entry 模块暴露)。 * @param {Object} data 请求体 * @param {string} data.entry_order_code 入库单号 * @param {number} [data.stock_id] 商品SKU ID(单条模式) * @param {number} [data.quantity] 本次入库数量(单条模式) * @param {string} [data.inbound_type] 入库方式(单条模式) * @param {Array} [data.items] 商品列表(批量模式) * @return {Promise} 统一 success 包装 */ async addDirectInboundItem(data = {}) { const { service } = this; const result = await service.systems.inboundDirectLog.addItem(data); return this.success('ok', result); } /** * 提交确认完成导入/PDA 直接入库(从 storage.entry 模块暴露)。 * @param {Object} data 请求体 * @param {number} data.entry_order_id 入库单 ID * @return {Promise} 统一 success 包装 */ async commitDirectInbound(data = {}) { const { service } = this; const { entry_order_id } = data || {}; const result = await service.systems.inboundDirectLog.commit(entry_order_id); return this.success('ok', result); } /** * 移除一条导入/PDA 直接入库记录(从 storage.entry 模块暴露)。 * @param {Object} data 请求体 * @param {number} data.id 入库记录ID * @return {Promise} 统一 success 包装 */ async removeDirectInboundItem(data = {}) { const { service } = this; const result = await service.systems.inboundDirectLog.removeItem(data); return this.success('ok', result); } /** * 绑定入库单与收货单的主表关系(仅主表绑定,不做明细分配)。 * @param {Object} data 请求体 * @param {number} data.entry_order_id 入库单 ID * @param {number[]} data.receiving_ids 收货单 ID 列表 * @return {Promise} 统一 success 包装 */ async bindReceiving(data = {}) { const { ctx } = this; console.log('[DEBUG] systems keys:', Object.keys(ctx.service.systems)); console.log('[DEBUG] receiving_entry_match:', typeof ctx.service.systems.receivingEntryMatch); const { entry_order_id, receiving_ids } = data || {}; const creator_id = ctx.user ? ctx.user.id || ctx.user.user_id : undefined; const result = await ctx.service.systems.receivingEntryMatch.bindEntryOrderReceiving({ entry_order_id, receiving_ids, creator_id, }); return this.success('绑定完成', result); } /** * 解除入库单与收货单的绑定关系。 * @param {Object} data 请求体 * @param {number} data.entry_order_id 入库单 ID * @param {number[]} data.receiving_ids 要解除绑定的收货单 ID 列表 * @return {Promise} 统一 success 包装 */ async unbindReceiving(data = {}) { const { ctx } = this; const { entry_order_id, receiving_ids } = data || {}; const result = await ctx.service.systems.receivingEntryMatch.unbindEntryOrderReceiving({ entry_order_id, receiving_ids, }); return this.success('解绑完成', result); } /** * 快捷直入/虚拟入库(system method 包装层)。 * @param {Object} data 请求体 * @param {number} data.id 入库单ID * @return {Promise} 统一 success 包装 */ async quickInbound(data = {}) { const { service } = this; const { id } = data; const result = await service.systems.storage.entry.quickInbound({ id }); if (result && result.code === 200) { return this.success(result.message || 'ok', result); } return this.fail(result?.message || '快捷入库失败', result); } /** * 获取入库单打印数据,按 RECEIPT 模板 field_code 映射返回。 * @param {Object} data 请求体 * @param {number} data.id 入库单ID * @param {number} [data.warehouse_id] 仓库ID,不传则取当前用户仓库 * @return {Promise} 打印数据(扁平键值 + items 明细数组) */ async getPrintData(data = {}) { const { ctx, service } = this; const id = Number(data && data.id || 0); if (!id) { return this.fail('id 参数不能为空', { code: 400 }); } try { const entryResult = await service.systems.storage.entry.get({ id }); if (!entryResult || entryResult.code !== 200 || !entryResult.data || !entryResult.data.entryOrder) { return this.fail('入库单不存在', { code: 404 }); } const entryOrder = entryResult.data.entryOrder; const items = Array.isArray(entryOrder.items) ? entryOrder.items : []; // 查询商品条码和图片(复用 getStockDetails 缓存) const barcodeMap = new Map(); const imageMap = new Map(); try { const stockIds = items .map(item => Number(item.stock_id || 0)) .filter(sid => sid > 0); if (stockIds.length > 0) { const stockDetails = await ctx.service.systems.stockWarehouse.getStockDetails( stockIds, {} ); for (const detail of stockDetails) { const sid = Number(detail.id); // 提取条码 if (Array.isArray(detail.barcodes) && detail.barcodes.length > 0) { barcodeMap.set( sid, detail.barcodes.map(bc => String(bc.barcode || '').trim()).filter(Boolean) ); } // 提取图片(有图片标记但实际 URL 需要额外查询) if (detail.is_images === 'Y') { imageMap.set(sid, ''); } } } } catch (err) { ctx.logger.warn('[entry.getPrintData] 查询商品详情失败: %s', err.message); } const printData = { entry_order_code: entryOrder.entry_order_code || '', order_type: entryOrder.order_type || '', order_status: entryOrder.order_status || '', purchase_order_code: entryOrder.purchase_order_code || '', supplier_name: entryOrder.supplier_name || '', warehouse_name: entryOrder.warehouse_name || '', store_name: entryOrder.store_name || '', logistics_name: entryOrder.logistics_name || '', express_code: entryOrder.express_code || '', order_create_time: entryOrder.order_create_time || '', expect_start_time: entryOrder.expect_start_time || '', remark: entryOrder.remark || '', total_order_lines: entryOrder.total_order_lines || 0, items: items.map(item => ({ items_col1: item.warehouse_item_code || item.external_item_code || '', items_col2: item.warehouse_item_name || '', items_col3: (barcodeMap.get(Number(item.stock_id)) || []).join(';') || '', items_col4: item.count || 0, items_col5: item.received_quantity || 0, items_col6: item.inventory_type || '', items_col7: imageMap.get(Number(item.stock_id)) || '', })), }; return this.success('ok', { data: printData, code: 200 }); } catch (error) { ctx.logger.error('[entry.getPrintData] 获取入库单打印数据失败:', error); return this.fail(error.message || '获取打印数据失败', { code: 500 }); } } /** * 入库单商品与收货单商品逐行对照视图(system method 包装层)。 * 支持传入多个收货单ID进行批量对照预览。 * @param {Object} data 请求体 * @param {number} data.entry_order_id 入库单ID * @param {number[]} [data.receiving_ids] 收货单ID列表(优先使用) * @param {number} [data.receiving_id] 单个收货单ID(向后兼容) * @return {Promise} 统一 success 包装 */ async receivingCompare(data = {}) { const { service } = this; const { entry_order_id, receiving_id, receiving_ids } = data || {}; const result = await service.systems.storage.entry.receivingCompare({ entry_order_id, receiving_id, receiving_ids }); return this.success('ok', result); } /** * 查询入库单操作日志。warehouseId 由服务端从当前上下文自动注入,前端无需传递。 * @param {Object} data 请求体 * @param {number} data.id 入库单ID * @param {number} [data.page=1] 页码 * @param {number} [data.pageSize=20] 每页数量 * @return {Promise} 统一 success 包装 */ async queryEntryLogs(data = {}) { const { ctx, service } = this; const warehouseId = ctx.user?.store_id; const result = await service.systems.operationLog.queryEntryOrderLogs({ id: data.id, warehouseId, page: data.page, pageSize: data.pageSize, }); return this.success('ok', result); } /** * 查询入库单已绑定收货单中匹配指定商品的可绑定收货明细列表。 * @param {Object} data 请求体 * @param {number} data.entry_order_id 入库单ID * @param {number} data.stock_id 商品stock_id * @return {Promise} 统一 success 包装 */ async getReceivingDetailsForBind(data = {}) { const { service } = this; const result = await service.systems.storage.entry.getReceivingDetailsForBind(data); if (result && result.code === 200) { return this.success('ok', result.data); } return this.fail(result?.message || '查询失败', result); } /** * 拉取入库单绑定的收货单中,指定商品的可用容器列表(收货明细)。 * 用于 PDA 上架时选择容器。 * @param {Object} data 请求体 * @param {number} data.entry_order_id 入库单ID * @param {number} data.stock_id 商品stock_id * @return {Promise} 统一 success 包装,data 包含 { list, total } */ async containerList(data = {}) { const { service } = this; const { entry_order_id, stock_id } = data || {}; const result = await service.systems.storage.entry.containerList({ entry_order_id, stock_id }); if (result && result.code === 200) { return this.success('ok', result.data); } return this.fail(result?.message || '查询失败', result); } /** * 审核入库单(CREATED → PENDING)。 * @param {Object} data 请求体 * @param {number} data.id 入库单ID * @return {Promise} 统一 success/fail 包装 */ async reviewEntry(data = {}) { const { service } = this; const result = await service.systems.entryOrder.reviewEntry(data); if (result && result.success) { return this.success(result.message, result.data, 200); } return this.fail(result?.message || '审核失败', result, 400); } } module.exports = entryService;