'use strict'; const MainService = require('../main'); class PickService extends MainService { /** * 初始化 pick 模块鉴权配置。 * * @param {Egg.Context} ctx 上下文对象。 */ constructor(ctx) { super(ctx); const _noNeedLogin = ''; const _noNeedRight = 'query,wavePickTaskDetail,wavePickTaskCurrent'; const _noNeedLog = 'query'; const _noNeedAuth = 'query,wavePickTaskDetail,wavePickTaskCurrent'; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } /** * 将入参标准化为布尔值。 * * 兼容 `true/false`、`1/0`、`yes/no`、`on/off` 以及大小写字符串。 * * @param {*} value 原始值。 * @param {boolean} defaultValue 默认值。 * @return {boolean} 解析后的布尔值。 */ normalizeBoolean(value, defaultValue = false) { if (value === undefined || value === null || value === '') { return defaultValue; } if (typeof value === 'boolean') { return value; } const normalized = String(value).trim().toLowerCase(); if ([ '1', 'true', 'yes', 'y', 'on' ].includes(normalized)) { return true; } if ([ '0', 'false', 'no', 'n', 'off' ].includes(normalized)) { return false; } return defaultValue; } /** * 按仓库上下文获取订单分表模型。 * * @param {number} warehouseId 仓库ID。 * @return {Promise} 订单模型。 */ async getOrderModelByWarehouse(warehouseId) { const { ctx } = this; const factory = ctx.model && ctx.model.OrderDeliveryFactory; if (!factory || typeof factory.getCurrentModel !== 'function') { throw new Error('订单分表模型工厂不可用'); } const model = await factory.getCurrentModel(warehouseId); if (!model || typeof model.findOne !== 'function') { throw new Error('订单分表模型不可用'); } return model; } /** * 按关键字获取或创建波次拣货任务。 * * 关键字支持两种命中方式: * - 命中运单号:先定位订单并强校验订单已入波次。 * - 命中波次号:直接按波次定位。 * * 命中目标波次后按以下规则处理: * - 若波次存在活动任务且创建人为当前用户:直接返回任务ID。 * - 若波次存在活动任务但创建人非当前用户:返回冲突失败信息。 * - 若波次不存在活动任务:按波次类型创建任务并返回任务ID。 * * @param {Object} data 请求参数。 * @param {string} data.keyword 运单号或波次号关键字。 * @return {Promise} 统一 success/fail 包装结果。 */ async query(data = {}) { const { service, ctx } = this; const requestData = this.isPlainObject(data) ? data : {}; const { keyword } = requestData; const normalizedKeyword = String(keyword || '').trim(); if (!normalizedKeyword) { return this.fail('请传入关键字 keyword', {}, 400); } const userWarehouseId = ctx && ctx.user ? ctx.user.store_id : undefined; const stateWarehouseId = ctx && ctx.state && ctx.state.user ? ctx.state.user.store_id : undefined; const normalizedWarehouseId = Number(userWarehouseId || stateWarehouseId || 0); if (!Number.isFinite(normalizedWarehouseId) || normalizedWarehouseId <= 0) { return this.fail('缺少当前用户仓库上下文 store_id', {}, 400); } const stateUser = this.isPlainObject(ctx && ctx.state && ctx.state.user) ? ctx.state.user : null; const ctxUser = this.isPlainObject(ctx && ctx.user) ? ctx.user : null; const operatorSource = stateUser || ctxUser || {}; const rawOperatorId = operatorSource.employees_id ?? operatorSource.operator_id ?? operatorSource.id; const operatorId = Number(rawOperatorId || 0); const operatorName = String( operatorSource.operator_name || operatorSource.employees_name || operatorSource.name || '' ).trim() || 'system'; if (!Number.isInteger(operatorId) || operatorId <= 0) { return this.fail('未获取到操作人上下文', {}, 401); } const orderExpress = await ctx.model.OrderExpress.findOne({ where: { warehouse_id: normalizedWarehouseId, waybill_code: normalizedKeyword, }, attributes: [ 'order_id' ], raw: true, }); let targetWaveId = 0; let targetWaveNo = ''; let targetWaveType = 2; let selectedOrderIds = []; const orderId = Number(orderExpress && orderExpress.order_id || 0); if (orderExpress && orderId > 0) { let orderModel = null; try { orderModel = await this.getOrderModelByWarehouse(normalizedWarehouseId); } catch (error) { return this.fail(error && error.message ? error.message : '订单模型不可用', {}, 500); } const order = await orderModel.findOne({ where: { id: orderId, warehouse_id: normalizedWarehouseId, }, attributes: [ 'id', 'wave_no', 'wave_id' ], raw: true, }); if (!order) { return this.fail('运单对应订单不存在', {}, 404); } const orderWaveId = Number(order.wave_id || 0); const orderWaveNo = String(order.wave_no || '').trim(); if (!(orderWaveId > 0 || orderWaveNo)) { return this.fail('运单对应订单未进入波次,无法创建拣货任务', {}, 400); } if (orderWaveId > 0) { const waveByIdRows = await ctx.model.query( ` SELECT wave_id, wave_no, wave_type FROM wms_wave_batch WHERE warehouse_id = :warehouseId AND wave_id = :waveId LIMIT 1 `, { replacements: { warehouseId: normalizedWarehouseId, waveId: orderWaveId, }, type: ctx.model.QueryTypes.SELECT, } ); const waveRow = Array.isArray(waveByIdRows) && waveByIdRows.length > 0 ? waveByIdRows[0] : null; if (!waveRow) { return this.fail('运单对应波次不存在或不属于当前仓库', {}, 404); } targetWaveId = Number(waveRow.wave_id || 0); targetWaveNo = String(waveRow.wave_no || '').trim(); targetWaveType = Number(waveRow.wave_type || 2); } else { const waveByNoRows = await ctx.model.query( ` SELECT wave_id, wave_no, wave_type FROM wms_wave_batch WHERE warehouse_id = :warehouseId AND wave_no = :waveNo LIMIT 1 `, { replacements: { warehouseId: normalizedWarehouseId, waveNo: orderWaveNo, }, type: ctx.model.QueryTypes.SELECT, } ); const waveRow = Array.isArray(waveByNoRows) && waveByNoRows.length > 0 ? waveByNoRows[0] : null; if (!waveRow) { return this.fail('运单对应波次不存在或不属于当前仓库', {}, 404); } targetWaveId = Number(waveRow.wave_id || 0); targetWaveNo = String(waveRow.wave_no || '').trim(); targetWaveType = Number(waveRow.wave_type || 2); } } else { const waveRows = await ctx.model.query( ` SELECT wave_id, wave_no, wave_type FROM wms_wave_batch WHERE warehouse_id = :warehouseId AND wave_no = :waveNo LIMIT 1 `, { replacements: { warehouseId: normalizedWarehouseId, waveNo: normalizedKeyword, }, type: ctx.model.QueryTypes.SELECT, } ); const waveRow = Array.isArray(waveRows) && waveRows.length > 0 ? waveRows[0] : null; if (!waveRow) { return this.fail('关键字未命中运单号或波次号', {}, 404); } targetWaveId = Number(waveRow.wave_id || 0); targetWaveNo = String(waveRow.wave_no || '').trim(); targetWaveType = Number(waveRow.wave_type || 2); } if (!Number.isInteger(targetWaveId) || targetWaveId <= 0 || !targetWaveNo) { return this.fail('目标波次信息不完整', {}, 400); } const activeTaskRows = await ctx.model.query( ` SELECT t.id AS task_id, t.pick_user_id, t.pick_user_name FROM wms_wave_pick_task_wave tw INNER JOIN wms_wave_pick_task t ON t.id = tw.task_id WHERE tw.wave_id = :waveId AND t.warehouse_id = :warehouseId AND t.status IN (0, 1, 2) ORDER BY t.id DESC LIMIT 1 `, { replacements: { waveId: targetWaveId, warehouseId: normalizedWarehouseId, }, type: ctx.model.QueryTypes.SELECT, } ); const activeTask = Array.isArray(activeTaskRows) && activeTaskRows.length > 0 ? activeTaskRows[0] : null; if (activeTask) { const activeTaskId = Number(activeTask.task_id || 0); const taskOwnerId = Number(activeTask.pick_user_id || 0); const taskOwnerName = String(activeTask.pick_user_name || '').trim() || `${taskOwnerId}`; if (taskOwnerId > 0 && taskOwnerId === operatorId) { return this.success('ok', { data: { task_id: activeTaskId, status: 'existing', tip: '当前波次已有您创建的活动任务,可直接继续', }, code: 200, }); } return this.fail( `当前波次已由其他人创建活动任务,请移交任务创建人处理(创建人: ${taskOwnerName},任务ID: ${activeTaskId})`, { task_id: activeTaskId, task_owner_id: taskOwnerId, task_owner_name: taskOwnerName, }, 409 ); } const normalizedWaveType = Number(targetWaveType || 2); const isGroupWave = normalizedWaveType === 1; const pickMode = isGroupWave ? 1 : 2; if (!isGroupWave && selectedOrderIds.length === 0) { let orderModel = null; try { orderModel = await this.getOrderModelByWarehouse(normalizedWarehouseId); } catch (error) { return this.fail(error && error.message ? error.message : '订单模型不可用', {}, 500); } const orderRows = await orderModel.findAll({ where: { warehouse_id: normalizedWarehouseId, wave_id: targetWaveId, }, attributes: [ 'id' ], raw: true, }); selectedOrderIds = [ ...new Set((Array.isArray(orderRows) ? orderRows : []) .map(item => Number(item && item.id || 0)) .filter(id => Number.isInteger(id) && id > 0)) ]; if (selectedOrderIds.length <= 0) { const fallbackRows = await orderModel.findAll({ where: { warehouse_id: normalizedWarehouseId, wave_no: targetWaveNo, }, attributes: [ 'id' ], raw: true, }); selectedOrderIds = [ ...new Set((Array.isArray(fallbackRows) ? fallbackRows : []) .map(item => Number(item && item.id || 0)) .filter(id => Number.isInteger(id) && id > 0)) ]; } if (selectedOrderIds.length <= 0) { return this.fail('散单波次下无可用订单,无法创建任务', {}, 400); } } try { const plan = { strategy_id: 0, warehouse_id: normalizedWarehouseId, source: 'pda', operator: { operator_id: operatorId, operator_name: operatorName, }, pick_mode: pickMode, wave_limit: 1, order_limit: selectedOrderIds.length, sku_limit: 0, box_limit: 0, dynamic_append: false, selected_wave_ids: [ targetWaveId ], }; const createData = { keyword: normalizedKeyword, selected_order_ids: pickMode === 2 ? selectedOrderIds : [], }; const createdTask = await service.systemMethods.order.wave.createWavePickTaskFromPlan({ plan, data: createData, waveBatchSource: 2, }); return this.success('ok', { data: { task_id: createdTask.task_id, status: 'created', tip: '任务创建成功', }, code: 200, }); } catch (error) { const code = Number(error && error.code); if (Number.isFinite(code) && code >= 400 && code < 600) { return this.fail(error.message || '任务创建失败', {}, code); } ctx.logger.error('[PickService.query] 获取或创建波次任务失败: %s', error && error.message ? error.message : error); return this.fail('任务创建失败', {}, 500); } } /** * 查询拣货任务详情。 * * 仅允许任务创建人查看任务详情,包含主任务、波次、订单与框信息。 * * @param {Object} data 请求参数。 * @param {number|string} data.task_id 拣货任务ID。 * @return {Promise} 统一 success/fail 包装结果。 */ async wavePickTaskDetail(data = {}) { const { service, ctx } = this; const requestData = this.isPlainObject(data) ? data : {}; const { task_id } = requestData; const taskId = Number(task_id); if (!Number.isInteger(taskId) || taskId <= 0) { return this.fail('task_id 必填且必须为正整数', {}, 400); } const stateUser = this.isPlainObject(ctx && ctx.state && ctx.state.user) ? ctx.state.user : null; const ctxUser = this.isPlainObject(ctx && ctx.user) ? ctx.user : null; const operatorSource = stateUser || ctxUser || {}; const rawOperatorId = operatorSource.employees_id ?? operatorSource.operator_id ?? operatorSource.id; const operatorId = Number(rawOperatorId || 0); if (!Number.isInteger(operatorId) || operatorId <= 0) { return this.fail('未获取到操作人上下文', {}, 401); } try { const result = await service.systems.pick.wavePickTaskDetail({ taskId, operatorId, }); return this.success('ok', { data: result, code: 200, }); } catch (error) { const code = Number(error && error.code); if (Number.isInteger(code) && code >= 400 && code < 600) { return this.fail(error.message || '查询失败', {}, code); } ctx.logger.error('[PickService.wavePickTaskDetail] 查询拣货任务详情失败: %s', error && error.message ? error.message : error); return this.fail('查询失败', {}, 500); } } /** * 查询当前登录用户正在处理中的拣货任务。 * * 仅供 PDA 使用,无需入参;按当前登录用户与仓库上下文返回最新任务ID。 * * @return {Promise} 统一 success/fail 包装结果。 */ async wavePickTaskCurrent() { const { service, ctx } = this; try { const result = await service.systems.pick.wavePickTaskCurrent(); return this.success('ok', { data: result, code: 200, }); } catch (error) { const code = Number(error && error.code); if (Number.isInteger(code) && code >= 400 && code < 600) { return this.fail(error.message || '查询失败', {}, code); } ctx.logger.error('[PickService.wavePickTaskCurrent] 查询当前拣货任务失败: %s', error && error.message ? error.message : error); return this.fail('查询失败', {}, 500); } } } module.exports = PickService;