oms/backend/app/model/orderItem.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

51 lines
3.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';
/**
* 订单明细模型,对应 order_items 表(订单的副表)
* 记录平台侧商品快照,并单向关联系统商品/组合商品:
* product_id 为空表示尚未解析出商品(parse_status:0未解析 1已解析 2解析失败)
* @param {Egg.Application} app egg application
* @return {object} orderItem model
*/
module.exports = app => {
const { BIGINT, STRING, TINYINT, DECIMAL, JSON, DATE } = app.Sequelize;
const OrderItem = app.model.define('order_item', {
id: { type: BIGINT.UNSIGNED, primaryKey: true, autoIncrement: true, comment: '主键' },
principal_id: { type: BIGINT.UNSIGNED, allowNull: false, comment: '所属主体ID' },
order_id: { type: BIGINT.UNSIGNED, allowNull: false, comment: '所属订单ID' },
shop_id: { type: BIGINT.UNSIGNED, comment: '所属店铺ID(冗余订单的店铺)' },
product_id: { type: BIGINT.UNSIGNED, comment: '系统商品ID,为空表示未解析出商品' },
combo_product_id: { type: BIGINT.UNSIGNED, comment: '组合商品ID,为空表示非组合商品' },
shop_product_id: { type: BIGINT.UNSIGNED, comment: '命中的店铺商品ID' },
external_item_id: { type: STRING(64), comment: '平台明细ID(店管家 OrderItemId)' },
item_type: { type: TINYINT, allowNull: false, defaultValue: 0, comment: '明细类型:0未识别 1普通商品 2组合商品' },
parse_status: { type: TINYINT, allowNull: false, defaultValue: 0, comment: '解析状态:0未解析 1已解析 2解析失败' },
parse_msg: { type: STRING(255), comment: '解析失败原因' },
outer_item_id: { type: STRING(100), comment: '平台商品ID' },
outer_sku_id: { type: STRING(100), comment: '平台规格ID' },
sku_code: { type: STRING(100), comment: '商家编码' },
name: { type: STRING(255), comment: '商品名称(快照)' },
spec: { type: STRING(255), comment: '规格(快照)' },
image: { type: STRING(255), comment: '图片(快照)' },
quantity: { type: DECIMAL(12, 3), allowNull: false, defaultValue: 0, comment: '数量' },
price: { type: DECIMAL(12, 2), comment: '单价' },
total_amount: { type: DECIMAL(12, 2), allowNull: false, defaultValue: 0, comment: '明细金额' },
raw: { type: JSON, comment: '平台返回的明细原始数据' },
platform_snapshot: { type: JSON, comment: '平台明细快照(绑定前的编码/名称/规格/图片,用于解绑还原)' },
created_at: { type: DATE, comment: '创建时间' },
updated_at: { type: DATE, comment: '更新时间' },
});
OrderItem.associate = () => {
app.model.OrderItem.belongsTo(app.model.Principal, { foreignKey: 'principal_id', as: 'principal' });
app.model.OrderItem.belongsTo(app.model.Order, { foreignKey: 'order_id', as: 'order' });
app.model.OrderItem.belongsTo(app.model.Shop, { foreignKey: 'shop_id', as: 'shop' });
app.model.OrderItem.belongsTo(app.model.Product, { foreignKey: 'product_id', as: 'product' });
app.model.OrderItem.belongsTo(app.model.ComboProduct, { foreignKey: 'combo_product_id', as: 'comboProduct' });
app.model.OrderItem.belongsTo(app.model.ShopProduct, { foreignKey: 'shop_product_id', as: 'shopProduct' });
};
return OrderItem;
};