liufumingren 2817d17fc7 1
2026-07-06 00:33:12 +08:00

1158 lines
39 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');
class PickService extends MainService {
/**
* 初始化 pick 模块鉴权配置。
*
* @param {Egg.Context} ctx 上下文对象。
*/
constructor(ctx) {
super(ctx);
const _noNeedLogin = '';
const _noNeedRight = 'query,wavePickComplete,wavePickTaskDetail,wavePickTaskCurrent,wavePickTaskSubmit,wavePickTaskComplete';
const _noNeedLog = 'query';
const _noNeedAuth = 'query,wavePickComplete,wavePickTaskDetail,wavePickTaskCurrent,wavePickTaskSubmit,wavePickTaskComplete';
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<Object>} 订单模型。
*/
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;
}
/**
* 生成拣货任务编号。
*
* @return {string} 任务编号。
*/
generatePickTaskNo() {
const now = new Date();
const pad2 = value => String(value).padStart(2, '0');
const datePart = `${now.getFullYear()}${pad2(now.getMonth() + 1)}${pad2(now.getDate())}`;
const timePart = `${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
const randomPart = Math.random().toString(36).slice(2, 6)
.toUpperCase();
return `PK${datePart}${timePart}${randomPart}`;
}
/**
* 创建波次拣货任务及关联关系。
*
* @param {Object} params 创建参数。
* @param {number} params.warehouseId 仓库ID。
* @param {number} params.waveId 波次ID。
* @param {string} params.waveNo 波次号。
* @param {number} params.pickMode 拣货模式。
* @param {number} params.operatorId 操作人ID。
* @param {string} params.operatorName 操作人名称。
* @param {Array<number>} params.orderIds 波次订单ID集合。
* @param {string} [params.remark=''] 备注。
* @param {number} [params.source=2] 任务来源:1-PDA抓取创建,2-扫描进任务/后台抓取,默认为2。
* @return {Promise<{task_id: number, task_no: string}>} 创建结果。
*/
async createWavePickTask(params = {}) {
const { ctx } = this;
const warehouseId = Number(params && params.warehouseId || 0);
const waveId = Number(params && params.waveId || 0);
const waveNo = String(params && params.waveNo || '').trim();
const pickMode = Number(params && params.pickMode || 2);
const operatorId = Number(params && params.operatorId || 0);
const operatorName = String(params && params.operatorName || '').trim() || 'system';
const source = Number(params && params.source !== undefined ? params.source : 2);
const remark = String(params && params.remark || '').trim();
const normalizedOrderIds = [ ...new Set((Array.isArray(params && params.orderIds) ? params.orderIds : [])
.map(id => Number(id || 0))
.filter(id => Number.isInteger(id) && id > 0)) ];
if (!Number.isInteger(warehouseId) || warehouseId <= 0) {
throw Object.assign(new Error('warehouse_id 参数不合法'), { code: 400 });
}
if (!Number.isInteger(waveId) || waveId <= 0 || !waveNo) {
throw Object.assign(new Error('目标波次信息不完整'), { code: 400 });
}
if (!Number.isInteger(operatorId) || operatorId <= 0) {
throw Object.assign(new Error('未获取到操作人上下文'), { code: 401 });
}
if (normalizedOrderIds.length <= 0) {
throw Object.assign(new Error('波次下无可用订单,无法创建任务'), { code: 400 });
}
const orderModel = await this.getOrderModelByWarehouse(warehouseId);
const orderRows = await orderModel.findAll({
where: {
warehouse_id: warehouseId,
id: {
[this.app.Sequelize.Op.in]: normalizedOrderIds,
},
},
attributes: [ 'id' ],
raw: true,
});
const orderNoMap = new Map((Array.isArray(orderRows) ? orderRows : [])
.map(row => [ Number(row && row.id || 0), '' ]));
const taskNo = this.generatePickTaskNo();
const transaction = await ctx.model.transaction();
try {
const taskInsertResult = await ctx.model.query(
`
INSERT INTO wms_wave_pick_task (
task_no,
warehouse_id,
wave_id,
pick_mode,
status,
source,
wave_count,
order_count,
box_count,
pick_user_id,
pick_user_name,
remark,
create_time,
update_time
) VALUES (
:taskNo,
:warehouseId,
:waveId,
:pickMode,
0,
:source,
1,
:orderCount,
0,
:operatorId,
:operatorName,
:remark,
NOW(),
NOW()
)
`,
{
replacements: {
taskNo,
warehouseId,
waveId,
pickMode,
source,
orderCount: normalizedOrderIds.length,
operatorId,
operatorName,
remark,
},
transaction,
}
);
const taskInsertHead = Array.isArray(taskInsertResult) ? taskInsertResult[0] : null;
const taskInsertMeta = Array.isArray(taskInsertResult) ? taskInsertResult[1] : null;
let taskId = Number(
(taskInsertMeta && (taskInsertMeta.insertId || taskInsertMeta.lastID || taskInsertMeta.id))
|| (taskInsertHead && (taskInsertHead.insertId || taskInsertHead.lastID || taskInsertHead.id))
|| 0
);
if (!Number.isInteger(taskId) || taskId <= 0) {
const taskIdRows = await ctx.model.query(
`
SELECT id
FROM wms_wave_pick_task
WHERE warehouse_id = :warehouseId
AND task_no = :taskNo
ORDER BY id DESC
LIMIT 1
`,
{
replacements: {
warehouseId,
taskNo,
},
type: ctx.model.QueryTypes.SELECT,
transaction,
}
);
const taskRow = Array.isArray(taskIdRows) && taskIdRows.length > 0 ? taskIdRows[0] : null;
taskId = Number(taskRow && taskRow.id || 0);
}
if (!Number.isInteger(taskId) || taskId <= 0) {
throw Object.assign(new Error('任务创建失败(未返回任务ID)'), { code: 500 });
}
await ctx.model.query(
`
INSERT INTO wms_wave_pick_task_wave (
task_id,
wave_id,
wave_no,
status,
warehouse_id,
bind_time,
create_time,
update_time
) VALUES (
:taskId,
:waveId,
:waveNo,
0,
:warehouseId,
NOW(),
NOW(),
NOW()
)
`,
{
replacements: {
taskId,
waveId,
waveNo,
warehouseId,
},
transaction,
}
);
if (normalizedOrderIds.length > 0) {
const orderValuesSql = [];
const orderReplacements = {};
normalizedOrderIds.forEach((orderId, index) => {
const orderIdKey = `orderId${index}`;
const orderNoKey = `orderNo${index}`;
orderValuesSql.push(`(
:taskId,
:waveId,
:${orderIdKey},
:${orderNoKey},
:warehouseId,
0,
0,
NOW(),
NOW()
)`);
orderReplacements[orderIdKey] = orderId;
orderReplacements[orderNoKey] = orderNoMap.get(orderId) || '';
});
await ctx.model.query(
`
INSERT INTO wms_wave_pick_task_order (
task_id,
wave_id,
order_id,
order_no,
warehouse_id,
pick_status,
review_status,
create_time,
update_time
) VALUES ${orderValuesSql.join(',\n')}
`,
{
replacements: {
taskId,
waveId,
warehouseId,
...orderReplacements,
},
transaction,
}
);
}
await transaction.commit();
// 写入 order_operation_log 抓取波次日志
try {
const operationLogService = this.ctx
&& this.ctx.service
&& this.ctx.service.systems
&& this.ctx.service.systems.operationLog;
if (operationLogService && typeof operationLogService.createOperationLogs === 'function') {
const logPayloads = normalizedOrderIds.map(orderId => ({
businessType: 'order',
businessId: `${orderId}`,
operationCode: 'ORDER_WAVE_GRAB',
operator: {
id: operatorId ? String(operatorId) : null,
name: operatorName || 'system',
},
extras: {
message: `订单${orderId}抓取波次成功`,
warehouseId,
externalLogType: 'PDA',
},
}));
await operationLogService.createOperationLogs(logPayloads);
}
} catch (e) {
ctx.logger.warn('[pick.createWavePickTask] 写入 order_operation_log 失败,不影响主流程', {
error: e && e.message,
normalizedOrderIds,
});
}
return {
task_id: taskId,
task_no: taskNo,
};
} catch (error) {
await transaction.rollback();
throw error;
}
}
/**
* 按关键字获取或创建波次拣货任务。
*
* 关键字支持两种命中方式:
* - 命中运单号:先定位订单并强校验订单已入波次。
* - 命中波次号:直接按波次定位。
*
* 去重策略(按优先级):
* 1. 波次级去重:同一 warehouse_id + 同一 wave_id 且存在活动任务(status IN 0,1)时不再创建。
* 2. keyword 级去重:同一 warehouse_id + 同一 keyword(remark 字段)在 30 分钟内已有任务时不再创建。
* - 已完成(status IN 2,3):直接返回已有任务结果。
* - 进行中(status IN 0,1):返回冲突提示。
*
* 命中目标波次后按以下规则处理:
* - 若波次存在活动任务且创建人为当前用户:直接返回任务ID。
* - 若波次存在活动任务但创建人非当前用户:返回冲突失败信息。
* - 若波次不存在活动任务:按波次类型创建任务并返回任务ID。
*
* @param {Object} data 请求参数。
* @param {string} data.keyword 运单号或波次号关键字。
* @return {Promise<Object>} 统一 success/fail 包装结果。
*/
async query(data = {}) {
const { 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 t
WHERE t.warehouse_id = :warehouseId
AND t.status IN (0, 1)
AND (
t.wave_id = :waveId
OR EXISTS (
SELECT 1
FROM wms_wave_pick_task_wave tw
WHERE tw.task_id = t.id
AND tw.wave_id = :waveId
)
)
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
);
}
// 波次级已完成任务去重:同一 warehouse_id + 同一 wave_id 已有完成任务时不再创建
const completedTaskRows = await ctx.model.query(
`
SELECT t.id AS task_id, t.status, t.pick_user_id, t.pick_user_name
FROM wms_wave_pick_task t
WHERE t.warehouse_id = :warehouseId
AND t.status IN (2, 3)
AND (
t.wave_id = :waveId
OR EXISTS (
SELECT 1
FROM wms_wave_pick_task_wave tw
WHERE tw.task_id = t.id
AND tw.wave_id = :waveId
)
)
ORDER BY t.id DESC
LIMIT 1
`,
{
replacements: {
waveId: targetWaveId,
warehouseId: normalizedWarehouseId,
},
type: ctx.model.QueryTypes.SELECT,
}
);
const completedTask = Array.isArray(completedTaskRows) && completedTaskRows.length > 0 ? completedTaskRows[0] : null;
if (completedTask) {
return this.success('ok', {
data: {
task_id: Number(completedTask.task_id),
status: 'existing_completed',
tip: '该波次已完成拣货任务,无需重复创建',
},
code: 200,
});
}
// keyword 级别去重:同一 warehouse_id + 同一 keyword(remark)在 30 分钟内已有任务则不再创建
const keywordRemark = `pick.query keyword=${normalizedKeyword}`;
const keywordDedupRows = await ctx.model.query(
`
SELECT t.id AS task_id, t.status, t.pick_user_id, t.pick_user_name
FROM wms_wave_pick_task t
WHERE t.warehouse_id = :warehouseId
AND t.remark = :remark
AND t.create_time >= DATE_SUB(NOW(), INTERVAL 30 MINUTE)
ORDER BY t.id DESC
LIMIT 1
`,
{
replacements: {
warehouseId: normalizedWarehouseId,
remark: keywordRemark,
},
type: ctx.model.QueryTypes.SELECT,
}
);
const keywordDedupTask = Array.isArray(keywordDedupRows) && keywordDedupRows.length > 0 ? keywordDedupRows[0] : null;
if (keywordDedupTask) {
const existingTaskId = Number(keywordDedupTask.task_id || 0);
const existingStatus = Number(keywordDedupTask.status ?? -1);
// 已完成(status=2 待复核 / status=3 已完成):直接返回已有结果,不创建新任务
if (existingStatus === 2 || existingStatus === 3) {
return this.success('ok', {
data: {
task_id: existingTaskId,
status: 'existing_completed',
tip: '该关键字近期已有完成任务,无需重复创建',
},
code: 200,
});
}
// 进行中(status=0 待开始 / status=1 拣货中):返回已有任务ID,提示任务进行中
if (existingStatus === 0 || existingStatus === 1) {
const taskOwnerId = Number(keywordDedupTask.pick_user_id || 0);
const taskOwnerName = String(keywordDedupTask.pick_user_name || '').trim() || `${taskOwnerId}`;
return this.fail(
`该关键字近期已有进行中任务(创建人: ${taskOwnerName},任务ID: ${existingTaskId}),请稍后再试`,
{
task_id: existingTaskId,
task_owner_id: taskOwnerId,
task_owner_name: taskOwnerName,
},
409
);
}
}
const normalizedWaveType = Number(targetWaveType || 2);
const isGroupWave = normalizedWaveType === 1;
const pickMode = isGroupWave ? 1 : 2;
if (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 createdTask = await this.createWavePickTask({
warehouseId: normalizedWarehouseId,
waveId: targetWaveId,
waveNo: targetWaveNo,
pickMode,
operatorId,
operatorName,
orderIds: selectedOrderIds,
remark: `pick.query keyword=${normalizedKeyword}`,
source: 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<Object>} 统一 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) {
const errorData = this.isPlainObject(error && error.data) ? error.data : {};
return this.fail(error.message || '查询失败', errorData, code);
}
ctx.logger.error('[PickService.wavePickTaskDetail] 查询拣货任务详情失败: %s', error && error.message ? error.message : error);
return this.fail('查询失败', {}, 500);
}
}
/**
* 查询当前登录用户正在处理中的拣货任务。
*
* 仅供 PDA 使用,无需入参;按当前登录用户与仓库上下文返回最新任务ID。
*
* @return {Promise<Object>} 统一 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);
}
}
/**
* 提交拣货任务中间态。
*
* @param {Object} data 请求参数。
* @param {number|string} data.task_id 拣货任务ID。
* @param {Object} [data.payload] 中间态业务数据。
* @return {Promise<Object>} 统一 success/fail 包装结果。
*/
async wavePickTaskSubmit(data = {}) {
const { service, ctx } = this;
const requestData = this.isPlainObject(data) ? data : {};
const taskId = Number(requestData.task_id || requestData.taskId || 0);
if (!Number.isInteger(taskId) || taskId <= 0) {
return this.fail('task_id 必填且必须为正整数', {}, 400);
}
try {
const result = await service.systems.pick.wavePickTaskSubmit({
taskId,
payload: this.isPlainObject(requestData.payload) ? requestData.payload : {},
});
return this.success('ok', {
data: result,
code: 200,
});
} catch (error) {
const code = Number(error && error.code);
if (Number.isInteger(code) && code >= 400 && code < 600) {
const errorData = this.isPlainObject(error && error.data) ? error.data : {};
return this.fail(error.message || '提交失败', errorData, code);
}
ctx.logger.error('[PickService.wavePickTaskSubmit] 提交拣货任务中间态失败: %s', error && error.message ? error.message : error);
return this.fail('提交失败', {}, 500);
}
}
/**
* 按波次号一键完成拣货。
*
* 内部复用 query 的去重与任务创建逻辑:
* - 若波次已有当前用户的活动任务 → 直接复用并完成。
* - 若波次已有他人活动任务 → 返回 409 冲突。
* - 若波次已完成 → 返回 already_completed。
* - 否则新建任务(source=2,后台抓取),创建成功后在内部调用 wavePickTaskComplete(mode=1 全部确认)完成拣货。
*
* @param {Object} data 请求参数。
* @param {number|string} data.wave_id 波次ID。
* @return {Promise<Object>} 统一 success/fail 包装结果。
*/
async wavePickComplete(data = {}) {
const { service, ctx } = this;
const requestData = this.isPlainObject(data) ? data : {};
const waveId = Number(requestData.wave_id || requestData.waveId || 0);
if (!Number.isInteger(waveId) || waveId <= 0) {
return this.fail('wave_id 必填且必须为正整数', {}, 400);
}
// --- 解析操作人上下文(与 query 保持一致)---
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);
}
// --- 按 wave_id 直接查波次 ---
const waveRows = 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 },
type: ctx.model.QueryTypes.SELECT,
}
);
const waveRow = Array.isArray(waveRows) && waveRows.length > 0 ? waveRows[0] : null;
if (!waveRow) {
return this.fail('波次不存在或不属于当前仓库', {}, 404);
}
const targetWaveId = Number(waveRow.wave_id || 0);
const targetWaveNo = String(waveRow.wave_no || '').trim();
const targetWaveType = Number(waveRow.wave_type || 2);
if (!Number.isInteger(targetWaveId) || targetWaveId <= 0 || !targetWaveNo) {
return this.fail('目标波次信息不完整', {}, 400);
}
// --- 去重:活动任务检查(与 query 一致)---
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 t
WHERE t.warehouse_id = :warehouseId
AND t.status IN (0, 1)
AND (
t.wave_id = :waveId
OR EXISTS (
SELECT 1
FROM wms_wave_pick_task_wave tw
WHERE tw.task_id = t.id
AND tw.wave_id = :waveId
)
)
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;
let taskId = 0;
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.fail(
`当前波次已由其他人创建活动任务,请移交任务创建人处理(创建人: ${taskOwnerName},任务ID: ${activeTaskId})`,
{ task_id: activeTaskId, task_owner_id: taskOwnerId, task_owner_name: taskOwnerName },
409
);
}
// 当前用户的活动任务,直接复用
taskId = activeTaskId;
}
// --- 去重:已完成任务检查(与 query 一致)---
if (taskId <= 0) {
const completedTaskRows = await ctx.model.query(
`SELECT t.id AS task_id
FROM wms_wave_pick_task t
WHERE t.warehouse_id = :warehouseId
AND t.status IN (2, 3)
AND (
t.wave_id = :waveId
OR EXISTS (
SELECT 1
FROM wms_wave_pick_task_wave tw
WHERE tw.task_id = t.id
AND tw.wave_id = :waveId
)
)
ORDER BY t.id DESC
LIMIT 1`,
{
replacements: { waveId: targetWaveId, warehouseId: normalizedWarehouseId },
type: ctx.model.QueryTypes.SELECT,
}
);
const completedTask = Array.isArray(completedTaskRows) && completedTaskRows.length > 0 ? completedTaskRows[0] : null;
if (completedTask) {
return this.success('ok', {
data: {
task_id: Number(completedTask.task_id),
status: 'already_completed',
tip: '该波次已完成拣货任务,无需重复操作',
},
code: 200,
});
}
}
// --- 无已有任务则创建新任务(与 query 一致)---
if (taskId <= 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,
});
let 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);
}
const normalizedWaveType = Number(targetWaveType || 2);
const isGroupWave = normalizedWaveType === 1;
const pickMode = isGroupWave ? 1 : 2;
try {
const createdTask = await this.createWavePickTask({
warehouseId: normalizedWarehouseId,
waveId: targetWaveId,
waveNo: targetWaveNo,
pickMode,
operatorId,
operatorName,
orderIds: selectedOrderIds,
remark: `pick.wavePickComplete wave_id=${waveId}`,
source: 2,
});
taskId = createdTask.task_id;
} 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.wavePickComplete] 创建波次任务失败: %s', error && error.message ? error.message : error);
return this.fail('任务创建失败', {}, 500);
}
}
// --- 任务已就绪,调用内部 wavePickTaskComplete 全部确认完成 ---
try {
const result = await service.systems.pick.wavePickTaskComplete({
taskId,
mode: 1,
orderIds: [],
});
return this.success('ok', {
data: {
...result,
status: 'completed',
tip: '波次拣货已完成',
},
code: 200,
});
} catch (error) {
const code = Number(error && error.code);
if (Number.isInteger(code) && code >= 400 && code < 600) {
const errorData = this.isPlainObject(error && error.data) ? error.data : {};
return this.fail(error.message || '拣货完成失败', errorData, code);
}
ctx.logger.error('[PickService.wavePickComplete] 完成拣货失败: %s', error && error.message ? error.message : error);
return this.fail('拣货完成失败', {}, 500);
}
}
/**
* 完全提交拣货任务。
*
* mode: 1=全部确认,2=部分确认(需传 order_ids)。
*
* @param {Object} data 请求参数。
* @param {number|string} data.task_id 拣货任务ID。
* @param {number|string} [data.mode=1] 提交模式。
* @param {Array<number|string>|number|string} [data.order_ids] 部分确认时的订单ID集合。
* @return {Promise<Object>} 统一 success/fail 包装结果。
*/
async wavePickTaskComplete(data = {}) {
const { service, ctx } = this;
const requestData = this.isPlainObject(data) ? data : {};
const taskId = Number(requestData.task_id || requestData.taskId || 0);
const mode = Number(requestData.mode || 1);
const rawOrderIds = requestData.order_ids !== undefined
? requestData.order_ids
: requestData.orderIds;
let orderIds = [];
if (Array.isArray(rawOrderIds)) {
orderIds = rawOrderIds;
} else if (typeof rawOrderIds === 'string') {
orderIds = rawOrderIds.split(',');
} else if (typeof rawOrderIds === 'number') {
orderIds = [ rawOrderIds ];
}
const normalizedOrderIds = [ ...new Set(orderIds
.map(id => Number(id || 0))
.filter(id => Number.isInteger(id) && id > 0)) ];
if (!Number.isInteger(taskId) || taskId <= 0) {
return this.fail('task_id 必填且必须为正整数', {}, 400);
}
try {
const result = await service.systems.pick.wavePickTaskComplete({
taskId,
mode,
orderIds: normalizedOrderIds,
});
return this.success('ok', {
data: result,
code: 200,
});
} catch (error) {
const code = Number(error && error.code);
if (Number.isInteger(code) && code >= 400 && code < 600) {
const errorData = this.isPlainObject(error && error.data) ? error.data : {};
return this.fail(error.message || '提交失败', errorData, code);
}
ctx.logger.error('[PickService.wavePickTaskComplete] 完全提交拣货任务失败: %s', error && error.message ? error.message : error);
return this.fail('提交失败', {}, 500);
}
}
}
module.exports = PickService;