'use strict'; const MainService = require('../../main'); const STORAGE_REPORT_EXPORT_TASK_CACHE_KEY_PREFIX = 'storage_report_export_task_'; const STORAGE_REPORT_EXPORT_TASK_CACHE_TTL_SECONDS = 1800; /** * 系统方法层:storage.report(库存流水报表接口包装层)。 */ class StorageReportMethodService extends MainService { constructor(ctx) { super(ctx); const _noNeedLogin = ''; const _noNeedRight = 'search,export,exportTaskProgress'; const _noNeedLog = 'search,export,exportTaskProgress'; const _noNeedAuth = 'search,export,exportTaskProgress'; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } /** * 查询库存流水统计报表。 * @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) * @param {string|Date} [data.where.start_time] 开始时间 * @param {string|Date} [data.where.end_time] 结束时间 * @param {boolean|string|number} [data.where.by_space=false] 是否按库位返回 * @param {Array} [data.where.store_ids] 货主ID列表 * @return {Promise} 统一 success 包装 */ async search(data = {}) { const { service } = this; const { whereValue = {} } = this.prepareWhereContext(data); const { start_time: startTime, end_time: endTime, by_space: bySpace, store_ids: storeIds, sort_field: whereSortField, sortField: whereSortFieldCamel, sort_order: whereSortOrder, sortOrder: whereSortOrderCamel, } = whereValue; const { sort = {} } = data; const { sort_field: sortFieldSnake, sortField: sortFieldCamel, sort_order: sortOrderSnake, sortOrder: sortOrderCamel, } = sort || {}; const result = await service.systems.storage.report.search(startTime, endTime, bySpace, storeIds, { sortField: sortFieldCamel || sortFieldSnake || whereSortFieldCamel || whereSortField, sortOrder: sortOrderCamel || sortOrderSnake || whereSortOrderCamel || whereSortOrder, }); return this.success('ok', result); } /** * 提交库存流水统计报表导出任务。 * @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) * @param {string|Date} [data.where.start_time] 开始时间 * @param {string|Date} [data.where.end_time] 结束时间 * @param {boolean|string|number} [data.where.by_space=false] 是否按库位返回 * @param {Array} [data.where.store_ids] 货主ID列表 * @return {Promise} 统一 success 包装(返回任务ID) */ async export(data = {}) { const { service } = this; const { whereValue = {} } = this.prepareWhereContext(data); const { start_time: startTime, end_time: endTime, by_space: bySpace, store_ids: storeIds, sort_field: whereSortField, sortField: whereSortFieldCamel, sort_order: whereSortOrder, sortOrder: whereSortOrderCamel, } = whereValue; const { sort = {} } = data; const { sort_field: sortFieldSnake, sortField: sortFieldCamel, sort_order: sortOrderSnake, sortOrder: sortOrderCamel, } = sort || {}; const taskId = this.generateExportTaskId(); const taskPayload = { task_id: taskId, status: 'submitted', progress: 0, message: '导出任务已提交', result: null, error: '', }; await this.setExportTaskProgress(taskId, taskPayload); const sortOption = { sortField: sortFieldCamel || sortFieldSnake || whereSortFieldCamel || whereSortField, sortOrder: sortOrderCamel || sortOrderSnake || whereSortOrderCamel || whereSortOrder, }; setImmediate(async () => { try { await this.setExportTaskProgress(taskId, { task_id: taskId, status: 'running', progress: 10, message: '导出任务执行中', result: null, error: '', }); const result = await service.systems.storage.report.export(startTime, endTime, bySpace, storeIds, sortOption); 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 `storage_report_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 `${STORAGE_REPORT_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, STORAGE_REPORT_EXPORT_TASK_CACHE_TTL_SECONDS); } catch (error) { this.ctx.logger.warn('[storage.report.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('[storage.report.export] 读取导出任务缓存失败: %s', error && error.message ? error.message : error); return null; } } } module.exports = StorageReportMethodService;