@pisell/pisellos 2.2.278 → 2.2.280

package/dist/modules/Order/types.d.ts

@@ -414,6 +414,7 @@ export interface CommitOrderParams {
         type: 'virtual' | 'appointment_booking';
         platform?: string;
         extraData?: Record<string, any>;
+        business_code?: string;
     };
 }
 export interface OrderSubmitBooking {
@@ -578,6 +579,10 @@ export interface LoadSalesDetailParams {
      * 存在时 loadSalesDetail 会跳过远端 lookup，直接复用 hydrate 后半段逻辑。
      */
     preloadedSalesDetail?: Record<string, any>;
+    /**
+     * sessionStorage 快照复用详情 hydrate 时使用；不带该值时保持既有编辑订单语义。
+     */
+    hydrateSource?: 'sessionStorage';
     forceRemote?: boolean;
     merge?: boolean;
 }
@@ -589,6 +594,12 @@ export interface SyncPaymentsToOrderParams {
     payments: OrderPaymentSource[];
     paymentStatus?: SubmitSalesOrderParams['query']['payment_status'];
     submitWhenPaid?: boolean;
+    /**
+     * Whether the checkout should be queued as the local `sync_sales` task.
+     * Defaults to true to preserve the WebPOS retry path. Set to false when
+     * the caller must wait for the cloud checkout response before proceeding.
+     */
+    checkoutSyncTaskEnabled?: boolean;
     smallTicketDataFlag?: number;
     businessCode?: string;
     channel?: string;
@@ -742,8 +753,15 @@ export interface OrderModuleAPI {
     removeProductFromOrder: (identity: OrderProductIdentity, options?: RemoveProductsFromOrderOptions) => Promise<OrderProduct[]>;
     /** 批量删除购物车行，末尾仅触发一次促销重算与 summary 刷新 */
     removeProductsFromOrder: (identities: OrderProductIdentity[], options?: RemoveProductsFromOrderOptions) => Promise<OrderProduct[]>;
-    /** @deprecated no-op；OrderModule 不再负责 tempOrder localStorage 持久化。 */
+    /** 在显式开启时保存当前 tempOrder 的 sessionStorage 会话快照。 */
     persistTempOrder: () => void;
+    /**
+     * 删除当前 cacheId 的 tempOrder 会话快照，并阻止当前模块实例再次写入。
+     * 新模块实例初始化时会按 otherParams 重新启用持久化。
+     */
+    clearSessionStoragePersistedTempOrder: () => void;
+    /** 取出一次待恢复的 sessionStorage tempOrder 快照。 */
+    consumeSessionStorageRestore: () => Record<string, any> | null;
     /**
      * 控制 IndexedDB 草稿（saveDraft）开关；localStorage tempOrder 持久化已废弃。
      * BigSale 弹窗等场景传 false 可跳过 saveDraft。
@@ -751,6 +769,8 @@ export interface OrderModuleAPI {
     setEnableTempOrderPersist: (enabled: boolean) => void;
     /** 是否允许 saveDraft 写入 IndexedDB 草稿。 */
     isTempOrderPersistEnabled: () => boolean;
+    /** 提交 tempOrder 变更并触发 `{moduleName}:changed` 事件 */
+    notifyTempOrderChanged: () => void;
     submitTempOrder: <T = any>(params?: {
         cacheId?: string;
         platform?: string;
@@ -799,6 +819,7 @@ export interface OrderModuleAPI {
     saveDraft: () => Promise<void>;
     hydrateTempOrderFromRecord: (record: Record<string, any>, options?: {
         recalcOnHydrate?: boolean;
+        source?: 'salesDetail' | 'sessionStorage';
     }) => Promise<OrderTempOrder>;
     syncPaymentsToOrder: <T = any>(params: SyncPaymentsToOrderParams) => Promise<SyncPaymentsToOrderResult<T>>;
     getSalesOrderByLookup: (params: SalesOrderLookupParams) => Promise<any>;

package/dist/modules/Order/utils/discountProductLineIdentity.d.ts

@@ -0,0 +1,45 @@
+import type { OrderTempOrder } from '../types';
+/**
+ * 商品券拆行的身份与回并工具。
+ *
+ * 背景：
+ * Rules.calcDiscount 应用 good_pass 时，会把一个数量行拆成若干「用券行」和
+ * 「普通余量行」。Rules 返回的拆分行可能复制同一份
+ * metadata.unique_identification_number，进而造成：
+ * - 按 UID 删除时同时命中多行；
+ * - UI 把不同券行视为同一个商品；
+ * - 后续商品更新无法准确定位目标行。
+ *
+ * 处理原则：
+ * 1. 拆分后每一行必须拥有独立 UID；
+ * 2. 原始拆分来源仅记录在 tempOrder._extend.productsByUid 的运行态索引中，
+ *    不写入商品 metadata，不污染提交协议；
+ * 3. 券被移除后，只回并被本工具确认来自同一折扣拆分源的行；
+ * 4. 预约、赠品、促销、手动折扣、备注、称重、holder 和已落库行均为硬边界。
+ *
+ * 两个导出函数都会原地更新 tempOrder。调用顺序必须是：
+ * ensureUniqueProductLineUids -> consolidateDiscountFreeProductLines。
+ */
+/** productsByUid 运行态记录中用于关联同一次折扣拆分的字段。 */
+export declare const DISCOUNT_SPLIT_ORIGIN_UID_KEY = "discountSplitOriginUid";
+/**
+ * 修复 Rules 折扣拆行复制 UID 的问题，并为拆分行记录共同来源。
+ *
+ * 第一条商品保留原 UID，后续重复行生成新 UUID；对应的 productsByUid.runtime
+ * 会复制原行 runtime（包括 origin），以保证删除、编辑及展示字段回读仍可工作。
+ *
+ * 没有 UID 的裸商品不会被补写 UID。这是为了兼容 Rules/mock 的历史协议形状；
+ * 正常 Order 写路径会在 normalize 阶段提前创建 UID。
+ */
+export declare function ensureUniqueProductLineUids(tempOrder: OrderTempOrder): void;
+/**
+ * 把券移除后已经恢复原价的同源折扣拆分行重新合并。
+ *
+ * 此函数刻意不执行通用的「同 SKU 合并」：没有 discountSplitOriginUid 的普通行
+ * 可能是业务 hook、导入订单或其它流程主动拆开的，不能在折扣重算时擅自合并。
+ *
+ * payment_price、tax_fee、surcharge_fee 属于 summary 计算层的派生值。券行与普通行
+ * 在回并前可能暂时不同，因此它们不参与 mergeKey；原始价格、SKU/option/bundle
+ * 结构以及税务/商品类型配置仍参与比较，防止不同商品语义被误合并。
+ */
+export declare function consolidateDiscountFreeProductLines(tempOrder: OrderTempOrder): void;

package/dist/modules/Order/utils/discountProductLineIdentity.js

@@ -0,0 +1,227 @@
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+import { cloneDeep } from 'lodash-es';
+import { buildProductLineFingerprint, getSafeProductNum } from "../../../solution/ScanOrder/utils";
+import { createUuidV4 } from "./orderCollectionIdentity";
+
+/**
+ * 商品券拆行的身份与回并工具。
+ *
+ * 背景：
+ * Rules.calcDiscount 应用 good_pass 时，会把一个数量行拆成若干「用券行」和
+ * 「普通余量行」。Rules 返回的拆分行可能复制同一份
+ * metadata.unique_identification_number，进而造成：
+ * - 按 UID 删除时同时命中多行；
+ * - UI 把不同券行视为同一个商品；
+ * - 后续商品更新无法准确定位目标行。
+ *
+ * 处理原则：
+ * 1. 拆分后每一行必须拥有独立 UID；
+ * 2. 原始拆分来源仅记录在 tempOrder._extend.productsByUid 的运行态索引中，
+ *    不写入商品 metadata，不污染提交协议；
+ * 3. 券被移除后，只回并被本工具确认来自同一折扣拆分源的行；
+ * 4. 预约、赠品、促销、手动折扣、备注、称重、holder 和已落库行均为硬边界。
+ *
+ * 两个导出函数都会原地更新 tempOrder。调用顺序必须是：
+ * ensureUniqueProductLineUids -> consolidateDiscountFreeProductLines。
+ */
+
+/** productsByUid 运行态记录中用于关联同一次折扣拆分的字段。 */
+export var DISCOUNT_SPLIT_ORIGIN_UID_KEY = 'discountSplitOriginUid';
+
+// 这里只保留本模块所需的最小读取逻辑，避免反向依赖体量较大的 Order/utils.ts
+// 并形成 utils.ts -> 本文件 -> utils.ts 的循环引用。
+function getProductLineUid(product) {
+  var _product$metadata$uni, _product$metadata;
+  if (!product || _typeof(product) !== 'object') return null;
+  var uid = (_product$metadata$uni = (_product$metadata = product.metadata) === null || _product$metadata === void 0 ? void 0 : _product$metadata.unique_identification_number) !== null && _product$metadata$uni !== void 0 ? _product$metadata$uni : product.unique_identification_number;
+  if (uid === undefined || uid === null || uid === '') return null;
+  return String(uid);
+}
+function getProductSkuOptions(product) {
+  var _product$product_sku;
+  return Array.isArray((_product$product_sku = product.product_sku) === null || _product$product_sku === void 0 ? void 0 : _product$product_sku.option) ? product.product_sku.option : [];
+}
+function hasProductLineNote(product) {
+  return typeof product.note === 'string' && product.note.trim().length > 0;
+}
+function isManualProductDiscountLine(product) {
+  var _product$metadata2, _product$metadata3;
+  return ((_product$metadata2 = product.metadata) === null || _product$metadata2 === void 0 ? void 0 : _product$metadata2.is_manual_discount) === true || ((_product$metadata3 = product.metadata) === null || _product$metadata3 === void 0 ? void 0 : _product$metadata3.is_manual_discount) === 1 || (product.discount_list || []).some(function (item) {
+    return (item === null || item === void 0 ? void 0 : item.type) === 'product';
+  });
+}
+function ensureProductsByUid(tempOrder) {
+  if (!tempOrder._extend || _typeof(tempOrder._extend) !== 'object') {
+    tempOrder._extend = {
+      productsByUid: {}
+    };
+  }
+  if (!tempOrder._extend.productsByUid) {
+    tempOrder._extend.productsByUid = {};
+  }
+  return tempOrder._extend.productsByUid;
+}
+
+/**
+ * 修复 Rules 折扣拆行复制 UID 的问题，并为拆分行记录共同来源。
+ *
+ * 第一条商品保留原 UID，后续重复行生成新 UUID；对应的 productsByUid.runtime
+ * 会复制原行 runtime（包括 origin），以保证删除、编辑及展示字段回读仍可工作。
+ *
+ * 没有 UID 的裸商品不会被补写 UID。这是为了兼容 Rules/mock 的历史协议形状；
+ * 正常 Order 写路径会在 normalize 阶段提前创建 UID。
+ */
+export function ensureUniqueProductLineUids(tempOrder) {
+  // usedUids 只描述本次 Rules 返回的商品集合，不能直接依赖 productsByUid：
+  // productsByUid 可能还保留已删除行的历史 runtime，历史 UID 不应导致当前行被改号。
+  var usedUids = new Set();
+  var productsByUid = ensureProductsByUid(tempOrder);
+  tempOrder.products = (tempOrder.products || []).map(function (product) {
+    var sourceUid = getProductLineUid(product);
+    // 单测 mock 或兼容旧 Rules 时可能返回没有 UID 的裸商品。
+    // 这里不主动补 UID，避免一个“校验重复”的工具意外改变旧协议对象形状。
+    if (!sourceUid) return product;
+
+    // 实际场景：可乐 ×5 首次进入 Rules 时只有一行。
+    // 使用三张券后 Rules 可能返回「可乐 ×2 + 三条可乐 ×1」，但四条都复制原 UID。
+    // 第一条继续使用原 UID，可保留购物车已有引用、runtime origin 和删除定位的稳定性。
+    if (!usedUids.has(sourceUid)) {
+      usedUids.add(sourceUid);
+      return product;
+    }
+
+    // 从第二条重复 UID 开始生成真正的行级身份。
+    // 这样点击任意一条“可乐 ×1”时，只会删除该行，不会把所有同 UID 行一起删除。
+    var splitUid = createUuidV4();
+    while (usedUids.has(splitUid)) {
+      splitUid = createUuidV4();
+    }
+    product.metadata = _objectSpread(_objectSpread({}, product.metadata || {}), {}, {
+      unique_identification_number: splitUid
+    });
+    var sourceRuntime = productsByUid[sourceUid] || {};
+    // 如果当前行已经是上一轮拆分出来的子行，继续沿用最初的拆分来源。
+    // 例如删除一条券行后，空出的券再次把「可乐 ×2」拆成两条 ×1，
+    // 新行仍应归属于最初那条可乐，而不是形成一个无法回并的新分组。
+    var discountSplitOriginUid = String(sourceRuntime[DISCOUNT_SPLIT_ORIGIN_UID_KEY] || sourceUid);
+
+    // 来源只写入 _extend.productsByUid：
+    // - metadata.unique_identification_number 是对外的行身份，必须各不相同；
+    // - discountSplitOriginUid 是内部回并依据，不能进入提交给后端的商品 metadata。
+    productsByUid[sourceUid] = _objectSpread(_objectSpread({}, sourceRuntime), {}, _defineProperty({}, DISCOUNT_SPLIT_ORIGIN_UID_KEY, discountSplitOriginUid));
+    // 克隆 origin 等 runtime 数据，保证新拆分行仍能正确展示标题、封面等商品信息。
+    productsByUid[splitUid] = _objectSpread(_objectSpread({}, cloneDeep(sourceRuntime)), {}, _defineProperty({}, DISCOUNT_SPLIT_ORIGIN_UID_KEY, discountSplitOriginUid));
+    usedUids.add(splitUid);
+    return product;
+  });
+}
+
+/**
+ * 把券移除后已经恢复原价的同源折扣拆分行重新合并。
+ *
+ * 此函数刻意不执行通用的「同 SKU 合并」：没有 discountSplitOriginUid 的普通行
+ * 可能是业务 hook、导入订单或其它流程主动拆开的，不能在折扣重算时擅自合并。
+ *
+ * payment_price、tax_fee、surcharge_fee 属于 summary 计算层的派生值。券行与普通行
+ * 在回并前可能暂时不同，因此它们不参与 mergeKey；原始价格、SKU/option/bundle
+ * 结构以及税务/商品类型配置仍参与比较，防止不同商品语义被误合并。
+ */
+export function consolidateDiscountFreeProductLines(tempOrder) {
+  // 实际目标场景：
+  // 选择客户后「可乐 ×5」被三张商品券拆成「×2、×1、×1、×1」；
+  // 清除客户/商品券后，四行都恢复为无折扣状态，应在本轮重算中立即回并为「可乐 ×5」。
+  var consolidatedProducts = [];
+  var productIndexByKey = new Map();
+  var _iterator = _createForOfIteratorHelper(tempOrder.products || []),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _product$booking_uid, _product$metadata4, _booking_id, _product$metadata5, _product$order_detail, _holder_id, _product$metadata6, _product$metadata7, _product$metadata8, _product$product_sku2, _product$metadata9, _tempOrder$_extend, _product$selling_pric, _product$original_pri, _custom_price, _product$is_charge_ta, _product$gift_card, _product$bundle_edit, _product$metadata$pri, _product$metadata10, _product$metadata$sou, _product$metadata11, _product$metadata$mai, _product$metadata12, _product$metadata$mai2, _product$metadata13, _product$product_vari;
+      var product = _step.value;
+      var productBundle = Array.isArray(product.product_bundle) ? product.product_bundle : [];
+      var hasDiscount = (product.discount_list || []).length > 0 || productBundle.some(function (bundle) {
+        return ((bundle === null || bundle === void 0 ? void 0 : bundle.discount_list) || []).length > 0;
+      });
+      var bookingUid = (_product$booking_uid = product.booking_uid) !== null && _product$booking_uid !== void 0 ? _product$booking_uid : (_product$metadata4 = product.metadata) === null || _product$metadata4 === void 0 ? void 0 : _product$metadata4.booking_uid;
+      var bookingId = (_booking_id = product.booking_id) !== null && _booking_id !== void 0 ? _booking_id : (_product$metadata5 = product.metadata) === null || _product$metadata5 === void 0 ? void 0 : _product$metadata5.booking_id;
+      var orderDetailId = (_product$order_detail = product.order_detail_id) !== null && _product$order_detail !== void 0 ? _product$order_detail : product.orderDetailId;
+      var holderId = (_holder_id = product.holder_id) !== null && _holder_id !== void 0 ? _holder_id : (_product$metadata6 = product.metadata) === null || _product$metadata6 === void 0 ? void 0 : _product$metadata6.holder_id;
+
+      // 以下情况即使“看起来是同一个 SKU”也必须保持独立：
+      // - 仍有商品券/折扣：每条券行分别承担券归属和 savedAmount；
+      // - 赠品/促销：独立行承载策略来源，合并会破坏促销撤销和展示；
+      // - 手动改价/备注：用户显式表达了不同价格或不同制作要求；
+      // - 称重商品：每次称重的净重和金额属于独立交易事实；
+      // - 预约/holder/历史订单行：分别关联预约、持有人或后端 order_detail。
+      var hasMergeBoundary = hasDiscount || Boolean(((_product$metadata7 = product.metadata) === null || _product$metadata7 === void 0 ? void 0 : _product$metadata7._giftInfo) || product._giftInfo) || Boolean((_product$metadata8 = product.metadata) === null || _product$metadata8 === void 0 ? void 0 : _product$metadata8._promotion) || isManualProductDiscountLine(product) || hasProductLineNote(product) || Number(((_product$product_sku2 = product.product_sku) === null || _product$product_sku2 === void 0 ? void 0 : _product$product_sku2.open_sold_weight) || 0) === 1 || ((_product$metadata9 = product.metadata) === null || _product$metadata9 === void 0 ? void 0 : _product$metadata9.is_edit_for_runtime) === true || bookingId !== undefined && bookingId !== null && bookingId !== 0 && bookingId !== '0' || bookingUid !== undefined && bookingUid !== null && String(bookingUid) !== '' || holderId !== undefined && holderId !== null && String(holderId) !== '' || orderDetailId !== undefined && orderDetailId !== null && orderDetailId !== '';
+      if (hasMergeBoundary) {
+        consolidatedProducts.push(product);
+        continue;
+      }
+      var productUid = getProductLineUid(product);
+      var discountSplitOriginUid = productUid ? (_tempOrder$_extend = tempOrder._extend) === null || _tempOrder$_extend === void 0 || (_tempOrder$_extend = _tempOrder$_extend.productsByUid) === null || _tempOrder$_extend === void 0 || (_tempOrder$_extend = _tempOrder$_extend[productUid]) === null || _tempOrder$_extend === void 0 ? void 0 : _tempOrder$_extend[DISCOUNT_SPLIT_ORIGIN_UID_KEY] : undefined;
+
+      // 没有同源标记的两条可乐，可能是 onBeforeMergeProductToOrder 返回 false 后
+      // 由业务主动保留的独立行，也可能来自导入订单；不能仅凭 SKU 相同就擅自合并。
+      if (!discountSplitOriginUid) {
+        consolidatedProducts.push(product);
+        continue;
+      }
+
+      // 同属一次券拆分仍不代表一定可以合并。
+      // 例如两行后来选择了不同 option、套餐子商品或自定义价格，需要继续保持独立。
+      var fingerprint = buildProductLineFingerprint(getProductSkuOptions(product), productBundle);
+      var priceSignature = JSON.stringify({
+        selling_price: String((_product$selling_pric = product.selling_price) !== null && _product$selling_pric !== void 0 ? _product$selling_pric : ''),
+        original_price: String((_product$original_pri = product.original_price) !== null && _product$original_pri !== void 0 ? _product$original_pri : ''),
+        custom_price: String((_custom_price = product.custom_price) !== null && _custom_price !== void 0 ? _custom_price : ''),
+        is_charge_tax: Number((_product$is_charge_ta = product.is_charge_tax) !== null && _product$is_charge_ta !== void 0 ? _product$is_charge_ta : 0),
+        gift_card: Number((_product$gift_card = product.gift_card) !== null && _product$gift_card !== void 0 ? _product$gift_card : 0),
+        bundle_edit: Number((_product$bundle_edit = product.bundle_edit) !== null && _product$bundle_edit !== void 0 ? _product$bundle_edit : 0),
+        price_schema_version: (_product$metadata$pri = (_product$metadata10 = product.metadata) === null || _product$metadata10 === void 0 ? void 0 : _product$metadata10.price_schema_version) !== null && _product$metadata$pri !== void 0 ? _product$metadata$pri : '',
+        source_product_price: String((_product$metadata$sou = (_product$metadata11 = product.metadata) === null || _product$metadata11 === void 0 ? void 0 : _product$metadata11.source_product_price) !== null && _product$metadata$sou !== void 0 ? _product$metadata$sou : ''),
+        main_product_selling_price: String((_product$metadata$mai = (_product$metadata12 = product.metadata) === null || _product$metadata12 === void 0 ? void 0 : _product$metadata12.main_product_selling_price) !== null && _product$metadata$mai !== void 0 ? _product$metadata$mai : ''),
+        main_product_original_price: String((_product$metadata$mai2 = (_product$metadata13 = product.metadata) === null || _product$metadata13 === void 0 ? void 0 : _product$metadata13.main_product_original_price) !== null && _product$metadata$mai2 !== void 0 ? _product$metadata$mai2 : ''),
+        bundle: productBundle.map(function (bundle) {
+          var _ref, _bundle$bundle_id, _ref2, _ref3, _bundle$bundle_produc, _ref4, _ref5, _bundle$bundle_varian, _bundle$price, _bundle$original_pric, _bundle$bundle_sellin;
+          return {
+            bundle_id: (_ref = (_bundle$bundle_id = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_id) !== null && _bundle$bundle_id !== void 0 ? _bundle$bundle_id : bundle === null || bundle === void 0 ? void 0 : bundle.id) !== null && _ref !== void 0 ? _ref : '',
+            product_id: (_ref2 = (_ref3 = (_bundle$bundle_produc = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_product_id) !== null && _bundle$bundle_produc !== void 0 ? _bundle$bundle_produc : bundle === null || bundle === void 0 ? void 0 : bundle._bundle_product_id) !== null && _ref3 !== void 0 ? _ref3 : bundle === null || bundle === void 0 ? void 0 : bundle.product_id) !== null && _ref2 !== void 0 ? _ref2 : '',
+            product_variant_id: (_ref4 = (_ref5 = (_bundle$bundle_varian = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_variant_id) !== null && _bundle$bundle_varian !== void 0 ? _bundle$bundle_varian : bundle === null || bundle === void 0 ? void 0 : bundle.variant_id) !== null && _ref5 !== void 0 ? _ref5 : bundle === null || bundle === void 0 ? void 0 : bundle.product_variant_id) !== null && _ref4 !== void 0 ? _ref4 : 0,
+            price: String((_bundle$price = bundle === null || bundle === void 0 ? void 0 : bundle.price) !== null && _bundle$price !== void 0 ? _bundle$price : ''),
+            original_price: String((_bundle$original_pric = bundle === null || bundle === void 0 ? void 0 : bundle.original_price) !== null && _bundle$original_pric !== void 0 ? _bundle$original_pric : ''),
+            bundle_selling_price: String((_bundle$bundle_sellin = bundle === null || bundle === void 0 ? void 0 : bundle.bundle_selling_price) !== null && _bundle$bundle_sellin !== void 0 ? _bundle$bundle_sellin : '')
+          };
+        })
+      });
+      var mergeKey = [discountSplitOriginUid, product.product_id, (_product$product_vari = product.product_variant_id) !== null && _product$product_vari !== void 0 ? _product$product_vari : 0, fingerprint, priceSignature].join('#');
+      var matchedIndex = productIndexByKey.get(mergeKey);
+
+      // 当前拆分来源 + 商品结构组合第一次出现时，保留该行作为回并目标。
+      // 后续相同行只累加数量，从而稳定保留首行 UID，避免 UI key 再次变化。
+      if (matchedIndex === undefined) {
+        productIndexByKey.set(mergeKey, consolidatedProducts.length);
+        consolidatedProducts.push(product);
+        continue;
+      }
+      var matchedProduct = consolidatedProducts[matchedIndex];
+      matchedProduct.num = getSafeProductNum(Number(matchedProduct.num || 0) + Number(product.num || 0));
+      // 示例：目标行 ×2，依次吸收三条 ×1，最终得到 ×5。
+      // 被吸收行的 productsByUid runtime 暂不删除：异步 UI/日志可能仍持有旧 UID，
+      // 保留历史索引比立即清理更安全；当前购物车身份始终以 tempOrder.products 为准。
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  tempOrder.products = consolidatedProducts;
+}

package/dist/modules/Order/utils/orderCollectionIdentity.d.ts

@@ -24,6 +24,16 @@ export interface NormalizeOrderCollectionsResult<T> {
     stats: Record<OrderCollectionKind, OrderCollectionIdentityStats>;
     uidRemaps: OrderCollectionUidRemap[];
 }
+export interface ProductLineIdentityRepair {
+    index: number;
+    from: string;
+    to: string;
+}
+export interface RepairDuplicateProductLineIdentitiesResult<T> {
+    products: T[];
+    productsByUid?: Record<string, Record<string, any>>;
+    repairs: ProductLineIdentityRepair[];
+}
 export declare function createUuidV4(): string;
 export declare function isBlankOrderCollectionIdentity(value: unknown): boolean;
 export declare function getOrderCollectionPersistentId(kind: OrderCollectionKind, item: unknown): string | null;
@@ -31,6 +41,11 @@ export declare function getOrderCollectionUid(kind: OrderCollectionKind, item: u
 export declare function buildOrderCollectionFallbackUid(kind: OrderCollectionKind, persistentId: string | number): string;
 export declare function getOrderCollectionReferenceUid(kind: OrderCollectionKind, item: unknown): string | null;
 export declare function setOrderCollectionUid<T>(kind: OrderCollectionKind, item: T, uid: string): T;
+/**
+ * Rules 会把同一商品按商品券拆成多条真实订单行。拆行结果会继承原商品 UID，
+ * 因此必须在通用 collection normalization 之前为后续行派生稳定身份，避免被折叠。
+ */
+export declare function repairDuplicateProductLineIdentities<T extends Record<string, any>>(products: T[] | null | undefined, productsByUid?: Record<string, Record<string, any>> | null): RepairDuplicateProductLineIdentitiesResult<T>;
 /**
  * 持久化行 ID 是服务端事实主键；只有至少一侧尚未持久化时，才允许用 runtime UID 对齐。
  */

package/dist/modules/Order/utils/orderCollectionIdentity.js

@@ -74,6 +74,81 @@ export function setOrderCollectionUid(kind, item, uid) {
   delete record[uidField];
   return record;
 }
+function getGoodPassResourceId(product) {
+  var _ref, _ref2, _goodPass$discount$re, _goodPass$discount;
+  var goodPass = (product.discount_list || []).find(function (item) {
+    var _item$discount, _item$discount2;
+    var type = (item === null || item === void 0 ? void 0 : item.type) || (item === null || item === void 0 ? void 0 : item.tag) || (item === null || item === void 0 || (_item$discount = item.discount) === null || _item$discount === void 0 ? void 0 : _item$discount.type) || (item === null || item === void 0 || (_item$discount2 = item.discount) === null || _item$discount2 === void 0 ? void 0 : _item$discount2.tag);
+    return type === 'good_pass';
+  });
+  if (!goodPass) return null;
+  var resourceId = (_ref = (_ref2 = (_goodPass$discount$re = (_goodPass$discount = goodPass.discount) === null || _goodPass$discount === void 0 ? void 0 : _goodPass$discount.resource_id) !== null && _goodPass$discount$re !== void 0 ? _goodPass$discount$re : goodPass.resource_id) !== null && _ref2 !== void 0 ? _ref2 : goodPass.discount_id) !== null && _ref !== void 0 ? _ref : goodPass.id;
+  return isBlankOrderCollectionIdentity(resourceId) ? null : String(resourceId);
+}
+function buildSplitProductUid(originalUid, product, duplicateOrdinal) {
+  var encodedOriginalUid = encodeURIComponent(originalUid);
+  var resourceId = getGoodPassResourceId(product);
+  if (resourceId) {
+    return "os-split:product:".concat(encodedOriginalUid, ":good-pass:").concat(encodeURIComponent(resourceId), ":").concat(duplicateOrdinal);
+  }
+  return "os-split:product:".concat(encodedOriginalUid, ":duplicate:").concat(duplicateOrdinal);
+}
+
+/**
+ * Rules 会把同一商品按商品券拆成多条真实订单行。拆行结果会继承原商品 UID，
+ * 因此必须在通用 collection normalization 之前为后续行派生稳定身份，避免被折叠。
+ */
+export function repairDuplicateProductLineIdentities(products, productsByUid) {
+  var repairedProducts = cloneDeep(products || []);
+  var repairedProductsByUid = productsByUid ? cloneDeep(productsByUid) : undefined;
+  var occupiedUids = new Set(repairedProducts.map(function (product) {
+    return getOrderCollectionUid('product', product);
+  }).filter(function (uid) {
+    return Boolean(uid);
+  }));
+  Object.keys(repairedProductsByUid || {}).forEach(function (uid) {
+    return occupiedUids.add(uid);
+  });
+  var occurrences = new Map();
+  var repairs = [];
+  repairedProducts.forEach(function (product, index) {
+    var originalUid = getOrderCollectionUid('product', product);
+    if (!originalUid) return;
+    var occurrence = (occurrences.get(originalUid) || 0) + 1;
+    occurrences.set(originalUid, occurrence);
+    if (occurrence === 1) return;
+    var duplicateOrdinal = occurrence - 1;
+    var baseCandidate = buildSplitProductUid(originalUid, product, duplicateOrdinal);
+    var nextUid = baseCandidate;
+    var conflictOrdinal = 1;
+    while (occupiedUids.has(nextUid)) {
+      nextUid = "".concat(baseCandidate, ":conflict:").concat(conflictOrdinal);
+      conflictOrdinal += 1;
+    }
+    var repairedProduct = setOrderCollectionUid('product', product, nextUid);
+    repairedProduct.identity_key = nextUid;
+    repairedProducts[index] = repairedProduct;
+    occupiedUids.add(nextUid);
+    repairs.push({
+      index: index,
+      from: originalUid,
+      to: nextUid
+    });
+    var runtimeSource = repairedProductsByUid === null || repairedProductsByUid === void 0 ? void 0 : repairedProductsByUid[originalUid];
+    if (runtimeSource && repairedProductsByUid) {
+      repairedProductsByUid[nextUid] = _objectSpread(_objectSpread({}, cloneDeep(runtimeSource)), runtimeSource.rowKey !== undefined ? {
+        rowKey: nextUid
+      } : {});
+    }
+  });
+  return _objectSpread(_objectSpread({
+    products: repairedProducts
+  }, repairedProductsByUid ? {
+    productsByUid: repairedProductsByUid
+  } : {}), {}, {
+    repairs: repairs
+  });
+}
 
 /**
  * 持久化行 ID 是服务端事实主键；只有至少一侧尚未持久化时，才允许用 runtime UID 对齐。

package/dist/modules/Order/utils.d.ts

@@ -15,6 +15,7 @@ export interface OrderProductsDepositSummary {
     deposit_policy_ids: number[];
     hasDeposit: boolean;
 }
+import type { WindowPlugin } from '../../plugins';
 /**
  * 把"含 option 的主商品单价"与 bundle 合成"单行 composite 单价"。
  *
@@ -177,6 +178,15 @@ export declare const mergeRelationForms: (relationForms: {
     form_id: number;
     form_record_ids: number[];
 }[];
+export interface CartOrderHolder {
+    customer_id?: number;
+    form_id: number | string;
+    form_record: (number | string)[] | null;
+}
+/**
+ * 为购物车行补齐订单所需的 holder 信息（与 cartAccount 结构保持一致）
+ */
+export declare function ensureCartItemOriginHolder(cartItem: CartItem, window?: WindowPlugin): void;
 export declare const getAllDiscountList: (cartItem: CartItem) => any;
 export { createUuidV4 };
 export declare function isTempOrder(data: any): data is OrderTempOrder;