@pisell/pisellos 2.2.244 → 2.2.246

package/lib/modules/Order/index.js

@@ -37,37 +37,157 @@ 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");
 var import_decimal = __toESM(require("decimal.js"));
 var import_lodash_es = require("lodash-es");
-var LOCAL_ORDER_STORE_NAME = "orders";
+function normalizeDiscountListSignature(discountList) {
+  return (discountList || []).map((item) => ({
+    type: (item == null ? void 0 : item.type) ?? "",
+    discount_id: (item == null ? void 0 : item.discount_id) ?? null,
+    order_discount_id: (item == null ? void 0 : item.order_discount_id) ?? null,
+    amount: new import_decimal.default(Number(item == null ? void 0 : item.amount) || 0).toFixed(2)
+  }));
+}
+function isSameDiscountList(left, right) {
+  if (!Array.isArray(left) || !Array.isArray(right))
+    return false;
+  return JSON.stringify(normalizeDiscountListSignature(left)) === JSON.stringify(
+    normalizeDiscountListSignature(right)
+  );
+}
+function isManualProductDiscountProduct(product) {
+  var _a, _b;
+  return ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.is_manual_discount) === true || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.is_manual_discount) === 1 || ((product == null ? void 0 : product.discount_list) || []).some((item) => (item == null ? void 0 : item.type) === "product");
+}
 var OrderModule = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     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;
+  }
+  collectHydratedEditDiscounts(products) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    const discountMap = /* @__PURE__ */ new Map();
+    for (const product of products || []) {
+      for (const item of (product == null ? void 0 : product.discount_list) || []) {
+        const type = (item == null ? void 0 : item.type) ?? (item == null ? void 0 : item.tag);
+        if (!type || type === "product")
+          continue;
+        const resourceId = ((_a = item == null ? void 0 : item.discount) == null ? void 0 : _a.resource_id) ?? (item == null ? void 0 : item.resource_id) ?? (item == null ? void 0 : item.discount_id) ?? (item == null ? void 0 : item.order_discount_id);
+        if (resourceId === void 0 || resourceId === null || resourceId === "")
+          continue;
+        const id = Number(resourceId);
+        const key = Number.isFinite(id) ? id : String(resourceId);
+        const title = ((_b = item == null ? void 0 : item.discount) == null ? void 0 : _b.title) ?? {};
+        const amount = Number((item == null ? void 0 : item.amount) || 0);
+        const detail = {
+          amount: String((item == null ? void 0 : item.amount) ?? "0"),
+          type,
+          resource_id: key,
+          title,
+          original_amount: String(((_c = item == null ? void 0 : item.discount) == null ? void 0 : _c.original_amount) ?? (item == null ? void 0 : item.amount) ?? "0"),
+          num: Number(((_d = item == null ? void 0 : item.metadata) == null ? void 0 : _d.num) ?? (product == null ? void 0 : product.num) ?? (product == null ? void 0 : product.product_quantity) ?? 1) || 1,
+          metadata: item == null ? void 0 : item.metadata,
+          discount: item == null ? void 0 : item.discount,
+          _num: Number(((_e = item == null ? void 0 : item.metadata) == null ? void 0 : _e.num) ?? (product == null ? void 0 : product.num) ?? (product == null ? void 0 : product.product_quantity) ?? 1) || 1
+        };
+        discountMap.set(key, {
+          id: key,
+          product_name: "",
+          encoded: "",
+          code: "",
+          tag: type,
+          product_id: ((_f = item == null ? void 0 : item.discount) == null ? void 0 : _f.discount_product_id) ?? (product == null ? void 0 : product.product_id) ?? 0,
+          relation_type: "",
+          par_value: String(((_g = item == null ? void 0 : item.discount) == null ? void 0 : _g.original_amount) ?? (item == null ? void 0 : item.amount) ?? "0"),
+          used_par_value: String((item == null ? void 0 : item.amount) ?? "0"),
+          limit_status: "enable",
+          limited_relation_product_data: {
+            id: 0,
+            type: "products",
+            product_ids: [product == null ? void 0 : product.product_id].filter((value) => value !== void 0 && value !== null),
+            product_collection_id: [],
+            filter: 0,
+            exclude_product_ids: []
+          },
+          balance: String((item == null ? void 0 : item.amount) ?? "0"),
+          format_title: title,
+          product: {
+            id: (product == null ? void 0 : product.product_id) ?? 0,
+            title: "",
+            is_charge_tax: (product == null ? void 0 : product.is_charge_tax) ?? 0,
+            base_price: String((product == null ? void 0 : product.original_price) ?? (product == null ? void 0 : product.selling_price) ?? "0")
+          },
+          type,
+          resource_id: key,
+          isEditMode: true,
+          isSelected: true,
+          isAvailable: true,
+          isUsed: true,
+          isDisabled: true,
+          amount,
+          discount: {
+            ...(item == null ? void 0 : item.discount) || {},
+            resource_id: key,
+            discount_product_id: ((_h = item == null ? void 0 : item.discount) == null ? void 0 : _h.discount_product_id) ?? (product == null ? void 0 : product.product_id) ?? 0,
+            discount_calculation_mode: ((_i = item == null ? void 0 : item.discount) == null ? void 0 : _i.discount_calculation_mode) ?? "item_level"
+          },
+          applicableProductDetails: [detail],
+          appliedProductDetails: [detail]
+        });
+      }
+    }
+    return Array.from(discountMap.values());
   }
   /**
    * 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 +195,32 @@ 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;
+      if (isManualProductDiscountProduct(product))
+        return product;
+      const discountItems = Array.isArray(product.discount_list) ? product.discount_list : [];
+      const hasOnlyPersistedDiscountSnapshots = product.order_detail_id !== void 0 && product.order_detail_id !== null && discountItems.length > 0 && discountItems.every((discount) => (discount == null ? void 0 : discount.order_discount_id) !== void 0 && (discount == null ? void 0 : discount.order_discount_id) !== null);
+      if (hasOnlyPersistedDiscountSnapshots) {
+        return product;
+      }
+      const totalPerUnitDiscount = (0, import_utils.resolveEffectivePerUnitDiscount)(product);
+      const optionSum = (0, import_utils.sumOptionUnitPrice)((0, import_utils.getProductSkuOptions)(product));
+      const sourcePrice = ((_a = product.metadata) == null ? void 0 : _a.source_product_price) ?? (((_b = product.metadata) == null ? void 0 : _b.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;
@@ -92,18 +238,54 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
     const app = appPlugin.getApp();
     this.logger = app.logger;
-    this.dbManager = app.sqlite;
     this.window = this.core.getPlugin("window");
     const otherParams = options.otherParams || {};
     this.cacheId = otherParams.cacheId;
     this.salesSummaryModuleName = otherParams.salesSummaryModuleName;
     this.rulesHooksOverride = (_a = otherParams.rules) == null ? void 0 : _a.hooks;
-    this.orderHooks = options.hooks || ((_b = otherParams.order) == null ? void 0 : _b.hooks) || ((_c = otherParams.hooks) == null ? void 0 : _c.order);
+    this.moduleHooksOverride = options.hooks;
+    this.orderHooks = this.moduleHooksOverride || ((_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");
   }
+  async destroy() {
+    var _a, _b;
+    const childModules = [(_a = this.store) == null ? void 0 : _a.discount, (_b = this.store) == null ? void 0 : _b.rules];
+    for (const childModule of childModules) {
+      if (!childModule || typeof childModule.destroy !== "function")
+        continue;
+      try {
+        await childModule.destroy();
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        this.logWarning("Destroy child module failed", {
+          module: childModule.name,
+          error: errorMessage
+        });
+      }
+    }
+    if (this.store) {
+      this.store.discount = null;
+      this.store.rules = null;
+    }
+    super.destroy();
+  }
+  /**
+   * 更新父级解决方案透传的运行态参数，并同步 Order 内部依赖的派生字段。
+   *
+   * @example
+   * orderModule.updateOtherParams({ cacheId: 'cache-2', channel: 'pos' });
+   */
+  updateOtherParams(params) {
+    var _a, _b, _c;
+    const otherParams = params || {};
+    this.cacheId = otherParams.cacheId;
+    this.salesSummaryModuleName = otherParams.salesSummaryModuleName;
+    this.rulesHooksOverride = (_a = otherParams.rules) == null ? void 0 : _a.hooks;
+    this.orderHooks = this.moduleHooksOverride || ((_b = otherParams.order) == null ? void 0 : _b.hooks) || ((_c = otherParams.hooks) == null ? void 0 : _c.order);
+    this.otherParams = otherParams;
+  }
   /**
    * 记录信息日志
    */
@@ -174,26 +356,57 @@ 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, _g;
+    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);
+      const currentEditDiscounts = (((_c = this.store.discount) == null ? void 0 : _c.getDiscountList()) || []).filter((discount) => discount == null ? void 0 : discount.isEditMode);
+      const currentEditDiscountIds = new Set(
+        currentEditDiscounts.map((discount) => discount == null ? void 0 : discount.id)
+      );
+      const mergedDiscountList = [
+        ...currentEditDiscounts,
+        ...discountList.filter((discount) => !currentEditDiscountIds.has(discount == null ? void 0 : discount.id))
+      ];
+      await ((_d = this.store.discount) == null ? void 0 : _d.setOriginalDiscountList(mergedDiscountList));
+      await ((_e = this.store.discount) == null ? void 0 : _e.setDiscountList(mergedDiscountList));
     }
-    if ((_d = (_c = this.store.tempOrder) == null ? void 0 : _c.products) == null ? void 0 : _d.length) {
+    if (params.apply !== false && ((_g = (_f = this.store.tempOrder) == null ? void 0 : _f.products) == null ? void 0 : _g.length)) {
       this.applyDiscount();
     }
+    return this.getDiscountList();
   }
   getDiscountList() {
     var _a;
     return ((_a = this.store.discount) == null ? void 0 : _a.getDiscountList()) || [];
   }
+  async ensureEditDiscountConfigForProductChange(tempOrder) {
+    var _a, _b, _c, _d, _e, _f;
+    const orderId = tempOrder.order_id;
+    const customerId = Number(
+      tempOrder.customer_id || ((_a = tempOrder.customer) == null ? void 0 : _a.id) || ((_c = (_b = tempOrder._extend) == null ? void 0 : _b.customerSnapshot) == null ? void 0 : _c.id) || ((_e = (_d = tempOrder._extend) == null ? void 0 : _d.customerSnapshot) == null ? void 0 : _e.customer_id) || 0
+    );
+    if (!orderId || !customerId || customerId === 1)
+      return;
+    const currentDiscountList = ((_f = this.store.discount) == null ? void 0 : _f.getDiscountList()) || [];
+    const hasRuntimeDiscounts = currentDiscountList.some((discount) => !(discount == null ? void 0 : discount.isEditMode));
+    if (hasRuntimeDiscounts)
+      return;
+    await this.loadDiscountConfig({
+      customerId,
+      action: "edit",
+      orderId: Number(orderId),
+      apply: false
+    });
+  }
   async scanCode(code, customerId) {
     var _a, _b, _c, _d, _e;
     const resultDiscountWithReason = await ((_a = this.store.discount) == null ? void 0 : _a.batchSearch(code, { customerId })) || { discountList: [], unavailableReasonKey: null };
@@ -204,6 +417,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         type: "clientCalc",
         isAvailable: false,
         discountList: this.getDiscountList(),
+        scannedDiscountList: resultDiscountList,
         unavailableReason: import_types2.UnavailableReason.Unknown
       };
     }
@@ -212,6 +426,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         type: "server",
         isAvailable: false,
         discountList: this.getDiscountList(),
+        scannedDiscountList: resultDiscountList,
         unavailableReasonKey
       };
     }
@@ -224,7 +439,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 +461,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       type: "clientCalc",
       isAvailable: isAvailable || false,
       discountList: newDiscountList || this.getDiscountList(),
+      scannedDiscountList: resultDiscountList,
       unavailableReason
     };
   }
@@ -253,6 +470,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 +484,26 @@ 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}`);
+          if (isManualProductDiscountProduct(previous)) {
+            return previous;
+          }
+          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 +511,201 @@ 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() {
+    var _a;
+    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 _a2, _b;
+                  return ((_b = (_a2 = p.metadata) == null ? void 0 : _a2._giftInfo) == null ? void 0 : _b.strategyId) === addAction.strategyId;
+                }
+              );
+              if (sameStrategy && !sameStrategy.booking_uid && !((_a = sameStrategy.metadata) == null ? void 0 : _a.booking_uid)) {
+                sameStrategy.num = (Number(sameStrategy.num) || 0) + (addAction.giftCount || 1);
+                continue;
+              }
+            }
+            try {
+              const giftResult = await this.giftSelectResolver({
+                strategyId: addAction.strategyId,
+                strategyName: addAction.strategyName,
+                giftCount: addAction.giftCount,
+                giftOptions: addAction.giftOptions,
+                sourceProductIds: addAction.sourceProductIds
+              });
+              const giftProducts = Array.isArray(giftResult) ? giftResult : giftResult == null ? void 0 : giftResult.products;
+              const giftBookings = Array.isArray(giftResult) ? [] : (giftResult == null ? void 0 : giftResult.bookings) || [];
+              if (Array.isArray(giftProducts) && giftProducts.length > 0) {
+                for (const [index, gp] of giftProducts.entries()) {
+                  if (!gp)
+                    continue;
+                  const booking = giftBookings[index];
+                  if (booking) {
+                    const linked = this.createLinkedProductAndBooking({
+                      product: gp,
+                      booking
+                    });
+                    result.products.push(linked.product);
+                    tempOrder.bookings = [...tempOrder.bookings || [], linked.booking];
+                    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,107 +749,18 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
     return tempOrder.request_unique_idempotency_token;
   }
-  hasLocalDatabase() {
-    return !!this.dbManager;
-  }
-  buildLocalOrderRecord(tempOrder) {
-    const externalSaleNumber = this.ensureExternalSaleNumber(tempOrder);
-    return {
-      ...tempOrder,
-      id: tempOrder.order_id ?? externalSaleNumber,
-      external_sale_number: externalSaleNumber,
-      summary: this.store.summary || (0, import_utils.createEmptySummary)(),
-      lastOrderInfo: this.store.lastOrderInfo
-    };
-  }
-  async getLocalOrderByOrderId(orderId) {
-    var _a, _b, _c, _d;
-    if (!this.dbManager || orderId === void 0 || orderId === null)
-      return null;
-    try {
-      const direct = await ((_b = (_a = this.dbManager).get) == null ? void 0 : _b.call(
-        _a,
-        LOCAL_ORDER_STORE_NAME,
-        orderId
-      ));
-      if (direct)
-        return direct;
-      const orders = await ((_d = (_c = this.dbManager).getAll) == null ? void 0 : _d.call(_c, LOCAL_ORDER_STORE_NAME));
-      return (orders || []).find(
-        (order) => String(order == null ? void 0 : order.order_id) === String(orderId)
-      ) || null;
-    } catch (error) {
-      this.logWarning("getLocalOrderByOrderId failed", {
-        orderId,
-        error: error instanceof Error ? error.message : String(error)
-      });
-      return null;
-    }
-  }
-  async getLocalOrderByOrderNumber(orderNumber) {
-    var _a, _b, _c, _d;
-    if (!this.dbManager || !orderNumber)
-      return null;
-    try {
-      const direct = await ((_b = (_a = this.dbManager).get) == null ? void 0 : _b.call(
-        _a,
-        LOCAL_ORDER_STORE_NAME,
-        orderNumber
-      ));
-      if (direct)
-        return direct;
-      const orders = await ((_d = (_c = this.dbManager).getAll) == null ? void 0 : _d.call(_c, LOCAL_ORDER_STORE_NAME));
-      return (orders || []).find(
-        (order) => String(order == null ? void 0 : order.order_number) === String(orderNumber)
-      ) || null;
-    } catch (error) {
-      this.logWarning("getLocalOrderByOrderNumber failed", {
-        orderNumber,
-        error: error instanceof Error ? error.message : String(error)
-      });
-      return null;
-    }
-  }
-  async getLocalOrderByExternalSaleNumber(externalSaleNumber) {
-    var _a, _b, _c, _d;
-    if (!this.dbManager || !externalSaleNumber)
-      return null;
-    try {
-      const direct = await ((_b = (_a = this.dbManager).get) == null ? void 0 : _b.call(
-        _a,
-        LOCAL_ORDER_STORE_NAME,
-        externalSaleNumber
-      ));
-      if (direct)
-        return direct;
-      const orders = await ((_d = (_c = this.dbManager).getAll) == null ? void 0 : _d.call(_c, LOCAL_ORDER_STORE_NAME));
-      return (orders || []).find(
-        (order) => String(order == null ? void 0 : order.external_sale_number) === String(externalSaleNumber)
-      ) || null;
-    } catch (error) {
-      this.logWarning("getLocalOrderByExternalSaleNumber failed", {
-        externalSaleNumber,
-        error: error instanceof Error ? error.message : String(error)
-      });
-      return null;
-    }
+  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}`;
   }
   async saveDraft() {
-    var _a, _b;
-    if (!this.dbManager)
-      return;
-    const tempOrder = this.ensureTempOrder();
-    const record = this.buildLocalOrderRecord(tempOrder);
-    try {
-      await ((_b = (_a = this.dbManager).update) == null ? void 0 : _b.call(_a, LOCAL_ORDER_STORE_NAME, record));
-    } catch (error) {
-      this.logWarning("saveDraft failed", {
-        externalSaleNumber: tempOrder.external_sale_number,
-        orderNumber: tempOrder.order_number,
-        orderId: tempOrder.order_id,
-        error: error instanceof Error ? error.message : String(error)
-      });
-    }
+  }
+  saveDraftInBackground() {
+    void this.saveDraft();
   }
   async hydrateTempOrderFromLocalRecord(record) {
     return this.hydrateTempOrderFromRecord(record);
@@ -500,15 +769,208 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     var _a, _b;
     return ((_a = result == null ? void 0 : result.data) == null ? void 0 : _a.order_id) ?? (result == null ? void 0 : result.order_id) ?? ((_b = result == null ? void 0 : result.data) == null ? void 0 : _b.id) ?? (result == null ? void 0 : result.id) ?? null;
   }
+  calculatePaymentEffectiveAmount(payment) {
+    const amount = new import_decimal.default(payment.amount || 0).minus(new import_decimal.default(payment.service_fee || 0));
+    const rounding = new import_decimal.default(payment.rounding_amount || 0);
+    return amount.minus(rounding);
+  }
   calculatePaymentTotal(payments) {
     return (0, import_utils.mapPaymentItemsToOrderPayments)(payments, {
       includeVoided: false
     }).reduce((sum, payment) => {
-      const amount = new import_decimal.default(payment.amount || 0);
-      const rounding = new import_decimal.default(payment.rounding_amount || 0);
-      return sum.plus(amount.minus(rounding));
+      return sum.plus(this.calculatePaymentEffectiveAmount(payment));
+    }, new import_decimal.default(0));
+  }
+  getDepositAmount(tempOrder, summary) {
+    return new import_decimal.default(summary.deposit_amount || tempOrder.deposit_amount || "0.00");
+  }
+  normalizeDepositAmount(amount) {
+    return import_decimal.default.max(new import_decimal.default(Number(amount) || 0), 0).toDecimalPlaces(2).toFixed(2);
+  }
+  applyDepositAmountToSummary(tempOrder, summary, amount) {
+    const depositAmount = this.normalizeDepositAmount(amount);
+    const hasDepositAmount = new import_decimal.default(depositAmount).gt(0);
+    const existedDeposit = summary.deposit && typeof summary.deposit === "object" ? summary.deposit : void 0;
+    const nextSummary = {
+      ...summary,
+      deposit_amount: depositAmount,
+      deposit: hasDepositAmount ? {
+        ...existedDeposit || {},
+        total: depositAmount,
+        deposit_policy_ids: (existedDeposit == null ? void 0 : existedDeposit.deposit_policy_ids) || [],
+        hasDeposit: true
+      } : void 0
+    };
+    tempOrder.deposit_amount = depositAmount;
+    tempOrder.is_deposit = hasDepositAmount ? 1 : 0;
+    return nextSummary;
+  }
+  isDepositOrder(tempOrder, depositAmount) {
+    return tempOrder.is_deposit === 1 || depositAmount.gt(0);
+  }
+  getOrderExpectedAmount(summary) {
+    return new import_decimal.default(summary.expect_amount || summary.total_amount || 0);
+  }
+  isDepositCovered(params) {
+    const depositAmount = this.getDepositAmount(params.tempOrder, params.summary);
+    if (!this.isDepositOrder(params.tempOrder, depositAmount))
+      return false;
+    if (depositAmount.lte(0))
+      return false;
+    return params.paidAmount.gte(depositAmount);
+  }
+  calculateDepositPaidAmount(payments) {
+    return (payments || []).reduce((sum, payment) => {
+      const paymentRecord = payment;
+      if ((paymentRecord == null ? void 0 : paymentRecord.status) !== "paid")
+        return sum;
+      const isDepositPayment = paymentRecord.type === "deposit" || paymentRecord.order_payment_type === "deposit";
+      if (!isDepositPayment)
+        return sum;
+      if (paymentRecord.origin_amount !== void 0 && paymentRecord.origin_amount !== null && paymentRecord.origin_amount !== "") {
+        return sum.plus(this.calculatePaymentGapAmount(paymentRecord));
+      }
+      const rounding = new import_decimal.default(paymentRecord.rounding_amount || 0);
+      return sum.plus(new import_decimal.default(paymentRecord.amount || 0).minus(rounding));
     }, new import_decimal.default(0));
   }
+  resolveNextOrderPaymentType(tempOrder) {
+    const depositAmount = new import_decimal.default(tempOrder.deposit_amount || "0.00");
+    if (!this.isDepositOrder(tempOrder, depositAmount))
+      return "normal";
+    if (depositAmount.lte(0))
+      return "normal";
+    const depositPaidAmount = this.calculateDepositPaidAmount(tempOrder.payments || []);
+    return depositPaidAmount.lt(depositAmount) ? "deposit" : "normal";
+  }
+  normalizePaymentSource(payment, options) {
+    const paymentRecord = payment;
+    const metadata = paymentRecord.metadata && typeof paymentRecord.metadata === "object" ? { ...paymentRecord.metadata } : {};
+    if (!metadata.unique_payment_number) {
+      metadata.unique_payment_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, options) {
+    const summary = (options == null ? void 0 : options.summary) || this.store.summary || (0, import_utils.createEmptySummary)();
+    const paymentTotal = this.calculatePaymentTotal(tempOrder.payments || []);
+    const refundAmount = this.getSummaryRefundAmount(summary);
+    const netPaymentTotal = import_decimal.default.max(paymentTotal.minus(refundAmount), 0);
+    const targetAmount = this.calculatePaymentTargetAmount(
+      tempOrder,
+      summary,
+      netPaymentTotal
+    );
+    if (this.shouldKeepPaymentStatusAfterAmountRecalc(tempOrder.payment_status, {
+      netPaymentTotal,
+      paymentTotal,
+      refundAmount,
+      targetAmount,
+      previousSummary: options == null ? void 0 : options.previousSummary,
+      tempOrder
+    })) {
+      return;
+    }
+    if (targetAmount.lte(0)) {
+      tempOrder.payment_status = "paid";
+      return;
+    }
+    if (netPaymentTotal.lte(0)) {
+      tempOrder.payment_status = "payment_processing";
+      return;
+    }
+    tempOrder.payment_status = netPaymentTotal.gte(targetAmount) ? "paid" : "partially_paid";
+  }
+  shouldKeepPaymentStatusAfterAmountRecalc(paymentStatus, params) {
+    const normalizedStatus = String(paymentStatus || "").trim().toLowerCase();
+    if (normalizedStatus !== "refunded" && normalizedStatus !== "partially_refunded") {
+      return false;
+    }
+    if (params.refundAmount.lte(0))
+      return false;
+    if (params.previousSummary) {
+      const previousTargetAmount = this.calculatePaymentTargetAmount(
+        params.tempOrder,
+        params.previousSummary,
+        params.netPaymentTotal
+      );
+      if (!previousTargetAmount.eq(params.targetAmount))
+        return false;
+    }
+    if (normalizedStatus === "refunded") {
+      return params.refundAmount.gte(params.paymentTotal);
+    }
+    return params.netPaymentTotal.gte(params.targetAmount);
+  }
+  resolveWalletPassUseValue(payment, amount) {
+    const usageUnit = payment.wallet_pass_usage_unit && typeof payment.wallet_pass_usage_unit === "object" ? payment.wallet_pass_usage_unit : null;
+    if (!usageUnit)
+      return payment.wallet_pass_use_value;
+    const price = new import_decimal.default(usageUnit.price || 0);
+    const points = new import_decimal.default(usageUnit.points || 0);
+    if (price.lte(0) || points.lte(0))
+      return payment.wallet_pass_use_value;
+    return amount.div(price).times(points).toDecimalPlaces(2).toFixed(2);
+  }
+  adjustVoucherFundRecord(params) {
+    var _a;
+    const fundRecord = params.voucher.fund_record && typeof params.voucher.fund_record === "object" && !Array.isArray(params.voucher.fund_record) ? { ...params.voucher.fund_record } : null;
+    if (!fundRecord || fundRecord.using_before_value === void 0 || fundRecord.using_before_value === null) {
+      return fundRecord || void 0;
+    }
+    const code = String(params.voucher.code || "").toUpperCase();
+    const isPointCard = code === "POINTCARD" || String(((_a = params.voucher.fund_record) == null ? void 0 : _a.tag) || "").toLowerCase() === "point_card";
+    const usingValue = isPointCard ? new import_decimal.default(params.walletPassUseValue || 0) : params.amount;
+    fundRecord.using_after_value = new import_decimal.default(fundRecord.using_before_value || 0).minus(usingValue).toDecimalPlaces(2).toFixed(2);
+    return fundRecord;
+  }
+  capVoucherPaymentsByRemainingAmount(params) {
+    const targetAmount = this.getPaymentTargetAmount();
+    const nonVoucherTotal = this.calculatePaymentTotal(params.nonVoucherPayments);
+    if (targetAmount.lte(0))
+      return [];
+    let remainingAmount = import_decimal.default.max(
+      targetAmount.minus(nonVoucherTotal),
+      0
+    );
+    const cappedVouchers = [];
+    for (const voucher of params.vouchers) {
+      if (remainingAmount.lte(0))
+        break;
+      const voucherAmount = import_decimal.default.max(new import_decimal.default(voucher.amount || 0), 0);
+      if (voucherAmount.lte(0))
+        continue;
+      const cappedAmount = import_decimal.default.min(voucherAmount, remainingAmount);
+      const amountText = cappedAmount.toDecimalPlaces(2).toFixed(2);
+      const walletPassUseValue = this.resolveWalletPassUseValue(
+        voucher,
+        cappedAmount
+      );
+      cappedVouchers.push({
+        ...voucher,
+        amount: amountText,
+        origin_amount: amountText,
+        wallet_pass_use_value: walletPassUseValue,
+        fund_record: this.adjustVoucherFundRecord({
+          voucher,
+          amount: cappedAmount,
+          walletPassUseValue
+        })
+      });
+      remainingAmount = remainingAmount.minus(cappedAmount);
+    }
+    return cappedVouchers;
+  }
   calculatePaidPaymentSummary(payments) {
     return (payments || []).reduce(
       (summary, payment) => {
@@ -518,13 +980,17 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         return {
           customerPaidAmount: summary.customerPaidAmount.plus(paymentRecord.amount || 0),
           orderPaidAmount: summary.orderPaidAmount.plus(paymentRecord.origin_amount || 0),
-          payServiceChargeAmount: summary.payServiceChargeAmount.plus(this.calculatePaymentServiceFee(paymentRecord))
+          gapPaidAmount: summary.gapPaidAmount.plus(this.calculatePaymentGapAmount(paymentRecord)),
+          payServiceChargeAmount: summary.payServiceChargeAmount.plus(this.calculatePaymentServiceFee(paymentRecord)),
+          roundingAmount: summary.roundingAmount.plus(this.calculatePaymentRoundingAmount(paymentRecord))
         };
       },
       {
         customerPaidAmount: new import_decimal.default(0),
         orderPaidAmount: new import_decimal.default(0),
-        payServiceChargeAmount: new import_decimal.default(0)
+        gapPaidAmount: new import_decimal.default(0),
+        payServiceChargeAmount: new import_decimal.default(0),
+        roundingAmount: new import_decimal.default(0)
       }
     );
   }
@@ -537,15 +1003,390 @@ 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);
   }
+  calculatePaymentGapAmount(payment) {
+    if (payment.origin_amount === void 0 || payment.origin_amount === null || payment.origin_amount === "") {
+      return new import_decimal.default(0);
+    }
+    const rounding = new import_decimal.default(payment.rounding_amount || 0);
+    return new import_decimal.default(payment.origin_amount || 0).minus(rounding);
+  }
+  calculatePaymentRoundingAmount(payment) {
+    if (payment.rounding_amount === void 0 || payment.rounding_amount === null || payment.rounding_amount === "") {
+      return new import_decimal.default(0);
+    }
+    return new import_decimal.default(payment.rounding_amount || 0);
+  }
+  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"
+    ];
+    const metadataMoneyKeys = [
+      "main_product_attached_bundle_selling_price",
+      "main_product_attached_bundle_payment_price"
+    ];
+    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;
+      }
+      for (const key of metadataMoneyKeys) {
+        const value = this.formatSummaryMetadataMoney(metadata[key]);
+        if (value === void 0)
+          continue;
+        metadata[key] = value;
+        hasMetadataPatch = true;
+      }
+      if (metadata.average_discount_amount_rate !== void 0) {
+        hasMetadataPatch = true;
+      }
+      if (Array.isArray(productRecord.relation_surcharge_ids)) {
+        metadata.relation_surcharge_ids = productRecord.relation_surcharge_ids;
+        hasMetadataPatch = true;
+      }
+      const productPaymentPrice = this.formatSummaryMetadataMoney(
+        productRecord.payment_price
+      );
+      if (productPaymentPrice !== void 0) {
+        productRecord.payment_price = productPaymentPrice;
+      }
+      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;
+        }
+        const bundlePaymentPrice = this.formatSummaryMetadataMoney(
+          bundleRecord.bundle_payment_price
+        );
+        if (bundlePaymentPrice !== void 0) {
+          bundleRecord.bundle_payment_price = bundlePaymentPrice;
+        }
+        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 refundAmount = this.getSummaryRefundAmount(summary);
+    const netOrderPaidAmount = import_decimal.default.max(orderPaidAmount.minus(refundAmount), 0);
+    const targetAmount = this.calculatePaymentTargetAmount(
+      tempOrder,
+      summary,
+      netOrderPaidAmount
+    );
+    return targetAmount.minus(netOrderPaidAmount).toFixed(2);
+  }
+  getSummaryRefundAmount(summary) {
+    return import_decimal.default.max(new import_decimal.default((summary == null ? void 0 : summary.total_refund_amount) || 0), 0);
+  }
+  calculatePaymentTargetAmount(tempOrder, summary, paidAmount = new import_decimal.default(0)) {
+    const depositAmount = this.getDepositAmount(tempOrder, summary);
+    if (!this.isDepositOrder(tempOrder, depositAmount)) {
+      return this.getOrderExpectedAmount(summary);
+    }
+    if (this.isDepositCovered({ tempOrder, summary, paidAmount })) {
+      return this.getOrderExpectedAmount(summary);
+    }
+    return depositAmount;
+  }
+  normalizeFingerprintMoney(value) {
+    if (value === void 0 || value === null || value === "")
+      return "";
+    try {
+      const parsed = new import_decimal.default(String(value || 0));
+      return parsed.toFixed(4);
+    } catch {
+      return String(value);
+    }
+  }
+  normalizeFingerprintValue(value) {
+    if (Array.isArray(value)) {
+      return value.map((item) => this.normalizeFingerprintValue(item));
+    }
+    if (!value || typeof value !== "object")
+      return value ?? "";
+    return Object.keys(value).sort().reduce((result, key) => {
+      result[key] = this.normalizeFingerprintValue(value[key]);
+      return result;
+    }, {});
+  }
+  buildProductFingerprintItem(product) {
+    const sku = (product == null ? void 0 : product.product_sku) || {};
+    const metadata = (product == null ? void 0 : product.metadata) || {};
+    const discountTypes = ((product == null ? void 0 : product.discount_list) || []).map((discount) => (discount == null ? void 0 : discount.type) ?? (discount == null ? void 0 : discount.tag));
+    const extensionType = (product == null ? void 0 : product.extension_type) || (discountTypes.includes("good_pass") ? "good_pass" : "normal");
+    return {
+      product_id: (product == null ? void 0 : product.product_id) ?? null,
+      product_variant_id: (product == null ? void 0 : product.product_variant_id) ?? null,
+      extension_type: extensionType,
+      num: (0, import_utils3.getSafeProductNum)((product == null ? void 0 : product.num) ?? (product == null ? void 0 : product.product_quantity)),
+      selling_price: this.normalizeFingerprintMoney(product == null ? void 0 : product.selling_price),
+      original_price: this.normalizeFingerprintMoney(product == null ? void 0 : product.original_price),
+      payment_price: this.normalizeFingerprintMoney((product == null ? void 0 : product.payment_price) ?? (product == null ? void 0 : product.selling_price)),
+      metadata: {
+        source_product_price: this.normalizeFingerprintMoney(metadata.source_product_price),
+        main_product_selling_price: this.normalizeFingerprintMoney(metadata.main_product_selling_price),
+        main_product_original_price: this.normalizeFingerprintMoney(metadata.main_product_original_price),
+        product_discount_difference: this.normalizeFingerprintMoney(metadata.product_discount_difference)
+      },
+      product_sku: this.normalizeFingerprintValue({
+        code: sku.code ?? "",
+        barcode: sku.barcode ?? "",
+        variant_id: sku.variant_id ?? (product == null ? void 0 : product.product_variant_id) ?? 0,
+        variant: sku.variant || [],
+        option: (0, import_utils.getProductSkuOptions)(product || {}).map((option) => ({
+          id: (option == null ? void 0 : option.id) ?? (option == null ? void 0 : option.option_group_item_id) ?? null,
+          option_group_id: (option == null ? void 0 : option.option_group_id) ?? null,
+          option_group_item_id: (option == null ? void 0 : option.option_group_item_id) ?? (option == null ? void 0 : option.id) ?? null,
+          num: Number((option == null ? void 0 : option.num) ?? 1) || 1,
+          add_price: this.normalizeFingerprintMoney((option == null ? void 0 : option.add_price) ?? (option == null ? void 0 : option.price))
+        }))
+      }),
+      product_bundle: this.normalizeFingerprintValue(((product == null ? void 0 : product.product_bundle) || []).map((bundle) => ({
+        bundle_product_id: (bundle == null ? void 0 : bundle.bundle_product_id) ?? (bundle == null ? void 0 : bundle._bundle_product_id) ?? (bundle == null ? void 0 : bundle.product_id) ?? null,
+        bundle_variant_id: (bundle == null ? void 0 : bundle.bundle_variant_id) ?? (bundle == null ? void 0 : bundle.product_variant_id) ?? 0,
+        num: (0, import_utils3.getSafeProductNum)((bundle == null ? void 0 : bundle.num) ?? (bundle == null ? void 0 : bundle.quantity)),
+        price: this.normalizeFingerprintMoney(bundle == null ? void 0 : bundle.price),
+        bundle_selling_price: this.normalizeFingerprintMoney(bundle == null ? void 0 : bundle.bundle_selling_price),
+        price_type: (bundle == null ? void 0 : bundle.price_type) ?? "",
+        price_type_ext: (bundle == null ? void 0 : bundle.price_type_ext) ?? ""
+      }))),
+      discount_list: this.normalizeFingerprintValue(((product == null ? void 0 : product.discount_list) || []).map((discount) => {
+        var _a;
+        return {
+          type: (discount == null ? void 0 : discount.type) ?? (discount == null ? void 0 : discount.tag) ?? "",
+          discount_id: (discount == null ? void 0 : discount.discount_id) ?? (discount == null ? void 0 : discount.order_discount_id) ?? ((_a = discount == null ? void 0 : discount.discount) == null ? void 0 : _a.resource_id) ?? null,
+          amount: this.normalizeFingerprintMoney(discount == null ? void 0 : discount.amount)
+        };
+      }))
+    };
+  }
+  buildOrderProductsFingerprint(products) {
+    const items = (products || []).map((product) => this.buildProductFingerprintItem(product));
+    items.sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right)));
+    return JSON.stringify(items);
+  }
+  buildProductStructuralFingerprintItem(product) {
+    const sku = (product == null ? void 0 : product.product_sku) || {};
+    const metadata = (product == null ? void 0 : product.metadata) || {};
+    const discountTypes = ((product == null ? void 0 : product.discount_list) || []).map((discount) => (discount == null ? void 0 : discount.type) ?? (discount == null ? void 0 : discount.tag));
+    const extensionType = (product == null ? void 0 : product.extension_type) || (discountTypes.includes("good_pass") ? "good_pass" : "normal");
+    return {
+      product_id: (product == null ? void 0 : product.product_id) ?? null,
+      product_variant_id: (product == null ? void 0 : product.product_variant_id) ?? null,
+      extension_type: extensionType,
+      num: (0, import_utils3.getSafeProductNum)((product == null ? void 0 : product.num) ?? (product == null ? void 0 : product.product_quantity)),
+      metadata: {
+        unique_identification_number: metadata.unique_identification_number ?? (product == null ? void 0 : product.unique_identification_number) ?? "",
+        price_override: metadata.price_override ?? "",
+        is_manual_discount: metadata.is_manual_discount ?? "",
+        product_discount_reason: metadata.product_discount_reason ?? ""
+      },
+      product_sku: this.normalizeFingerprintValue({
+        code: sku.code ?? "",
+        barcode: sku.barcode ?? "",
+        variant_id: sku.variant_id ?? (product == null ? void 0 : product.product_variant_id) ?? 0,
+        variant: sku.variant || [],
+        option: (0, import_utils.getProductSkuOptions)(product || {}).map((option) => ({
+          id: (option == null ? void 0 : option.id) ?? (option == null ? void 0 : option.option_group_item_id) ?? null,
+          option_group_id: (option == null ? void 0 : option.option_group_id) ?? null,
+          option_group_item_id: (option == null ? void 0 : option.option_group_item_id) ?? (option == null ? void 0 : option.id) ?? null,
+          num: Number((option == null ? void 0 : option.num) ?? 1) || 1,
+          add_price: this.normalizeFingerprintMoney((option == null ? void 0 : option.add_price) ?? (option == null ? void 0 : option.price))
+        }))
+      }),
+      product_bundle: this.normalizeFingerprintValue(((product == null ? void 0 : product.product_bundle) || []).map((bundle) => ({
+        bundle_id: (bundle == null ? void 0 : bundle.bundle_id) ?? (bundle == null ? void 0 : bundle.id) ?? null,
+        bundle_group_id: (bundle == null ? void 0 : bundle.bundle_group_id) ?? (bundle == null ? void 0 : bundle.group_id) ?? null,
+        bundle_product_id: (bundle == null ? void 0 : bundle.bundle_product_id) ?? (bundle == null ? void 0 : bundle._bundle_product_id) ?? (bundle == null ? void 0 : bundle.product_id) ?? null,
+        bundle_variant_id: (bundle == null ? void 0 : bundle.bundle_variant_id) ?? (bundle == null ? void 0 : bundle.product_variant_id) ?? 0,
+        num: (0, import_utils3.getSafeProductNum)((bundle == null ? void 0 : bundle.num) ?? (bundle == null ? void 0 : bundle.quantity)),
+        price_type: (bundle == null ? void 0 : bundle.price_type) ?? "",
+        price_type_ext: (bundle == null ? void 0 : bundle.price_type_ext) ?? "",
+        option: this.normalizeFingerprintValue(((bundle == null ? void 0 : bundle.option) || []).map((option) => ({
+          id: (option == null ? void 0 : option.id) ?? (option == null ? void 0 : option.option_group_item_id) ?? null,
+          option_group_id: (option == null ? void 0 : option.option_group_id) ?? null,
+          option_group_item_id: (option == null ? void 0 : option.option_group_item_id) ?? (option == null ? void 0 : option.id) ?? null,
+          num: Number((option == null ? void 0 : option.num) ?? 1) || 1,
+          add_price: this.normalizeFingerprintMoney((option == null ? void 0 : option.add_price) ?? (option == null ? void 0 : option.price))
+        })))
+      }))),
+      discount_list: this.normalizeFingerprintValue(((product == null ? void 0 : product.discount_list) || []).map((discount) => {
+        var _a;
+        return {
+          type: (discount == null ? void 0 : discount.type) ?? (discount == null ? void 0 : discount.tag) ?? "",
+          discount_id: (discount == null ? void 0 : discount.discount_id) ?? (discount == null ? void 0 : discount.order_discount_id) ?? ((_a = discount == null ? void 0 : discount.discount) == null ? void 0 : _a.resource_id) ?? null,
+          amount: this.normalizeFingerprintMoney(discount == null ? void 0 : discount.amount)
+        };
+      }))
+    };
+  }
+  buildOrderProductsStructuralFingerprint(products) {
+    const items = (products || []).map((product) => this.buildProductStructuralFingerprintItem(product));
+    items.sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right)));
+    return JSON.stringify(items);
+  }
+  getManualDepositOverride(tempOrder) {
+    var _a;
+    const override = (_a = tempOrder._extend) == null ? void 0 : _a.manualDepositOverride;
+    if (!override || typeof override !== "object")
+      return null;
+    if (typeof override.amount !== "string")
+      return null;
+    if (typeof override.productStructuralFingerprint !== "string")
+      return null;
+    return override;
+  }
+  setManualDepositOverride(tempOrder, amount) {
+    tempOrder._extend = {
+      ...tempOrder._extend || {},
+      manualDepositOverride: {
+        amount,
+        productStructuralFingerprint: this.buildOrderProductsStructuralFingerprint(tempOrder.products)
+      }
+    };
+  }
+  clearManualDepositOverride(tempOrder) {
+    var _a;
+    if (!((_a = tempOrder._extend) == null ? void 0 : _a.manualDepositOverride))
+      return;
+    tempOrder._extend = { ...tempOrder._extend };
+    delete tempOrder._extend.manualDepositOverride;
+  }
+  getOriginalSalesSnapshot(tempOrder) {
+    var _a;
+    const snapshot = (_a = tempOrder._extend) == null ? void 0 : _a.originalSalesSnapshot;
+    if (!snapshot || typeof snapshot !== "object")
+      return null;
+    if (typeof snapshot.productFingerprint !== "string")
+      return null;
+    return snapshot;
+  }
+  isSnapshotPayableAmountUnchanged(tempOrder, snapshot, snapshotSummary) {
+    const currentPaidPaymentSummary = this.calculatePaidPaymentSummary(tempOrder.payments || []);
+    const currentAmountGap = this.calculateSummaryAmountGap({
+      tempOrder,
+      summary: snapshotSummary,
+      orderPaidAmount: currentPaidPaymentSummary.gapPaidAmount
+    });
+    const snapshotPaidPaymentSummary = this.calculatePaidPaymentSummary(
+      Array.isArray(snapshot.payments) ? snapshot.payments : []
+    );
+    const snapshotAmountGap = this.calculateSummaryAmountGap({
+      tempOrder,
+      summary: snapshotSummary,
+      orderPaidAmount: snapshotPaidPaymentSummary.gapPaidAmount
+    });
+    return currentAmountGap === snapshotAmountGap;
+  }
+  restoreOriginalSnapshotIfProductsUnchanged(tempOrder) {
+    const snapshot = this.getOriginalSalesSnapshot(tempOrder);
+    if (!snapshot)
+      return null;
+    const currentFingerprint = this.buildOrderProductsFingerprint(tempOrder.products);
+    if (currentFingerprint !== snapshot.productFingerprint) {
+      const currentStructuralFingerprint = this.buildOrderProductsStructuralFingerprint(tempOrder.products);
+      const snapshotStructuralFingerprint = this.buildOrderProductsStructuralFingerprint(
+        Array.isArray(snapshot.products) ? snapshot.products : []
+      );
+      if (currentStructuralFingerprint !== snapshotStructuralFingerprint)
+        return null;
+    }
+    const summary = {
+      ...(0, import_utils.createEmptySummary)(),
+      ...(0, import_lodash_es.cloneDeep)(snapshot.summary || {})
+    };
+    if (!this.isSnapshotPayableAmountUnchanged(tempOrder, snapshot, summary))
+      return null;
+    if (Array.isArray(snapshot.products)) {
+      tempOrder.products = (0, import_lodash_es.cloneDeep)(snapshot.products);
+    }
+    if (Array.isArray(snapshot.surcharges)) {
+      tempOrder.surcharges = (0, import_lodash_es.cloneDeep)(snapshot.surcharges);
+    }
+    tempOrder.surcharge_fee = summary.surcharge_fee || tempOrder.surcharge_fee;
+    tempOrder.deposit_amount = summary.deposit_amount || "0.00";
+    tempOrder.is_deposit = summary.deposit_amount !== "0.00" ? 1 : 0;
+    this.store.summary = summary;
+    return summary;
+  }
+  clearPersistedAmountFieldsForFullRecalc(products) {
+    const moneyKeys = [
+      "surcharge_fee",
+      "main_product_attached_bundle_surcharge_fee",
+      "surcharge_rounding_remainder",
+      "main_product_attached_bundle_tax_fee",
+      "tax_fee",
+      "original_tax_fee",
+      "tax_fee_rounding_remainder",
+      "original_tax_fee_rounding_remainder"
+    ];
+    const metadataMoneyKeys = [
+      "main_product_attached_bundle_surcharge_fee",
+      "surcharge_rounding_remainder",
+      "main_product_attached_bundle_tax_fee",
+      "tax_fee_rounding_remainder"
+    ];
+    for (const product of products || []) {
+      const record = product;
+      for (const key of moneyKeys)
+        delete record[key];
+      if (record.metadata && typeof record.metadata === "object") {
+        record.metadata = { ...record.metadata };
+        for (const key of metadataMoneyKeys)
+          delete record.metadata[key];
+      }
+      for (const bundle of record.product_bundle || []) {
+        for (const key of moneyKeys)
+          delete bundle[key];
+        if (bundle.metadata && typeof bundle.metadata === "object") {
+          bundle.metadata = { ...bundle.metadata };
+          for (const key of metadataMoneyKeys)
+            delete bundle.metadata[key];
+        }
+      }
+    }
+  }
   getPaymentTargetAmount() {
     const tempOrder = this.ensureTempOrder();
     const summary = this.store.summary || (0, import_utils.createEmptySummary)();
-    if (tempOrder.is_deposit === 1) {
-      return new import_decimal.default(
-        tempOrder.deposit_amount || summary.deposit_amount || 0
-      );
-    }
-    return new import_decimal.default(summary.total_amount || summary.expect_amount || 0);
+    const paidPaymentSummary = this.calculatePaidPaymentSummary(tempOrder.payments || []);
+    const refundAmount = this.getSummaryRefundAmount(summary);
+    const netPaidAmount = import_decimal.default.max(
+      paidPaymentSummary.gapPaidAmount.minus(refundAmount),
+      0
+    );
+    return this.calculatePaymentTargetAmount(tempOrder, summary, netPaidAmount);
   }
   ensureTempOrder() {
     if (this.store.tempOrder) {
@@ -559,17 +1400,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;
@@ -605,9 +1472,12 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return null;
     const summary = this.store.summary || (0, import_utils.createEmptySummary)();
     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 paidPaymentSummary = this.calculatePaidPaymentSummary(tempOrder.payments || []);
+    const amountGap = this.calculateSummaryAmountGap({
+      tempOrder,
+      summary,
+      orderPaidAmount: paidPaymentSummary.gapPaidAmount
+    });
     return {
       isDeposit: tempOrder.is_deposit === 1 || depositAmount !== "0.00",
       depositAmount,
@@ -650,7 +1520,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() {
@@ -664,6 +1536,17 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     product.metadata = metadata;
     return String(uid);
   }
+  sanitizeOrderProductForTempOrder(product) {
+    if (product.metadata && typeof product.metadata === "object") {
+      delete product.metadata.origin;
+    }
+    return product;
+  }
+  sanitizeTempOrderProducts(tempOrder) {
+    tempOrder.products = (tempOrder.products || []).map(
+      (product) => this.sanitizeOrderProductForTempOrder(product)
+    );
+  }
   ensureExtend(tempOrder) {
     if (!tempOrder._extend || typeof tempOrder._extend !== "object") {
       tempOrder._extend = { productsByUid: {} };
@@ -697,6 +1580,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     );
     productMetadata.unique_identification_number = productUid;
     bookingMetadata.unique_identification_number = bookingUid;
+    this.syncBookingMetadataHolder(params.booking, bookingMetadata);
     return {
       productUid,
       bookingUid,
@@ -718,44 +1602,266 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       }
     };
   }
+  /**
+   * booking.holder 是提交真源；metadata.holder 作为详情/回显冗余字段同步保存。
+   *
+   * @example
+   * this.syncBookingMetadataHolder(booking, metadata);
+   */
+  syncBookingMetadataHolder(booking, metadata) {
+    if ((booking == null ? void 0 : booking.holder) !== void 0) {
+      metadata.holder = booking.holder;
+    }
+  }
+  /**
+   * 从单条 booking 的 holder / metadata 中收集 holder form_record。
+   *
+   * @example
+   * const ids = this.collectBookingHolderRecords(booking);
+   */
+  collectBookingHolderRecords(booking) {
+    var _a;
+    const holder = (booking == null ? void 0 : booking.holder) && typeof booking.holder === "object" ? booking.holder : null;
+    const source = (holder == null ? void 0 : holder.form_record) ?? ((_a = booking == null ? void 0 : booking.metadata) == null ? void 0 : _a.holder_id);
+    const records = Array.isArray(source) ? source : [source];
+    return records.filter((record) => record !== void 0 && record !== null && record !== "");
+  }
+  /**
+   * 按 form_record 顺序读取 booking holder 的主字段名称。
+   *
+   * @example
+   * const names = this.collectBookingHolderNames(booking);
+   */
+  collectBookingHolderNames(booking) {
+    const holder = (booking == null ? void 0 : booking.holder) && typeof booking.holder === "object" ? booking.holder : null;
+    const rawName = holder == null ? void 0 : holder.name;
+    if (Array.isArray(rawName)) {
+      return rawName.map((name) => String(name || "").trim());
+    }
+    if (typeof rawName === "string") {
+      return rawName.split(",").map((name) => name.trim());
+    }
+    return [];
+  }
+  /**
+   * 按老 ticketBooking `formatHolder` 语义汇总订单顶层 holder。
+   *
+   * @example
+   * const holder = this.buildTempOrderHolderFromBookings(tempOrder);
+   */
+  buildTempOrderHolderFromBookings(tempOrder) {
+    var _a, _b;
+    const holderRecords = [];
+    const holderNames = [];
+    let baseHolder = null;
+    const seen = /* @__PURE__ */ new Set();
+    for (const booking of tempOrder.bookings || []) {
+      const holder = (booking == null ? void 0 : booking.holder) && typeof booking.holder === "object" ? booking.holder : null;
+      if (!baseHolder && holder) {
+        baseHolder = holder;
+      }
+      const records = this.collectBookingHolderRecords(booking);
+      const names = this.collectBookingHolderNames(booking);
+      for (const [index, record] of records.entries()) {
+        const key = String(record);
+        if (seen.has(key))
+          continue;
+        seen.add(key);
+        holderRecords.push(record);
+        if (names[index]) {
+          holderNames.push(names[index]);
+        }
+      }
+    }
+    if (!holderRecords.length) {
+      return null;
+    }
+    const nextHolder = {
+      customer_id: (baseHolder == null ? void 0 : baseHolder.customer_id) ?? tempOrder.customer_id,
+      form_id: (baseHolder == null ? void 0 : baseHolder.form_id) ?? ((_a = tempOrder.holder) == null ? void 0 : _a.form_id) ?? 0,
+      form_record: holderRecords
+    };
+    if (holderNames.length) {
+      nextHolder.name = holderNames.join(",");
+    }
+    if ((baseHolder == null ? void 0 : baseHolder.is_source_shop) || ((_b = this.otherParams) == null ? void 0 : _b.isFranchisee)) {
+      nextHolder.is_source_shop = 1;
+    }
+    return nextHolder;
+  }
+  /**
+   * 将 booking 级 holder 汇总到 tempOrder 顶层 holder。
+   *
+   * @example
+   * this.syncTempOrderHolderFromBookings(tempOrder);
+   */
+  syncTempOrderHolderFromBookings(tempOrder) {
+    const bookings = tempOrder.bookings || [];
+    const hasHolderSource = bookings.some((booking) => {
+      var _a;
+      return (booking == null ? void 0 : booking.holder) !== void 0 || ((_a = booking == null ? void 0 : booking.metadata) == null ? void 0 : _a.holder_id) !== void 0;
+    });
+    const nextHolder = this.buildTempOrderHolderFromBookings(tempOrder);
+    if (nextHolder || hasHolderSource || bookings.length === 0) {
+      tempOrder.holder = nextHolder;
+    }
+  }
+  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)
       return null;
     return this.core.getModule(this.salesSummaryModuleName);
   }
+  applyOrderProductsDepositSummary(tempOrder, summary) {
+    var _a;
+    const depositSummary = (0, import_utils.calculateOrderProductsDeposit)(tempOrder.products || [], {
+      productsByUid: (_a = tempOrder._extend) == null ? void 0 : _a.productsByUid
+    });
+    const manualDepositOverride = this.getManualDepositOverride(tempOrder);
+    const currentStructuralFingerprint = manualDepositOverride ? this.buildOrderProductsStructuralFingerprint(tempOrder.products) : "";
+    const shouldUseManualDepositOverride = Boolean(
+      manualDepositOverride && manualDepositOverride.productStructuralFingerprint === currentStructuralFingerprint
+    );
+    if (manualDepositOverride && !shouldUseManualDepositOverride) {
+      this.clearManualDepositOverride(tempOrder);
+    }
+    const depositAmount = shouldUseManualDepositOverride ? manualDepositOverride.amount : depositSummary.totalText;
+    const hasDepositAmount = new import_decimal.default(depositAmount).gt(0);
+    const nextSummary = {
+      ...summary,
+      deposit_amount: depositAmount,
+      deposit: hasDepositAmount ? {
+        total: depositAmount,
+        deposit_policy_ids: depositSummary.deposit_policy_ids,
+        deposit_policy_data: depositSummary.protocols,
+        hasDeposit: true
+      } : void 0
+    };
+    tempOrder.deposit_amount = depositAmount;
+    tempOrder.is_deposit = hasDepositAmount ? 1 : 0;
+    return nextSummary;
+  }
   async recalculateSummary(options) {
     const tempOrder = (options == null ? void 0 : options.createIfMissing) ? this.ensureTempOrder() : this.store.tempOrder;
     if (!tempOrder)
       return null;
+    this.sanitizeTempOrderProducts(tempOrder);
+    const snapshotSummary = this.restoreOriginalSnapshotIfProductsUnchanged(tempOrder);
+    if (snapshotSummary)
+      return snapshotSummary;
+    const shouldFullRecalculateFromSnapshot = Boolean(this.getOriginalSalesSnapshot(tempOrder));
+    const summaryProducts = shouldFullRecalculateFromSnapshot ? (0, import_lodash_es.cloneDeep)(tempOrder.products || []) : tempOrder.products;
+    if (shouldFullRecalculateFromSnapshot) {
+      this.clearPersistedAmountFieldsForFullRecalc(summaryProducts || []);
+    }
     const salesSummary = this.getSalesSummary();
     const existedSummary = this.store.summary || (0, import_utils.createEmptySummary)();
+    const totalRefundAmount = existedSummary.total_refund_amount || "0.00";
     const paidPaymentSummary = this.calculatePaidPaymentSummary(
       tempOrder.payments || []
     );
     if (!salesSummary) {
-      const emptySummary = {
+      const emptyBaseSummary = {
         ...(0, import_utils.createEmptySummary)(),
-        total_refund_amount: existedSummary.total_refund_amount || "0.00",
+        ...existedSummary,
+        total_refund_amount: totalRefundAmount
+      };
+      const emptySummaryBase = {
+        ...emptyBaseSummary,
         customer_paid_amount: paidPaymentSummary.customerPaidAmount.toFixed(2),
         order_paid_amount: paidPaymentSummary.orderPaidAmount.toFixed(2),
-        pay_service_charge_amount: paidPaymentSummary.payServiceChargeAmount.toFixed(2)
+        pay_service_charge_amount: paidPaymentSummary.payServiceChargeAmount.toFixed(2),
+        rounding_amount: paidPaymentSummary.roundingAmount.toFixed(2)
+      };
+      const emptySummaryWithDeposit = this.applyOrderProductsDepositSummary(
+        tempOrder,
+        emptySummaryBase
+      );
+      const emptySummary = {
+        ...emptySummaryWithDeposit,
+        amount_gap: this.calculateSummaryAmountGap({
+          tempOrder,
+          summary: emptySummaryWithDeposit,
+          orderPaidAmount: paidPaymentSummary.gapPaidAmount
+        })
       };
-      this.store.summary = emptySummary;
       tempOrder.surcharge_fee = emptySummary.surcharge_fee;
+      this.store.summary = emptySummary;
+      this.updateTempOrderPaymentStatus(tempOrder, {
+        previousSummary: existedSummary,
+        summary: emptySummary
+      });
       return this.store.summary;
     }
     const salesSummaryResult = await salesSummary.getSummary({
-      products: tempOrder.products,
+      products: summaryProducts,
       isPriceIncludeTax: tempOrder.is_price_include_tax,
       shopDiscount: tempOrder.shop_discount
     });
-    const summary = {
+    if (shouldFullRecalculateFromSnapshot) {
+      tempOrder.products = summaryProducts;
+    }
+    this.syncSummaryProductMetadata(tempOrder.products || []);
+    const roundingAmount = paidPaymentSummary.roundingAmount;
+    const payServiceChargeAmount = paidPaymentSummary.payServiceChargeAmount;
+    const hasSalesSummaryAmount = salesSummaryResult.expect_amount !== void 0 || salesSummaryResult.total_amount !== void 0;
+    const expectAmount = hasSalesSummaryAmount ? new import_decimal.default(salesSummaryResult.expect_amount ?? salesSummaryResult.total_amount ?? 0) : null;
+    const amountPaymentPatch = hasSalesSummaryAmount || !roundingAmount.eq(0) || !payServiceChargeAmount.eq(0) ? {
+      rounding_amount: roundingAmount.toFixed(2),
+      ...expectAmount ? {
+        total_amount: import_decimal.default.max(
+          0,
+          expectAmount.plus(roundingAmount).plus(payServiceChargeAmount)
+        ).toFixed(2)
+      } : {}
+    } : {};
+    const normalizedExpectAmountPatch = expectAmount && salesSummaryResult.expect_amount === void 0 ? { expect_amount: expectAmount.toFixed(2) } : {};
+    const summaryForGap = this.applyOrderProductsDepositSummary(tempOrder, {
       ...salesSummaryResult,
-      total_refund_amount: existedSummary.total_refund_amount || "0.00",
+      total_refund_amount: totalRefundAmount,
+      ...amountPaymentPatch,
+      ...normalizedExpectAmountPatch
+    });
+    const summary = {
+      ...summaryForGap,
+      total_refund_amount: totalRefundAmount,
       customer_paid_amount: paidPaymentSummary.customerPaidAmount.toFixed(2),
       order_paid_amount: paidPaymentSummary.orderPaidAmount.toFixed(2),
-      pay_service_charge_amount: paidPaymentSummary.payServiceChargeAmount.toFixed(2)
+      ...amountPaymentPatch,
+      ...normalizedExpectAmountPatch,
+      amount_gap: this.calculateSummaryAmountGap({
+        tempOrder,
+        summary: summaryForGap,
+        orderPaidAmount: paidPaymentSummary.gapPaidAmount
+      }),
+      pay_service_charge_amount: payServiceChargeAmount.toFixed(2)
     };
     this.store.summary = summary;
     if (summary.is_price_include_tax !== void 0) {
@@ -766,8 +1872,10 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
     tempOrder.surcharge_fee = summary.surcharge_fee;
     tempOrder.surcharges = summary.surcharges || [];
-    tempOrder.deposit_amount = summary.deposit_amount || "0.00";
-    tempOrder.is_deposit = summary.deposit_amount !== "0.00" ? 1 : 0;
+    this.updateTempOrderPaymentStatus(tempOrder, {
+      previousSummary: existedSummary,
+      summary
+    });
     return this.store.summary;
   }
   async getOrderSummary() {
@@ -777,13 +1885,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) || "";
@@ -795,6 +1912,36 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.persistTempOrder();
     return tempOrder.shop_discount;
   }
+  updateTempOrderDepositAmount(amount) {
+    const tempOrder = this.ensureTempOrder();
+    const depositAmount = this.normalizeDepositAmount(amount);
+    const previousSummary = this.store.summary || (0, import_utils.createEmptySummary)();
+    const summaryWithDeposit = this.applyDepositAmountToSummary(
+      tempOrder,
+      {
+        ...(0, import_utils.createEmptySummary)(),
+        ...previousSummary
+      },
+      depositAmount
+    );
+    this.setManualDepositOverride(tempOrder, depositAmount);
+    const paidPaymentSummary = this.calculatePaidPaymentSummary(tempOrder.payments || []);
+    const summary = {
+      ...summaryWithDeposit,
+      amount_gap: this.calculateSummaryAmountGap({
+        tempOrder,
+        summary: summaryWithDeposit,
+        orderPaidAmount: paidPaymentSummary.gapPaidAmount
+      })
+    };
+    this.store.summary = summary;
+    this.updateTempOrderPaymentStatus(tempOrder, {
+      previousSummary,
+      summary
+    });
+    this.persistTempOrder();
+    return summary;
+  }
   updateTempOrderBuzzer(buzzer) {
     const tempOrder = this.ensureTempOrder();
     tempOrder.buzzer = String(buzzer || "");
@@ -807,14 +1954,77 @@ 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)
+    };
+  }
+  isCustomerBoundDiscount(discount) {
+    const type = (discount == null ? void 0 : discount.type) ?? (discount == null ? void 0 : discount.tag);
+    return type === "good_pass" || type === "discount_card" || type === "product_discount_card";
+  }
+  clearCustomerBoundDiscounts(tempOrder) {
+    var _a, _b, _c, _d;
+    const filterDiscountList = (discountList) => {
+      if (!Array.isArray(discountList))
+        return [];
+      return discountList.filter((discount) => !this.isCustomerBoundDiscount(discount));
+    };
+    tempOrder.products = (tempOrder.products || []).map((product) => {
+      const nextProduct = {
+        ...product,
+        discount_list: filterDiscountList(product.discount_list)
+      };
+      if (Array.isArray(nextProduct.product_bundle)) {
+        nextProduct.product_bundle = nextProduct.product_bundle.map((bundle) => ({
+          ...bundle,
+          discount_list: filterDiscountList(bundle.discount_list)
+        }));
+      }
+      return nextProduct;
+    });
+    delete tempOrder.discount_list;
+    const discountModule = this.store.discount;
+    if (!discountModule)
+      return;
+    const currentDiscounts = ((_a = discountModule.getDiscountList) == null ? void 0 : _a.call(discountModule)) || [];
+    const currentOriginalDiscounts = ((_b = discountModule.getOriginalDiscountList) == null ? void 0 : _b.call(discountModule)) || [];
+    const nextDiscounts = currentDiscounts.filter((discount) => {
+      if (discount == null ? void 0 : discount.isEditMode)
+        return true;
+      return !this.isCustomerBoundDiscount(discount);
+    });
+    const nextOriginalDiscounts = currentOriginalDiscounts.filter((discount) => {
+      if (discount == null ? void 0 : discount.isEditMode)
+        return true;
+      return !this.isCustomerBoundDiscount(discount);
+    });
+    void ((_c = discountModule.setDiscountList) == null ? void 0 : _c.call(discountModule, nextDiscounts));
+    void ((_d = discountModule.setOriginalDiscountList) == null ? void 0 : _d.call(discountModule, nextOriginalDiscounts));
+  }
   /**
    * 更新当前 tempOrder 的客户协议字段。
    *
-   * PaymentModal 只需要修改订单里的客户字段；如果外部还有客户模块需要同步，
+   * PaymentModal 只需要修改订单里的客户事实；如果外部还有客户模块需要同步，
    * 应由调用方通过回调处理，不能把外部 UI 状态写进 tempOrder。
    */
   updateTempOrderCustomer(customer) {
     const tempOrder = this.ensureTempOrder();
+    const previousCustomerId = tempOrder.customer_id ?? null;
     const customerId = customer.customer_id ?? customer.customerId ?? customer.id ?? null;
     const customerName = customer.customer_name ?? customer.customerName ?? customer.display_name ?? customer.name ?? "";
     tempOrder.customer_id = customerId === null || customerId === void 0 || customerId === "" ? null : Number(customerId);
@@ -824,6 +2034,15 @@ 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
+    });
+    const nextCustomerId = tempOrder.customer_id ?? null;
     this.persistTempOrder();
     return {
       customerId: tempOrder.customer_id,
@@ -838,11 +2057,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 +2078,20 @@ 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.clearCustomerBoundDiscounts(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 +2109,18 @@ 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.clearCustomerBoundDiscounts(tempOrder);
     this.persistTempOrder();
+    this.saveDraftInBackground();
     this.core.effects.emit(import_types.OrderHooks.OnOrderCustomerChange, null);
   }
   emitOrderCustomerChange() {
@@ -920,10 +2160,28 @@ 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 orderPaymentType = this.resolveNextOrderPaymentType(tempOrder);
+    const mapped = (0, import_utils.mapPaymentItemsToOrderPayments)([
+      this.normalizePaymentSource(
+        {
+          ...payment,
+          type: orderPaymentType,
+          order_payment_type: orderPaymentType
+        },
+        { 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 +2247,48 @@ 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 isVoucherPayment = (payment) => {
+      return payment.voucher_id !== void 0 && Number(payment.voucher_id) !== 0;
+    };
+    const hasSyncedOrderPayment = (payment) => {
+      return payment.order_payment_id !== void 0 && payment.order_payment_id !== null;
+    };
+    const mappedVouchers = (0, import_utils.mapPaymentItemsToOrderPayments)(
+      payments.map(
+        (payment) => this.normalizePaymentSource(payment, { defaultPaid: true })
+      )
+    ).filter((payment) => {
+      return isVoucherPayment(payment);
+    });
     const nonVoucherPayments = (tempOrder.payments || []).filter((payment) => {
-      return payment.voucher_id === void 0 || Number(payment.voucher_id) === 0;
+      return !isVoucherPayment(payment);
+    });
+    const syncedVoucherPayments = (tempOrder.payments || []).filter((payment) => {
+      return isVoucherPayment(payment) && hasSyncedOrderPayment(payment);
+    });
+    const syncedVoucherPaymentIds = new Set(
+      syncedVoucherPayments.map((payment) => String(payment.order_payment_id))
+    );
+    const replaceableVouchers = mappedVouchers.filter((payment) => {
+      if (!hasSyncedOrderPayment(payment))
+        return true;
+      return !syncedVoucherPaymentIds.has(String(payment.order_payment_id));
     });
-    tempOrder.payments = [...nonVoucherPayments, ...mappedVouchers];
+    const cappedVouchers = this.capVoucherPaymentsByRemainingAmount({
+      vouchers: replaceableVouchers,
+      nonVoucherPayments: [
+        ...nonVoucherPayments,
+        ...syncedVoucherPayments
+      ]
+    });
+    tempOrder.payments = [...nonVoucherPayments, ...syncedVoucherPayments, ...cappedVouchers];
+    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) {
@@ -1015,37 +2307,98 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
     return true;
   }
-  // ─── TempOrder: 商品 CRUD ───
-  async addProductToOrder(product, booking) {
-    var _a;
-    const tempOrder = this.ensureTempOrder();
+  hasOrderProductLineNote(product) {
+    return typeof (product == null ? void 0 : product.note) === "string" && product.note.trim().length > 0;
+  }
+  /**
+   * 判断商品行是否显式绑定了 booking。
+   *
+   * @example
+   * this.hasLinkedBookingUid({ metadata: { booking_uid: 'booking-1' } });
+   */
+  hasLinkedBookingUid(product) {
+    var _a;
+    const bookingUid = (product == null ? void 0 : product.booking_uid) ?? ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.booking_uid);
+    return bookingUid !== void 0 && bookingUid !== null && String(bookingUid) !== "";
+  }
+  // ─── TempOrder: 商品 CRUD ───
+  /**
+   * 预约商品加车后的统一收尾：促销、折扣、summary 重算与持久化（批量拆行时只调用一次）。
+   *
+   * @example
+   * await this.finalizeProductOrderMutation(tempOrder);
+   */
+  async finalizeProductOrderMutation(tempOrder, options) {
+    this.syncTempOrderHolderFromBookings(tempOrder);
+    if (!(options == null ? void 0 : options.skipEditDiscountConfigRefresh)) {
+      await this.ensureEditDiscountConfigForProductChange(tempOrder);
+    }
+    if (!(options == null ? void 0 : options.skipDiscountRecalculation)) {
+      await this.applyPromotion();
+    }
+    if (!(options == null ? void 0 : options.skipDiscountRecalculation)) {
+      this.applyDiscount();
+    }
+    this.sanitizeTempOrderProducts(tempOrder);
+    await this.recalculateSummary({ createIfMissing: true });
+    this.persistTempOrder();
+  }
+  /**
+   * 向 tempOrder 追加一条商品行（及可选 booking），不触发 summary 重算。
+   * 带 booking 且 num>1 时由 `addProductToOrder` 拆成多次本方法调用（每次 num=1）。
+   *
+   * @example
+   * await this.appendProductLineToTempOrder(tempOrder, { product_id: 1, num: 1 }, booking);
+   */
+  async appendProductLineToTempOrder(tempOrder, product, booking) {
+    var _a, _b;
     const linked = booking ? this.createLinkedProductAndBooking({ product, booking }) : null;
     const productToAdd = (linked == null ? void 0 : linked.product) || product;
     const incomingFingerprint = (0, import_utils3.buildProductLineFingerprint)(
-      productToAdd.product_option_item,
+      (0, import_utils.getProductSkuOptions)(productToAdd),
       productToAdd.product_bundle
     );
-    const normalizedIncoming = (0, import_utils3.normalizeOrderProduct)(productToAdd);
+    const normalizedIncoming = (0, import_utils.mergeOrderProductDisplayFields)(
+      productToAdd,
+      (0, import_utils3.normalizeOrderProduct)(productToAdd)
+    );
+    const incomingBookingUid = productToAdd.booking_uid ?? ((_a = productToAdd.metadata) == null ? void 0 : _a.booking_uid);
+    if (incomingBookingUid !== void 0 && incomingBookingUid !== null && String(incomingBookingUid) !== "") {
+      normalizedIncoming.booking_uid = String(incomingBookingUid);
+      normalizedIncoming.metadata = {
+        ...normalizedIncoming.metadata || {},
+        booking_uid: String(incomingBookingUid)
+      };
+    }
+    normalizedIncoming.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+      normalizedIncoming.discount_list
+    );
     const hasIncomingGoodPass = this.hasGoodPassDiscount(
       normalizedIncoming
     );
-    const shouldForceNewLine = !!booking;
+    const hasIncomingProductNote = this.hasOrderProductLineNote(normalizedIncoming);
+    const hasIncomingBookingUid = this.hasLinkedBookingUid(productToAdd) || this.hasLinkedBookingUid(normalizedIncoming);
+    const shouldForceNewLine = !!booking || hasIncomingProductNote || hasIncomingBookingUid;
     const matchedIndex = hasIncomingGoodPass || shouldForceNewLine ? -1 : tempOrder.products.findIndex((item) => {
       if (this.hasGoodPassDiscount(item))
         return false;
+      if (this.hasOrderProductLineNote(item))
+        return false;
+      if (item.order_detail_id !== void 0 && item.order_detail_id !== null)
+        return false;
       if (item.product_id !== productToAdd.product_id)
         return false;
       if (item.product_variant_id !== productToAdd.product_variant_id)
         return false;
       const existedFingerprint2 = (0, import_utils3.buildProductLineFingerprint)(
-        item.product_option_item,
+        (0, import_utils.getProductSkuOptions)(item),
         item.product_bundle
       );
       return existedFingerprint2 === incomingFingerprint;
     });
     const matchedProduct = matchedIndex === -1 ? null : tempOrder.products[matchedIndex];
     const existedFingerprint = matchedProduct ? (0, import_utils3.buildProductLineFingerprint)(
-      matchedProduct.product_option_item,
+      (0, import_utils.getProductSkuOptions)(matchedProduct),
       matchedProduct.product_bundle
     ) : "";
     const shouldMerge = matchedProduct ? await this.shouldMergeProductToOrder({
@@ -1071,28 +2424,58 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           booking_uid: linked.bookingUid
         };
       }
-      tempOrder.products.push(normalizedIncoming);
+      tempOrder.products = [...tempOrder.products, normalizedIncoming];
     } else {
       const targetProduct = matchedProduct;
-      const targetUid = (_a = targetProduct.metadata) == null ? void 0 : _a.unique_identification_number;
-      const normalizedProduct = (0, import_utils3.normalizeOrderProduct)({
-        ...productToAdd,
-        metadata: {
-          ...productToAdd.metadata || {},
-          unique_identification_number: targetUid
-        }
-      });
+      const targetUid = (_b = targetProduct.metadata) == null ? void 0 : _b.unique_identification_number;
+      const normalizedProduct = (0, import_utils.mergeOrderProductDisplayFields)(
+        targetProduct,
+        (0, import_utils3.normalizeOrderProduct)({
+          ...productToAdd,
+          metadata: {
+            ...productToAdd.metadata || {},
+            unique_identification_number: targetUid
+          }
+        })
+      );
+      normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+        normalizedProduct.discount_list
+      );
+      const nextNum = (0, import_utils3.getSafeProductNum)(targetProduct.num + normalizedProduct.num);
+      const targetIsManualProductDiscount = isManualProductDiscountProduct(targetProduct);
+      const nextDiscountList = targetIsManualProductDiscount ? (0, import_utils.normalizeOrderProductDiscountList)(
+        (0, import_manualProductDiscount.syncManualProductDiscountProductNum)(
+          targetProduct.discount_list,
+          nextNum
+        )
+      ) : normalizedProduct.discount_list;
       tempOrder.products[matchedIndex] = {
         ...targetProduct,
         ...normalizedProduct,
+        discount_list: nextDiscountList,
         metadata: {
           ...targetProduct.metadata || {},
           ...normalizedProduct.metadata || {},
           unique_identification_number: targetUid
         },
+        product_sku: {
+          ...targetProduct.product_sku || { option: [] },
+          ...normalizedProduct.product_sku || { option: [] },
+          option: (0, import_utils.getProductSkuOptions)(normalizedProduct)
+        },
+        ...targetIsManualProductDiscount ? {
+          selling_price: targetProduct.selling_price,
+          original_price: targetProduct.original_price,
+          payment_price: targetProduct.payment_price,
+          metadata: {
+            ...normalizedProduct.metadata || {},
+            ...targetProduct.metadata || {},
+            unique_identification_number: targetUid
+          }
+        } : {},
         note: targetProduct.note,
         order_detail_id: targetProduct.order_detail_id,
-        num: (0, import_utils3.getSafeProductNum)(targetProduct.num + normalizedProduct.num)
+        num: nextNum
       };
       this.captureProductRuntime(
         tempOrder,
@@ -1104,9 +2487,79 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (linked) {
       tempOrder.bookings = [...tempOrder.bookings || [], linked.booking];
     }
-    this.applyDiscount();
-    await this.recalculateSummary({ createIfMissing: true });
-    this.persistTempOrder();
+  }
+  /**
+   * 添加商品行。带 booking 时强制独立行；num>1 时拆成多条 num=1 的 product+booking（对齐 BookingByStep / ticketBooking addService）。
+   *
+   * @example
+   * await order.addProductToOrder({ product_id: 1, num: 3 }, { start_time: '10:00' });
+   * // → tempOrder.products 新增 3 行，每行 num=1，bookings 3 条
+   */
+  async addProductToOrder(product, booking) {
+    const tempOrder = this.ensureTempOrder();
+    if (booking) {
+      const productRecord = product;
+      const splitCount = (0, import_utils3.getSafeProductNum)(
+        productRecord.num ?? productRecord.product_quantity ?? 1
+      );
+      if (splitCount > 1) {
+        for (let i = 0; i < splitCount; i += 1) {
+          const singleLine = (0, import_lodash_es.cloneDeep)(productRecord);
+          singleLine.num = 1;
+          delete singleLine.product_quantity;
+          await this.appendProductLineToTempOrder(
+            tempOrder,
+            singleLine,
+            (0, import_lodash_es.cloneDeep)(booking)
+          );
+        }
+        await this.finalizeProductOrderMutation(tempOrder);
+        return tempOrder.products;
+      }
+    }
+    await this.appendProductLineToTempOrder(tempOrder, product, booking);
+    await this.finalizeProductOrderMutation(tempOrder);
+    return tempOrder.products;
+  }
+  /**
+   * 批量添加商品行，所有行追加完成后只触发一次促销、折扣、summary 重算与持久化。
+   *
+   * @example
+   * await order.addProductsToOrder([
+   *   { product: { product_id: 1, product_variant_id: 0, num: 1 } },
+   *   { product: { product_id: 2, product_variant_id: 0, num: 1 } },
+   * ]);
+   */
+  async addProductsToOrder(items, options) {
+    const tempOrder = this.ensureTempOrder();
+    if (!Array.isArray(items) || items.length === 0)
+      return tempOrder.products;
+    for (const item of items || []) {
+      const { product, booking } = item;
+      if (!product)
+        continue;
+      if (booking) {
+        const productRecord = product;
+        const splitCount = (0, import_utils3.getSafeProductNum)(
+          productRecord.num ?? productRecord.product_quantity ?? 1
+        );
+        if (splitCount > 1) {
+          for (let i = 0; i < splitCount; i += 1) {
+            const singleLine = (0, import_lodash_es.cloneDeep)(productRecord);
+            singleLine.num = 1;
+            delete singleLine.product_quantity;
+            await this.appendProductLineToTempOrder(
+              tempOrder,
+              singleLine,
+              (0, import_lodash_es.cloneDeep)(booking)
+            );
+          }
+          continue;
+        }
+      }
+      await this.appendProductLineToTempOrder(tempOrder, product, booking);
+    }
+    await this.finalizeProductOrderMutation(tempOrder, options);
     return tempOrder.products;
   }
   hasGoodPassDiscount(product) {
@@ -1127,15 +2580,55 @@ 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;
+  getBundleRuntimeIdentity(bundle) {
+    if (!bundle || typeof bundle !== "object")
+      return "";
+    return [
+      bundle.bundle_id ?? bundle.id ?? "",
+      bundle.bundle_group_id ?? bundle.group_id ?? "",
+      bundle.bundle_product_id ?? bundle._bundle_product_id ?? bundle.product_id ?? "",
+      bundle.bundle_variant_id ?? bundle.product_variant_id ?? 0
+    ].join("|");
+  }
+  preservePersistedBundlePriceFields(previousBundles, nextBundles) {
+    if (!Array.isArray(nextBundles))
+      return nextBundles;
+    if (!Array.isArray(previousBundles) || previousBundles.length === 0)
+      return nextBundles;
+    const previousByIdentity = /* @__PURE__ */ new Map();
+    previousBundles.forEach((bundle) => {
+      const identity = this.getBundleRuntimeIdentity(bundle);
+      if (identity)
+        previousByIdentity.set(identity, bundle);
+    });
+    return nextBundles.map((bundle, index) => {
+      if (!bundle || typeof bundle !== "object")
+        return bundle;
+      const previous = previousByIdentity.get(this.getBundleRuntimeIdentity(bundle)) || previousBundles[index];
+      if (!previous || typeof previous !== "object")
+        return bundle;
+      return {
+        ...bundle,
+        price: previous.price,
+        custom_price: previous.custom_price,
+        bundle_payment_price: previous.bundle_payment_price,
+        bundle_selling_price: previous.bundle_selling_price,
+        original_price: previous.original_price,
+        product_price: previous.product_price
+      };
+    });
+  }
+  async updateOrderProduct(params) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q;
     const {
       product_id,
       product_variant_id,
       updates,
       unique_identification_number,
-      product_option_item,
-      product_bundle
+      identity_key,
+      product_sku,
+      product_bundle,
+      booking
     } = params;
     const tempOrder = this.ensureTempOrder();
     const identityLookup = {
@@ -1144,12 +2637,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 (product_option_item !== void 0)
-      identityLookup.product_option_item = product_option_item;
+    if (identity_key !== void 0) {
+      identityLookup.identity_key = identity_key;
+    }
+    if (product_sku !== void 0)
+      identityLookup.product_sku = product_sku;
     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] 目标商品不存在，无法更新");
     }
@@ -1163,12 +2674,49 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         ...targetProduct.metadata || {},
         ...(updates == null ? void 0 : updates.metadata) || {},
         unique_identification_number: ((_a = targetProduct.metadata) == null ? void 0 : _a.unique_identification_number) || unique_identification_number
+      },
+      product_sku: {
+        ...targetProduct.product_sku || { option: [] },
+        ...(updates == null ? void 0 : updates.product_sku) && typeof updates.product_sku === "object" ? updates.product_sku : {},
+        option: Array.isArray((_b = updates == null ? void 0 : updates.product_sku) == null ? void 0 : _b.option) ? updates.product_sku.option : (0, import_utils.getProductSkuOptions)(targetProduct)
       }
     };
     nextProduct.num = (0, import_utils3.getSafeProductNum)(nextProduct.num);
     const callerUpdatesTopPrice = Object.prototype.hasOwnProperty.call(updates || {}, "selling_price") || Object.prototype.hasOwnProperty.call(updates || {}, "original_price");
-    const callerUpdatesMainMeta = ((_b = updates == null ? void 0 : updates.metadata) == null ? void 0 : _b.main_product_selling_price) !== void 0 || ((_c = updates == null ? void 0 : updates.metadata) == null ? void 0 : _c.main_product_original_price) !== void 0 || ((_d = updates == null ? void 0 : updates.metadata) == null ? void 0 : _d.source_product_price) !== void 0;
-    if (callerUpdatesTopPrice && !callerUpdatesMainMeta) {
+    const callerUpdatesMainMeta = ((_c = updates == null ? void 0 : updates.metadata) == null ? void 0 : _c.main_product_selling_price) !== void 0 || ((_d = updates == null ? void 0 : updates.metadata) == null ? void 0 : _d.main_product_original_price) !== void 0 || ((_e = updates == null ? void 0 : updates.metadata) == null ? void 0 : _e.source_product_price) !== void 0;
+    const isPersistedOrderLine = targetProduct.order_detail_id !== void 0 && targetProduct.order_detail_id !== null;
+    const callerChangesDiscountList = Array.isArray(updates == null ? void 0 : updates.discount_list) && updates.discount_list.length > 0 && !isSameDiscountList(updates.discount_list, targetProduct.discount_list);
+    const callerUpdatesManualPrice = ((_f = updates == null ? void 0 : updates.metadata) == null ? void 0 : _f.price_override) !== void 0 || ((_g = updates == null ? void 0 : updates.metadata) == null ? void 0 : _g.is_manual_discount) !== void 0 || ((_h = updates == null ? void 0 : updates.metadata) == null ? void 0 : _h.product_discount_reason) !== void 0 || callerChangesDiscountList;
+    const callerAllowsBookingReprice = (() => {
+      if (params.allow_booking_reprice !== true || !booking || !callerUpdatesTopPrice || !callerUpdatesMainMeta) {
+        return false;
+      }
+      const hasChangedPrice = (nextValue, currentValue) => {
+        if (nextValue === void 0 || nextValue === null || nextValue === "") {
+          return false;
+        }
+        return !new import_decimal.default(Number(nextValue) || 0).equals(
+          new import_decimal.default(Number(currentValue) || 0)
+        );
+      };
+      return hasChangedPrice(updates.selling_price, targetProduct.selling_price) || hasChangedPrice(updates.original_price, targetProduct.original_price);
+    })();
+    if (isPersistedOrderLine && !callerUpdatesManualPrice && !callerAllowsBookingReprice) {
+      nextProduct.selling_price = targetProduct.selling_price;
+      nextProduct.original_price = targetProduct.original_price;
+      nextProduct.payment_price = targetProduct.payment_price;
+      nextProduct.metadata = {
+        ...nextProduct.metadata || {},
+        source_product_price: (_i = targetProduct.metadata) == null ? void 0 : _i.source_product_price,
+        main_product_selling_price: (_j = targetProduct.metadata) == null ? void 0 : _j.main_product_selling_price,
+        main_product_original_price: (_k = targetProduct.metadata) == null ? void 0 : _k.main_product_original_price,
+        price_schema_version: ((_l = targetProduct.metadata) == null ? void 0 : _l.price_schema_version) ?? 2
+      };
+      nextProduct.product_bundle = this.preservePersistedBundlePriceFields(
+        targetProduct.product_bundle,
+        nextProduct.product_bundle
+      );
+    } else if (callerUpdatesTopPrice && !callerUpdatesMainMeta) {
       const existedMeta = nextProduct.metadata || {};
       nextProduct.metadata = { ...existedMeta };
       delete nextProduct.metadata.source_product_price;
@@ -1176,39 +2724,313 @@ 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_utils.mergeOrderProductDisplayFields)(
+      nextProduct,
+      (0, import_utils3.normalizeOrderProduct)(nextProduct)
+    );
+    normalizedProduct.discount_list = (0, import_utils.normalizeOrderProductDiscountList)(
+      normalizedProduct.discount_list
+    );
+    const preservedBookingUid = nextProduct.booking_uid || ((_m = nextProduct.metadata) == null ? void 0 : _m.booking_uid) || targetProduct.booking_uid || ((_n = targetProduct.metadata) == null ? void 0 : _n.booking_uid);
+    if (!booking && preservedBookingUid) {
+      normalizedProduct.booking_uid = preservedBookingUid;
+      normalizedProduct.metadata = {
+        ...normalizedProduct.metadata || {},
+        booking_uid: preservedBookingUid
+      };
+    }
+    if (booking) {
+      const productUid = String(
+        ((_o = normalizedProduct.metadata) == null ? void 0 : _o.unique_identification_number) || ((_p = targetProduct.metadata) == null ? void 0 : _p.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.syncTempOrderHolderFromBookings(tempOrder);
     this.captureProductRuntime(
       tempOrder,
       updates,
       tempOrder.products[productIndex],
-      (_e = tempOrder.products[productIndex].metadata) == null ? void 0 : _e.unique_identification_number
+      (_q = tempOrder.products[productIndex].metadata) == null ? void 0 : _q.unique_identification_number
     );
+    await this.applyPromotion();
     this.applyDiscount();
+    this.sanitizeTempOrderProducts(tempOrder);
     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_sku,
+      product_bundle
+    } = params;
+    const tempOrder = this.ensureTempOrder();
+    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_sku !== void 0)
+      identityLookup.product_sku = product_sku;
+    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();
+    this.sanitizeTempOrderProducts(tempOrder);
+    await this.recalculateSummary({ createIfMissing: true });
+    this.persistTempOrder();
+    return tempOrder.products;
+  }
+  updateOrderBooking(params) {
+    const { unique_identification_number, updates } = params;
     const tempOrder = this.ensureTempOrder();
-    tempOrder.products = tempOrder.products.filter(
-      (item) => !(0, import_utils3.isIdentityMatch)(item, identity)
+    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
+      }
+    };
+    this.syncBookingMetadataHolder(nextBooking, nextBooking.metadata);
+    nextBooking.is_all = (0, import_utils.normalizeBookingIsAll)(nextBooking);
+    nextBooking.sub_type = (0, import_utils.normalizeBookingSubType)(nextBooking);
+    tempOrder.bookings[bookingIndex] = nextBooking;
+    this.syncTempOrderHolderFromBookings(tempOrder);
+    this.persistTempOrder();
+    return tempOrder.bookings;
+  }
+  /**
+   * 商品行写路径收尾：促销 → 折扣 → 清洗 → summary → 持久化。
+   * 批量删除等多行变更场景只应调用一次，避免 N 次 applyPromotion。
+   *
+   * @example
+   * await this.finalizeAfterProductsMutation(tempOrder);
+   */
+  async finalizeAfterProductsMutation(tempOrder) {
+    this.syncTempOrderHolderFromBookings(tempOrder);
+    await this.applyPromotion();
     this.applyDiscount();
+    this.sanitizeTempOrderProducts(tempOrder);
     await this.recalculateSummary({ createIfMissing: true });
     this.persistTempOrder();
+  }
+  /**
+   * 批量按 identity 删除购物车行，末尾仅一次促销重算。
+   *
+   * @example
+   * await order.removeProductsFromOrder([identityA, identityB]);
+   */
+  async removeProductsFromOrder(identities) {
+    var _a, _b, _c, _d;
+    const tempOrder = this.ensureTempOrder();
+    if (!identities.length) {
+      return tempOrder.products;
+    }
+    const productsBeforeRemove = tempOrder.products || [];
+    const bookingsBeforeRemove = tempOrder.bookings || [];
+    const matchedProducts = productsBeforeRemove.filter((item) => {
+      return identities.some((identity) => (0, import_utils3.isIdentityMatch)(item, identity));
+    });
+    const removedProducts = [];
+    tempOrder.products = tempOrder.products.filter((item) => {
+      const shouldRemove = identities.some((identity) => (0, import_utils3.isIdentityMatch)(item, identity));
+      if (shouldRemove)
+        removedProducts.push(item);
+      return !shouldRemove;
+    });
+    for (const product of removedProducts) {
+      this.removeLinkedBookingsForProduct(tempOrder, product);
+    }
+    const linkedBookingUidsToRemove = /* @__PURE__ */ new Set();
+    for (const product of matchedProducts) {
+      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 productBookingUid = (product == null ? void 0 : product.booking_uid) || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.booking_uid);
+      const isAddTimeProduct = ((_c = product == null ? void 0 : product.metadata) == null ? void 0 : _c.product_add_schedule_time) !== void 0 && ((_d = product == null ? void 0 : product.metadata) == null ? void 0 : _d.product_add_schedule_time) !== null;
+      if (isAddTimeProduct)
+        continue;
+      if (productBookingUid !== void 0 && productBookingUid !== null && productBookingUid !== "") {
+        linkedBookingUidsToRemove.add(String(productBookingUid));
+      }
+      if (productUid !== void 0 && productUid !== null && productUid !== "") {
+        bookingsBeforeRemove.forEach((booking) => {
+          const bookingUid = this.getBookingUniqueIdentificationNumber(booking);
+          if (bookingUid && String((booking == null ? void 0 : booking.product_uid) || "") === String(productUid)) {
+            linkedBookingUidsToRemove.add(bookingUid);
+          }
+        });
+      }
+    }
+    if (linkedBookingUidsToRemove.size > 0) {
+      tempOrder.products = (tempOrder.products || []).filter((line) => {
+        var _a2, _b2, _c2;
+        const lineBookingUid = ((_a2 = line == null ? void 0 : line.metadata) == null ? void 0 : _a2.booking_uid) || (line == null ? void 0 : line.booking_uid);
+        const isAddTimeProduct = ((_b2 = line == null ? void 0 : line.metadata) == null ? void 0 : _b2.product_add_schedule_time) !== void 0 && ((_c2 = line == null ? void 0 : line.metadata) == null ? void 0 : _c2.product_add_schedule_time) !== null;
+        return !(isAddTimeProduct && lineBookingUid !== void 0 && lineBookingUid !== null && linkedBookingUidsToRemove.has(String(lineBookingUid)));
+      });
+    }
+    await this.finalizeAfterProductsMutation(tempOrder);
     return tempOrder.products;
   }
+  async removeProductFromOrder(identity) {
+    return this.removeProductsFromOrder([identity]);
+  }
+  /**
+   * 仅清空购物车行（products / bookings），不重置整单。
+   * 用于「仅清空商品」；客户、备注、支付等协议字段保持不变。
+   */
+  async clearOrderCartLines() {
+    const tempOrder = this.ensureTempOrder();
+    tempOrder.products = [];
+    tempOrder.bookings = [];
+    this.syncTempOrderHolderFromBookings(tempOrder);
+    if (tempOrder._extend && typeof tempOrder._extend === "object") {
+      tempOrder._extend = {
+        ...tempOrder._extend,
+        productsByUid: {}
+      };
+    }
+    await this.applyPromotion();
+    this.applyDiscount();
+    this.sanitizeTempOrderProducts(tempOrder);
+    await this.recalculateSummary({ createIfMissing: true });
+    this.persistTempOrder();
+    return tempOrder;
+  }
   // ─── TempOrder: 提交 ───
+  buildCurrentSubmitPayloadForLocalPrint(params) {
+    var _a, _b, _c;
+    const tempOrder = this.ensureTempOrder();
+    this.persistTempOrder();
+    const payload = (0, import_utils.buildSubmitPayload)({
+      tempOrder,
+      cacheId: (params == null ? void 0 : params.cacheId) ?? this.cacheId,
+      platform: (params == null ? void 0 : params.platform) || ((_a = this.otherParams) == null ? void 0 : _a.platform),
+      businessCode: (params == null ? void 0 : params.businessCode) ?? ((_b = this.otherParams) == null ? void 0 : _b.businessCode) ?? ((_c = this.otherParams) == null ? void 0 : _c.business_code),
+      channel: params == null ? void 0 : params.channel,
+      type: params == null ? void 0 : params.type,
+      summary: this.store.summary || (0, import_utils.createEmptySummary)(),
+      enhance: (nextPayload) => ({
+        ...nextPayload,
+        order_number: tempOrder.order_number ?? nextPayload.order_number ?? null,
+        shop_order_number: tempOrder.shop_order_number ?? nextPayload.shop_order_number ?? null,
+        shop_full_order_number: tempOrder.shop_full_order_number ?? nextPayload.shop_full_order_number ?? null,
+        small_ticket_data_flag: 1
+      })
+    });
+    payload.created_at = void 0;
+    return payload;
+  }
+  async applyLocalPrintOrderNumbers(order) {
+    const tempOrder = this.ensureTempOrder();
+    if (!order || typeof order !== "object")
+      return tempOrder;
+    const shopOrderNumber = order.shop_order_number;
+    const shopFullOrderNumber = order.shop_full_order_number;
+    if (shopOrderNumber !== void 0 && shopOrderNumber !== null && shopOrderNumber !== "") {
+      tempOrder.shop_order_number = String(shopOrderNumber);
+    }
+    if (shopFullOrderNumber !== void 0 && shopFullOrderNumber !== null && shopFullOrderNumber !== "") {
+      tempOrder.shop_full_order_number = String(shopFullOrderNumber);
+    }
+    this.persistTempOrder();
+    await this.saveDraft();
+    return tempOrder;
+  }
   /**
    * 提交当前 Sales tempOrder。
    *
    * smallTicketDataFlag 用于 B 端 checkout 小票数据返回。PaymentModal 在支付提交时
-   * 应传 1，确保 /order/sales/checkout 返回打印所需数据。
+   * 应传 1，确保 /shop/order/sales/checkout 返回打印所需数据。
    */
   async submitTempOrder(params) {
-    var _a, _b, _c;
+    return this.runSubmitTempOrder(params);
+  }
+  async submitTempOrderAsync(params) {
+    return this.runSubmitTempOrder({
+      ...params,
+      syncMode: true
+    });
+  }
+  async runSubmitTempOrder(params) {
+    var _a, _b, _c, _d, _e;
     const tempOrder = this.ensureTempOrder();
     this.persistTempOrder();
+    const latestSummary = await this.recalculateSummary({ createIfMissing: true }) || this.store.summary || (0, import_utils.createEmptySummary)();
     const effectiveCacheId = (params == null ? void 0 : params.cacheId) ?? this.cacheId;
     const hasPaymentOverride = (params == null ? void 0 : params.payments) !== void 0;
     const hasPaymentStatusOverride = (params == null ? void 0 : params.paymentStatus) !== void 0;
@@ -1224,26 +3046,37 @@ 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,
       cacheId: effectiveCacheId,
       platform: (params == null ? void 0 : params.platform) || ((_a = this.otherParams) == null ? void 0 : _a.platform),
-      businessCode: params == null ? void 0 : params.businessCode,
+      businessCode: (params == null ? void 0 : params.businessCode) ?? ((_b = this.otherParams) == null ? void 0 : _b.businessCode) ?? ((_c = this.otherParams) == null ? void 0 : _c.business_code),
       channel: params == null ? void 0 : params.channel,
       type: params == null ? void 0 : params.type,
+      summary: latestSummary,
+      request_unique_idempotency_token: params == null ? void 0 : params.request_unique_idempotency_token,
       enhance: enhancePayload
     });
+    if (params == null ? void 0 : params.syncMode) {
+      payload.sync_mode = true;
+    }
+    if (!payload.created_at) {
+      payload.created_at = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
+    }
     await this.saveDraft();
     let result;
     try {
       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
+        paymentsCount: ((_d = payload.payments) == null ? void 0 : _d.length) || 0,
+        smallTicketDataFlag: payload.small_ticket_data_flag,
+        syncMode: payload.sync_mode
       });
       result = await this.submitSalesOrder({
         query: payload
@@ -1261,7 +3094,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         orderId: payload.order_id,
         externalSaleNumber: payload.external_sale_number,
         paymentStatus: payload.payment_status,
-        paymentsCount: ((_c = payload.payments) == null ? void 0 : _c.length) || 0
+        paymentsCount: ((_e = payload.payments) == null ? void 0 : _e.length) || 0
       });
       throw error;
     }
@@ -1271,6 +3104,11 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return result;
     }
     const submittedOrderId = this.extractOrderIdFromSubmitResult(result);
+    this.logInfo("runSubmitTempOrder: 提交成功", {
+      submittedOrderId,
+      result,
+      tempOrder
+    });
     if (submittedOrderId !== null && submittedOrderId !== void 0) {
       tempOrder.order_id = submittedOrderId;
       const resultRecord = result;
@@ -1278,23 +3116,43 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         submittedOrderId,
         (resultRecord == null ? void 0 : resultRecord.data) || resultRecord || {}
       );
+    } else if (this.isLocalPendingSubmitResult(result)) {
+      this.store.syncState = "local";
+    } else {
+      this.store.syncState = "submitted";
     }
     return result;
   }
   async markLocalOrderSynced(orderId, remoteOrder) {
     const tempOrder = this.ensureTempOrder();
     tempOrder.order_id = orderId;
+    this.applyRemoteOrderNumbersToTempOrder(tempOrder, remoteOrder);
     this.store.lastOrderInfo = remoteOrder;
     this.store.syncState = "submitted";
     this.persistTempOrder();
     await this.saveDraft();
   }
+  applyRemoteOrderNumbersToTempOrder(tempOrder, remoteOrder) {
+    const applyOrderNumber = (key) => {
+      const value = remoteOrder == null ? void 0 : remoteOrder[key];
+      if (value !== void 0 && value !== null && value !== "") {
+        tempOrder[key] = String(value);
+      }
+    };
+    applyOrderNumber("order_number");
+    applyOrderNumber("shop_order_number");
+    applyOrderNumber("shop_full_order_number");
+  }
   isSubmitResponseRejected(response) {
     const isErrorCode = (response == null ? void 0 : response.code) !== void 0 && response.code !== 200 && response.code !== "200";
     const isErrorStatus = (response == null ? void 0 : response.status) === false || typeof (response == null ? void 0 : response.status) === "number" && response.status >= 400;
     const isErrorSuccess = (response == null ? void 0 : response.success) === false;
     return isErrorCode || isErrorStatus || isErrorSuccess;
   }
+  isLocalPendingSubmitResult(response) {
+    const data = (response == null ? void 0 : response.data) && typeof response.data === "object" ? response.data : response;
+    return Number(data == null ? void 0 : data.need_sync) === 1;
+  }
   isSubmitErrorResponse(response) {
     if (!response || typeof response !== "object")
       return false;
@@ -1322,26 +3180,51 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       }
     });
   }
+  generateIdempotencyToken() {
+    const tempOrder = this.ensureTempOrder();
+    const token = this.buildPaymentSyncIdempotencyToken(
+      tempOrder,
+      tempOrder.payments
+    );
+    return `${token}_${Date.now()}`;
+  }
   async syncPaymentsToOrder(params) {
     const tempOrder = this.ensureTempOrder();
     const mappedPayments = (0, import_utils.mapPaymentItemsToOrderPayments)(
       params.payments || []
     );
+    const paymentTotal = this.calculatePaymentTotal(mappedPayments);
+    const targetAmount = this.getPaymentTargetAmount();
+    const isFullyPaid = targetAmount.lte(0) ? true : paymentTotal.gte(targetAmount);
+    const paymentStatus = isFullyPaid ? params.paymentStatus || "paid" : "partially_paid";
     tempOrder.payments = mappedPayments;
-    if (params.paymentStatus)
-      tempOrder.payment_status = params.paymentStatus;
+    tempOrder.payment_status = 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) {
+    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,
+      businessCode: params.businessCode,
+      channel: params.channel,
+      enhancePayload: (payload) => {
+        const nextPayload = {
+          ...payload,
+          request_unique_idempotency_token: paymentSyncIdempotencyToken
+        };
+        return nextPayload;
+      }
     });
     return { isFullyPaid, submitResult };
   }
@@ -1477,7 +3360,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * Checkout 专用：创建订单到后端
    *
    * 专门为 Checkout 模块设计的订单创建方法，
-   * 直接调用 /order/checkout 接口创建订单
+   * 通过 OS Server 调用 checkout 接口创建订单
    * 接收已经处理好的订单数据，无需再处理购物车
    *
    * @param params Checkout 订单参数（已处理的订单数据）
@@ -1546,7 +3429,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         orderData.schedule_date = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
       }
       console.log("[Order] 调用后端接口创建订单:", {
-        url: "/order/checkout",
+        url: "/shop/order/checkout",
         orderType: orderData.type,
         platform: orderData.platform,
         isDeposit: orderData.is_deposit,
@@ -1557,7 +3440,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         paymentsMethods: ((_m = orderData.payments) == null ? void 0 : _m.map((p) => p.code)) || []
       });
       this.logInfo("Calling backend checkout API", {
-        url: "/order/checkout",
+        url: "/shop/order/checkout",
         orderType: orderData.type,
         platform: orderData.platform,
         isDeposit: orderData.is_deposit,
@@ -1579,7 +3462,11 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         hasOrderId: !!orderData.order_id,
         smallTicketDataFlag: orderData.small_ticket_data_flag
       });
-      const response = await this.request.post("/order/checkout", orderData);
+      const response = await this.request.post("/order/checkout", orderData, {
+        osServer: true,
+        customToast: () => {
+        }
+      });
       this.logInfo("Order API called successfully", {
         response
       });
@@ -1599,7 +3486,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   async submitSalesOrder(params) {
     const { url, query } = params;
     const fetchUrl = url || "/order/sales/checkout";
-    return this.request.post(fetchUrl, query, { customToast: () => {
+    return this.request.post(fetchUrl, query, { osServer: true, customToast: () => {
     } });
   }
   /**
@@ -1623,13 +3510,18 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       emails: params.emails
     });
   }
-  // TODO 获取详情的接口
-  async getOrderInfoByRemote(order_id) {
-    const res = await this.request.get(`/order/sales/${order_id}`, {
-      with: ["products", "bookings", "payments", "customer", "summary", "contacts_info"]
-    }, {
-      osServer: true
-    });
+  async getSalesOrderByLookup(params) {
+    const lookup = params.lookup === void 0 || params.lookup === null ? "" : String(params.lookup).trim();
+    if (!lookup) {
+      throw new Error("加载销售详情需要 lookup");
+    }
+    if (lookup.startsWith("LOCAL_")) {
+      params.forceRemote = false;
+    }
+    const res = await this.request.get(`/order/sales/${encodeURIComponent(lookup)}`, {
+      with: ["products", "bookings", "payments", "customer", "summary", "contacts_info"],
+      ...params.forceRemote ? { forceRemote: true } : {}
+    }, { osServer: true });
     if (res.code === 200) {
       this.store.lastOrderInfo = res.data;
     }
@@ -1642,58 +3534,64 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 例如数组字段、商品行唯一值、价格 metadata、summary 派生状态和 _extend。
    */
   async hydrateTempOrderFromRecord(record, options) {
+    var _a, _b, _c;
     const raw = record && typeof record === "object" && record.data && record.order_id == null ? record.data : record || {};
-    const defaults = this.createDefaultTempOrderInstance();
-    const nextTempOrder = {
-      ...defaults
+    const nextTempOrder = this.normalizeTempOrderForRuntime(raw);
+    const rawSummary = raw.summary && typeof raw.summary === "object" ? raw.summary : {};
+    const summarySurcharges = Array.isArray(rawSummary.surcharges) ? rawSummary.surcharges.map((s) => ({ ...s || {} })) : (0, import_lodash_es.cloneDeep)(nextTempOrder.surcharges || []);
+    this.store.tempOrder = nextTempOrder;
+    this.store.summary = {
+      ...(0, import_utils.createEmptySummary)(),
+      ...rawSummary,
+      surcharges: summarySurcharges
     };
-    const TEMP_ORDER_KEYS = [
-      "order_id",
-      "external_sale_number",
-      "order_number",
-      "shop_order_number",
-      "shop_full_order_number",
-      "type",
-      "business_code",
-      "platform",
-      "sales_channel",
-      "order_sales_channel",
-      "vouchers",
-      "status",
-      "payment_status",
-      "shipping_status",
-      "customer_id",
-      "customer_name",
-      "country_calling_code",
-      "phone",
-      "email",
-      "customer",
-      "is_price_include_tax",
-      "tax_title",
-      "tax_country_code",
-      "currency_code",
-      "currency_symbol",
-      "currency_format",
-      "is_deposit",
-      "deposit_amount",
-      "shop_discount",
-      "surcharge_fee",
-      "note",
-      "buzzer",
-      "delivery_type",
-      "table_number",
-      "schedule_date",
-      "created_at",
-      "request_unique_idempotency_token"
-    ];
-    TEMP_ORDER_KEYS.forEach((key) => {
-      if (raw[key] !== void 0) {
-        nextTempOrder[key] = raw[key];
+    nextTempOrder._extend = {
+      ...nextTempOrder._extend || {},
+      originalSalesSnapshot: {
+        summary: (0, import_lodash_es.cloneDeep)(this.store.summary),
+        products: (0, import_lodash_es.cloneDeep)(nextTempOrder.products || []),
+        payments: (0, import_lodash_es.cloneDeep)(nextTempOrder.payments || []),
+        surcharges: (0, import_lodash_es.cloneDeep)(nextTempOrder.surcharges || []),
+        productFingerprint: this.buildOrderProductsFingerprint(nextTempOrder.products || [])
       }
-    });
+    };
+    this.store.lastOrderInfo = raw.lastOrderInfo || raw;
+    const hydratedEditDiscounts = this.collectHydratedEditDiscounts(nextTempOrder.products);
+    const currentDiscounts = typeof ((_a = this.store.discount) == null ? void 0 : _a.getDiscountList) === "function" ? this.store.discount.getDiscountList() || [] : [];
+    const shouldSkipEmptyDiscountSync = hydratedEditDiscounts.length === 0 && currentDiscounts.length === 0;
+    if (!shouldSkipEmptyDiscountSync) {
+      await ((_b = this.store.discount) == null ? void 0 : _b.setOriginalDiscountList(hydratedEditDiscounts));
+      await ((_c = this.store.discount) == null ? void 0 : _c.setDiscountList(hydratedEditDiscounts));
+    }
+    if (options == null ? void 0 : options.recalcOnHydrate) {
+      await this.recalculateSummary({ createIfMissing: false });
+    }
+    this.persistTempOrder();
+    return nextTempOrder;
+  }
+  normalizeTempOrderForRuntime(raw, options) {
+    var _a, _b;
+    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)) : [];
+    const rawProducts = Array.isArray(raw.products) ? raw.products : [];
+    nextTempOrder.products = rawProducts.length > 0 ? rawProducts.map((p) => this.normalizeHydratedOrderProduct(p)) : [];
     nextTempOrder.bookings = Array.isArray(raw.bookings) ? raw.bookings.map((b) => ({
       ...b || {},
       is_all: (0, import_utils.normalizeBookingIsAll)(b || {}),
@@ -1701,7 +3599,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;
@@ -1709,35 +3606,120 @@ 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 });
+    const tempOrderExtend = nextTempOrder._extend;
+    const productsByUid = tempOrderExtend.productsByUid || {};
+    for (const [index, product] of nextTempOrder.products.entries()) {
+      const uid = (_a = product.metadata) == null ? void 0 : _a.unique_identification_number;
+      if (!uid)
+        continue;
+      const existed = productsByUid[uid] && typeof productsByUid[uid] === "object" ? productsByUid[uid] : {};
+      const rawProduct = rawProducts[index] && typeof rawProducts[index] === "object" ? rawProducts[index] : product;
+      const origin = existed.origin ?? rawProduct._origin ?? ((_b = rawProduct.metadata) == null ? void 0 : _b.origin) ?? rawProduct;
+      const originSnapshot = (0, import_lodash_es.cloneDeep)(origin);
+      const productOptionString = this.buildHydratedProductOptionString(rawProduct) || this.buildHydratedProductOptionString(product);
+      if (productOptionString && originSnapshot && typeof originSnapshot === "object") {
+        if (originSnapshot.product_option_string === void 0) {
+          originSnapshot.product_option_string = productOptionString;
+        }
+        if (originSnapshot.product_options_stirng === void 0) {
+          originSnapshot.product_options_stirng = productOptionString;
+        }
+      }
+      productsByUid[uid] = {
+        ...existed,
+        origin: originSnapshot
+      };
     }
-    this.persistTempOrder();
+    tempOrderExtend.productsByUid = productsByUid;
+    if ((options == null ? void 0 : options.ensureIdentity) !== false) {
+      this.ensureExternalSaleNumber(nextTempOrder);
+    }
+    nextTempOrder.vouchers = raw.vouchers || [];
     return nextTempOrder;
   }
+  pickHydratedDisplayText(value) {
+    if (value === void 0 || value === null)
+      return "";
+    if (typeof value === "string")
+      return value;
+    if (typeof value !== "object")
+      return String(value);
+    return value.auto || value.original || value.en || value["zh-CN"] || value["zh-HK"] || "";
+  }
+  formatHydratedNamePair(group, item) {
+    const groupText = this.pickHydratedDisplayText(group);
+    const itemText = this.pickHydratedDisplayText(item);
+    if (groupText && itemText)
+      return `${groupText}:${itemText}`;
+    return groupText || itemText;
+  }
+  buildHydratedProductOptionString(product) {
+    const segments = [];
+    const sku = (product == null ? void 0 : product.product_sku) || {};
+    if (Array.isArray(sku.variant)) {
+      for (const variant of sku.variant) {
+        const segment = this.formatHydratedNamePair(variant == null ? void 0 : variant.group, variant == null ? void 0 : variant.item);
+        if (segment)
+          segments.push(segment);
+      }
+    }
+    return segments.join(", ");
+  }
+  normalizeHydratedProductOptionItem(optionItem) {
+    const rawNum = (optionItem == null ? void 0 : optionItem.num) ?? (optionItem == null ? void 0 : optionItem.quantity) ?? 1;
+    const parsedNum = Number(rawNum);
+    const rawPrice = (optionItem == null ? void 0 : optionItem.add_price) ?? (optionItem == null ? void 0 : optionItem.price) ?? 0;
+    const parsedPrice = Number(rawPrice);
+    const normalized = {
+      ...optionItem,
+      option_group_item_id: optionItem == null ? void 0 : optionItem.option_group_item_id,
+      option_group_id: optionItem == null ? void 0 : optionItem.option_group_id,
+      num: Number.isFinite(parsedNum) && parsedNum > 0 ? parsedNum : 1,
+      add_price: Number.isFinite(parsedPrice) ? parsedPrice : 0
+    };
+    delete normalized.price;
+    if ((optionItem == null ? void 0 : optionItem.name) !== void 0)
+      normalized.name = optionItem.name;
+    if ((optionItem == null ? void 0 : optionItem.group_name) !== void 0)
+      normalized.group_name = optionItem.group_name;
+    if ((optionItem == null ? void 0 : optionItem.id) !== void 0)
+      normalized.id = optionItem.id;
+    return normalized;
+  }
   normalizeHydratedOrderProduct(product) {
     const row = { ...product || {} };
     if (row.num === void 0 && row.product_quantity !== void 0) {
       row.num = row.product_quantity;
     }
-    if (!Array.isArray(row.product_option_item))
-      row.product_option_item = [];
+    const productSku = (0, import_utils.ensureProductSku)(row);
+    row.product_sku = {
+      ...productSku,
+      option: (0, import_utils.normalizeProductSkuOptions)(
+        productSku.option.map(
+          (optionItem) => this.normalizeHydratedProductOptionItem(optionItem || {})
+        )
+      )
+    };
+    delete row[`product_${"option"}_item`];
     if (!Array.isArray(row.product_bundle))
       row.product_bundle = [];
     if (!row.metadata || typeof row.metadata !== "object")
       row.metadata = {};
+    if (row.booking_uid && !row.metadata.booking_uid) {
+      row.metadata.booking_uid = row.booking_uid;
+    }
     const existingIdentity = row.metadata.unique_identification_number || row.unique_identification_number;
     if (!existingIdentity) {
       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,
+      product_sku: normalized.product_sku,
       metadata: {
         ...row.metadata,
         ...normalized.metadata
@@ -1745,7 +3727,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     };
     if (result.metadata)
       delete result.metadata.price_schema_version;
-    return result;
+    return this.sanitizeOrderProductForTempOrder(result);
   }
   getLastOrderInfo() {
     var _a;
@@ -1754,8 +3736,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   async getOrderInfo(order_id) {
     const res = await this.request.get(`/order/sales/${order_id}`, {
       with: ["products", "bookings"]
-    }, {
-      osServer: true
     });
     return res;
   }