oms/backend/database/migrations/20260915000300-migrate-orders-to-order-deliveries.js
liufumingren 57f55c0974 fix(backend): 修正历史搬迁迁移在全新库上的列依赖
- 20260915000300 的统计回填要写 order_deliveries.item_total/item_amount/item_kind,
  但这三列由后续迁移 20260915000400 添加
- 全新库上本迁移先于它执行,必然报 Unknown column 'd.item_total' 并中断整个迁移流程
- 改为先用 describeTable 判断列是否存在,不存在则跳过回填(全新库 orders 为空、搬迁本就是 0 行)
2026-09-14 22:14:16 +08:00

122 lines
6.2 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';
/**
* 历史订单数据搬迁:orders / order_items → order_deliveries / order_delivery_items
*
* 背景:原「订单表」(orders + order_items) 继续保留启用(不删不改),
* 本次把存量数据「转入」新的发货单表,供「订单」菜单对应的页面直接读写新表。
*
* 幂等:依赖 legacy_order_id / legacy_order_item_id 判重(见 20260915000200 迁移),
* 重复执行不会产生重复数据,也不会覆盖搬迁后新建/编辑过的行。
* 回滚:只删除 legacy_* 非空的行,不影响迁移后新建的单据。
*
* 字段映射(无法确定的语义一律不做猜测,原表保留可回溯):
* orders → order_deliveries
* order_no → delivery_order_code
* principal_id / shop_id → principal_id / shop_id
* order_type(TINYINT,内部数字枚举) → 'JYCK'(一般交易出库单,历史来源无类型语义,按默认归档)
* total_amount / pay_amount → total_amount / got_amount(实付金额 → 已收金额)
* receiver{name,phone,address} → name / mobile / detail_address(扁平列,口径同 WMS receiverInfo)
* status → status:1→1 待处理,2→2 已审核,3→4 已完成,4→9 已取消,其它→1
* 注:备注(remark)已从 order_deliveries 移除(见 20260915000900),历史备注不回迁,原表保留可回湖
* created_at / updated_at → created_at / updated_at
* 不搬迁(原表保留,可回溯):wms_status / wms_order_no / wms_synced_at / submit_*
*
* order_items → order_delivery_items
* sku_code(商家编码) → item_code(对齐 WMS itemCode)
* name → item_name
* quantity / price → plan_qty / actual_price
* outer_item_id(平台商品ID) → ext_code(外部编码 extCode)
* order_line_no → 按订单内 order_items.id 升序生成行号(同 WMS `${lineIndex + 1}`)
* inventory_type → 'ZP'(历史明细无残次标记)
* 不搬迁:outer_sku_id / spec / image / parse_* / product_id 等(原表保留)
*
* 搬迁后按 recalcOrderDelivery 同口径回填统计:item_total(计划数量合计)、
* item_amount(Σ 计划数量 × 实际单价)、item_kind(按 item_code 去重的商品种类数)。
*/
module.exports = {
async up(queryInterface) {
const { sequelize } = queryInterface;
const headerSql = `
INSERT INTO order_deliveries (
legacy_order_id, principal_id, shop_id, delivery_order_code, order_type,
is_urgency, invoice_flag, total_amount, got_amount,
name, mobile, detail_address,
status, created_at, updated_at
)
SELECT
o.id, o.principal_id, o.shop_id, o.order_no, 'JYCK',
'N', 'N', COALESCE(o.total_amount, 0), COALESCE(o.pay_amount, 0),
JSON_UNQUOTE(JSON_EXTRACT(o.receiver, '$.name')),
JSON_UNQUOTE(JSON_EXTRACT(o.receiver, '$.phone')),
JSON_UNQUOTE(JSON_EXTRACT(o.receiver, '$.address')),
CASE o.status WHEN 2 THEN 2 WHEN 3 THEN 4 WHEN 4 THEN 9 ELSE 1 END,
o.created_at, o.updated_at
FROM orders o
WHERE NOT EXISTS (SELECT 1 FROM order_deliveries d WHERE d.legacy_order_id = o.id)
`;
const itemSql = `
INSERT INTO order_delivery_items (
legacy_order_item_id, principal_id, order_delivery_id, order_line_no,
item_code, item_name, plan_qty, actual_price, ext_code, inventory_type,
created_at, updated_at
)
SELECT
oi.id, oi.principal_id, d.id,
(SELECT COUNT(*) FROM order_items x WHERE x.order_id = oi.order_id AND x.id <= oi.id),
NULLIF(oi.sku_code, ''), oi.name, COALESCE(oi.quantity, 0), oi.price,
NULLIF(oi.outer_item_id, ''), 'ZP',
oi.created_at, oi.updated_at
FROM order_items oi
JOIN order_deliveries d ON d.legacy_order_id = oi.order_id
WHERE NOT EXISTS (SELECT 1 FROM order_delivery_items t WHERE t.legacy_order_item_id = oi.id)
`;
const statsSql = `
UPDATE order_deliveries d
JOIN (
SELECT
order_delivery_id,
SUM(plan_qty) AS qty,
SUM(plan_qty * COALESCE(actual_price, 0)) AS amount,
COUNT(DISTINCT COALESCE(NULLIF(item_code, ''), CONCAT('#', id))) AS kinds
FROM order_delivery_items
GROUP BY order_delivery_id
) t ON t.order_delivery_id = d.id
SET
d.item_total = t.qty,
d.item_amount = ROUND(t.amount, 2),
d.item_kind = t.kinds
WHERE d.legacy_order_id IS NOT NULL
`;
// 见下方事务内的说明:全新库上这些统计列尚未创建,需要据此决定是否回填
const columns = await queryInterface.describeTable('order_deliveries');
const hasStatsColumns = [ 'item_total', 'item_amount', 'item_kind' ].every(name => Boolean(columns[name]));
await sequelize.transaction(async transaction => {
await sequelize.query(headerSql, { transaction });
await sequelize.query(itemSql, { transaction });
// item_total / item_amount / item_kind 三个统计列由**后续**迁移 20260915000400 添加;
// 全新库上本迁移先于它执行,此时列还不存在(且 orders 表为空、搬迁本就是 0 行),
// 所以先确认列是否存在,不存在就跳过回填,避免 Unknown column 把迁移流程打断。
if (hasStatsColumns) {
// 统计口径与 recalcOrderDelivery 保持一致:商品总数 / 商品总金额(Σ 计划数量 × 实际单价)/ 商品种类数
await sequelize.query(statsSql, { transaction });
} else {
console.log('[migration] order_deliveries 尚无 item_total/item_amount/item_kind(由 20260915000400 添加),跳过统计回填');
}
});
},
async down(queryInterface) {
const { sequelize } = queryInterface;
await sequelize.transaction(async transaction => {
// 明细先删,避免依赖外键级联的行为差异
await sequelize.query('DELETE FROM order_delivery_items WHERE legacy_order_item_id IS NOT NULL', { transaction });
await sequelize.query('DELETE FROM order_deliveries WHERE legacy_order_id IS NOT NULL', { transaction });
});
},
};