liufumingren 04305fffd6 feat: stock.transaction 新增 where.ids 精确筛选,支持导出选中记录
之前 where.ids 传入完全被忽略,导致导出内容与用户选中的记录不符。
queryList/exportList 现已支持 ids 数组精确筛选 wms_stock_transaction.id。
2026-07-17 02:26:10 +08:00

530 lines
15 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const MainService = require('../../main');
const STOCK_TRANSACTION_EXPORT_TASK_CACHE_KEY_PREFIX = 'stock_transaction_export_task_';
const STOCK_TRANSACTION_EXPORT_TASK_CACHE_TTL_SECONDS = 1800;
/**
* 系统方法层:stock.transaction(商品出入库流水查询包装层)。
*/
class StockTransactionMethodService extends MainService {
constructor(ctx) {
super(ctx);
const _noNeedLogin = '';
const _noNeedRight = 'list,storeList,export,exportStore,exportTaskProgress';
const _noNeedLog = 'list,storeList,export,exportStore,exportTaskProgress';
const _noNeedAuth = 'list,storeList,export,exportStore,exportTaskProgress';
this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth);
}
/**
* 仓库侧商品出入库流水列表查询。
* 按当前用户仓库(ctx.user.store_id)限定数据范围。
* @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 warehouseId = Number(this.ctx.user && this.ctx.user.store_id);
const { pagination } = data;
const { whereValue = {} } = this.prepareWhereContext(data);
const {
start_time: startTime,
end_time: endTime,
store_ids: storeIds,
stock_ids: stockIds,
keyword,
ids,
transaction_type: transactionType,
order_type: orderType,
order_no: orderNo,
batch_no: batchNo,
entry_order_id: entryOrderId,
receiving_id: receivingId,
order_id: orderId,
} = whereValue;
const { sort = {} } = data;
const {
sort_field: sortFieldSnake,
sortField: sortFieldCamel,
sort_order: sortOrderSnake,
sortOrder: sortOrderCamel,
} = sort || {};
const sortOption = {
sortField: sortFieldCamel || sortFieldSnake,
sortOrder: sortOrderCamel || sortOrderSnake,
};
const result = await service.systems.stockTransaction.queryList({
warehouseId,
startTime,
endTime,
storeIds,
stockIds,
keyword,
ids,
transactionType,
orderType,
orderNo,
batchNo,
entryOrderId,
receivingId,
orderId,
sort: sortOption,
pagination,
mode: 'warehouse',
});
return this.success('ok', result);
}
/**
* 货主侧商品出入库流水列表查询。
* 按货主 store_id 限定数据范围。
* @param {Object} data 请求体
* @param {number} data.store_id 货主ID(必传)
* @param {Object} [data.pagination] 分页参数
* @param {Object} [data.where] 查询条件
* @param {Object} [data.sort] 排序参数
* @return {Promise<Object>} 统一 success 包装
*/
async storeList(data = {}) {
const { service } = this;
const storeId = Number(data.store_id);
if (!Number.isInteger(storeId) || storeId <= 0) {
return this.failure('store_id 不能为空');
}
const { pagination } = data;
const { whereValue = {} } = this.prepareWhereContext(data);
const {
start_time: startTime,
end_time: endTime,
warehouse_ids: warehouseIdsRaw,
warehouse_id: warehouseIdRaw,
stock_ids: stockIdsRaw,
stock_id: stockIdRaw,
keyword,
ids,
transaction_type: transactionType,
order_type: orderType,
order_no: orderNo,
batch_no: batchNo,
entry_order_id: entryOrderId,
receiving_id: receivingId,
order_id: orderId,
} = whereValue;
// 兼容 warehouse_id(单数)和 warehouse_ids(数组)
const warehouseIds = warehouseIdsRaw !== undefined
? warehouseIdsRaw
: (warehouseIdRaw !== undefined ? [ warehouseIdRaw ] : undefined);
// 兼容 stock_id(单数)和 stock_ids(数组)
const stockIds = stockIdsRaw !== undefined
? stockIdsRaw
: (stockIdRaw !== undefined ? [ stockIdRaw ] : null);
const { sort = {} } = data;
const {
sort_field: sortFieldSnake,
sortField: sortFieldCamel,
sort_order: sortOrderSnake,
sortOrder: sortOrderCamel,
} = sort || {};
const sortOption = {
sortField: sortFieldCamel || sortFieldSnake,
sortOrder: sortOrderCamel || sortOrderSnake,
};
const result = await service.systems.stockTransaction.queryList({
storeId,
startTime,
endTime,
warehouseIds,
stockIds,
keyword,
ids,
transactionType,
orderType,
orderNo,
batchNo,
entryOrderId,
receivingId,
orderId,
sort: sortOption,
pagination,
});
return this.success('ok', result);
}
/**
* 仓库侧提交商品流水导出任务。
* 与 list 使用相同查询条件,异步执行,立即返回任务ID。
* @param {Object} data 请求体
* @return {Promise<Object>} 统一 success 包装(返回任务ID)
*/
async export(data = {}) {
const { service } = this;
const warehouseId = Number(this.ctx.user && this.ctx.user.store_id);
const { whereValue = {} } = this.prepareWhereContext(data);
const {
start_time: startTime,
end_time: endTime,
store_ids: storeIds,
stock_ids: stockIds,
keyword,
ids,
transaction_type: transactionType,
order_type: orderType,
order_no: orderNo,
batch_no: batchNo,
entry_order_id: entryOrderId,
receiving_id: receivingId,
order_id: orderId,
} = whereValue;
const { sort = {} } = data;
const sortOption = {
sortField: sort.sortField || sort.sort_field,
sortOrder: sort.sortOrder || sort.sort_order,
};
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.stockTransaction.exportList({
warehouseId,
startTime,
endTime,
storeIds,
stockIds,
keyword,
ids,
transactionType,
orderType,
orderNo,
batchNo,
entryOrderId,
receivingId,
orderId,
sort: sortOption,
mode: 'warehouse',
});
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(),
});
}
/**
* 货主侧提交商品流水导出任务。
* 与 storeList 使用相同查询条件,异步执行,立即返回任务ID。
* @param {Object} data 请求体
* @param {number} data.store_id 货主ID(必传)
* @return {Promise<Object>} 统一 success 包装(返回任务ID)
*/
async exportStore(data = {}) {
const { service } = this;
const storeId = Number(data.store_id);
if (!Number.isInteger(storeId) || storeId <= 0) {
return this.failure('store_id 不能为空');
}
const { whereValue = {} } = this.prepareWhereContext(data);
const {
start_time: startTime,
end_time: endTime,
warehouse_ids: warehouseIdsRaw,
warehouse_id: warehouseIdRaw,
stock_ids: stockIdsRaw,
stock_id: stockIdRaw,
keyword,
ids,
transaction_type: transactionType,
order_type: orderType,
order_no: orderNo,
batch_no: batchNo,
entry_order_id: entryOrderId,
receiving_id: receivingId,
order_id: orderId,
} = whereValue;
const warehouseIds = warehouseIdsRaw !== undefined
? warehouseIdsRaw
: (warehouseIdRaw !== undefined ? [ warehouseIdRaw ] : undefined);
const stockIds = stockIdsRaw !== undefined
? stockIdsRaw
: (stockIdRaw !== undefined ? [ stockIdRaw ] : null);
const { sort = {} } = data;
const sortOption = {
sortField: sort.sortField || sort.sort_field,
sortOrder: sort.sortOrder || sort.sort_order,
};
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.stockTransaction.exportList({
storeId,
startTime,
endTime,
warehouseIds,
stockIds,
keyword,
ids,
transactionType,
orderType,
orderNo,
batchNo,
entryOrderId,
receivingId,
orderId,
sort: sortOption,
mode: 'store',
});
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>} 统一 success 包装
*/
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。
* @return {string} 导出任务ID
*/
generateExportTaskId() {
const warehouseId = this.ctx?.user?.store_id || 'unknown';
const timestamp = Date.now();
const randomToken = Math.random().toString(36).slice(2, 10);
return `stock_transaction_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_TRANSACTION_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_TRANSACTION_EXPORT_TASK_CACHE_TTL_SECONDS);
} catch (error) {
this.ctx.logger.warn('[stock.transaction.export] 写入导出任务缓存失败: %s', error && error.message ? error.message : error);
}
}
/**
* 读取导出任务进度缓存。
* @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) {
this.ctx.logger.warn('[stock.transaction.export] 读取导出任务缓存失败: %s', error && error.message ? error.message : error);
return null;
}
}
}
module.exports = StockTransactionMethodService;