WMS_MAIN/database/migrations/20261113151000-backfill-order-has-sn-item.js
liufumingren 9af7dcf8fb feat(storeWarehouse): 签约关系接口配置按货主开放接口落库且回调地址统一取配置
- storeWarehouse.store.saveApiConfig:新增 resolveContractApiInterfaceType,
  interface_type_id=3(OPEN_API_WAREHOUSE 仓库开放接口)自动映射为 2(OPEN_API 货主开放接口)落库,
  不再要求当前主体为仓库(货主可维护自身签约关系下的接口配置)
- callback_url 不再取入参(含 callbackUrl 别名),统一写入 config.openapi.defaultCallbackUrl(新增配置项,默认空)
- storeWarehouse.store.listApiConfig:interface_type_id 过滤同步映射(传 3 按 2 查询)
- 文档:methods/system.json 升级 0.3.350、methods/changes/system.json 变更记录、docs/openapi-callback-events.md 回调地址来源说明
- 测试:saveApiConfig 新增 4 条用例(3→2 落库、忽略入参回调地址、默认值未配置、货主主体可保存、缺失类型 404),listApiConfig 新增 1 条过滤映射用例

同时提交工作区其余在制品改动:
- waybill:移除 wms_order_express_trace 模型并新增 drop 迁移,轨迹查询/取号/打印链路调整
- order:订单 SN 编码(order_item_sn / order_item_sn_log / sn_code_rule、has_sn_item 回填迁移),pendingOrder/recheckOrder/wave/base 调整
- express_platform、order_async、order_export、order_storage_allocation、storage.report、stock_store 配套修复
- lib:新增 jd_client,调整 qimen_client、callback_functions 及配套测试

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-14 17:14:04 +08:00

195 lines
6.6 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';
/**
* 存量订单回填 has_sn_item(是否含序列号管理商品)。
*
* 口径:订单任一明细的 stock_warehouse.is_sn_mgmt='Y' → has_sn_item='Y',否则保持 'N'。
*
* 覆盖范围:基表 wms_order_delivery 与全部仓库分表,按分表后缀关联对应订单明细表:
* - wms_order_delivery_{wh} → wms_order_items_{wh}
* - wms_order_delivery_{wh}_history → wms_order_items_{wh}_history
* - wms_order_delivery_{wh}_dispatch → wms_order_items_{wh}_dispatch
* - wms_order_delivery_{wh}_outsourced → wms_order_items_{wh}(外仓明细与常用表共用)
*
* 幂等:先把 Y 重置为 N,再按明细回填 Y,重复执行结果一致。
*/
const BASE_TABLE = 'wms_order_delivery';
const SHARD_PATTERN = /^wms_order_delivery_(\d+)(?:_(history|dispatch|outsourced))?$/;
/**
* 列举库内全部订单分表。
* @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 {import('sequelize').QueryInterface} queryInterface 查询接口。
* @param {string} tableName 表名。
* @return {Promise<boolean>} 是否存在。
*/
async function tableExists(queryInterface, tableName) {
const [ rows ] = await queryInterface.sequelize.query(
'SELECT TABLE_NAME AS tableName FROM INFORMATION_SCHEMA.TABLES '
+ 'WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = :tableName LIMIT 1',
{ replacements: { tableName } }
);
return Boolean(rows && rows.length > 0);
}
/**
* 判断表是否包含指定列。
* @param {import('sequelize').QueryInterface} queryInterface 查询接口。
* @param {string} tableName 表名。
* @param {string} columnName 列名。
* @return {Promise<boolean>} 是否存在。
*/
async function columnExists(queryInterface, tableName, columnName) {
const [ rows ] = await queryInterface.sequelize.query(
'SELECT COLUMN_NAME AS columnName FROM INFORMATION_SCHEMA.COLUMNS '
+ 'WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = :tableName AND COLUMN_NAME = :columnName LIMIT 1',
{ replacements: { tableName, columnName } }
);
return Boolean(rows && rows.length > 0);
}
/**
* 由订单表名推导对应订单明细表名。
* @param {string} orderTable 订单表名。
* @return {string|null} 明细表名,无法推导时返回 null。
*/
function resolveItemsTable(orderTable) {
if (orderTable === BASE_TABLE) {
return 'wms_order_items';
}
const matched = SHARD_PATTERN.exec(orderTable);
if (!matched) {
return null;
}
const warehouseId = matched[1];
const suffix = matched[2] || '';
if (suffix === 'history') {
return `wms_order_items_${warehouseId}_history`;
}
if (suffix === 'dispatch') {
return `wms_order_items_${warehouseId}_dispatch`;
}
return `wms_order_items_${warehouseId}`;
}
/**
* 提取受影响行数。
* @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 = {
/**
* 执行迁移:按订单明细回填 has_sn_item。
* @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) {
if (!await tableExists(queryInterface, tableName)) {
results.push({ tableName, action: 'skip', reason: 'order-table-missing' });
continue;
}
const itemsTable = resolveItemsTable(tableName);
if (!itemsTable || !await tableExists(queryInterface, itemsTable)) {
results.push({ tableName, action: 'skip', reason: `items-table-missing:${itemsTable || ''}` });
continue;
}
// 兼容旧版基表:wms_order_items(无 stock_id / order_id 的历史结构)无法参与回填
if (!await columnExists(queryInterface, itemsTable, 'order_id')
|| !await columnExists(queryInterface, itemsTable, 'stock_id')) {
results.push({ tableName, action: 'skip', reason: `items-table-unsupported:${itemsTable}` });
continue;
}
const resetResult = await queryInterface.sequelize.query(`
UPDATE \`${tableName}\`
SET has_sn_item = 'N'
WHERE has_sn_item = 'Y'
`);
const updateResult = await queryInterface.sequelize.query(`
UPDATE \`${tableName}\` o
INNER JOIN (
SELECT DISTINCT oi.order_id
FROM \`${itemsTable}\` oi
INNER JOIN wms_stock_warehouse sw
ON sw.id = oi.stock_id
AND sw.is_sn_mgmt = 'Y'
) t ON t.order_id = o.id
SET o.has_sn_item = 'Y'
`);
results.push({
tableName,
itemsTable,
resetRows: extractAffectedRows(resetResult),
affectedRows: extractAffectedRows(updateResult),
});
}
console.log('[20261113151000-backfill-order-has-sn-item] up results:', JSON.stringify(results));
},
/**
* 回滚迁移:全部置回 'N'。
* @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) {
if (!await tableExists(queryInterface, tableName)) {
results.push({ tableName, action: 'skip', reason: 'order-table-missing' });
continue;
}
const updateResult = await queryInterface.sequelize.query(`
UPDATE \`${tableName}\`
SET has_sn_item = 'N'
WHERE has_sn_item = 'Y'
`);
results.push({ tableName, affectedRows: extractAffectedRows(updateResult) });
}
console.log('[20261113151000-backfill-order-has-sn-item] down results:', JSON.stringify(results));
},
};