oms/backend/test/app/lib/orderItemExpand.test.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

145 lines
4.9 KiB
JavaScript

'use strict';
const { assert } = require('egg-mock/bootstrap');
const {
buildSnapshot,
normalizeSnapshot,
foldPlatformLines,
expandPlatformLine,
} = require('../../../app/lib/orderItemExpand');
/**
* 订单明细「平台行 ↔ 最小单位行」互转的单测。
*
* 覆盖三类绑定口径:未绑定(保留平台原样)、系统商品(一行对一行)、组合商品(拆成子商品行),
* 以及子行折叠回平台行时不丢原始数量/单价。
*/
describe('app/lib/orderItemExpand', () => {
const comboLine = {
line_no: '1',
item_code: 'PK1',
item_name: '平台组合',
plan_qty: 2,
actual_price: 29.9,
shop_product_id: 9,
platform_snapshot: { item_code: 'PK1', item_name: '平台组合', line_no: '1', plan_qty: 2, actual_price: 29.9 },
template: { shop_id: 18 },
};
it('buildSnapshot 记录原行号、原数量与原单价', () => {
const snapshot = buildSnapshot(
{ sku_code: 'SKU1', name: '平台商品', spec: '红色', image: 'a.png', quantity: 2, price: 12.345 },
3
);
assert.deepStrictEqual(snapshot, {
item_code: 'SKU1',
item_name: '平台商品',
sku_code: 'SKU1',
spec: '红色',
image: 'a.png',
line_no: '3',
plan_qty: 2,
actual_price: 12.35,
});
});
it('绑定组合商品时拆成子商品行:数量相乘、单价取子商品零售价', () => {
const parts = expandPlatformLine(comboLine, {
shopProduct: { id: 9 },
combo: { id: 7, code: 'C1', name: '组合' },
comboItems: [{ product_id: 3, quantity: 20, item_code: 'P3', item_name: '测试商品', retail_price: '1.00' }],
});
assert.strictEqual(parts.length, 1);
assert.strictEqual(parts[0].item_code, 'P3');
assert.strictEqual(parts[0].plan_qty, 40);
assert.strictEqual(parts[0].actual_price, 1);
assert.strictEqual(parts[0].product_id, 3);
assert.strictEqual(parts[0].combo_product_id, 7);
assert.strictEqual(parts[0].parse_status, 1);
});
it('组合未配置子商品时保留组合行并提示', () => {
const parts = expandPlatformLine(comboLine, {
shopProduct: { id: 9 },
combo: { id: 7, code: 'C1', name: '组合' },
comboItems: [],
});
assert.strictEqual(parts.length, 1);
assert.strictEqual(parts[0].item_code, 'C1');
assert.strictEqual(parts[0].item_type, 2);
assert(parts[0].parse_msg.includes('未配置子商品'));
});
it('绑定系统商品时一行对一行', () => {
const parts = expandPlatformLine(comboLine, {
shopProduct: { id: 9 },
product: { id: 5, item_code: 'S5', item_name: '系统商品' },
});
assert.strictEqual(parts.length, 1);
assert.strictEqual(parts[0].item_code, 'S5');
assert.strictEqual(parts[0].plan_qty, 2);
assert.strictEqual(parts[0].item_type, 1);
});
it('未采集到店铺商品时保留平台原样并标记待处理', () => {
const parts = expandPlatformLine({ ...comboLine, platform_snapshot: null }, {});
assert.strictEqual(parts[0].item_code, 'PK1');
assert.strictEqual(parts[0].parse_status, 2);
assert(parts[0].parse_msg.includes('未采集到该店铺商品'));
});
it('子行按快照原行号折叠回平台行并恢复原数量', () => {
const rows = [
{
id: 1,
order_line_no: '1',
item_code: 'P3',
plan_qty: 40,
actual_price: 1,
platform_snapshot: { line_no: '1', item_code: 'PK1', item_name: '平台组合', plan_qty: 2, actual_price: 29.9 },
},
{
id: 2,
order_line_no: '2',
item_code: 'PK1',
plan_qty: 1,
actual_price: 29.9,
platform_snapshot: { line_no: '2', item_code: 'PK2', item_name: '平台第二行', plan_qty: 1, actual_price: 29.9 },
},
];
const lines = foldPlatformLines(rows);
assert.strictEqual(lines.length, 2);
assert.strictEqual(lines[0].item_code, 'PK1');
assert.strictEqual(lines[0].plan_qty, 2);
assert.strictEqual(lines[1].item_code, 'PK2');
});
it('同一平台行拆出的多子行只折叠为一行', () => {
const snapshot = { line_no: '1', item_code: 'PK1', plan_qty: 3, actual_price: 10 };
const lines = foldPlatformLines([
{ id: 1, order_line_no: '1', platform_snapshot: snapshot },
{ id: 2, order_line_no: '2', platform_snapshot: snapshot },
]);
assert.strictEqual(lines.length, 1);
assert.strictEqual(lines[0].plan_qty, 3);
});
it('无快照的历史行按自身独立折叠并补齐字段', () => {
const lines = foldPlatformLines([
{ id: 77, order_line_no: '4', item_code: 'X', item_name: 'Y', plan_qty: 5, actual_price: 3 },
]);
const snapshot = normalizeSnapshot(lines[0]);
assert.strictEqual(lines.length, 1);
assert.strictEqual(snapshot.line_no, '4');
assert.strictEqual(snapshot.plan_qty, 5);
assert.strictEqual(snapshot.actual_price, 3);
});
});