333 lines
13 KiB
JavaScript
333 lines
13 KiB
JavaScript
'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<Object>} 统一 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);
|
||
}
|
||
|
||
/**
|
||
* 查询入库单详情。仅通过入库单 ID 定位。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.id 入库单ID(必填)
|
||
* @return {Promise<Object>} 统一 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<Object>} 统一 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 入库单号
|
||
* @param {number} [data.stock_id] 商品SKU ID(单条模式)
|
||
* @param {number} [data.quantity] 本次入库数量(单条模式)
|
||
* @param {string} [data.inbound_type] 入库方式(单条模式)
|
||
* @param {Array} [data.items] 商品列表(批量模式)
|
||
* @return {Promise<Object>} 统一 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<Object>} 统一 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<Object>} 统一 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<Object>} 统一 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<Object>} 统一 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<Object>} 统一 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<Object>} 打印数据(扁平键值 + 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<Object>} 统一 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<Object>} 统一 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<Object>} 统一 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<Object>} 统一 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<Object>} 统一 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;
|