liufumingren 0c3518e65d 1
2026-05-13 03:18:39 +08:00

456 lines
15 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,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<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;
}
/**
* 按关键字获取或创建波次拣货任务。
*
* 关键字支持两种命中方式:
* - 命中运单号:先定位订单并强校验订单已入波次。
* - 命中波次号:直接按波次定位。
*
* 命中目标波次后按以下规则处理:
* - 若波次存在活动任务且创建人为当前用户:直接返回任务ID。
* - 若波次存在活动任务但创建人非当前用户:返回冲突失败信息。
* - 若波次不存在活动任务:按波次类型创建任务并返回任务ID。
*
* @param {Object} data 请求参数。
* @param {string} data.keyword 运单号或波次号关键字。
* @return {Promise<Object>} 统一 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<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) {
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<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);
}
}
}
module.exports = PickService;