@pisell/pisellos 2.2.180 → 2.2.182

package/lib/modules/Order/index.js

@@ -37,7 +37,9 @@ var import_types = require("./types");
 var import_utils = require("./utils");
 var import_utils2 = require("../Product/utils");
 var import_dayjs = __toESM(require("dayjs"));
+var import_cartPromotion = require("../../solution/BaseSales/utils/cartPromotion");
 var import_utils3 = require("../../solution/ScanOrder/utils");
+var import_manualProductDiscount = require("./utils/manualProductDiscount");
 var import_Discount = require("../Discount");
 var import_Rules = require("../Rules");
 var import_types2 = require("../Rules/types");
@@ -49,25 +51,51 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     super(name || "order", version);
     this.defaultName = "order";
     this.defaultVersion = "1.0.0";
+    // ─── 促销/赠品 ────────────────────────────────────
+    /** 评估器引用；由 SalesSdkProvider 注入，未注入时 applyPromotion 静默跳过 */
+    this.promotionEvaluator = null;
+    /** 赠品选择 resolver；由 SDK host bridge 注入 */
+    this.giftSelectResolver = null;
+    /** applyPromotion 递归保护 flag（写路径同步调 applyPromotion，禁止重入） */
+    this.isApplyingPromotion = false;
+    /** 最近一次 applyPromotion 的未满足促销提示 */
+    this.lastUnfulfilledPromotions = [];
+    /** 最近一次 applyPromotion 的赠品操作 diff（debug / SDK 读取使用） */
+    this.lastGiftActions = null;
+    /**
+     * 是否将 tempOrder 写入 IndexedDB 草稿（orders store）。
+     * BigSale 弹窗等短生命周期场景通过 setEnableTempOrderPersist(false) 关闭。
+     */
+    this.draftPersistEnabled = true;
   }
   /**
    * Populate `savedAmount` on each discount based on product-level discount details.
    * Only selected discounts get a non-zero value.
    */
   static populateSavedAmounts(productList, discountList) {
-    var _a, _b;
     const savedMap = /* @__PURE__ */ new Map();
+    const addDiscountAmount = (discount, quantity) => {
+      var _a, _b;
+      const discountKey = ((_a = discount.discount) == null ? void 0 : _a.resource_id) || discount.id;
+      if (discountKey == null)
+        return;
+      const qty = Number(quantity) || 1;
+      const amount = new import_decimal.default(discount.amount || 0).times(qty).plus(((_b = discount.metadata) == null ? void 0 : _b.product_discount_difference) || 0);
+      savedMap.set(
+        discountKey,
+        (savedMap.get(discountKey) || new import_decimal.default(0)).plus(amount)
+      );
+    };
     for (const product of productList) {
       const qty = product.num || 1;
       for (const pd of product.discount_list || []) {
-        const discountKey = ((_a = pd.discount) == null ? void 0 : _a.resource_id) || pd.id;
-        if (discountKey == null)
-          continue;
-        const amount = new import_decimal.default(pd.amount || 0).times(qty).plus(((_b = pd.metadata) == null ? void 0 : _b.product_discount_difference) || 0);
-        savedMap.set(
-          discountKey,
-          (savedMap.get(discountKey) || new import_decimal.default(0)).plus(amount)
-        );
+        addDiscountAmount(pd, qty);
+      }
+      for (const bundle of product.product_bundle || []) {
+        const bundleQty = new import_decimal.default(Number(qty) || 1).times(Number((bundle == null ? void 0 : bundle.num) ?? (bundle == null ? void 0 : bundle.quantity) ?? 1) || 1).toNumber();
+        for (const pd of (bundle == null ? void 0 : bundle.discount_list) || []) {
+          addDiscountAmount(pd, bundleQty);
+        }
       }
     }
     for (const d of discountList) {
@@ -75,6 +103,27 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       d.savedAmount = d.isSelected && key != null && savedMap.has(key) ? savedMap.get(key).toNumber() : 0;
     }
   }
+  applyProductDiscountPrices(products) {
+    return (products || []).map((product) => {
+      var _a, _b, _c;
+      if ((_a = product.metadata) == null ? void 0 : _a.is_manual_discount)
+        return product;
+      const totalPerUnitDiscount = (0, import_utils.resolveEffectivePerUnitDiscount)(product);
+      const optionSum = (0, import_utils.sumOptionUnitPrice)(product.product_option_item);
+      const sourcePrice = ((_b = product.metadata) == null ? void 0 : _b.source_product_price) ?? (((_c = product.metadata) == null ? void 0 : _c.main_product_original_price) != null ? new import_decimal.default(Number(product.metadata.main_product_original_price) || 0).minus(optionSum).toFixed(2) : product.original_price ?? "0");
+      const newSourceSellingPrice = new import_decimal.default(Number(sourcePrice) || 0).minus(totalPerUnitDiscount).toDecimalPlaces(2).toString();
+      const newMainSellingPrice = new import_decimal.default(Number(newSourceSellingPrice) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
+      if (product.metadata) {
+        product.metadata.main_product_selling_price = newMainSellingPrice;
+        product.metadata.price_schema_version = 2;
+      }
+      product.selling_price = (0, import_utils.composeLinePrice)({
+        mainPrice: newMainSellingPrice,
+        bundle: product.product_bundle
+      });
+      return product;
+    });
+  }
   async initialize(core, options) {
     var _a, _b, _c;
     this.core = core;
@@ -101,7 +150,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.orderHooks = options.hooks || ((_b = otherParams.order) == null ? void 0 : _b.hooks) || ((_c = otherParams.hooks) == null ? void 0 : _c.order);
     this.otherParams = otherParams;
     this.registerDiscountModules(options);
-    this.restoreTempOrderFromStorage();
     this.logInfo("OrderModule initialized successfully");
   }
   /**
@@ -174,21 +222,25 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   // ─── Discount: 公共 API ───
   async loadDiscountConfig(params) {
-    var _a, _b, _c, _d;
-    const discountList = await ((_a = this.store.discount) == null ? void 0 : _a.loadPrepareConfig({
+    var _a, _b, _c, _d, _e, _f;
+    const orderId = params.orderId || ((_a = this.store.tempOrder) == null ? void 0 : _a.order_id) || void 0;
+    const discountList = await ((_b = this.store.discount) == null ? void 0 : _b.loadPrepareConfig({
       customer_id: params.customerId,
-      action: params.action || "create",
+      action: params.action || (orderId ? "edit" : "create"),
       with_good_pass: 1,
       with_discount_card: 1,
       with_wallet_pass_holder: 1,
-      request_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
+      request_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+      ...orderId ? { order_id: orderId } : {}
     }));
     if (discountList) {
-      (_b = this.store.discount) == null ? void 0 : _b.setDiscountList(discountList);
+      await ((_c = this.store.discount) == null ? void 0 : _c.setOriginalDiscountList(discountList));
+      await ((_d = this.store.discount) == null ? void 0 : _d.setDiscountList(discountList));
     }
-    if ((_d = (_c = this.store.tempOrder) == null ? void 0 : _c.products) == null ? void 0 : _d.length) {
+    if (params.apply !== false && ((_f = (_e = this.store.tempOrder) == null ? void 0 : _e.products) == null ? void 0 : _f.length)) {
       this.applyDiscount();
     }
+    return this.getDiscountList();
   }
   getDiscountList() {
     var _a;
@@ -204,6 +256,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         type: "clientCalc",
         isAvailable: false,
         discountList: this.getDiscountList(),
+        scannedDiscountList: resultDiscountList,
         unavailableReason: import_types2.UnavailableReason.Unknown
       };
     }
@@ -212,6 +265,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         type: "server",
         isAvailable: false,
         discountList: this.getDiscountList(),
+        scannedDiscountList: resultDiscountList,
         unavailableReasonKey
       };
     }
@@ -224,7 +278,8 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return {
         type: "clientCalc",
         isAvailable: true,
-        discountList: this.getDiscountList()
+        discountList: this.getDiscountList(),
+        scannedDiscountList: resultDiscountList
       };
     }
     const tempOrder = this.store.tempOrder;
@@ -245,6 +300,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       type: "clientCalc",
       isAvailable: isAvailable || false,
       discountList: newDiscountList || this.getDiscountList(),
+      scannedDiscountList: resultDiscountList,
       unavailableReason
     };
   }
@@ -253,6 +309,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const tempOrder = this.store.tempOrder;
     if (!tempOrder)
       return;
+    delete tempOrder.discount_list;
     const rulesModule = this.store.rules;
     if (!rulesModule)
       return;
@@ -266,7 +323,23 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       orderTotalAmount: Number(((_d = this.store.summary) == null ? void 0 : _d.total_amount) || 0)
     });
     if (result == null ? void 0 : result.productList) {
-      tempOrder.products = result.productList;
+      const previousProductsByUid = (0, import_utils.indexOrderProductsByUid)(tempOrder.products);
+      tempOrder.products = this.applyProductDiscountPrices(
+        (result.productList || []).map((product, index) => {
+          const uid = (0, import_utils.getOrderProductLineUid)(product);
+          const previous = (uid ? previousProductsByUid.get(uid) : void 0) ?? previousProductsByUid.get(`__index__:${index}`);
+          const mergedProduct = previous ? (0, import_utils.mergeOrderProductDisplayFields)(previous, product) : product;
+          return {
+            ...mergedProduct,
+            discount_list: (0, import_utils.normalizeOrderProductDiscountList)(
+              (0, import_manualProductDiscount.syncManualProductDiscountProductNum)(
+                mergedProduct.discount_list,
+                mergedProduct.num
+              )
+            )
+          };
+        })
+      );
     }
     if (result == null ? void 0 : result.discountList) {
       OrderModule.populateSavedAmounts(
@@ -274,80 +347,185 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         result.discountList
       );
       (_e = this.store.discount) == null ? void 0 : _e.setDiscountList(result.discountList);
-      tempOrder.discount_list = result.discountList.filter(
-        (d) => d.isSelected
-      );
     }
   }
-  // ─── TempOrder: 初始化入口 ───
-  initTempOrder(params) {
-    if (params.cacheId !== void 0)
-      this.cacheId = params.cacheId;
-    if (params.salesSummaryModuleName !== void 0)
-      this.salesSummaryModuleName = params.salesSummaryModuleName;
-    this.restoreTempOrderFromStorage();
+  // ─── 促销/赠品 ──────────────────────────────────────
+  /**
+   * 注入促销评估器。
+   *
+   * @example
+   * order.setPromotionEvaluator(appHelper.utils.promotionEvaluator);
+   */
+  setPromotionEvaluator(evaluator) {
+    this.promotionEvaluator = evaluator || null;
   }
-  // ─── TempOrder: localStorage 持久化 ───
-  getTempOrderStorageKey() {
-    if (!this.cacheId)
-      return null;
-    return `scanOrder:tempOrder:${this.cacheId}`;
+  /**
+   * 注入赠品选择 resolver。OS 需要补赠品时会 await 调用 resolver；缺省时跳过新增并 console.warn。
+   *
+   * @example
+   * order.setGiftSelectResolver(async (ctx) => {
+   *   // SDK 内部决定弹窗 or 自动选第一项，返回完整 OrderProduct[]
+   *   return giftSelectBridge.request(ctx);
+   * });
+   */
+  setGiftSelectResolver(resolver) {
+    this.giftSelectResolver = resolver || null;
   }
-  restoreTempOrderFromStorage() {
-    var _a, _b;
-    const key = this.getTempOrderStorageKey();
-    if (!key)
+  /**
+   * 为商品目录追加促销标签，供上层 Sales 门面复用。
+   *
+   * @example
+   * const products = order.appendPromotionTags(catalogProducts);
+   */
+  appendPromotionTags(products) {
+    return (0, import_cartPromotion.appendPromotionTags)(products, this.promotionEvaluator);
+  }
+  /**
+   * 应用购物车促销：计算 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied。
+   *
+   * 调用时机：写路径（add/update/remove/clear/setCustomer）末尾自动触发；外部一般无需手动调。
+   *
+   * 关键约束：
+   * - 不调用任何公开 CRUD API（如 removeProductFromOrder），全部内部 mutate tempOrder.products，避免事件风暴；
+   * - 用 `isApplyingPromotion` 防递归；
+   * - 多选项赠品依赖 giftSelectResolver，未注入则跳过且 console.warn；
+   * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进。
+   */
+  async applyPromotion() {
+    if (this.isApplyingPromotion)
       return;
-    if (!this.window)
+    if (!this.promotionEvaluator)
       return;
-    const cachedData = this.window.localStorage.getItem(key);
-    if (!cachedData)
+    const tempOrder = this.store.tempOrder;
+    if (!tempOrder)
       return;
+    this.isApplyingPromotion = true;
     try {
-      const parsedData = JSON.parse(cachedData);
-      if (!(0, import_utils.isTempOrder)(parsedData)) {
-        this.window.localStorage.removeItem(key);
-        return;
+      const result = (0, import_cartPromotion.processCartPromotion)(
+        tempOrder.products,
+        this.promotionEvaluator
+      );
+      if (result.giftActions.toRemove.length > 0) {
+        const removeSet = new Set(result.giftActions.toRemove.map(String));
+        result.products = result.products.filter((p) => {
+          const uid = (0, import_cartPromotion.getOrderProductUid)(p);
+          return uid ? !removeSet.has(String(uid)) : true;
+        });
       }
-      if (Array.isArray(parsedData.products)) {
-        for (let i = 0; i < parsedData.products.length; i++) {
-          const p = parsedData.products[i];
-          if (!p || typeof p !== "object")
-            continue;
-          if (!Array.isArray(p.product_option_item)) {
-            p.product_option_item = [];
-          }
-          if (!Array.isArray(p.product_bundle)) {
-            p.product_bundle = [];
+      for (const reduce of result.giftActions.toReduce) {
+        for (const item of reduce.items) {
+          const product = result.products.find(
+            (p) => (0, import_cartPromotion.getOrderProductUid)(p) === item.uid
+          );
+          if (product) {
+            product.num = item.newQuantity;
           }
-          const row = p;
-          parsedData.products[i] = (0, import_utils3.normalizeOrderProduct)(row);
         }
       }
-      const parsedRecord = parsedData;
-      this.store.summary = parsedRecord.summary || (0, import_utils.createEmptySummary)();
-      delete parsedData.summary;
-      if (parsedRecord.lastOrderInfo) {
-        this.store.lastOrderInfo = parsedRecord.lastOrderInfo;
-        delete parsedData.lastOrderInfo;
-      }
-      if (!parsedData._extend || typeof parsedData._extend !== "object") {
-        parsedData._extend = { productsByUid: {} };
-      } else if (!parsedData._extend.productsByUid) {
-        parsedData._extend.productsByUid = {};
+      if (result.giftActions.toAdd.length > 0) {
+        if (!this.giftSelectResolver) {
+          if (result.giftActions.toAdd.some((g) => g.giftOptions.length > 1)) {
+            console.warn(
+              "[OrderModule] giftSelectResolver not set, skip applying gifts",
+              result.giftActions.toAdd
+            );
+          } else {
+            console.warn(
+              "[OrderModule] giftSelectResolver not set, skip applying single-option gifts",
+              result.giftActions.toAdd
+            );
+          }
+        } else {
+          for (const addAction of result.giftActions.toAdd) {
+            if (addAction.giftOptions.length === 1) {
+              const sameStrategy = result.products.find(
+                (p) => {
+                  var _a, _b;
+                  return ((_b = (_a = p.metadata) == null ? void 0 : _a._giftInfo) == null ? void 0 : _b.strategyId) === addAction.strategyId;
+                }
+              );
+              if (sameStrategy) {
+                sameStrategy.num = (Number(sameStrategy.num) || 0) + (addAction.giftCount || 1);
+                continue;
+              }
+            }
+            try {
+              const giftProducts = await this.giftSelectResolver({
+                strategyId: addAction.strategyId,
+                strategyName: addAction.strategyName,
+                giftCount: addAction.giftCount,
+                giftOptions: addAction.giftOptions,
+                sourceProductIds: addAction.sourceProductIds
+              });
+              if (Array.isArray(giftProducts) && giftProducts.length > 0) {
+                for (const gp of giftProducts) {
+                  if (!gp)
+                    continue;
+                  result.products.push(gp);
+                }
+              }
+            } catch (error) {
+              console.warn(
+                "[OrderModule] giftSelectResolver rejected, skip add gift",
+                addAction.strategyId,
+                error
+              );
+            }
+          }
+        }
       }
-      this.store.tempOrder = parsedData;
-    } catch {
-      (_b = (_a = this.window) == null ? void 0 : _a.localStorage) == null ? void 0 : _b.removeItem(key);
+      tempOrder.products = result.products;
+      this.lastUnfulfilledPromotions = result.unfulfilledPromotions;
+      this.lastGiftActions = result.giftActions;
+      const payload = {
+        unfulfilledPromotions: result.unfulfilledPromotions,
+        giftActions: result.giftActions,
+        gifts: result.gifts.map((g) => ({
+          strategyId: g.strategyId,
+          strategyName: g.strategyName,
+          giftCount: g.giftCount,
+          giftOptions: g.giftOptions
+        })),
+        products: tempOrder.products
+      };
+      this.effectsEmit("onPromotionApplied", payload);
+    } catch (error) {
+      console.error("[OrderModule] applyPromotion failed", error);
+    } finally {
+      this.isApplyingPromotion = false;
     }
   }
+  /** 最近一次 applyPromotion 输出的未满足促销列表 */
+  getUnfulfilledPromotions() {
+    return this.lastUnfulfilledPromotions;
+  }
+  /** 最近一次 applyPromotion 输出的赠品操作 diff */
+  getLastGiftActions() {
+    return this.lastGiftActions;
+  }
+  // ─── TempOrder: 初始化入口 ───
+  initTempOrder(params) {
+    if (params.cacheId !== void 0)
+      this.cacheId = params.cacheId;
+    if (params.salesSummaryModuleName !== void 0)
+      this.salesSummaryModuleName = params.salesSummaryModuleName;
+  }
+  /**
+   * 控制 IndexedDB 草稿（saveDraft）是否写入。
+   * localStorage 版 tempOrder 持久化已废弃，此方法仅影响 saveDraft。
+   *
+   * @example
+   * order.setEnableTempOrderPersist(false); // BigSale 弹窗：跳过 ~1s 的 dbUpdate
+   */
+  setEnableTempOrderPersist(enabled) {
+    this.draftPersistEnabled = enabled;
+  }
+  /** 是否允许 saveDraft 写入 IndexedDB 草稿。 */
+  isTempOrderPersistEnabled() {
+    return this.draftPersistEnabled;
+  }
+  /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化；草稿保存请使用 IndexedDB saveDraft。 */
   persistTempOrder() {
-    const key = this.getTempOrderStorageKey();
-    if (!key || !this.store.tempOrder)
-      return;
-    if (!this.window)
-      return;
-    this.window.localStorage.setItem(key, JSON.stringify(this.store.tempOrder));
   }
   // ─── TempOrder: 创建 & 获取 ───
   createDefaultTempOrderInstance() {
@@ -391,6 +569,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
     return tempOrder.request_unique_idempotency_token;
   }
+  buildPaymentSyncIdempotencyToken(tempOrder, payments) {
+    const baseToken = this.ensureRequestUniqueIdempotencyToken(tempOrder);
+    const paidPaymentsCount = (payments || []).filter((payment) => {
+      return String((payment == null ? void 0 : payment.status) || "").toLowerCase() === "paid";
+    }).length;
+    const paidCount = paidPaymentsCount > 0 ? paidPaymentsCount : payments.length;
+    return `${baseToken}_payment_${paidCount}`;
+  }
   hasLocalDatabase() {
     return !!this.dbManager;
   }
@@ -478,8 +664,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   async saveDraft() {
     var _a, _b;
-    if (!this.dbManager)
+    if (!this.draftPersistEnabled || !this.dbManager) {
       return;
+    }
     const tempOrder = this.ensureTempOrder();
     const record = this.buildLocalOrderRecord(tempOrder);
     try {
@@ -493,6 +680,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       });
     }
   }
+  saveDraftInBackground() {
+    void this.saveDraft();
+  }
   async hydrateTempOrderFromLocalRecord(record) {
     return this.hydrateTempOrderFromRecord(record);
   }
@@ -509,6 +699,33 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return sum.plus(amount.minus(rounding));
     }, new import_decimal.default(0));
   }
+  normalizePaymentSource(payment, options) {
+    const paymentRecord = payment;
+    const metadata = paymentRecord.metadata && typeof paymentRecord.metadata === "object" ? { ...paymentRecord.metadata } : {};
+    if (!metadata.unique_identification_number) {
+      metadata.unique_identification_number = (0, import_utils.createUuidV4)();
+    }
+    const normalized = {
+      ...paymentRecord,
+      metadata,
+      origin_amount: paymentRecord.origin_amount ?? paymentRecord.amount ?? "0.00"
+    };
+    if (paymentRecord.status !== void 0) {
+      normalized.status = paymentRecord.status;
+    } else if ((options == null ? void 0 : options.defaultPaid) !== false) {
+      normalized.status = "paid";
+    }
+    return normalized;
+  }
+  updateTempOrderPaymentStatus(tempOrder) {
+    const paymentTotal = this.calculatePaymentTotal(tempOrder.payments || []);
+    if (paymentTotal.lte(0)) {
+      tempOrder.payment_status = tempOrder.payment_status || "payment_processing";
+      return;
+    }
+    const targetAmount = this.getPaymentTargetAmount();
+    tempOrder.payment_status = targetAmount.gt(0) && paymentTotal.gte(targetAmount) ? "paid" : "partially_paid";
+  }
   calculatePaidPaymentSummary(payments) {
     return (payments || []).reduce(
       (summary, payment) => {
@@ -537,6 +754,66 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const fixedAmount = new import_decimal.default(serviceCharge.amount || 0);
     return new import_decimal.default(payment.amount || 0).times(percentage).plus(fixedAmount);
   }
+  formatSummaryMetadataMoney(value) {
+    if (value === void 0 || value === null || value === "")
+      return void 0;
+    if (value instanceof import_decimal.default)
+      return value.toFixed(2);
+    return new import_decimal.default(String(value || 0)).toFixed(2);
+  }
+  syncSummaryProductMetadata(products) {
+    const moneyKeys = [
+      "main_product_attached_bundle_surcharge_fee",
+      "main_product_attached_bundle_tax_fee",
+      "surcharge_rounding_remainder",
+      "tax_fee_rounding_remainder"
+    ];
+    for (const product of products || []) {
+      const productRecord = product;
+      const metadata = productRecord.metadata && typeof productRecord.metadata === "object" ? { ...productRecord.metadata } : {};
+      let hasMetadataPatch = false;
+      for (const key of moneyKeys) {
+        const value = this.formatSummaryMetadataMoney(productRecord[key]);
+        if (value === void 0)
+          continue;
+        metadata[key] = value;
+        hasMetadataPatch = true;
+      }
+      if (Array.isArray(productRecord.relation_surcharge_ids)) {
+        metadata.relation_surcharge_ids = productRecord.relation_surcharge_ids;
+        hasMetadataPatch = true;
+      }
+      if (hasMetadataPatch)
+        productRecord.metadata = metadata;
+      if (!Array.isArray(productRecord.product_bundle))
+        continue;
+      for (const bundle of productRecord.product_bundle) {
+        const bundleRecord = bundle;
+        const bundleMetadata = bundleRecord.metadata && typeof bundleRecord.metadata === "object" ? { ...bundleRecord.metadata } : {};
+        let hasBundleMetadataPatch = false;
+        const bundleSurchargeFee = this.formatSummaryMetadataMoney(
+          bundleRecord.surcharge_fee
+        );
+        if (bundleSurchargeFee !== void 0) {
+          bundleMetadata.surcharge_fee = bundleSurchargeFee;
+          hasBundleMetadataPatch = true;
+        }
+        if (Array.isArray(bundleRecord.relation_surcharge_ids)) {
+          bundleMetadata.relation_surcharge_ids = bundleRecord.relation_surcharge_ids;
+          hasBundleMetadataPatch = true;
+        }
+        if (hasBundleMetadataPatch)
+          bundleRecord.metadata = bundleMetadata;
+      }
+    }
+  }
+  calculateSummaryAmountGap(params) {
+    const { tempOrder, summary, orderPaidAmount } = params;
+    const depositAmount = summary.deposit_amount || tempOrder.deposit_amount || "0.00";
+    const isDeposit = tempOrder.is_deposit === 1 || new import_decimal.default(depositAmount || 0).gt(0);
+    const targetAmount = isDeposit ? new import_decimal.default(depositAmount || 0) : new import_decimal.default(summary.total_amount || summary.expect_amount || 0);
+    return targetAmount.minus(orderPaidAmount).toFixed(2);
+  }
   getPaymentTargetAmount() {
     const tempOrder = this.ensureTempOrder();
     const summary = this.store.summary || (0, import_utils.createEmptySummary)();
@@ -559,17 +836,43 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return newOrder;
   }
   restoreOrder() {
+    var _a, _b;
     const freshTempOrder = this.createDefaultTempOrderInstance();
     this.ensureExternalSaleNumber(freshTempOrder);
     this.store.tempOrder = freshTempOrder;
     this.store.summary = (0, import_utils.createEmptySummary)();
     this.store.lastOrderInfo = void 0;
+    this.store.syncState = void 0;
+    void ((_a = this.store.discount) == null ? void 0 : _a.setOriginalDiscountList([]));
+    void ((_b = this.store.discount) == null ? void 0 : _b.setDiscountList([]));
     this.persistTempOrder();
     return freshTempOrder;
   }
   getTempOrder() {
     return this.store.tempOrder;
   }
+  async replaceTempOrder(tempOrder, options) {
+    if (!(0, import_utils.isTempOrder)(tempOrder)) {
+      throw new Error("无效的 tempOrder 数据");
+    }
+    const nextTempOrder = this.normalizeTempOrderForRuntime(
+      (0, import_lodash_es.cloneDeep)(tempOrder),
+      { ensureIdentity: false }
+    );
+    this.store.tempOrder = nextTempOrder;
+    if ((options == null ? void 0 : options.recalculateSummary) !== false) {
+      await this.recalculateSummary({ createIfMissing: false });
+    } else {
+      this.store.summary = (0, import_utils.createEmptySummary)();
+    }
+    if ((options == null ? void 0 : options.persist) !== false) {
+      this.persistTempOrder();
+    }
+    if (options == null ? void 0 : options.saveDraft) {
+      await this.saveDraft();
+    }
+    return nextTempOrder;
+  }
   getOrderIdentity() {
     var _a;
     const tempOrder = this.store.tempOrder;
@@ -607,7 +910,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const depositAmount = tempOrder.deposit_amount || summary.deposit_amount || "0.00";
     const targetAmount = tempOrder.is_deposit === 1 ? new import_decimal.default(depositAmount || 0) : new import_decimal.default(summary.total_amount || summary.expect_amount || 0);
     const paymentTotal = this.calculatePaymentTotal(tempOrder.payments || []);
-    const amountGap = import_decimal.default.max(0, targetAmount.minus(paymentTotal)).toFixed(2);
+    const amountGap = targetAmount.minus(paymentTotal).toFixed(2);
     return {
       isDeposit: tempOrder.is_deposit === 1 || depositAmount !== "0.00",
       depositAmount,
@@ -650,7 +953,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.ensureExternalSaleNumber(tempOrder);
     await this.recalculateSummary({ createIfMissing: true });
     this.persistTempOrder();
-    await this.saveDraft();
+    if (this.draftPersistEnabled) {
+      await this.saveDraft();
+    }
     return tempOrder;
   }
   getOrderProducts() {
@@ -718,6 +1023,33 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       }
     };
   }
+  getBookingUniqueIdentificationNumber(booking) {
+    var _a;
+    const uid = (_a = booking == null ? void 0 : booking.metadata) == null ? void 0 : _a.unique_identification_number;
+    if (uid === void 0 || uid === null || uid === "")
+      return null;
+    return String(uid);
+  }
+  findBookingIndexByUniqueIdentificationNumber(tempOrder, uniqueIdentificationNumber) {
+    return (tempOrder.bookings || []).findIndex((booking) => {
+      return this.getBookingUniqueIdentificationNumber(booking) === uniqueIdentificationNumber;
+    });
+  }
+  removeLinkedBookingsForProduct(tempOrder, product) {
+    var _a, _b;
+    const productUid = ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.unique_identification_number) || (product == null ? void 0 : product.unique_identification_number);
+    const bookingUid = (product == null ? void 0 : product.booking_uid) || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.booking_uid);
+    if (!productUid && !bookingUid)
+      return;
+    tempOrder.bookings = (tempOrder.bookings || []).filter((booking) => {
+      const currentBookingUid = this.getBookingUniqueIdentificationNumber(booking);
+      if (bookingUid && currentBookingUid === String(bookingUid))
+        return false;
+      if (productUid && String((booking == null ? void 0 : booking.product_uid) || "") === String(productUid))
+        return false;
+      return true;
+    });
+  }
   // ─── TempOrder: 金额汇总 ───
   getSalesSummary() {
     if (!this.salesSummaryModuleName)
@@ -739,6 +1071,11 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         total_refund_amount: existedSummary.total_refund_amount || "0.00",
         customer_paid_amount: paidPaymentSummary.customerPaidAmount.toFixed(2),
         order_paid_amount: paidPaymentSummary.orderPaidAmount.toFixed(2),
+        amount_gap: this.calculateSummaryAmountGap({
+          tempOrder,
+          summary: (0, import_utils.createEmptySummary)(),
+          orderPaidAmount: paidPaymentSummary.orderPaidAmount
+        }),
         pay_service_charge_amount: paidPaymentSummary.payServiceChargeAmount.toFixed(2)
       };
       this.store.summary = emptySummary;
@@ -750,11 +1087,17 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       isPriceIncludeTax: tempOrder.is_price_include_tax,
       shopDiscount: tempOrder.shop_discount
     });
+    this.syncSummaryProductMetadata(tempOrder.products || []);
     const summary = {
       ...salesSummaryResult,
       total_refund_amount: existedSummary.total_refund_amount || "0.00",
       customer_paid_amount: paidPaymentSummary.customerPaidAmount.toFixed(2),
       order_paid_amount: paidPaymentSummary.orderPaidAmount.toFixed(2),
+      amount_gap: this.calculateSummaryAmountGap({
+        tempOrder,
+        summary: salesSummaryResult,
+        orderPaidAmount: paidPaymentSummary.orderPaidAmount
+      }),
       pay_service_charge_amount: paidPaymentSummary.payServiceChargeAmount.toFixed(2)
     };
     this.store.summary = summary;
@@ -777,13 +1120,22 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.persistTempOrder();
     return summary;
   }
-  // ─── TempOrder: 备注 ───
-  updateTempOrderNote(note) {
+  updateTempOrderNote(note, sync = false) {
     const tempOrder = this.ensureTempOrder();
     tempOrder.note = String(note || "");
     this.persistTempOrder();
+    if (sync) {
+      const orderId = tempOrder.order_id;
+      if (!orderId)
+        return tempOrder.note;
+      return this.syncTempOrderNoteToRemote(orderId, tempOrder.note);
+    }
     return tempOrder.note;
   }
+  async syncTempOrderNoteToRemote(orderId, note) {
+    await this.request.put(`/order/order/${orderId}/note`, { note });
+    return note;
+  }
   getTempOrderNote() {
     var _a;
     return ((_a = this.store.tempOrder) == null ? void 0 : _a.note) || "";
@@ -807,10 +1159,29 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.persistTempOrder();
     return tempOrder.contacts_info;
   }
+  buildTempOrderCustomer(params) {
+    if (!params.customerId)
+      return null;
+    const source = params.source ? (0, import_lodash_es.cloneDeep)(params.source) : {};
+    const name = source.name ?? source.display_name ?? source.customerName ?? source.customer_name ?? params.customerName;
+    const customerName = source.customer_name ?? source.customerName ?? source.display_name ?? source.name ?? params.customerName;
+    return {
+      ...source,
+      id: source.id ?? params.customerId,
+      customer_id: source.customer_id ?? params.customerId,
+      name: String(name || ""),
+      customer_name: String(customerName || ""),
+      country_calling_code: String(
+        source.country_calling_code ?? source.countryCallingCode ?? params.countryCallingCode
+      ),
+      phone: String(source.phone ?? params.phone),
+      email: String(source.email ?? params.email)
+    };
+  }
   /**
    * 更新当前 tempOrder 的客户协议字段。
    *
-   * PaymentModal 只需要修改订单里的客户字段；如果外部还有客户模块需要同步，
+   * PaymentModal 只需要修改订单里的客户事实；如果外部还有客户模块需要同步，
    * 应由调用方通过回调处理，不能把外部 UI 状态写进 tempOrder。
    */
   updateTempOrderCustomer(customer) {
@@ -824,6 +1195,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     );
     tempOrder.phone = String(customer.phone || "");
     tempOrder.email = String(customer.email || "");
+    tempOrder.customer = this.buildTempOrderCustomer({
+      source: customer,
+      customerId: tempOrder.customer_id,
+      customerName: tempOrder.customer_name,
+      countryCallingCode: tempOrder.country_calling_code,
+      phone: tempOrder.phone,
+      email: tempOrder.email
+    });
     this.persistTempOrder();
     return {
       customerId: tempOrder.customer_id,
@@ -838,11 +1217,20 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return;
     }
     const tempOrder = this.ensureTempOrder();
+    const previousCustomerId = tempOrder.customer_id ?? null;
     tempOrder.customer_id = patch.customer_id || patch.id || null;
     tempOrder.customer_name = String(patch.customer_name || "");
     tempOrder.country_calling_code = String(patch.country_calling_code || "");
     tempOrder.phone = String(patch.phone || "");
     tempOrder.email = String(patch.email || "");
+    tempOrder.customer = this.buildTempOrderCustomer({
+      source: snapshot || null,
+      customerId: tempOrder.customer_id,
+      customerName: tempOrder.customer_name,
+      countryCallingCode: tempOrder.country_calling_code,
+      phone: tempOrder.phone,
+      email: tempOrder.email
+    });
     if (snapshot !== void 0) {
       const extend = this.ensureExtend(tempOrder);
       if (snapshot === null)
@@ -850,12 +1238,19 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       else
         extend.customerSnapshot = (0, import_lodash_es.cloneDeep)(snapshot);
     }
+    const nextCustomerId = tempOrder.customer_id ?? null;
+    if (String(previousCustomerId ?? "") !== String(nextCustomerId ?? "")) {
+      (0, import_utils.clearTempOrderHolderAssignments)(tempOrder);
+    }
     this.persistTempOrder();
-    this.emitOrderCustomerChange();
+    this.saveDraftInBackground();
+    if (String(previousCustomerId ?? "") !== String(nextCustomerId ?? "")) {
+      this.emitOrderCustomerChange();
+    }
   }
   getOrderCustomer() {
     const tempOrder = this.store.tempOrder;
-    if (!tempOrder || tempOrder.customer_id === null || tempOrder.customer_id === void 0) {
+    if (!tempOrder || !tempOrder.customer_id) {
       return null;
     }
     return {
@@ -873,14 +1268,17 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   clearOrderCustomer() {
     const tempOrder = this.ensureTempOrder();
+    (0, import_utils.clearTempOrderHolderAssignments)(tempOrder);
     tempOrder.customer_id = null;
     tempOrder.customer_name = "";
     tempOrder.country_calling_code = "";
     tempOrder.phone = "";
     tempOrder.email = "";
+    tempOrder.customer = null;
     if (tempOrder._extend)
       delete tempOrder._extend.customerSnapshot;
     this.persistTempOrder();
+    this.saveDraftInBackground();
     this.core.effects.emit(import_types.OrderHooks.OnOrderCustomerChange, null);
   }
   emitOrderCustomerChange() {
@@ -920,10 +1318,20 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   /** 追加单个支付项，并立即持久化当前 tempOrder。 */
   addOrderPayment(payment) {
+    this.logInfo("addOrderPayment", {
+      payment
+    });
     const tempOrder = this.ensureTempOrder();
-    const mapped = (0, import_utils.mapPaymentItemsToOrderPayments)([payment]);
+    const mapped = (0, import_utils.mapPaymentItemsToOrderPayments)([
+      this.normalizePaymentSource(payment, { defaultPaid: true })
+    ]);
     tempOrder.payments = [...tempOrder.payments || [], ...mapped];
     this.persistTempOrder();
+    void this.recalculateSummary({ createIfMissing: true }).catch((error) => {
+      this.logError("recalculate summary after addOrderPayment failed", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    });
     return tempOrder.payments;
   }
   /**
@@ -989,14 +1397,24 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    */
   updateVoucherOrderPayments(payments) {
     const tempOrder = this.ensureTempOrder();
-    const mappedVouchers = (0, import_utils.mapPaymentItemsToOrderPayments)(payments).filter(
-      (payment) => payment.voucher_id !== void 0 && Number(payment.voucher_id) !== 0
-    );
+    const mappedVouchers = (0, import_utils.mapPaymentItemsToOrderPayments)(
+      payments.map(
+        (payment) => this.normalizePaymentSource(payment, { defaultPaid: false })
+      )
+    ).filter((payment) => {
+      return payment.voucher_id !== void 0 && Number(payment.voucher_id) !== 0;
+    });
     const nonVoucherPayments = (tempOrder.payments || []).filter((payment) => {
       return payment.voucher_id === void 0 || Number(payment.voucher_id) === 0;
     });
     tempOrder.payments = [...nonVoucherPayments, ...mappedVouchers];
+    this.updateTempOrderPaymentStatus(tempOrder);
     this.persistTempOrder();
+    void this.recalculateSummary({ createIfMissing: true }).catch((error) => {
+      this.logError("recalculate summary after updateVoucherOrderPayments failed", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    });
     return tempOrder.payments;
   }
   async shouldMergeProductToOrder(params) {
@@ -1026,6 +1444,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       productToAdd.product_bundle
     );
     const normalizedIncoming = (0, import_utils3.normalizeOrderProduct)(productToAdd);
+    normalizedIncoming.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+      normalizedIncoming.discount_list
+    );
     const hasIncomingGoodPass = this.hasGoodPassDiscount(
       normalizedIncoming
     );
@@ -1082,6 +1503,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           unique_identification_number: targetUid
         }
       });
+      normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+        normalizedProduct.discount_list
+      );
       tempOrder.products[matchedIndex] = {
         ...targetProduct,
         ...normalizedProduct,
@@ -1104,6 +1528,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (linked) {
       tempOrder.bookings = [...tempOrder.bookings || [], linked.booking];
     }
+    await this.applyPromotion();
     this.applyDiscount();
     await this.recalculateSummary({ createIfMissing: true });
     this.persistTempOrder();
@@ -1127,15 +1552,17 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       (item) => (item == null ? void 0 : item.type) === "good_pass" || (item == null ? void 0 : item.tag) === "good_pass"
     );
   }
-  async updateProductInOrder(params) {
-    var _a, _b, _c, _d, _e;
+  async updateOrderProduct(params) {
+    var _a, _b, _c, _d, _e, _f, _g;
     const {
       product_id,
       product_variant_id,
       updates,
       unique_identification_number,
+      identity_key,
       product_option_item,
-      product_bundle
+      product_bundle,
+      booking
     } = params;
     const tempOrder = this.ensureTempOrder();
     const identityLookup = {
@@ -1144,12 +1571,30 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     };
     if (unique_identification_number !== void 0) {
       identityLookup.unique_identification_number = unique_identification_number;
+      if (identity_key === void 0) {
+        identityLookup.identity_key = unique_identification_number;
+      }
+    }
+    if (identity_key !== void 0) {
+      identityLookup.identity_key = identity_key;
     }
     if (product_option_item !== void 0)
       identityLookup.product_option_item = product_option_item;
     if (product_bundle !== void 0)
       identityLookup.product_bundle = product_bundle;
-    const productIndex = (0, import_utils3.getProductIdentityIndex)(tempOrder.products, identityLookup);
+    let productIndex = -1;
+    if (unique_identification_number !== void 0) {
+      const targetUid = String(unique_identification_number);
+      productIndex = tempOrder.products.findIndex((item) => {
+        var _a2;
+        return String(
+          ((_a2 = item.metadata) == null ? void 0 : _a2.unique_identification_number) || item.unique_identification_number || ""
+        ) === targetUid;
+      });
+    }
+    if (productIndex === -1) {
+      productIndex = (0, import_utils3.getProductIdentityIndex)(tempOrder.products, identityLookup);
+    }
     if (productIndex === -1) {
       throw new Error("[Order] 目标商品不存在，无法更新");
     }
@@ -1176,28 +1621,178 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       delete nextProduct.metadata.main_product_original_price;
       delete nextProduct.metadata.price_schema_version;
     }
-    tempOrder.products[productIndex] = (0, import_utils3.normalizeOrderProduct)(nextProduct);
+    let normalizedProduct = (0, import_utils3.normalizeOrderProduct)(nextProduct);
+    normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+      normalizedProduct.discount_list
+    );
+    if (booking) {
+      const productUid = String(
+        ((_e = normalizedProduct.metadata) == null ? void 0 : _e.unique_identification_number) || ((_f = targetProduct.metadata) == null ? void 0 : _f.unique_identification_number) || unique_identification_number || (0, import_utils.createUuidV4)()
+      );
+      normalizedProduct.metadata = {
+        ...normalizedProduct.metadata || {},
+        unique_identification_number: productUid
+      };
+      const linked = this.createLinkedProductAndBooking({
+        product: {
+          ...normalizedProduct,
+          unique_identification_number: productUid
+        },
+        booking
+      });
+      this.removeLinkedBookingsForProduct(tempOrder, targetProduct);
+      normalizedProduct = {
+        ...normalizedProduct,
+        booking_uid: linked.bookingUid,
+        metadata: {
+          ...normalizedProduct.metadata || {},
+          booking_uid: linked.bookingUid,
+          unique_identification_number: productUid
+        }
+      };
+      tempOrder.bookings = [...tempOrder.bookings || [], linked.booking];
+    }
+    tempOrder.products[productIndex] = normalizedProduct;
     this.captureProductRuntime(
       tempOrder,
       updates,
       tempOrder.products[productIndex],
-      (_e = tempOrder.products[productIndex].metadata) == null ? void 0 : _e.unique_identification_number
+      (_g = tempOrder.products[productIndex].metadata) == null ? void 0 : _g.unique_identification_number
     );
+    await this.applyPromotion();
     this.applyDiscount();
     await this.recalculateSummary({ createIfMissing: true });
     this.persistTempOrder();
     return tempOrder.products;
   }
-  async removeProductFromOrder(identity) {
+  async updateOrderProductQuantity(params) {
+    var _a;
+    const {
+      product_id,
+      product_variant_id,
+      num,
+      unique_identification_number,
+      identity_key,
+      product_option_item,
+      product_bundle
+    } = params;
     const tempOrder = this.ensureTempOrder();
-    tempOrder.products = tempOrder.products.filter(
-      (item) => !(0, import_utils3.isIdentityMatch)(item, identity)
+    const identityLookup = {
+      product_id,
+      product_variant_id
+    };
+    if (unique_identification_number !== void 0) {
+      identityLookup.unique_identification_number = unique_identification_number;
+      if (identity_key === void 0) {
+        identityLookup.identity_key = unique_identification_number;
+      }
+    }
+    if (identity_key !== void 0)
+      identityLookup.identity_key = identity_key;
+    if (product_option_item !== void 0)
+      identityLookup.product_option_item = product_option_item;
+    if (product_bundle !== void 0)
+      identityLookup.product_bundle = product_bundle;
+    let productIndex = -1;
+    if (unique_identification_number !== void 0) {
+      const targetUid = String(unique_identification_number);
+      productIndex = tempOrder.products.findIndex((item) => {
+        var _a2;
+        return String(
+          ((_a2 = item.metadata) == null ? void 0 : _a2.unique_identification_number) || item.unique_identification_number || ""
+        ) === targetUid;
+      });
+    }
+    if (productIndex === -1) {
+      productIndex = (0, import_utils3.getProductIdentityIndex)(tempOrder.products, identityLookup);
+    }
+    if (productIndex === -1) {
+      throw new Error("[Order] 目标商品不存在，无法更新数量");
+    }
+    const targetProduct = tempOrder.products[productIndex];
+    const normalizedProduct = (0, import_utils3.normalizeOrderProduct)({
+      ...targetProduct,
+      num: (0, import_utils3.getSafeProductNum)(num),
+      metadata: {
+        ...targetProduct.metadata || {},
+        unique_identification_number: ((_a = targetProduct.metadata) == null ? void 0 : _a.unique_identification_number) || unique_identification_number
+      }
+    });
+    normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+      normalizedProduct.discount_list
     );
+    tempOrder.products[productIndex] = normalizedProduct;
+    await this.applyPromotion();
     this.applyDiscount();
     await this.recalculateSummary({ createIfMissing: true });
     this.persistTempOrder();
     return tempOrder.products;
   }
+  updateOrderBooking(params) {
+    const { unique_identification_number, updates } = params;
+    const tempOrder = this.ensureTempOrder();
+    const bookingUid = String(unique_identification_number || "");
+    const bookingIndex = this.findBookingIndexByUniqueIdentificationNumber(
+      tempOrder,
+      bookingUid
+    );
+    if (!bookingUid || bookingIndex === -1) {
+      throw new Error("[Order] 目标 booking 不存在，无法更新");
+    }
+    const targetBooking = tempOrder.bookings[bookingIndex] || {};
+    const nextBooking = {
+      ...targetBooking,
+      ...updates,
+      metadata: {
+        ...targetBooking.metadata || {},
+        ...updates.metadata || {},
+        unique_identification_number: bookingUid
+      }
+    };
+    nextBooking.is_all = (0, import_utils.normalizeBookingIsAll)(nextBooking);
+    nextBooking.sub_type = (0, import_utils.normalizeBookingSubType)(nextBooking);
+    tempOrder.bookings[bookingIndex] = nextBooking;
+    this.persistTempOrder();
+    return tempOrder.bookings;
+  }
+  async removeProductFromOrder(identity) {
+    const tempOrder = this.ensureTempOrder();
+    const removedProducts = [];
+    tempOrder.products = tempOrder.products.filter((item) => {
+      const shouldRemove = (0, import_utils3.isIdentityMatch)(item, identity);
+      if (shouldRemove)
+        removedProducts.push(item);
+      return !shouldRemove;
+    });
+    for (const product of removedProducts) {
+      this.removeLinkedBookingsForProduct(tempOrder, product);
+    }
+    await this.applyPromotion();
+    this.applyDiscount();
+    await this.recalculateSummary({ createIfMissing: true });
+    this.persistTempOrder();
+    return tempOrder.products;
+  }
+  /**
+   * 仅清空购物车行（products / bookings），不重置整单。
+   * 用于「仅清空商品」；客户、备注、支付等协议字段保持不变。
+   */
+  async clearOrderCartLines() {
+    const tempOrder = this.ensureTempOrder();
+    tempOrder.products = [];
+    tempOrder.bookings = [];
+    if (tempOrder._extend && typeof tempOrder._extend === "object") {
+      tempOrder._extend = {
+        ...tempOrder._extend,
+        productsByUid: {}
+      };
+    }
+    await this.applyPromotion();
+    this.applyDiscount();
+    await this.recalculateSummary({ createIfMissing: true });
+    this.persistTempOrder();
+    return tempOrder;
+  }
   // ─── TempOrder: 提交 ───
   /**
    * 提交当前 Sales tempOrder。
@@ -1224,7 +1819,8 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         ...hasPaymentStatusOverride ? { payment_status: params == null ? void 0 : params.paymentStatus } : {},
         ...hasSmallTicketDataFlagOverride ? { small_ticket_data_flag: params == null ? void 0 : params.smallTicketDataFlag } : {}
       };
-      return (params == null ? void 0 : params.enhancePayload) ? params.enhancePayload(nextPayload, ctx) : nextPayload;
+      const enhancedPayload = (params == null ? void 0 : params.enhancePayload) ? params.enhancePayload(nextPayload, ctx) : nextPayload;
+      return enhancedPayload;
     } : void 0;
     const payload = (0, import_utils.buildSubmitPayload)({
       tempOrder,
@@ -1241,6 +1837,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       this.logInfo("submitTempOrder calling sales checkout", {
         orderId: payload.order_id,
         externalSaleNumber: payload.external_sale_number,
+        requestUniqueIdempotencyToken: payload.request_unique_idempotency_token,
         paymentStatus: payload.payment_status,
         paymentsCount: ((_b = payload.payments) == null ? void 0 : _b.length) || 0,
         smallTicketDataFlag: payload.small_ticket_data_flag
@@ -1327,21 +1924,37 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const mappedPayments = (0, import_utils.mapPaymentItemsToOrderPayments)(
       params.payments || []
     );
-    tempOrder.payments = mappedPayments;
-    if (params.paymentStatus)
-      tempOrder.payment_status = params.paymentStatus;
-    this.persistTempOrder();
-    await this.saveDraft();
     const paymentTotal = this.calculatePaymentTotal(mappedPayments);
     const targetAmount = this.getPaymentTargetAmount();
     const isFullyPaid = targetAmount.lte(0) ? false : paymentTotal.gte(targetAmount);
-    if (!isFullyPaid || !params.submitWhenPaid) {
+    const paymentStatus = isFullyPaid ? params.paymentStatus || "paid" : "partially_paid";
+    tempOrder.payments = mappedPayments;
+    tempOrder.payment_status = paymentStatus;
+    this.persistTempOrder();
+    await this.saveDraft();
+    if (!params.submitWhenPaid) {
       return { isFullyPaid };
     }
+    if (this.store.syncState === "submitting") {
+      return { isFullyPaid };
+    }
+    this.store.syncState = "submitting";
+    const paymentSyncIdempotencyToken = this.buildPaymentSyncIdempotencyToken(
+      tempOrder,
+      mappedPayments
+    );
     const submitResult = await this.submitTempOrder({
       payments: mappedPayments,
-      paymentStatus: params.paymentStatus || "paid",
-      smallTicketDataFlag: params.smallTicketDataFlag
+      paymentStatus,
+      smallTicketDataFlag: params.smallTicketDataFlag,
+      channel: params.channel,
+      enhancePayload: (payload) => {
+        const nextPayload = {
+          ...payload,
+          request_unique_idempotency_token: paymentSyncIdempotencyToken
+        };
+        return nextPayload;
+      }
     });
     return { isFullyPaid, submitResult };
   }
@@ -1689,6 +2302,33 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         nextTempOrder[key] = raw[key];
       }
     });
+    this.store.tempOrder = nextTempOrder;
+    this.store.summary = raw.summary && typeof raw.summary === "object" ? { ...(0, import_utils.createEmptySummary)(), ...raw.summary } : (0, import_utils.createEmptySummary)();
+    this.store.lastOrderInfo = raw.lastOrderInfo || raw;
+    if (options == null ? void 0 : options.recalcOnHydrate) {
+      await this.recalculateSummary({ createIfMissing: false });
+    }
+    this.persistTempOrder();
+    return nextTempOrder;
+  }
+  normalizeTempOrderForRuntime(raw, options) {
+    const nextTempOrder = {
+      ...this.createDefaultTempOrderInstance(),
+      ...raw || {}
+    };
+    delete nextTempOrder.summary;
+    delete nextTempOrder.lastOrderInfo;
+    delete nextTempOrder.discount_list;
+    delete nextTempOrder.shop_id;
+    delete nextTempOrder.create_date;
+    delete nextTempOrder.total_amount;
+    delete nextTempOrder.expect_amount;
+    delete nextTempOrder.paid_amount;
+    delete nextTempOrder.shop_note;
+    delete nextTempOrder.start_time;
+    delete nextTempOrder.tax_fee;
+    delete nextTempOrder.total_refund_amount;
+    delete nextTempOrder.holder_id;
     nextTempOrder.metadata = raw.metadata && typeof raw.metadata === "object" ? { ...raw.metadata } : {};
     nextTempOrder.holder = raw.holder && typeof raw.holder === "object" ? { ...raw.holder } : null;
     nextTempOrder.products = Array.isArray(raw.products) ? raw.products.map((p) => this.normalizeHydratedOrderProduct(p)) : [];
@@ -1699,7 +2339,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     })) : [];
     nextTempOrder.payments = Array.isArray(raw.payments) ? raw.payments.map((p) => ({ ...p || {} })) : [];
     nextTempOrder.surcharges = Array.isArray(raw.surcharges) ? raw.surcharges.map((s) => ({ ...s || {} })) : [];
-    nextTempOrder.discount_list = Array.isArray(raw.discount_list) ? raw.discount_list.map((d) => ({ ...d || {} })) : [];
     nextTempOrder.relation_forms = Array.isArray(raw.relation_forms) ? raw.relation_forms.map((f) => ({ ...f || {} })) : [];
     nextTempOrder.contacts = Array.isArray(raw.contacts) ? raw.contacts.map((c) => ({ ...c || {} })) : [];
     nextTempOrder.contacts_info = raw.contacts_info && typeof raw.contacts_info === "object" && !Array.isArray(raw.contacts_info) ? { ...raw.contacts_info } : null;
@@ -1707,14 +2346,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       ...raw._extend,
       productsByUid: raw._extend.productsByUid || {}
     } : { productsByUid: {} };
-    this.ensureExternalSaleNumber(nextTempOrder);
-    this.store.tempOrder = nextTempOrder;
-    this.store.summary = raw.summary && typeof raw.summary === "object" ? { ...(0, import_utils.createEmptySummary)(), ...raw.summary } : (0, import_utils.createEmptySummary)();
-    this.store.lastOrderInfo = raw.lastOrderInfo || raw;
-    if (options == null ? void 0 : options.recalcOnHydrate) {
-      await this.recalculateSummary({ createIfMissing: false });
+    if ((options == null ? void 0 : options.ensureIdentity) !== false) {
+      this.ensureExternalSaleNumber(nextTempOrder);
     }
-    this.persistTempOrder();
     return nextTempOrder;
   }
   normalizeHydratedOrderProduct(product) {
@@ -1733,6 +2367,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       row.metadata.unique_identification_number = (0, import_utils.createUuidV4)();
     }
     const normalized = (0, import_utils3.normalizeOrderProduct)(row);
+    normalized.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+      normalized.discount_list
+    );
     const result = {
       ...row,
       ...normalized,