- storeWarehouse.store.saveApiConfig:新增 resolveContractApiInterfaceType, interface_type_id=3(OPEN_API_WAREHOUSE 仓库开放接口)自动映射为 2(OPEN_API 货主开放接口)落库, 不再要求当前主体为仓库(货主可维护自身签约关系下的接口配置) - callback_url 不再取入参(含 callbackUrl 别名),统一写入 config.openapi.defaultCallbackUrl(新增配置项,默认空) - storeWarehouse.store.listApiConfig:interface_type_id 过滤同步映射(传 3 按 2 查询) - 文档:methods/system.json 升级 0.3.350、methods/changes/system.json 变更记录、docs/openapi-callback-events.md 回调地址来源说明 - 测试:saveApiConfig 新增 4 条用例(3→2 落库、忽略入参回调地址、默认值未配置、货主主体可保存、缺失类型 404),listApiConfig 新增 1 条过滤映射用例 同时提交工作区其余在制品改动: - waybill:移除 wms_order_express_trace 模型并新增 drop 迁移,轨迹查询/取号/打印链路调整 - order:订单 SN 编码(order_item_sn / order_item_sn_log / sn_code_rule、has_sn_item 回填迁移),pendingOrder/recheckOrder/wave/base 调整 - express_platform、order_async、order_export、order_storage_allocation、storage.report、stock_store 配套修复 - lib:新增 jd_client,调整 qimen_client、callback_functions 及配套测试 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1336 lines
41 KiB
JavaScript
1336 lines
41 KiB
JavaScript
'use strict';
|
||
|
||
const MainService = require('../../main');
|
||
|
||
const STOCK_WAREHOUSE_EXPORT_TASK_CACHE_KEY_PREFIX = 'stock_warehouse_export_task_';
|
||
const STOCK_WAREHOUSE_EXPORT_TASK_CACHE_TTL_SECONDS = 1800;
|
||
|
||
class WarehouseService extends MainService {
|
||
constructor(ctx) {
|
||
super(ctx);
|
||
const _noNeedLogin = '';
|
||
const _noNeedRight = 'list,externalList,externalExport,export,exportTaskProgress,getProhibitedType,getInfo,getBarcodes,getStoreStocks,queryStockLogs,getStockUnits,getUnitList,createUnit,checkItemCodeUnique,deleteUnit,createProhibited,deleteProhibited,search,getStockDetail,staticList';
|
||
const _noNeedLog = 'list,externalList,externalExport,export,exportTaskProgress,getProhibitedType,getInfo,getBarcodes,getStoreStocks,queryStockLogs,getStockUnits,checkItemCodeUnique,getUnitList,search,getStockDetail,staticList';
|
||
const _noNeedAuth = 'list,externalList,externalExport,export,exportTaskProgress,getProhibitedType,getInfo,getBarcodes,getStoreStocks,queryStockLogs,getStockUnits,checkItemCodeUnique,getUnitList,search,getStockDetail,staticList';
|
||
this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth);
|
||
}
|
||
|
||
/**
|
||
* 归一化回收站筛选条件,兼容历史 is_deleted 字段。
|
||
* @param {Object} where 原始 where 条件
|
||
* @return {Object} 归一化后的 where 条件
|
||
*/
|
||
normalizeWarehouseRecycleWhere(where = {}) {
|
||
if (!this.isPlainObject(where)) {
|
||
return {};
|
||
}
|
||
|
||
const normalizedWhere = { ...where };
|
||
const recycleCondition = normalizedWhere.is_deleted;
|
||
if (!this.isPlainObject(recycleCondition)) {
|
||
return normalizedWhere;
|
||
}
|
||
|
||
const recycleValue = recycleCondition.value;
|
||
const isDeleted = recycleValue === true
|
||
|| recycleValue === 1
|
||
|| String(recycleValue || '').trim().toLowerCase() === 'true'
|
||
|| String(recycleValue || '').trim() === '1';
|
||
|
||
normalizedWhere.deleted_at = {
|
||
operator: isDeleted ? 'isnotnull' : 'isnull',
|
||
value: isDeleted ? 1 : 0,
|
||
};
|
||
delete normalizedWhere.is_deleted;
|
||
|
||
return normalizedWhere;
|
||
}
|
||
|
||
/**
|
||
* 仓库商品列表查询。
|
||
* @param {Object} data 请求体
|
||
* @param {Object} [data.pagination] 分页参数
|
||
* @param {Object} [data.where] 筛选条件
|
||
* @param {Object} [data.sort] 排序参数
|
||
* @param {string} [data.sort.sortField] 排序字段(兼容:sort_field)
|
||
* @param {string} [data.sort.sortOrder] 排序顺序(兼容:sort_order)
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async list(data = {}) {
|
||
const { service } = this;
|
||
const { pagination } = data;
|
||
const sort = data.sort || {};
|
||
const sortParams = {
|
||
sortField: sort.sortField || sort.sort_field || 'id',
|
||
sortOrder: sort.sortOrder || sort.sort_order || 'DESC',
|
||
};
|
||
if (this.isPlainObject(data)) {
|
||
const rawWhere = this.isPlainObject(data.where) ? data.where : {};
|
||
data.where = this.normalizeWarehouseRecycleWhere(rawWhere);
|
||
}
|
||
const { where } = this.prepareWhereContext(data, {
|
||
specialFieldMap: {
|
||
barcode: {
|
||
bucket: 'barcode',
|
||
},
|
||
prohibited_type: {
|
||
bucket: 'prohibited',
|
||
field: 'id',
|
||
},
|
||
has_bound_item: {
|
||
bucket: 'storeOutStock',
|
||
field: 'stock_id',
|
||
},
|
||
has_requirements: {
|
||
bucket: 'requirement',
|
||
},
|
||
},
|
||
});
|
||
const result = await service.systems.stockStore.getWarehouseStock(where, pagination, sortParams);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 外仓商品列表查询。
|
||
* - 传入 warehouse_id:按指定仓库维度查询
|
||
* - 不传 warehouse_id:按当前货主维度查询(store_id = ctx.user.store_id)
|
||
* @param {Object} data 请求体
|
||
* @param {number} [data.warehouse_id] 仓库ID(可选)
|
||
* @param {Object} [data.pagination] 分页参数
|
||
* @param {Object} [data.where] 筛选条件
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async externalList(data = {}) {
|
||
const { service, ctx } = this;
|
||
const warehouseId = Number(data.warehouse_id || data.warehouseId || 0);
|
||
const { pagination } = data;
|
||
const sort = data.sort || {};
|
||
const sortParams = {
|
||
sortField: sort.sortField || sort.sort_field || 'id',
|
||
sortOrder: sort.sortOrder || sort.sort_order || 'DESC',
|
||
};
|
||
if (this.isPlainObject(data)) {
|
||
const rawWhere = this.isPlainObject(data.where) ? data.where : {};
|
||
data.where = this.normalizeWarehouseRecycleWhere(rawWhere);
|
||
}
|
||
// 传入 warehouse_id 时合并到 where 条件中
|
||
if (warehouseId > 0) {
|
||
data.where = {
|
||
...(data.where || {}),
|
||
warehouse_id: { operator: 'eq', value: warehouseId },
|
||
};
|
||
}
|
||
const { where } = this.prepareWhereContext(data, {
|
||
specialFieldMap: {
|
||
barcode: {
|
||
bucket: 'barcode',
|
||
},
|
||
prohibited_type: {
|
||
bucket: 'prohibited',
|
||
field: 'id',
|
||
},
|
||
has_bound_item: {
|
||
bucket: 'storeOutStock',
|
||
field: 'stock_id',
|
||
},
|
||
has_requirements: {
|
||
bucket: 'requirement',
|
||
},
|
||
},
|
||
});
|
||
// 始终按当前货主维度查(store_id = self)
|
||
const result = await service.systems.stockStore.getWarehouseStock(where, pagination, sortParams, 0, ctx.user.store_id);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 提交外仓商品导出任务(复用 externalList 的筛选语义与排序规则)。
|
||
* - 传入 warehouse_id:按指定仓库维度导出
|
||
* - 不传 warehouse_id:按当前货主维度导出(store_id = ctx.user.store_id)
|
||
* @param {Object} data 请求体
|
||
* @param {number} [data.warehouse_id] 仓库ID(可选)
|
||
* @param {Object} [data.where] 筛选条件
|
||
* @param {Object} [data.sort] 排序参数
|
||
* @param {string} [data.sort.sortField] 排序字段(兼容:sort_field)
|
||
* @param {string} [data.sort.sortOrder] 排序顺序(兼容:sort_order)
|
||
* @return {Promise<Object>} 统一成功包装响应,data 为导出任务信息
|
||
*/
|
||
async externalExport(data = {}) {
|
||
const { service, ctx } = this;
|
||
const warehouseId = Number(data.warehouse_id || data.warehouseId || 0);
|
||
const sort = data.sort || {};
|
||
const sortField = sort.sortField || sort.sort_field;
|
||
const sortOrder = sort.sortOrder || sort.sort_order;
|
||
const sortParams = {
|
||
...(sortField ? { sortField } : {}),
|
||
...(sortOrder ? { sortOrder } : {}),
|
||
};
|
||
|
||
if (this.isPlainObject(data)) {
|
||
const rawWhere = this.isPlainObject(data.where) ? data.where : {};
|
||
data.where = this.normalizeWarehouseRecycleWhere(rawWhere);
|
||
}
|
||
// 传入 warehouse_id 时合并到 where 条件中
|
||
if (warehouseId > 0) {
|
||
data.where = {
|
||
...(data.where || {}),
|
||
warehouse_id: { operator: 'eq', value: warehouseId },
|
||
};
|
||
}
|
||
const { where } = this.prepareWhereContext(data, {
|
||
specialFieldMap: {
|
||
barcode: {
|
||
bucket: 'barcode',
|
||
},
|
||
prohibited_type: {
|
||
bucket: 'prohibited',
|
||
field: 'id',
|
||
},
|
||
has_bound_item: {
|
||
bucket: 'storeOutStock',
|
||
field: 'stock_id',
|
||
},
|
||
has_requirements: {
|
||
bucket: 'requirement',
|
||
},
|
||
},
|
||
});
|
||
|
||
const taskId = this.generateExportTaskId('external');
|
||
const taskPayload = {
|
||
task_id: taskId,
|
||
status: 'submitted',
|
||
progress: 0,
|
||
message: '外仓导出任务已提交',
|
||
result: null,
|
||
error: '',
|
||
};
|
||
|
||
await this.setExportTaskProgress(taskId, taskPayload);
|
||
|
||
setImmediate(async () => {
|
||
try {
|
||
await this.setExportTaskProgress(taskId, {
|
||
task_id: taskId,
|
||
status: 'running',
|
||
progress: 10,
|
||
message: '外仓导出任务执行中',
|
||
result: null,
|
||
error: '',
|
||
});
|
||
|
||
// 始终按当前货主维度导出(store_id = self)
|
||
const result = await service.systems.stockStore.exportExternalWarehouseStock(where, sortParams, warehouseId, ctx.user.store_id);
|
||
|
||
await this.setExportTaskProgress(taskId, {
|
||
task_id: taskId,
|
||
status: 'success',
|
||
progress: 100,
|
||
message: '外仓导出任务完成',
|
||
result,
|
||
error: '',
|
||
});
|
||
} catch (error) {
|
||
const errorMessage = error && error.message ? error.message : `${error}`;
|
||
await this.setExportTaskProgress(taskId, {
|
||
task_id: taskId,
|
||
status: 'failed',
|
||
progress: 100,
|
||
message: '外仓导出任务失败',
|
||
result: null,
|
||
error: errorMessage,
|
||
});
|
||
}
|
||
});
|
||
|
||
return this.success('ok', {
|
||
...taskPayload,
|
||
update_time: Date.now(),
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 提交仓库商品导出任务(复用 list 的筛选语义与排序规则)。
|
||
* @param {Object} data 请求体
|
||
* @param {Object} [data.where] 筛选条件
|
||
* @param {Object} [data.sort] 排序参数
|
||
* @param {string} [data.sort.sortField] 排序字段(兼容:sort_field)
|
||
* @param {string} [data.sort.sortOrder] 排序顺序(兼容:sort_order)
|
||
* @return {Promise<Object>} 统一成功包装响应,data 为导出任务信息
|
||
*/
|
||
async export(data = {}) {
|
||
const { service } = this;
|
||
if (this.isPlainObject(data)) {
|
||
const rawWhere = this.isPlainObject(data.where) ? data.where : {};
|
||
data.where = this.normalizeWarehouseRecycleWhere(rawWhere);
|
||
}
|
||
const { where, whereValue = {} } = this.prepareWhereContext(data, {
|
||
specialFieldMap: {
|
||
barcode: {
|
||
bucket: 'barcode',
|
||
},
|
||
prohibited_type: {
|
||
bucket: 'prohibited',
|
||
field: 'id',
|
||
},
|
||
has_bound_item: {
|
||
bucket: 'storeOutStock',
|
||
field: 'stock_id',
|
||
},
|
||
has_requirements: {
|
||
bucket: 'requirement',
|
||
},
|
||
},
|
||
});
|
||
|
||
const { sort = {} } = data;
|
||
const sortField = sort.sortField || sort.sort_field || whereValue.sortField || whereValue.sort_field;
|
||
const sortOrder = sort.sortOrder || sort.sort_order || whereValue.sortOrder || whereValue.sort_order;
|
||
const sortParams = {
|
||
...(sortField ? { sortField } : {}),
|
||
...(sortOrder ? { sortOrder } : {}),
|
||
};
|
||
|
||
const taskId = this.generateExportTaskId();
|
||
const taskPayload = {
|
||
task_id: taskId,
|
||
status: 'submitted',
|
||
progress: 0,
|
||
message: '导出任务已提交',
|
||
result: null,
|
||
error: '',
|
||
};
|
||
|
||
await this.setExportTaskProgress(taskId, taskPayload);
|
||
|
||
setImmediate(async () => {
|
||
try {
|
||
await this.setExportTaskProgress(taskId, {
|
||
task_id: taskId,
|
||
status: 'running',
|
||
progress: 10,
|
||
message: '导出任务执行中',
|
||
result: null,
|
||
error: '',
|
||
});
|
||
|
||
const result = await service.systems.stockStore.exportWarehouseStock(where, sortParams);
|
||
|
||
await this.setExportTaskProgress(taskId, {
|
||
task_id: taskId,
|
||
status: 'success',
|
||
progress: 100,
|
||
message: '导出任务完成',
|
||
result,
|
||
error: '',
|
||
});
|
||
} catch (error) {
|
||
const errorMessage = error && error.message ? error.message : `${error}`;
|
||
await this.setExportTaskProgress(taskId, {
|
||
task_id: taskId,
|
||
status: 'failed',
|
||
progress: 100,
|
||
message: '导出任务失败',
|
||
result: null,
|
||
error: errorMessage,
|
||
});
|
||
}
|
||
});
|
||
|
||
return this.success('ok', {
|
||
...taskPayload,
|
||
update_time: Date.now(),
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 查询仓库商品导出任务进度。
|
||
* @param {Object} data 请求体
|
||
* @param {string} [data.task_id] 任务ID(下划线写法)
|
||
* @param {string} [data.taskId] 任务ID(驼峰写法)
|
||
* @return {Promise<Object>} 统一成功包装响应
|
||
*/
|
||
async exportTaskProgress(data = {}) {
|
||
const taskId = this.normalizeExportTaskId(data);
|
||
if (!taskId) {
|
||
return this.success('ok', {
|
||
task_id: '',
|
||
status: 'not_found',
|
||
progress: 0,
|
||
message: '任务不存在',
|
||
result: null,
|
||
error: '',
|
||
download_url: '',
|
||
update_time: Date.now(),
|
||
});
|
||
}
|
||
|
||
const cachedTask = await this.getExportTaskProgress(taskId);
|
||
if (!cachedTask) {
|
||
return this.success('ok', {
|
||
task_id: taskId,
|
||
status: 'not_found',
|
||
progress: 0,
|
||
message: '任务不存在',
|
||
result: null,
|
||
error: '',
|
||
download_url: '',
|
||
update_time: Date.now(),
|
||
});
|
||
}
|
||
|
||
const safeResult = this.isPlainObject(cachedTask.result) ? cachedTask.result : {};
|
||
const downloadUrl = String(
|
||
safeResult.url
|
||
|| safeResult.cndUrl
|
||
|| safeResult.cosUrl
|
||
|| safeResult.fileKey
|
||
|| ''
|
||
);
|
||
|
||
return this.success('ok', {
|
||
task_id: taskId,
|
||
...cachedTask,
|
||
download_url: downloadUrl,
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 生成仓库商品导出任务ID。
|
||
* @param {string} [prefix=''] 任务类型前缀(如 'external')
|
||
* @return {string} 导出任务ID
|
||
*/
|
||
generateExportTaskId(prefix = '') {
|
||
const warehouseId = this.ctx?.user?.store_id || 'unknown';
|
||
const timestamp = Date.now();
|
||
const randomToken = Math.random().toString(36).slice(2, 10);
|
||
const typePrefix = prefix ? `${prefix}_` : '';
|
||
return `stock_warehouse_${typePrefix}export_${warehouseId}_${timestamp}_${randomToken}`;
|
||
}
|
||
|
||
/**
|
||
* 归一化仓库商品导出任务ID。
|
||
* @param {Object} data 请求体
|
||
* @param {string} [data.task_id] 任务ID(下划线写法)
|
||
* @param {string} [data.taskId] 任务ID(驼峰写法)
|
||
* @return {string} 归一化后的任务ID
|
||
*/
|
||
normalizeExportTaskId(data = {}) {
|
||
const normalizedData = this.isPlainObject(data) ? data : {};
|
||
return String(normalizedData.task_id || normalizedData.taskId || '').trim();
|
||
}
|
||
|
||
/**
|
||
* 获取仓库商品导出任务缓存键。
|
||
* @param {string} taskId 任务ID
|
||
* @return {string} 缓存键
|
||
*/
|
||
getExportTaskCacheKey(taskId = '') {
|
||
const normalizedTaskId = String(taskId || '').trim();
|
||
if (!normalizedTaskId) {
|
||
return '';
|
||
}
|
||
|
||
return `${STOCK_WAREHOUSE_EXPORT_TASK_CACHE_KEY_PREFIX}${normalizedTaskId}`;
|
||
}
|
||
|
||
/**
|
||
* 写入仓库商品导出任务进度缓存。
|
||
* @param {string} taskId 任务ID
|
||
* @param {Object} payload 任务状态载荷
|
||
* @return {Promise<void>} 无返回值
|
||
*/
|
||
async setExportTaskProgress(taskId = '', payload = {}) {
|
||
const cacheKey = this.getExportTaskCacheKey(taskId);
|
||
if (!cacheKey || typeof this.app.setCacheAsync !== 'function') {
|
||
return;
|
||
}
|
||
|
||
const safePayload = this.isPlainObject(payload) ? payload : {};
|
||
const progressPayload = {
|
||
task_id: String(taskId || '').trim(),
|
||
status: String(safePayload.status || 'submitted').trim() || 'submitted',
|
||
progress: Number.isFinite(Number(safePayload.progress)) ? Math.min(100, Math.max(0, Math.round(Number(safePayload.progress)))) : 0,
|
||
message: String(safePayload.message || ''),
|
||
result: safePayload.result ?? null,
|
||
error: String(safePayload.error || ''),
|
||
update_time: Date.now(),
|
||
};
|
||
|
||
try {
|
||
await this.app.setCacheAsync(cacheKey, progressPayload, STOCK_WAREHOUSE_EXPORT_TASK_CACHE_TTL_SECONDS);
|
||
} catch (error) {
|
||
const errorMessage = error && error.message ? error.message : `${error}`;
|
||
this.ctx.logger.warn(`[stock.warehouse.export] 写入导出任务缓存失败: ${errorMessage}`);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 读取仓库商品导出任务进度缓存。
|
||
* @param {string} taskId 任务ID
|
||
* @return {Promise<Object|null>} 任务缓存
|
||
*/
|
||
async getExportTaskProgress(taskId = '') {
|
||
const cacheKey = this.getExportTaskCacheKey(taskId);
|
||
if (!cacheKey || typeof this.app.getCacheAsync !== 'function') {
|
||
return null;
|
||
}
|
||
|
||
try {
|
||
const cached = await this.app.getCacheAsync(cacheKey);
|
||
if (!this.isPlainObject(cached)) {
|
||
return null;
|
||
}
|
||
return cached;
|
||
} catch (error) {
|
||
const errorMessage = error && error.message ? error.message : `${error}`;
|
||
this.ctx.logger.warn(`[stock.warehouse.export] 读取导出任务缓存失败: ${errorMessage}`);
|
||
return null;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 查询违禁品类型列表(系统预设 + 当前仓库)。
|
||
* @return {Promise<Object>} data 为违禁品类型数组
|
||
*/
|
||
async getProhibitedType() {
|
||
const { service } = this;
|
||
const result = await service.systems.stockStore.getProhibitedType();
|
||
return this.success('ok', { data: result, code: 200 });
|
||
}
|
||
|
||
/**
|
||
* 按商品条件获取仓库商品详情。
|
||
* @param {Object} data 请求体(常见包含 id/item_code)
|
||
* @return {Promise<Object>} data 为单个商品详情对象
|
||
*/
|
||
async getInfo(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.stockStore.getInfo(data);
|
||
return this.success('ok', { data: result, code: 200 });
|
||
}
|
||
|
||
/**
|
||
* 更新仓库商品资料。
|
||
* @param {Object} data 请求体(含商品主键与可编辑字段)
|
||
* @return {Promise<Object>} data 为更新结果
|
||
*/
|
||
async saveWarehouseStock(data) {
|
||
const { service } = this;
|
||
const {
|
||
id,
|
||
item_code,
|
||
item_name,
|
||
goods_code,
|
||
sku_property,
|
||
stock_unit,
|
||
packing_requirements,
|
||
pick_requirements,
|
||
recheck_requirements,
|
||
merge_requirements,
|
||
length,
|
||
width,
|
||
height,
|
||
volume,
|
||
volume_cm3,
|
||
volumeCm3,
|
||
gross_weight,
|
||
net_weight,
|
||
tag_price,
|
||
retail_price,
|
||
is_sn_mgmt,
|
||
is_shelf_life_mgmt,
|
||
is_batch_mgmt,
|
||
need_recheck,
|
||
prohibited_id,
|
||
brand_name,
|
||
managementFlags,
|
||
enable_box_spec,
|
||
box_unit,
|
||
quantity_per_box,
|
||
box_gross_weight,
|
||
box_net_weight,
|
||
box_length,
|
||
box_width,
|
||
box_height,
|
||
box_volume,
|
||
box_volume_m3,
|
||
boxVolumeM3,
|
||
box_remark,
|
||
shelf_life_days,
|
||
inbound_min_days,
|
||
outbound_min_days,
|
||
remaining_threshold_days,
|
||
warning_quantity,
|
||
sn_code_rules,
|
||
snCodeRules,
|
||
} = data || {};
|
||
try {
|
||
const result = await service.systems.stockStore.saveWarehouseStock({
|
||
id,
|
||
item_code,
|
||
item_name,
|
||
goods_code,
|
||
sku_property,
|
||
stock_unit,
|
||
packing_requirements,
|
||
pick_requirements,
|
||
recheck_requirements,
|
||
merge_requirements,
|
||
length,
|
||
width,
|
||
height,
|
||
volume,
|
||
volume_cm3,
|
||
volumeCm3,
|
||
gross_weight,
|
||
net_weight,
|
||
tag_price,
|
||
retail_price,
|
||
is_sn_mgmt,
|
||
is_shelf_life_mgmt,
|
||
is_batch_mgmt,
|
||
need_recheck,
|
||
prohibited_id,
|
||
brand_name,
|
||
managementFlags,
|
||
enable_box_spec,
|
||
box_unit,
|
||
quantity_per_box,
|
||
box_gross_weight,
|
||
box_net_weight,
|
||
box_length,
|
||
box_width,
|
||
box_height,
|
||
box_volume,
|
||
box_volume_m3,
|
||
boxVolumeM3,
|
||
box_remark,
|
||
shelf_life_days,
|
||
inbound_min_days,
|
||
outbound_min_days,
|
||
remaining_threshold_days,
|
||
warning_quantity,
|
||
sn_code_rules,
|
||
snCodeRules,
|
||
});
|
||
return this.success('ok', { data: result, code: 200 });
|
||
} catch (error) {
|
||
return this.fail(error.message);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 新建仓库商品资料。
|
||
* @param {Object} data 请求体(必填字段见 stockStore 校验)
|
||
* @return {Promise<Object>} data 为新建结果
|
||
*/
|
||
async createWarehouseStock(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.stockStore.createWarehouseStock(data);
|
||
return this.success('ok', { data: result, code: 200 });
|
||
}
|
||
|
||
/**
|
||
* 导入仓库商品资料。
|
||
*
|
||
* 支持直接传数组,也支持从 rows、items、list、data 中提取数组。
|
||
* SKU 为空时创建,SKU 不为空时更新,并返回批量处理结果汇总。
|
||
*
|
||
* @param {Object|Array} data 导入请求体或商品数组
|
||
* @return {Promise<Object>} 导入结果汇总
|
||
*/
|
||
async import(data = {}) {
|
||
const { service } = this;
|
||
const rows = this._normalizeWarehouseImportRows(data);
|
||
const summary = {
|
||
total_count: rows.length,
|
||
created_count: 0,
|
||
updated_count: 0,
|
||
fail_count: 0,
|
||
created_ids: [],
|
||
updated_ids: [],
|
||
fail_items: [],
|
||
};
|
||
|
||
if (rows.length === 0) {
|
||
return this.fail('导入数据不能为空', summary);
|
||
}
|
||
|
||
for (let index = 0; index < rows.length; index += 1) {
|
||
const sourceRow = rows[index];
|
||
const normalizedRow = this._normalizeWarehouseImportRow(sourceRow);
|
||
|
||
if (!normalizedRow) {
|
||
summary.fail_count += 1;
|
||
summary.fail_items.push({
|
||
index,
|
||
row: sourceRow,
|
||
error: '导入行数据无效',
|
||
});
|
||
continue;
|
||
}
|
||
|
||
try {
|
||
const hasSku = String(normalizedRow.id ?? '').trim() !== '';
|
||
let result;
|
||
|
||
if (hasSku) {
|
||
result = await service.systems.stockStore.saveWarehouseStock(normalizedRow);
|
||
} else {
|
||
result = await service.systems.stockStore.createWarehouseStock(normalizedRow);
|
||
}
|
||
|
||
// 条码同步:仅当传入非空条码时写入 wms_stock_barcodes 表(未传条码则保留原有条码)
|
||
const barcodes = Array.isArray(normalizedRow.barcode) ? normalizedRow.barcode : [];
|
||
if (barcodes.length > 0) {
|
||
const stockId = (result && result.id != null) ? result.id : normalizedRow.id;
|
||
if (stockId != null) {
|
||
await service.systems.stockStore.saveWarehouseStockBarcode({
|
||
id: stockId,
|
||
barcodes,
|
||
});
|
||
}
|
||
}
|
||
|
||
if (hasSku) {
|
||
summary.updated_count += 1;
|
||
if (result && result.id != null) {
|
||
summary.updated_ids.push(result.id);
|
||
} else {
|
||
summary.updated_ids.push(normalizedRow.id);
|
||
}
|
||
} else {
|
||
summary.created_count += 1;
|
||
if (result && result.id != null) {
|
||
summary.created_ids.push(result.id);
|
||
}
|
||
}
|
||
} catch (error) {
|
||
summary.fail_count += 1;
|
||
summary.fail_items.push({
|
||
index,
|
||
row: normalizedRow,
|
||
error: error && error.message ? error.message : `${error}`,
|
||
});
|
||
}
|
||
}
|
||
|
||
if (summary.created_count + summary.updated_count === 0) {
|
||
return this.fail('导入失败', summary);
|
||
}
|
||
|
||
return this.success('导入完成', summary);
|
||
}
|
||
|
||
/**
|
||
* 归一化仓库商品导入数据列表。
|
||
*
|
||
* @param {Object|Array} data 导入请求体或商品数组
|
||
* @return {Array<Object>} 商品数组
|
||
*/
|
||
_normalizeWarehouseImportRows(data = {}) {
|
||
if (Array.isArray(data)) {
|
||
return data;
|
||
}
|
||
|
||
if (!this.isPlainObject(data)) {
|
||
return [];
|
||
}
|
||
|
||
const candidates = [ data.rows, data.items, data.list, data.data ];
|
||
for (const candidate of candidates) {
|
||
if (Array.isArray(candidate)) {
|
||
return candidate;
|
||
}
|
||
}
|
||
|
||
return [];
|
||
}
|
||
|
||
/**
|
||
* 归一化单条仓库商品导入数据。
|
||
*
|
||
* @param {Object} row 原始导入行
|
||
* @return {Object|null} 归一化后的数据行
|
||
*/
|
||
_normalizeWarehouseImportRow(row) {
|
||
if (!this.isPlainObject(row)) {
|
||
return null;
|
||
}
|
||
|
||
const pickValue = keys => {
|
||
for (const key of keys) {
|
||
if (!Object.prototype.hasOwnProperty.call(row, key)) {
|
||
continue;
|
||
}
|
||
|
||
const value = row[key];
|
||
if (value === undefined || value === null) {
|
||
continue;
|
||
}
|
||
|
||
if (typeof value === 'string' && value.trim() === '') {
|
||
continue;
|
||
}
|
||
|
||
return value;
|
||
}
|
||
return undefined;
|
||
};
|
||
|
||
const sku = pickValue([ 'SKU', 'sku', 'id', 'item_id', 'itemId', 'stock_id', 'stockId' ]);
|
||
const itemCode = pickValue([ '商品编码', 'item_code', 'itemCode' ]) ?? '';
|
||
const goodsCode = pickValue([ '货物编码', 'goods_code', 'goodsCode', 'cargo_code', 'cargoCode' ]) ?? '';
|
||
const itemName = pickValue([ '商品名称', 'item_name', 'itemName' ])
|
||
?? itemCode
|
||
?? goodsCode
|
||
?? '';
|
||
const storeId = pickValue([ 'store_id', 'storeId' ]) ?? this.ctx?.user?.store_id;
|
||
const needRecheckRaw = pickValue([ '是否需要复核', 'need_recheck', 'needRecheck' ]);
|
||
|
||
return {
|
||
...row,
|
||
id: sku,
|
||
store_id: storeId,
|
||
item_code: itemCode,
|
||
goods_code: goodsCode,
|
||
item_name: itemName,
|
||
sku_property: pickValue([ 'SKU规格', 'sku_property', 'skuProperty' ]) ?? '',
|
||
stock_unit: pickValue([ '库存单位', 'stock_unit', 'stockUnit' ]) ?? '',
|
||
brand_name: pickValue([ '品牌', 'brand_name', 'brandName' ]) ?? '',
|
||
gross_weight: pickValue([ '毛重', 'gross_weight', 'grossWeight' ]),
|
||
tag_price: pickValue([ '标价', 'tag_price', 'tagPrice' ]),
|
||
retail_price: pickValue([ '零售价', 'retail_price', 'retailPrice' ]),
|
||
...(needRecheckRaw !== undefined && { need_recheck: this._normalizeNeedRecheckValue(needRecheckRaw) }),
|
||
barcode: this._normalizeBarcodeField(
|
||
pickValue([ '条码', 'bar_code', 'barCode', 'barcodeList', 'barcode_list', 'barcode' ])
|
||
),
|
||
};
|
||
}
|
||
|
||
/**
|
||
* 归一化「是否需要复核」字段值:需要 → Y,不需要 → N。
|
||
* 支持中文(需要/需要复核/不需要/无需复核)、Y/N、1/0、布尔值。
|
||
*
|
||
* @param {string|number|boolean} raw 原始值
|
||
* @return {string} 'Y' 或 'N'
|
||
*/
|
||
_normalizeNeedRecheckValue(raw) {
|
||
const normalized = String(raw ?? '').trim();
|
||
if ([ '需要', '需要复核', 'Y', 'y', '1' ].includes(normalized) || raw === true) {
|
||
return 'Y';
|
||
}
|
||
if ([ '不需要', '无需', '无需复核', 'N', 'n', '0' ].includes(normalized) || raw === false) {
|
||
return 'N';
|
||
}
|
||
throw new Error(`是否需要复核值不合法: ${raw},仅支持 需要/不需要`);
|
||
}
|
||
|
||
/**
|
||
* 归一化条码字段,只接受逗号分隔的字符串格式,返回去重后的条码数组。
|
||
* 与 stock.warehouse.export 导出格式对齐(导出使用逗号分隔)。
|
||
*
|
||
* @param {string|undefined|null} raw 原始条码值(逗号分隔字符串)
|
||
* @return {Array<string>} 归一化后的去重条码数组
|
||
*/
|
||
_normalizeBarcodeField(raw) {
|
||
if (typeof raw === 'string' && raw.trim()) {
|
||
return [ ...new Set(raw.split(',').map(s => s.trim()).filter(Boolean)) ];
|
||
}
|
||
return [];
|
||
}
|
||
|
||
/**
|
||
* 查询商品条码列表。
|
||
* @param {Object} data 请求体(支持分页与关键字)
|
||
* @return {Promise<Object>} data 为条码分页结果
|
||
*/
|
||
async getBarcodes(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.stockStore.getBarcodes(data);
|
||
return this.success('ok', { data: result, code: 200 });
|
||
}
|
||
|
||
/**
|
||
* 保存商品条码信息。
|
||
* @param {Object} data 请求体(包含 stock_id 与条码字段)
|
||
* @return {Promise<Object>} data 为保存结果
|
||
*/
|
||
async saveWarehouseStockBarcode(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.stockStore.saveWarehouseStockBarcode(data);
|
||
return this.success('ok', { data: result, code: 200 });
|
||
}
|
||
|
||
/**
|
||
* 查询仓库与货主商品关联列表。
|
||
* @param {Object} data 请求体(支持筛选/分页)
|
||
* @return {Promise<Object>} data 为关联分页结果
|
||
*/
|
||
async getStoreStocks(data) {
|
||
const { ctx, service } = this;
|
||
// 校验归属:stock_warehouse 的 store_id 或 warehouse_id 匹配当前主体即可放行
|
||
const stockId = Number(data.stock_id || 0);
|
||
if (stockId > 0) {
|
||
const stock = await ctx.model.StockWarehouse.findOne({
|
||
where: { id: stockId },
|
||
attributes: [ 'id', 'store_id', 'warehouse_id' ],
|
||
raw: true,
|
||
});
|
||
if (!stock
|
||
|| (stock.store_id !== ctx.user.store_id && stock.warehouse_id !== ctx.user.store_id)) {
|
||
return this.fail('无权限查看该商品的绑定信息', { code: 403 });
|
||
}
|
||
// 使用实际的 warehouse_id 查询
|
||
data._warehouseId = stock.warehouse_id;
|
||
}
|
||
const result = await service.systems.stockStore.getStoreStocks(data);
|
||
return this.success('ok', { data: result, code: 200 });
|
||
}
|
||
|
||
/**
|
||
* 绑定货主商品。
|
||
* @param {Object} data 请求体(关联关系参数)
|
||
* @return {Promise<Object>} 成功或失败均返回 success 包装,message 给出结果
|
||
*/
|
||
async bindItem(data) {
|
||
const { service } = this;
|
||
const { id, warehouse_stock } = data || {};
|
||
try {
|
||
const result = await service.systems.stockStore.bindItem({
|
||
id,
|
||
warehouse_stock,
|
||
});
|
||
return this.success('绑定成功', { data: result, code: 200 });
|
||
} catch (e) {
|
||
return this.success(e.message, { code: 200 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 解绑货主商品。
|
||
* @param {Object} data 请求体(关联关系参数)
|
||
* @return {Promise<Object>} 成功或失败均返回 success 包装,message 给出结果
|
||
*/
|
||
async unbindItem(data) {
|
||
const { service } = this;
|
||
const { id } = data || {};
|
||
try {
|
||
const result = await service.systems.stockStore.unbindItem({ id });
|
||
return this.success('解绑成功', { data: result, code: 200 });
|
||
} catch (e) {
|
||
return this.success(e.message, { code: 200 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 校验商品编码唯一性。
|
||
* @param {Object} data 请求体
|
||
* @param {number} [data.item_id] 商品ID(编辑场景,排除自身)
|
||
* @param {number} [data.id] 兼容旧字段的商品ID
|
||
* @param {string} data.item_code 商品编码
|
||
* @param {number} data.owner_id 货主ID
|
||
* @param {number} [data.store_id] 兼容旧字段的货主ID
|
||
* @param {number} data.warehouse_id 仓库ID
|
||
* @return {Promise<Object>} data.unique 为是否唯一,重复时返回提示信息
|
||
*/
|
||
async checkItemCodeUnique(data) {
|
||
const { ctx, service } = this;
|
||
const {
|
||
item_id,
|
||
id,
|
||
item_code,
|
||
owner_id,
|
||
store_id,
|
||
warehouse_id,
|
||
} = data || {};
|
||
const targetItemId = item_id || id || null;
|
||
const targetOwnerId = owner_id || store_id;
|
||
const targetWarehouseId = warehouse_id || ctx.user.store_id;
|
||
try {
|
||
if (!item_code || !targetOwnerId || !targetWarehouseId) {
|
||
return this.fail('参数错误');
|
||
}
|
||
const result = await service.systems.stockStore.checkItemCodeUnique(
|
||
targetItemId,
|
||
item_code,
|
||
targetOwnerId,
|
||
targetWarehouseId
|
||
);
|
||
return this.success('获取成功', { data: result, code: 200 });
|
||
} catch (error) {
|
||
return this.fail(error.message);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 查询静态商品列表(仓库级)。
|
||
* 静态判定:商品最后一个收/发流水时间超过仓库配置的静态时间阈值即视为进入静态。
|
||
* @param {Object} data 请求体
|
||
* @param {Object} [data.pagination] 分页参数(page/pageSize)
|
||
* @param {number} [data.hours] 静态时间阈值(小时),缺省读仓库配置 stock_static_hours(默认 168)
|
||
* @return {Promise<Object>} data 为 { list, pagination }
|
||
*/
|
||
async staticList(data = {}) {
|
||
const { ctx, service } = this;
|
||
const pagination = this.isPlainObject(data.pagination) ? data.pagination : data;
|
||
const result = await service.systems.stockWarehouse.getStaticStockList({
|
||
warehouseId: ctx.user && ctx.user.store_id,
|
||
hours: data.hours,
|
||
page: Number(pagination.page || 1),
|
||
pageSize: Number(pagination.pageSize || 20),
|
||
});
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 查询库存操作日志。
|
||
* @param {Object} data 请求体(会自动注入当前 warehouseId)
|
||
* @return {Promise<Object>} data 为日志分页结果
|
||
*/
|
||
async queryStockLogs(data) {
|
||
const { ctx, service } = this;
|
||
try {
|
||
const stockId = Number(data.id || 0);
|
||
if (stockId > 0) {
|
||
// 校验 stock_warehouse:store_id 或 warehouse_id 匹配当前主体即可放行
|
||
const stock = await ctx.model.StockWarehouse.findOne({
|
||
where: { id: stockId },
|
||
attributes: [ 'id', 'store_id', 'warehouse_id' ],
|
||
raw: true,
|
||
});
|
||
if (!stock
|
||
|| (stock.store_id !== ctx.user.store_id && stock.warehouse_id !== ctx.user.store_id)) {
|
||
return this.fail('无权限查看该商品的库存日志', { code: 403 });
|
||
}
|
||
data.warehouseId = stock.warehouse_id;
|
||
} else {
|
||
data.warehouseId = ctx.user.store_id;
|
||
}
|
||
const result = await service.systems.operationLog.queryStockLogs(data);
|
||
return this.success('ok', { data: result, code: 200 });
|
||
} catch (e) {
|
||
return this.success(e.message, { code: 200 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 批量删除仓库商品资料(软删除)。
|
||
* @param {Object} data 请求体(含 ids)
|
||
* @return {Promise<Object>} data 为删除结果,message 为业务提示
|
||
*/
|
||
async handleBatchDelete(data) {
|
||
const { service } = this;
|
||
try {
|
||
const result = await service.systems.stockStore.handleBatchDelete(data);
|
||
return this.success(result.message, { data: result.data, code: result.code });
|
||
} catch (e) {
|
||
return this.success(e.message, { code: 200 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 删除库存单位。
|
||
* @param {Object} data 请求体(含单位ID)
|
||
* @return {Promise<Object>} data 为删除结果,message 为业务提示
|
||
*/
|
||
async deleteUnit(data) {
|
||
const { service } = this;
|
||
try {
|
||
const result = await service.systems.stockStore.deleteUnit(data);
|
||
return this.success(result.message, { data: result.data, code: result.code });
|
||
} catch (e) {
|
||
return this.success(e.message, { code: 200 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 删除违禁品类型。
|
||
* @param {Object} data 请求体(含类型ID)
|
||
* @return {Promise<Object>} data 为删除结果,message 为业务提示
|
||
*/
|
||
async deleteProhibited(data) {
|
||
const { service } = this;
|
||
try {
|
||
const result = await service.systems.stockStore.deleteProhibited(data);
|
||
return this.success(result.message, { data: result.data, code: result.code });
|
||
} catch (e) {
|
||
return this.success(e.message, { code: 200 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 批量修改商品资料字段。
|
||
* @param {Object} data 请求体(含 ids/method/value)
|
||
* @return {Promise<Object>} data 为修改结果,message 为业务提示
|
||
*/
|
||
async handleBatchChange(data) {
|
||
const { service } = this;
|
||
try {
|
||
const result = await service.systems.stockStore.handleBatchChange(data);
|
||
return this.success(result.message, { data: result.data, code: result.code });
|
||
} catch (e) {
|
||
return this.success(e.message, { code: 405 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 查询可用库存单位(系统预设 + 仓库自定义)。
|
||
* @return {Promise<Object>} data 为单位数组
|
||
*/
|
||
async getStockUnits() {
|
||
const { ctx } = this;
|
||
const warehouse_id = ctx.user.store_id;
|
||
|
||
try {
|
||
const where = {
|
||
[ctx.app.Sequelize.Op.or]: [
|
||
{ warehouse_id: null },
|
||
{ warehouse_id },
|
||
],
|
||
};
|
||
|
||
const units = await ctx.model.StockUnit.findAll({
|
||
where,
|
||
order: [
|
||
[ 'warehouse_id', 'ASC' ],
|
||
[ 'created_at', 'DESC' ],
|
||
],
|
||
});
|
||
return this.success('ok', { data: units, code: 200 });
|
||
} catch (error) {
|
||
return this.fail(error.message);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 查询当前仓库自定义单位列表。
|
||
* @return {Promise<Object>} data 为单位数组
|
||
*/
|
||
async getUnitList() {
|
||
const { ctx } = this;
|
||
const warehouse_id = ctx.user.store_id;
|
||
|
||
try {
|
||
const where = {
|
||
warehouse_id,
|
||
};
|
||
|
||
const units = await ctx.model.StockUnit.findAll({
|
||
where,
|
||
order: [
|
||
[ 'warehouse_id', 'ASC' ],
|
||
[ 'created_at', 'DESC' ],
|
||
],
|
||
});
|
||
return this.success('ok', { data: units, code: 200 });
|
||
} catch (error) {
|
||
return this.fail(error.message);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 新增违禁品类型。
|
||
* @param {Object} data 请求体
|
||
* @param {string} data.name 违禁品类型名称
|
||
* @return {Promise<Object|void>} 成功返回 success;参数校验失败时直接写入 ctx.body
|
||
*/
|
||
async createProhibited(data) {
|
||
const { ctx } = this;
|
||
const warehouse_id = ctx.user.store_id || null;
|
||
const { name } = data;
|
||
|
||
if (!name || name.trim() === '') {
|
||
ctx.body = {
|
||
code: 400,
|
||
message: '违禁品类型名称不能为空',
|
||
};
|
||
return;
|
||
}
|
||
|
||
const trimmedName = name.trim();
|
||
|
||
try {
|
||
const systemUnit = await ctx.model.ProhibitedType.findOne({
|
||
where: {
|
||
type_name: trimmedName,
|
||
warehouse_id: null,
|
||
},
|
||
});
|
||
|
||
if (systemUnit) {
|
||
ctx.body = {
|
||
code: 400,
|
||
message: '该违禁品类型是系统预设,不允许添加',
|
||
};
|
||
return;
|
||
}
|
||
|
||
const existUnit = await ctx.model.ProhibitedType.findOne({
|
||
where: {
|
||
type_name: trimmedName,
|
||
warehouse_id,
|
||
},
|
||
});
|
||
|
||
if (existUnit) {
|
||
ctx.body = {
|
||
code: 400,
|
||
message: '该违禁品类型名称已存在',
|
||
};
|
||
return;
|
||
}
|
||
|
||
await ctx.model.ProhibitedType.create({
|
||
type_name: trimmedName,
|
||
warehouse_id,
|
||
});
|
||
|
||
const where = {};
|
||
if (warehouse_id) {
|
||
where[ctx.app.Sequelize.Op.or] = [
|
||
{ warehouse_id: null },
|
||
{ warehouse_id },
|
||
];
|
||
} else {
|
||
where.warehouse_id = null;
|
||
}
|
||
|
||
await ctx.model.ProhibitedType.findAll({
|
||
where,
|
||
order: [
|
||
[ 'warehouse_id', 'ASC' ],
|
||
[ 'created_at', 'DESC' ],
|
||
],
|
||
});
|
||
return this.success('添加成功', { code: 200 });
|
||
} catch (error) {
|
||
return this.success('创建违禁品类型失败', { code: 405 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 新增库存单位。
|
||
* @return {Promise<Object|void>} 成功返回 success;参数校验失败时直接写入 ctx.body
|
||
*/
|
||
async createUnit() {
|
||
const { ctx } = this;
|
||
const warehouse_id = ctx.user.store_id || null;
|
||
const { name } = ctx.request.body;
|
||
|
||
if (!name || name.trim() === '') {
|
||
ctx.body = {
|
||
code: 400,
|
||
message: '单位名称不能为空',
|
||
};
|
||
return;
|
||
}
|
||
|
||
const trimmedName = name.trim();
|
||
|
||
try {
|
||
const systemUnit = await ctx.model.StockUnit.findOne({
|
||
where: {
|
||
name: trimmedName,
|
||
warehouse_id: null,
|
||
},
|
||
});
|
||
|
||
if (systemUnit) {
|
||
ctx.body = {
|
||
code: 400,
|
||
message: '该单位是系统预设单位,不允许添加',
|
||
};
|
||
return;
|
||
}
|
||
|
||
const existUnit = await ctx.model.StockUnit.findOne({
|
||
where: {
|
||
name: trimmedName,
|
||
warehouse_id,
|
||
},
|
||
});
|
||
|
||
if (existUnit) {
|
||
ctx.body = {
|
||
code: 400,
|
||
message: '该单位名称已存在',
|
||
};
|
||
return;
|
||
}
|
||
|
||
await ctx.model.StockUnit.create({
|
||
name: trimmedName,
|
||
warehouse_id,
|
||
});
|
||
|
||
const where = {};
|
||
if (warehouse_id) {
|
||
where[ctx.app.Sequelize.Op.or] = [
|
||
{ warehouse_id: null },
|
||
{ warehouse_id },
|
||
];
|
||
} else {
|
||
where.warehouse_id = null;
|
||
}
|
||
|
||
await ctx.model.StockUnit.findAll({
|
||
where,
|
||
order: [
|
||
[ 'warehouse_id', 'ASC' ],
|
||
[ 'created_at', 'DESC' ],
|
||
],
|
||
});
|
||
return this.success('添加成功', { code: 200 });
|
||
} catch (error) {
|
||
return this.success('创建库存单位失败', { code: 200 });
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 快捷搜索仓库商品,当 mode='combo' 时桥接到组合商品查询。
|
||
* @param {Object} data 请求体
|
||
* @param {string} [data.mode] 查询模式,'combo' 时搜索组合商品,默认搜索普通商品
|
||
* @param {string} [data.keyword] 搜索关键字(默认模式)
|
||
* @param {number} [data.id] 组合商品ID(mode='combo' 时精确查询)
|
||
* @param {string} [data.custom_code] 自定义编码(mode='combo' 时模糊查询)
|
||
* @param {number} [data.store_id] 货主ID(默认模式)
|
||
* @param {boolean} [data.with_stock] 是否返回库存数据(默认模式)
|
||
* @param {boolean} [data.is_batch] 是否按批次返回(默认模式)
|
||
* @return {Promise<Object>} data 为搜索结果数组(默认模式)或组合商品列表(combo 模式)
|
||
*/
|
||
async search(data) {
|
||
const { service } = this;
|
||
const { mode } = data || {};
|
||
|
||
if (mode === 'combo') {
|
||
const { id, custom_code, keyword } = data || {};
|
||
if (keyword) {
|
||
const result = await service.systems.comboGoods.search({ keyword });
|
||
return this.success('ok', result);
|
||
}
|
||
const result = await service.systems.comboGoods.searchByIdOrCode({ id, custom_code });
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
const result = await service.systems.stockStore.search(data);
|
||
return this.success('ok', result);
|
||
}
|
||
|
||
/**
|
||
* 查询商品库存明细(按库位/批次维度展示库存分布)。
|
||
* @param {Object} data 请求体
|
||
* @param {number} data.stock_id 商品库存ID(stock_warehouse.id)
|
||
* @param {Object} [data.pagination] 分页参数
|
||
* @return {Promise<Object>} data 为库存明细分页结果
|
||
*/
|
||
async getStockDetail(data) {
|
||
const { service } = this;
|
||
const result = await service.systems.stockStore.getStockDetail(data);
|
||
return this.success('ok', result);
|
||
}
|
||
}
|
||
|
||
module.exports = WarehouseService;
|