'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} 统一 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, 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, 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} 统一 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, 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, transactionType, orderType, orderNo, batchNo, entryOrderId, receivingId, orderId, sort: sortOption, pagination, }); return this.success('ok', result); } /** * 仓库侧提交商品流水导出任务。 * 与 list 使用相同查询条件,异步执行,立即返回任务ID。 * @param {Object} data 请求体 * @return {Promise} 统一 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, 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, 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} 统一 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, 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, 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} 统一 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} 无返回值 */ 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} 任务缓存 */ 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;