542 lines
15 KiB
JavaScript
542 lines
15 KiB
JavaScript
'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: 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;
|
||
|
||
// 兼容 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({
|
||
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(ctx.user.store_id)限定数据范围,不接受外部传入 store_id,防止跨货主查询。
|
||
* @param {Object} data 请求体
|
||
* @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(this.ctx.user && this.ctx.user.store_id);
|
||
if (!Number.isInteger(storeId) || storeId <= 0) {
|
||
return this.failure('无法获取当前货主身份,请重新登录');
|
||
}
|
||
|
||
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,
|
||
mode: 'store',
|
||
});
|
||
|
||
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: 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;
|
||
|
||
// 兼容 stock_id(单数)和 stock_ids(数组)
|
||
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({
|
||
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。
|
||
* store_id 从当前登录上下文(ctx.user.store_id)获取,不接受外部传入,防止跨货主查询。
|
||
* @param {Object} data 请求体
|
||
* @return {Promise<Object>} 统一 success 包装(返回任务ID)
|
||
*/
|
||
async exportStore(data = {}) {
|
||
const { service } = this;
|
||
const storeId = Number(this.ctx.user && this.ctx.user.store_id);
|
||
if (!Number.isInteger(storeId) || storeId <= 0) {
|
||
return this.failure('无法获取当前货主身份,请重新登录');
|
||
}
|
||
|
||
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;
|