'use strict'; const MainService = require('../../main'); /** * 系统方法层:storage.inventory(库存操作接口包装层)。 * 职责:统一包装库存操作接口,调用底层 systems/storage/inventory service。 */ class InventoryMethodService extends MainService { constructor(ctx) { super(ctx); const _noNeedLogin = ''; const _noNeedRight = 'list'; const _noNeedLog = 'list'; const _noNeedAuth = 'list,quickPutaway'; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } /** * 移库(库位转移):将单条库存从一个库位移动到另一个库位。 * @param {Object} data 请求体 * @param {number} data.storage_id 库存记录ID(必填) * @param {number} data.target_space_id 目标库位ID(必填) * @param {number} [data.quantity] 移库数量(可选,默认全部移动) * @return {Promise} 统一 success 包装 */ async transferLocation(data = {}) { const { service } = this; const result = await service.systems.storage.inventory.transferLocation(data); return this.success('ok', result); } /** * 按库位+商品维度移库:自动查找该库位下该商品的所有库存记录,合并移动到目标库位。 * @param {Object} data 请求体 * @param {number} data.space_id 原库位ID(必填) * @param {number} data.stock_id 商品SKU ID(必填) * @param {number} data.target_space_id 目标库位ID(必填) * @param {number} data.quantity 移库数量(必填) * @return {Promise} 统一 success 包装 */ async transferByProduct(data = {}) { const { service } = this; const result = await service.systems.storage.inventory.transferByProduct(data); return this.success('ok', result); } /** * 库存列表查询(查 wms_storage),支持 where 条件、分页、排序、批次分组。 * @param {Object} data 请求体 * @param {Object} [data.where] 查询条件 * @param {Object} [data.pagination] 分页参数 { page, pageSize } * @param {Object} [data.sort] 排序参数 { sortField, sortOrder } * @param {boolean} [data.group_by_batch=false] 是否按批次查询 * @return {Promise} 统一 success 包装 */ async list(data = {}) { const { service } = this; const { pagination, sort, group_by_batch } = data; this.prepareWhereContext(data); const result = await service.systems.storage.inventory.getInventoryList(pagination, sort, group_by_batch); return this.success('ok', result); } /** * 收货单快捷入库:将收货单的明细直接转为入库单,相同商品自动合并数量。 * 要求货主配置中允许收货单快捷入库,否则直接返回失败。 * @param {Object} data 请求体 * @param {number} data.receiving_id 收货单ID(必填) * @return {Promise} 统一 success 包装,返回创建的入库单信息 */ async quickPutaway(data = {}) { const { service } = this; const { receiving_id } = data; const result = await service.systems.storage.inventory.quickPutaway({ receiving_id }); return this.success('ok', result); } } module.exports = InventoryMethodService;