456 lines
15 KiB
JavaScript
456 lines
15 KiB
JavaScript
'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;
|