oms/backend/database/migrations/20261103000100-add-platform-snapshot-to-order-items.js
liufumingren ab630e7c01 feat(external-print): 订单拉取与定时同步,组合商品拆分为最小单位
后端能力:
- 接入店管家订单接口(/NewOrder/List),明细归一化后按店铺商品匹配系统商品/组合商品
- 新增 service/externalPrintOrder:手动与定时拉单共用入库逻辑,同时写入待审核状态分表
- 新增 schedule/fetchExternalShopOrders:按店铺配置的间隔自动拉单(最小 3 分钟,起点重叠 10 分钟)
- 新增 lib/orderItemExpand + service/orderItemResolve:平台行与最小单位行互转;
  绑定组合商品时按「数量 = 平台数量 x 组合内数量、单价取子商品零售价」拆成子商品行,解绑可还原
- 明细新增 platform_snapshot,保留平台原样(编码/名称/规格/图片/原行号/原数量/原单价)
- 店铺商品列表支持 has_unbound_order 筛选,订单列表支持 exclude_unbound(均已同步导出定义)
- 店铺商品只读化:移除新增/编辑/删除动作,仅保留查询与绑定;
  同步商品时平台已不存在的商品自动清理(未绑定且未被订单引用直接删除,已绑定或被引用仅下架)
- 新增 scripts/rebuild-order-items 存量明细重建脚本,新增 orderItemExpand 单测(8 项)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:29:09 +08:00

36 lines
1.3 KiB
JavaScript

'use strict';
/**
* 订单明细增加「平台原样快照」列。
*
* 背景:绑定系统商品/组合商品时,明细的编码/名称/规格/图片会被系统商品信息覆盖;
* 解绑后需要还原为平台原始快照,而 raw 列是平台各异的原始报文,无法通用还原,
* 因此在拉单时把统一结构下的平台快照单独留存在 platform_snapshot。
*/
const SNAPSHOT_COLUMN = {
type: 'JSON',
allowNull: true,
comment: '平台明细快照(绑定前的编码/名称/规格/图片,用于解绑还原)',
};
module.exports = {
async up(queryInterface, Sequelize) {
// 幂等:上一次执行可能因数据库异常中断,列已加上但迁移未记录
for (const table of [ 'order_items', 'order_status_items' ]) {
const columns = await queryInterface.describeTable(table);
if (!columns.platform_snapshot) {
await queryInterface.addColumn(table, 'platform_snapshot', { ...SNAPSHOT_COLUMN, type: Sequelize.JSON });
}
}
},
async down(queryInterface) {
for (const table of [ 'order_items', 'order_status_items' ]) {
const columns = await queryInterface.describeTable(table);
if (columns.platform_snapshot) {
await queryInterface.removeColumn(table, 'platform_snapshot');
}
}
},
};