WMS_MAIN/database/migrations/20260906100000-backfill-order-wave-scope-single.js
liufumingren 6939d9600a feat: 拦截链路完善与车绑定修复
- 订单表新增 intercept_time 拦截时间字段(迁移覆盖基表与全部分表),全拦截链路写入拦截时间、解除拦截清空

- 新增自动库内拦截确定定时任务(1h 间隔,扫描 requested+未打印订单,超时自动库内拦截确定)

- 复核链路自动移除波次内未打印拦截订单回池,拦截解除后可重新抓取发货

- 打印解绑车判定排除拦截订单,修复波次含拦截订单时车无法解锁

- 同步 methods 文档与变更记录;含 wave_scope 回填、workbench token 过期等前序迁移
2026-09-07 03:48:43 +08:00

130 lines
4.5 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';
/**
* 存量订单治理:单品单件散单波次订单回填 wave_scope = 4。
*
* 口径(与代码写入逻辑 resolveWaveScopeByWaveMeta 一致):
* - 订单 wave_id > 0;
* - 波次 wms_wave_batch.wave_type = 2(散单);
* - 该波次最新拣货任务 pick_mode = 2(单品单件,1-小团购 2-单品单件 3-先拣后分 4-边拣边分 5-大团购)。
*
* pick_mode 取“每波次最新任务”:wms_wave_pick_task(wave_id 直连)与
* wms_wave_pick_task_wave(任务-波次关联)两个来源取 id 最大的一条。
* MySQL 5.7 兼容(不使用窗口函数)。
*
* 覆盖范围:基表 wms_order_delivery 与全部仓库分表(current/history/dispatch/outsourced)。
* 幂等:按条件覆盖写入,重复执行结果一致。
*/
const BASE_TABLE = 'wms_order_delivery';
const SHARD_PATTERN = /^wms_order_delivery_(\d+)(?:_(history|dispatch|outsourced))?$/;
/** 每波次最新拣货任务的 pick_mode 派生表 SQL(两个来源取 id 最大,DISTINCT 去重防止直连/关联重复行放大) */
const LATEST_PICK_MODE_SQL = `
SELECT u2.wave_id, u2.pick_mode
FROM (
SELECT DISTINCT wave_id, pick_mode, id
FROM (
SELECT wave_id, pick_mode, id FROM wms_wave_pick_task
UNION ALL
SELECT tw.wave_id, t.pick_mode, t.id
FROM wms_wave_pick_task_wave tw
JOIN wms_wave_pick_task t ON t.id = tw.task_id
) u
) u2
JOIN (
SELECT wave_id, MAX(id) AS max_id
FROM (
SELECT wave_id, id FROM wms_wave_pick_task
UNION ALL
SELECT tw.wave_id, t.id
FROM wms_wave_pick_task_wave tw
JOIN wms_wave_pick_task t ON t.id = tw.task_id
) v
GROUP BY wave_id
) latest ON latest.wave_id = u2.wave_id AND latest.max_id = u2.id
`;
/**
* 列举库内全部订单分表。
* @param {import('sequelize').QueryInterface} queryInterface 查询接口。
* @return {Promise<string[]>} 分表名列表。
*/
async function listOrderShards(queryInterface) {
const [ rows ] = await queryInterface.sequelize.query(
'SELECT TABLE_NAME AS tableName FROM INFORMATION_SCHEMA.TABLES '
+ 'WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME LIKE \'wms_order_delivery\\_%\' '
+ 'ORDER BY TABLE_NAME'
);
return (rows || [])
.map(row => String(row.tableName || row.TABLE_NAME || ''))
.filter(name => SHARD_PATTERN.test(name));
}
/**
* 提取受影响行数。
* @param {*} updateResult query 返回结果。
* @return {number} 受影响行数。
*/
function extractAffectedRows(updateResult) {
if (Array.isArray(updateResult)) {
const meta = updateResult[1];
return Number(meta && (meta.affectedRows || meta.affectedCount || meta.rowCount) || 0);
}
if (updateResult && typeof updateResult === 'object') {
return Number(updateResult.affectedRows || updateResult.affectedCount || updateResult.rowCount || 0);
}
return 0;
}
module.exports = {
/**
* 执行迁移:单品单件散单波次订单 wave_scope 置为 4。
* @param {import('sequelize').QueryInterface} queryInterface 查询接口。
* @return {Promise<void>} 无返回值。
*/
async up(queryInterface) {
const tables = [ BASE_TABLE, ...await listOrderShards(queryInterface) ];
const results = [];
for (const tableName of tables) {
const updateResult = await queryInterface.sequelize.query(`
UPDATE \`${tableName}\` o
JOIN wms_wave_batch wb ON wb.wave_id = o.wave_id
JOIN (
${LATEST_PICK_MODE_SQL}
) pm ON pm.wave_id = o.wave_id
SET o.wave_scope = 4
WHERE o.wave_id > 0
AND wb.wave_type = 2
AND pm.pick_mode = 2
`);
results.push({ tableName, affectedRows: extractAffectedRows(updateResult) });
}
console.log('[20260906100000-backfill-order-wave-scope-single] up results:', JSON.stringify(results));
},
/**
* 回滚迁移:单品单件(wave_scope=4)订单回置为散单(2)。
* @param {import('sequelize').QueryInterface} queryInterface 查询接口。
* @return {Promise<void>} 无返回值。
*/
async down(queryInterface) {
const tables = [ BASE_TABLE, ...await listOrderShards(queryInterface) ];
const results = [];
for (const tableName of tables) {
const updateResult = await queryInterface.sequelize.query(`
UPDATE \`${tableName}\`
SET wave_scope = 2
WHERE wave_scope = 4
`);
results.push({ tableName, affectedRows: extractAffectedRows(updateResult) });
}
console.log('[20260906100000-backfill-order-wave-scope-single] down results:', JSON.stringify(results));
},
};