@pisell/pisellos 2.3.101 → 2.3.103

package/lib/modules/Order/index.js

@@ -18,6 +18,7 @@ var _manualProductDiscount = require("./utils/manualProductDiscount");
 var _bundleDiscountHydration = require("./utils/bundleDiscountHydration");
 var _orderCollectionIdentity = require("./utils/orderCollectionIdentity");
 var _discountProductLineIdentity = require("./utils/discountProductLineIdentity");
+var _virtualSettlement = require("./utils/virtualSettlement");
 var _Discount = require("../Discount");
 var _Rules = require("../Rules");
 var _types2 = require("../Rules/types");
@@ -94,8 +95,10 @@ class OrderModule extends _BaseModule.BaseModule {
   promotionEvaluator = null;
   /** 赠品选择 resolver；由 SDK host bridge 注入 */
   giftSelectResolver = null;
-  /** applyPromotion 递归保护 flag（写路径同步调 applyPromotion，禁止重入） */
+  /** 促销评估递归保护 flag（写路径同步评估促销，禁止重入） */
   isApplyingPromotion = false;
+  /** 保持旧事件语义：同步事件监听器内触发的订单写入不得递归评估促销。 */
+  isEmittingPromotionApplied = false;
   /** 商品曾应用过客户券卡，客户变更剥离后需强制跑一次 calcDiscount 复位价格 */
   hasActiveCustomerBoundDiscount = false;
   /** 最近一次 applyPromotion 的未满足促销提示 */
@@ -298,6 +301,7 @@ class OrderModule extends _BaseModule.BaseModule {
       this.store.tempOrder = null;
       this.store.summary = (0, _utils.createEmptySummary)();
       this.store.availableWalletIds = [];
+      this.store.virtualCurrencyList = [];
       this.store.lastOrderInfo = undefined;
       this.store.syncState = undefined;
       this.store.discountList = [];
@@ -310,6 +314,9 @@ class OrderModule extends _BaseModule.BaseModule {
     if (!Array.isArray(this.store.availableWalletIds)) {
       this.store.availableWalletIds = [];
     }
+    if (!Array.isArray(this.store.virtualCurrencyList)) {
+      this.store.virtualCurrencyList = [];
+    }
     this.request = this.core.getPlugin('request');
     const appPlugin = this.core.getPlugin('app');
     if (!appPlugin) {
@@ -364,6 +371,12 @@ class OrderModule extends _BaseModule.BaseModule {
     this.otherParams = otherParams;
   }
 
+  /** PC/H5 属于在线店铺；其它或缺失平台统一沿用 POS 行为。 */
+  isOnlineStorePlatform() {
+    const platform = String(this.otherParams?.platform || '').trim().toLowerCase();
+    return platform === 'pc' || platform === 'h5';
+  }
+
   /**
    * 记录信息日志
    */
@@ -451,6 +464,7 @@ class OrderModule extends _BaseModule.BaseModule {
       with_wallet_pass_holder: 1,
       with_available_wallet_flag: 1,
       with_available_wallet_pass_flag: 1,
+      with_virtual_currency: 1,
       request_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
       ...(orderId ? {
         order_id: orderId
@@ -458,6 +472,7 @@ class OrderModule extends _BaseModule.BaseModule {
     });
     const discountList = prepareConfigResult?.discountList;
     this.store.availableWalletIds = prepareConfigResult?.availableWalletIds || [];
+    this.store.virtualCurrencyList = prepareConfigResult?.virtualCurrencyList || [];
     if (discountList) {
       const currentDiscountList = this.store.discount?.getDiscountList() || [];
       const currentEditDiscounts = currentDiscountList.filter(discount => discount?.isEditMode);
@@ -485,6 +500,9 @@ class OrderModule extends _BaseModule.BaseModule {
   getAvailableWalletIds() {
     return Array.isArray(this.store.availableWalletIds) ? [...this.store.availableWalletIds] : [];
   }
+  getVirtualCurrencyList() {
+    return (0, _lodashEs.cloneDeep)(this.store.virtualCurrencyList || []);
+  }
   async syncScannedDiscountsToOriginalDiscountList(discountList) {
     const scanDiscounts = (discountList || []).filter(discount => discount?.isScan);
     if (!scanDiscounts.length) return;
@@ -508,6 +526,16 @@ class OrderModule extends _BaseModule.BaseModule {
     });
   }
   async scanCode(code, customerId) {
+    if (this.isActiveVirtualSettlementOrder(this.store.tempOrder)) {
+      return {
+        type: 'clientCalc',
+        isAvailable: false,
+        isAccepted: false,
+        discountList: [],
+        scannedDiscountList: [],
+        unavailableReason: _types2.UnavailableReason.ProductNotApplicable
+      };
+    }
     const resultDiscountWithReason = (await this.store.discount?.batchSearch(code, {
       customerId
     })) || {
@@ -603,6 +631,14 @@ class OrderModule extends _BaseModule.BaseModule {
     // 也需要让 Rules.calcDiscount 把 DiscountModule 的 isSelected / isAvailable /
     // appliedProductDetails / savedAmount 复位。
     if (!tempOrder) return;
+    if (this.isActiveVirtualSettlementOrder(tempOrder)) {
+      tempOrder.products = (0, _virtualSettlement.normalizeVirtualSettlementProducts)(tempOrder.products);
+      tempOrder.discount_list = [];
+      tempOrder.shop_discount = '0.00';
+      void this.store.discount?.setDiscountList([]);
+      void this.store.discount?.setOriginalDiscountList([]);
+      return;
+    }
     this.syncLinkedBookingHoldersToProducts(tempOrder);
     delete tempOrder.discount_list;
     const discountList = this.store.discount?.getDiscountList() || [];
@@ -679,7 +715,7 @@ class OrderModule extends _BaseModule.BaseModule {
   }
 
   /**
-   * 应用购物车促销：计算 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied。
+   * 只执行购物车促销评估与赠品写回，不发布稳定态事件。
    *
    * 调用时机：写路径（add/update/remove/clear/setCustomer）末尾自动触发；外部一般无需手动调。
    *
@@ -687,22 +723,27 @@ class OrderModule extends _BaseModule.BaseModule {
    * - 不调用任何公开 CRUD API（如 removeProductFromOrder），全部内部 mutate tempOrder.products，避免事件风暴；
    * - 用 `isApplyingPromotion` 防递归；
    * - 多选项赠品依赖 giftSelectResolver，未注入则跳过且 console.warn；
-   * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进。
+   * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进；
+   * - 返回的 payload 只能在 applyDiscount（商品写路径还需 summary/persist）完成后发布。
    */
-  async applyPromotion() {
-    if (this.isApplyingPromotion) {
-      return;
+  async evaluatePromotion() {
+    if (this.isApplyingPromotion || this.isEmittingPromotionApplied) {
+      return null;
     }
     if (!this.promotionEvaluator) {
-      return;
+      return null;
     }
     const tempOrder = this.store.tempOrder;
     if (!tempOrder) {
-      return;
+      return null;
+    }
+    if (this.isActiveVirtualSettlementOrder(tempOrder)) {
+      tempOrder.products = (0, _virtualSettlement.normalizeVirtualSettlementProducts)(tempOrder.products);
+      return null;
     }
     const strategyConfigs = this.promotionEvaluator.getStrategyConfigs?.();
     if (Array.isArray(strategyConfigs) && strategyConfigs.length === 0) {
-      return;
+      return null;
     }
     this.isApplyingPromotion = true;
     try {
@@ -794,14 +835,46 @@ class OrderModule extends _BaseModule.BaseModule {
         })),
         products: tempOrder.products
       };
-      this.effectsEmit('onPromotionApplied', payload);
+      return payload;
     } catch (error) {
       console.error('[OrderModule] applyPromotion failed', error);
+      return null;
     } finally {
       this.isApplyingPromotion = false;
     }
   }
 
+  /** 发布促销稳定态；products 必须读取折扣计算后的当前数组。 */
+  emitPromotionApplied(payload) {
+    if (!payload) return;
+    const products = this.store.tempOrder?.products || payload.products;
+    this.isEmittingPromotionApplied = true;
+    try {
+      void this.effectsEmit('onPromotionApplied', {
+        ...payload,
+        products
+      });
+    } finally {
+      // effectsEmit 同步调用监听器后返回 Promise；保持既有的非阻塞事件行为。
+      this.isEmittingPromotionApplied = false;
+    }
+  }
+
+  /** 公开入口：促销、折扣、summary 与持久化完成后发布稳定态事件。 */
+  async applyPromotion() {
+    const payload = await this.evaluatePromotion();
+    if (!payload) return;
+    const tempOrder = this.store.tempOrder;
+    if (!tempOrder) return;
+    this.applyDiscount();
+    this.sanitizeTempOrderProducts(tempOrder);
+    await this.recalculateSummary({
+      createIfMissing: true
+    });
+    this.persistTempOrder();
+    this.emitPromotionApplied(payload);
+  }
+
   /** 最近一次 applyPromotion 输出的未满足促销列表 */
   getUnfulfilledPromotions() {
     return this.lastUnfulfilledPromotions;
@@ -1830,7 +1903,8 @@ class OrderModule extends _BaseModule.BaseModule {
     return product;
   }
   sanitizeTempOrderProducts(tempOrder) {
-    tempOrder.products = (tempOrder.products || []).map(product => this.sanitizeOrderProductForTempOrder(product));
+    tempOrder.products = (tempOrder.products || []).map(product => this.sanitizeOrderProductForTempOrder(this.normalizeVirtualSettlementProductIfEnabled(product)));
+    this.syncTempOrderSettlementState(tempOrder);
     (0, _discountProductLineIdentity.ensureUniqueProductLineUids)(tempOrder);
   }
   ensureExtend(tempOrder) {
@@ -2151,6 +2225,7 @@ class OrderModule extends _BaseModule.BaseModule {
       products: summaryProducts,
       isPriceIncludeTax: tempOrder.is_price_include_tax,
       shopDiscount: tempOrder.shop_discount,
+      virtualSettlementMode: this.shouldUseVirtualSettlementSummary(tempOrder),
       ...(this.otherParams?.channel ? {
         channel: this.otherParams.channel
       } : {})
@@ -2619,6 +2694,7 @@ class OrderModule extends _BaseModule.BaseModule {
     const nextCustomerId = tempOrder.customer_id ?? null;
     if (String(previousCustomerId ?? '') !== String(nextCustomerId ?? '')) {
       this.store.availableWalletIds = [];
+      this.store.virtualCurrencyList = [];
       (0, _utils.clearTempOrderHolderAssignments)(tempOrder);
       this.clearCustomerBoundDiscounts(tempOrder);
       this.applyDiscount();
@@ -2657,6 +2733,7 @@ class OrderModule extends _BaseModule.BaseModule {
     tempOrder.customer = null;
     if (tempOrder._extend) delete tempOrder._extend.customerSnapshot;
     this.store.availableWalletIds = [];
+    this.store.virtualCurrencyList = [];
     this.clearCustomerBoundDiscounts(tempOrder);
     this.applyDiscount();
     this.persistTempOrder();
@@ -2976,6 +3053,78 @@ class OrderModule extends _BaseModule.BaseModule {
     const bookingUid = product?.booking_uid ?? product?.metadata?.booking_uid;
     return bookingUid !== undefined && bookingUid !== null && String(bookingUid) !== '';
   }
+  isMultiCurrencySettlementEnabled() {
+    return this.otherParams?.enableMultiCurrencySettlement === true;
+  }
+  isActiveVirtualSettlementOrder(tempOrder) {
+    return this.isMultiCurrencySettlementEnabled() && (0, _virtualSettlement.isVirtualSettlementOrder)(tempOrder);
+  }
+  shouldUseVirtualSettlementSummary(tempOrder) {
+    return this.isActiveVirtualSettlementOrder(tempOrder) || tempOrder?.metadata?.currency_settlement_config?.settlement_type === 'virtual_currency';
+  }
+  normalizeVirtualSettlementProductIfEnabled(product) {
+    return this.isMultiCurrencySettlementEnabled() ? (0, _virtualSettlement.normalizeVirtualSettlementOrderProduct)(product) : product;
+  }
+  assertAndLockProductSettlement(tempOrder, product) {
+    if (!this.isMultiCurrencySettlementEnabled()) return;
+    const currentKey = (0, _virtualSettlement.getTempOrderSettlementKey)(tempOrder);
+    const incomingKey = (0, _virtualSettlement.getSettlementKey)((0, _virtualSettlement.getSelectedSettlementSnapshot)(product)) || 'legal_currency';
+    if (currentKey && currentKey !== incomingKey) {
+      throw new _virtualSettlement.OrderSettlementConflictError(currentKey, incomingKey);
+    }
+    const snapshot = (0, _virtualSettlement.getSelectedSettlementSnapshot)(product);
+    if (snapshot?.settlement_type === 'virtual_currency' && tempOrder.customer_id && Number(tempOrder.customer_id) !== 1) {
+      const currencyProductId = Number(snapshot.currency_product_id);
+      const asset = (this.store.virtualCurrencyList || []).find(item => Number(item?.product_id) === currencyProductId);
+      if (!asset) {
+        throw new _virtualSettlement.VirtualCurrencyAssetNotFoundError(currencyProductId);
+      }
+      const existedAmount = tempOrder.products.reduce((sum, item) => sum.plus(new _decimal.default(item.selling_price || 0).times(item.num || 1)), new _decimal.default(0));
+      const requiredAmount = existedAmount.plus(new _decimal.default(snapshot.price || 0).times(product.num || 1));
+      const balance = new _decimal.default(asset.balance || 0);
+      if (balance.lt(requiredAmount)) {
+        throw new _virtualSettlement.VirtualCurrencyBalanceError(balance.toFixed(2), requiredAmount.toFixed(2));
+      }
+    }
+    (0, _virtualSettlement.applyTempOrderSettlementState)(tempOrder, snapshot || {
+      settlement_type: 'legal_currency',
+      price: product.selling_price ?? product.original_price ?? product.payment_price ?? 0,
+      unit_label: tempOrder.currency_code,
+      symbol: tempOrder.currency_symbol,
+      amount_format: tempOrder.currency_format
+    });
+  }
+  syncTempOrderSettlementState(tempOrder) {
+    if (!this.isMultiCurrencySettlementEnabled()) return;
+    tempOrder.metadata = tempOrder.metadata || {};
+    if (!tempOrder.products.length) {
+      (0, _virtualSettlement.releaseTempOrderSettlementState)(tempOrder);
+      return;
+    }
+    const snapshot = (0, _virtualSettlement.getTempOrderSettlementSnapshot)(tempOrder);
+    if (snapshot) {
+      (0, _virtualSettlement.applyTempOrderSettlementState)(tempOrder, snapshot);
+      return;
+    }
+    tempOrder.metadata.cart_settlement_key = 'legal_currency';
+  }
+  prepareVirtualSettlementTempOrder(tempOrder) {
+    if (!this.isMultiCurrencySettlementEnabled()) return;
+    this.syncTempOrderSettlementState(tempOrder);
+    if (!this.isActiveVirtualSettlementOrder(tempOrder)) return;
+    tempOrder.products = (0, _virtualSettlement.normalizeVirtualSettlementProducts)(tempOrder.products);
+    tempOrder.discount_list = [];
+    tempOrder.shop_discount = '0.00';
+    tempOrder.surcharge_fee = '0.00';
+    tempOrder.surcharges = [];
+    const virtualOrder = tempOrder;
+    virtualOrder.discount_amount = '0.00';
+    virtualOrder.product_tax_fee = '0.00';
+    virtualOrder.tax_fee = '0.00';
+    virtualOrder.shipping_fee = '0.00';
+    virtualOrder.shipping_tax_fee = '0.00';
+    virtualOrder.tip_fee = '0.00';
+  }
 
   // ─── TempOrder: 商品 CRUD ───
 
@@ -2987,13 +3136,13 @@ class OrderModule extends _BaseModule.BaseModule {
    */
   async finalizeProductOrderMutation(tempOrder, options) {
     this.syncTempOrderHolderFromBookings(tempOrder);
-    if (!options?.skipEditDiscountConfigRefresh) {
+    this.prepareVirtualSettlementTempOrder(tempOrder);
+    const isVirtualSettlement = this.isActiveVirtualSettlementOrder(tempOrder);
+    if (!options?.skipEditDiscountConfigRefresh && !isVirtualSettlement) {
       await this.ensureEditDiscountConfigForProductChange(tempOrder);
     }
-    if (!options?.skipDiscountRecalculation) {
-      await this.applyPromotion();
-    }
-    if (!options?.skipDiscountRecalculation) {
+    const promotionPayload = !options?.skipDiscountRecalculation && !isVirtualSettlement ? await this.evaluatePromotion() : null;
+    if (!options?.skipDiscountRecalculation && !isVirtualSettlement) {
       this.applyDiscount();
     }
     this.sanitizeTempOrderProducts(tempOrder);
@@ -3001,6 +3150,7 @@ class OrderModule extends _BaseModule.BaseModule {
       createIfMissing: true
     });
     this.persistTempOrder();
+    this.emitPromotionApplied(promotionPayload);
   }
 
   /**
@@ -3021,9 +3171,10 @@ class OrderModule extends _BaseModule.BaseModule {
       booking
     }) : null;
     const productToAdd = linked?.product || product;
+    this.assertAndLockProductSettlement(tempOrder, productToAdd);
     const disableMerge = options?.disableMerge === true;
     const incomingFingerprint = disableMerge ? '' : (0, _utils3.buildProductLineFingerprint)((0, _utils.getProductSkuOptions)(productToAdd), productToAdd.product_bundle);
-    const normalizedIncoming = (0, _utils.mergeOrderProductDisplayFields)(productToAdd, (0, _utils3.normalizeOrderProduct)(productToAdd));
+    const normalizedIncoming = this.normalizeVirtualSettlementProductIfEnabled((0, _utils.mergeOrderProductDisplayFields)(productToAdd, (0, _utils3.normalizeOrderProduct)(productToAdd)));
     if (disableMerge) {
       normalizedIncoming.metadata = {
         ...(normalizedIncoming.metadata || {}),
@@ -3084,13 +3235,13 @@ class OrderModule extends _BaseModule.BaseModule {
       } else {
         const targetProduct = matchedProduct;
         const targetUid = targetProduct.metadata?.unique_identification_number;
-        const normalizedProduct = (0, _utils.mergeOrderProductDisplayFields)(targetProduct, (0, _utils3.normalizeOrderProduct)({
+        const normalizedProduct = this.normalizeVirtualSettlementProductIfEnabled((0, _utils.mergeOrderProductDisplayFields)(targetProduct, (0, _utils3.normalizeOrderProduct)({
           ...productToAdd,
           metadata: {
             ...(productToAdd.metadata || {}),
             unique_identification_number: targetUid
           }
-        }));
+        })));
         normalizedProduct.discount_list = (0, _utils.normalizeOrderProductDiscountList)(normalizedProduct.discount_list);
         const nextNum = (0, _utils3.getSafeProductNum)(targetProduct.num + normalizedProduct.num);
         tempOrder.products[matchedIndex] = {
@@ -3146,6 +3297,67 @@ class OrderModule extends _BaseModule.BaseModule {
     return commitProductLine(shouldMerge);
   }
 
+  /**
+   * booking 数量拆行时，若 Holder 数量与拆行数严格一致，则按下标分配。
+   * 数量不一致时保持旧数据，避免猜测 Holder 与商品份数的对应关系。
+   */
+  createSplitBookingLine(product, booking, index, splitCount) {
+    const singleLine = (0, _lodashEs.cloneDeep)(product);
+    singleLine.num = 1;
+    delete singleLine.product_quantity;
+    const singleBooking = (0, _lodashEs.cloneDeep)(booking);
+    const bookingHolder = booking?.holder && typeof booking.holder === 'object' ? booking.holder : null;
+    const metadataHolder = booking?.metadata?.holder && typeof booking.metadata.holder === 'object' ? booking.metadata.holder : null;
+    const rawHolderIds = bookingHolder?.form_record ?? booking?.metadata?.holder_id ?? metadataHolder?.form_record ?? product?.metadata?.holder_id;
+    const holderIds = (Array.isArray(rawHolderIds) ? rawHolderIds : [rawHolderIds]).map(holderId => holderId && typeof holderId === 'object' ? holderId.form_record_id : holderId).filter(holderId => holderId !== undefined && holderId !== null && holderId !== '');
+    if (holderIds.length !== splitCount) {
+      return {
+        product: singleLine,
+        booking: singleBooking
+      };
+    }
+    const holderId = holderIds[index];
+    const rawHolderName = bookingHolder?.name ?? metadataHolder?.name;
+    const holderNames = Array.isArray(rawHolderName) ? rawHolderName.map(name => String(name || '').trim()) : typeof rawHolderName === 'string' ? rawHolderName.split(',').map(name => name.trim()) : [];
+    const holderName = holderNames.length === splitCount ? holderNames[index] : undefined;
+    const splitHolder = holder => ({
+      ...holder,
+      form_record: [holderId],
+      ...(holderName ? {
+        name: holderName
+      } : Object.prototype.hasOwnProperty.call(holder, 'name') ? {
+        name: undefined
+      } : {})
+    });
+    singleLine.metadata = {
+      ...(singleLine.metadata || {}),
+      holder_id: [holderId]
+    };
+    if (singleLine._extend && typeof singleLine._extend === 'object') {
+      singleLine._extend = {
+        ...singleLine._extend,
+        holder_id: [holderId]
+      };
+    }
+    if (singleBooking.holder && typeof singleBooking.holder === 'object') {
+      singleBooking.holder = splitHolder(singleBooking.holder);
+    }
+    singleBooking.metadata = {
+      ...(singleBooking.metadata || {}),
+      holder_id: [holderId],
+      ...(singleBooking.metadata?.holder && typeof singleBooking.metadata.holder === 'object' ? {
+        holder: splitHolder(singleBooking.metadata.holder)
+      } : {})
+    };
+    if (Object.prototype.hasOwnProperty.call(singleBooking, 'holder_id')) {
+      singleBooking.holder_id = [holderId];
+    }
+    return {
+      product: singleLine,
+      booking: singleBooking
+    };
+  }
+
   /**
    * 添加商品行。带 booking 时强制独立行；num>1 时拆成多条 num=1 的 product+booking（对齐 BookingByStep / ticketBooking addService）。
    *
@@ -3204,29 +3416,26 @@ class OrderModule extends _BaseModule.BaseModule {
         const splitCount = (0, _utils3.getSafeProductNum)(productRecord.num ?? productRecord.product_quantity ?? 1);
         if (splitCount > 1) {
           for (let i = 0; i < splitCount; i += 1) {
-            const singleLine = (0, _lodashEs.cloneDeep)(productRecord);
-            const singleBooking = (0, _lodashEs.cloneDeep)(booking);
-            singleLine.num = 1;
-            delete singleLine.product_quantity;
+            const splitLine = this.createSplitBookingLine(productRecord, booking, i, splitCount);
             if (i > 0) {
-              delete singleLine.unique_identification_number;
-              delete singleLine.identity_key;
-              if (singleLine.metadata) {
-                singleLine.metadata = {
-                  ...singleLine.metadata
+              delete splitLine.product.unique_identification_number;
+              delete splitLine.product.identity_key;
+              if (splitLine.product.metadata) {
+                splitLine.product.metadata = {
+                  ...splitLine.product.metadata
                 };
-                delete singleLine.metadata.unique_identification_number;
-                delete singleLine.metadata.identity_key;
+                delete splitLine.product.metadata.unique_identification_number;
+                delete splitLine.product.metadata.identity_key;
               }
-              delete singleBooking.booking_uid;
-              if (singleBooking.metadata) {
-                singleBooking.metadata = {
-                  ...singleBooking.metadata
+              delete splitLine.booking.booking_uid;
+              if (splitLine.booking.metadata) {
+                splitLine.booking.metadata = {
+                  ...splitLine.booking.metadata
                 };
-                delete singleBooking.metadata.unique_identification_number;
+                delete splitLine.booking.metadata.unique_identification_number;
               }
             }
-            const committedProduct = await this.appendProductLineToTempOrder(tempOrder, singleLine, singleBooking, {
+            const committedProduct = await this.appendProductLineToTempOrder(tempOrder, splitLine.product, splitLine.booking, {
               insertAtIndex,
               disableMerge: options?.disableMerge
             });
@@ -3282,10 +3491,8 @@ class OrderModule extends _BaseModule.BaseModule {
         const splitCount = (0, _utils3.getSafeProductNum)(productRecord.num ?? productRecord.product_quantity ?? 1);
         if (splitCount > 1) {
           for (let i = 0; i < splitCount; i += 1) {
-            const singleLine = (0, _lodashEs.cloneDeep)(productRecord);
-            singleLine.num = 1;
-            delete singleLine.product_quantity;
-            const appendResult = this.appendProductLineToTempOrder(tempOrder, singleLine, (0, _lodashEs.cloneDeep)(booking));
+            const splitLine = this.createSplitBookingLine(productRecord, booking, i, splitCount);
+            const appendResult = this.appendProductLineToTempOrder(tempOrder, splitLine.product, splitLine.booking);
             if (appendResult) await appendResult;
           }
           continue;
@@ -3498,7 +3705,7 @@ class OrderModule extends _BaseModule.BaseModule {
     }
     // normalizeOrderProduct 幂等：v2 metadata 存在 → 保留 main_product_* 折扣重算 composite；
     // 否则 → 把顶层 selling_price 视作 source，派生 main_product_* 并写 price_schema_version: 2。
-    let normalizedProduct = (0, _utils.mergeOrderProductDisplayFields)(nextProduct, (0, _utils3.normalizeOrderProduct)(nextProduct));
+    let normalizedProduct = this.normalizeVirtualSettlementProductIfEnabled((0, _utils.mergeOrderProductDisplayFields)(nextProduct, (0, _utils3.normalizeOrderProduct)(nextProduct)));
     normalizedProduct.discount_list = (0, _utils.normalizeOrderProductDiscountList)(normalizedProduct.discount_list);
     const preservedBookingUid = nextProduct.booking_uid || nextProduct.metadata?.booking_uid || targetProduct.booking_uid || targetProduct.metadata?.booking_uid;
     if (!booking && preservedBookingUid) {
@@ -3541,7 +3748,7 @@ class OrderModule extends _BaseModule.BaseModule {
   async updateOrderProduct(params) {
     const tempOrder = this.ensureTempOrder();
     const updatedProductUid = this.applyOrderProductUpdateToTempOrder(tempOrder, params);
-    await this.applyPromotion();
+    const promotionPayload = await this.evaluatePromotion();
     this.applyDiscount({
       reapplyBookingDiscountProductUids: params.allow_booking_discount_reapply && updatedProductUid ? [String(updatedProductUid)] : undefined
     });
@@ -3550,6 +3757,7 @@ class OrderModule extends _BaseModule.BaseModule {
       createIfMissing: true
     });
     this.persistTempOrder();
+    this.emitPromotionApplied(promotionPayload);
     this.logInfo('updateOrderProduct success', {
       params
     });
@@ -3615,23 +3823,45 @@ class OrderModule extends _BaseModule.BaseModule {
       throw new Error('[Order] 目标商品不存在，无法更新数量');
     }
     const targetProduct = tempOrder.products[productIndex];
-    const normalizedProduct = (0, _utils3.normalizeOrderProduct)({
+    const normalizedProduct = this.normalizeVirtualSettlementProductIfEnabled((0, _utils3.normalizeOrderProduct)({
       ...targetProduct,
       num: (0, _utils3.getSafeProductNum)(num),
       metadata: {
         ...(targetProduct.metadata || {}),
         unique_identification_number: targetProduct.metadata?.unique_identification_number || unique_identification_number
       }
-    });
+    }));
     normalizedProduct.discount_list = (0, _utils.normalizeOrderProductDiscountList)(normalizedProduct.discount_list);
+    const settlementSnapshot = (0, _virtualSettlement.getSelectedSettlementSnapshot)(normalizedProduct);
+    if (this.isMultiCurrencySettlementEnabled() && settlementSnapshot?.settlement_type === 'virtual_currency' && tempOrder.customer_id && Number(tempOrder.customer_id) !== 1) {
+      const currencyProductId = Number(settlementSnapshot.currency_product_id);
+      const asset = (this.store.virtualCurrencyList || []).find(item => Number(item?.product_id) === currencyProductId);
+      if (!asset) {
+        throw new _virtualSettlement.VirtualCurrencyAssetNotFoundError(currencyProductId);
+      }
+      const requiredAmount = tempOrder.products.reduce((sum, item, index) => {
+        const current = index === productIndex ? normalizedProduct : item;
+        const currentSnapshot = (0, _virtualSettlement.getSelectedSettlementSnapshot)(current);
+        return sum.plus(new _decimal.default(currentSnapshot?.price || current.selling_price || 0).times(current.num || 1));
+      }, new _decimal.default(0));
+      const balance = new _decimal.default(asset.balance || 0);
+      if (balance.lt(requiredAmount)) {
+        throw new _virtualSettlement.VirtualCurrencyBalanceError(balance.toFixed(2), requiredAmount.toFixed(2));
+      }
+    }
     tempOrder.products[productIndex] = normalizedProduct;
-    await this.applyPromotion();
-    this.applyDiscount();
+    this.prepareVirtualSettlementTempOrder(tempOrder);
+    const isVirtualSettlement = this.isActiveVirtualSettlementOrder(tempOrder);
+    const promotionPayload = !isVirtualSettlement ? await this.evaluatePromotion() : null;
+    if (!isVirtualSettlement) {
+      this.applyDiscount();
+    }
     this.sanitizeTempOrderProducts(tempOrder);
     await this.recalculateSummary({
       createIfMissing: true
     });
     this.persistTempOrder();
+    this.emitPromotionApplied(promotionPayload);
     this.logInfo('updateOrderProductQuantity success', {
       params
     });
@@ -3676,7 +3906,7 @@ class OrderModule extends _BaseModule.BaseModule {
    */
   async finalizeAfterProductsMutation(tempOrder, options) {
     this.syncTempOrderHolderFromBookings(tempOrder);
-    await this.applyPromotion();
+    const promotionPayload = await this.evaluatePromotion();
     this.applyDiscount({
       reapplyBookingDiscountProductUids: options?.reapplyBookingDiscountProductUids
     });
@@ -3685,6 +3915,7 @@ class OrderModule extends _BaseModule.BaseModule {
       createIfMissing: true
     });
     this.persistTempOrder();
+    this.emitPromotionApplied(promotionPayload);
   }
 
   /**
@@ -3780,6 +4011,7 @@ class OrderModule extends _BaseModule.BaseModule {
     this.ensureSalesNotesLoadedForMutation(tempOrder);
     tempOrder.products = [];
     tempOrder.bookings = [];
+    (0, _virtualSettlement.releaseTempOrderSettlementState)(tempOrder);
     this.removeSalesNotesForMissingProductLines(tempOrder);
     this.syncTempOrderHolderFromBookings(tempOrder);
     if (tempOrder._extend && typeof tempOrder._extend === 'object') {
@@ -3788,17 +4020,53 @@ class OrderModule extends _BaseModule.BaseModule {
         productsByUid: {}
       };
     }
-    await this.applyPromotion();
+    const promotionPayload = await this.evaluatePromotion();
     this.applyDiscount();
     this.sanitizeTempOrderProducts(tempOrder);
     await this.recalculateSummary({
       createIfMissing: true
     });
     this.persistTempOrder();
+    this.emitPromotionApplied(promotionPayload);
     this.logInfo('clearOrderCartLines success', {});
     return tempOrder;
   }
 
+  /**
+   * 切换购物车结算单位时清理所有会影响新币种的订单状态，但保留当前客户。
+   */
+  async clearOrderForSettlementSwitch() {
+    const tempOrder = this.ensureTempOrder();
+    this.ensureSalesNotesLoadedForMutation(tempOrder);
+    tempOrder.products = [];
+    tempOrder.bookings = [];
+    this.removeSalesNotesForMissingProductLines(tempOrder);
+    tempOrder.discount_list = [];
+    tempOrder.payments = [];
+    tempOrder.refunds = [];
+    tempOrder.shop_discount = '0.00';
+    tempOrder.surcharges = [];
+    (0, _virtualSettlement.releaseTempOrderSettlementState)(tempOrder);
+    this.syncTempOrderHolderFromBookings(tempOrder);
+    if (tempOrder._extend && typeof tempOrder._extend === 'object') {
+      tempOrder._extend = {
+        ...tempOrder._extend,
+        productsByUid: {}
+      };
+    }
+    await this.store.discount?.setDiscountList([]);
+    await this.store.discount?.setOriginalDiscountList([]);
+    this.hasActiveCustomerBoundDiscount = false;
+    this.lastUnfulfilledPromotions = [];
+    this.lastGiftActions = null;
+    await this.recalculateSummary({
+      createIfMissing: true
+    });
+    this.persistTempOrder();
+    this.logInfo('clearOrderForSettlementSwitch success', {});
+    return tempOrder;
+  }
+
   // ─── TempOrder: 提交 ───
 
   buildCurrentSubmitPayloadForLocalPrint(params) {
@@ -3888,9 +4156,14 @@ class OrderModule extends _BaseModule.BaseModule {
   }
   async runSubmitTempOrder(params) {
     const tempOrder = this.ensureTempOrder();
+    this.prepareVirtualSettlementTempOrder(tempOrder);
+    const isOnlineStorePlatform = this.isOnlineStorePlatform();
     const shouldConfirmPendingVoucherPayments = params?.confirmPendingVoucherPayments !== false;
     const hasPaymentOverride = params?.payments !== undefined;
-    const preparedPaymentOverride = hasPaymentOverride ? this.prepareVoucherPaymentsForSubmit(params?.payments || [], shouldConfirmPendingVoucherPayments) : undefined;
+    let preparedPaymentOverride;
+    if (hasPaymentOverride) {
+      preparedPaymentOverride = isOnlineStorePlatform ? params?.payments || [] : this.prepareVoucherPaymentsForSubmit(params?.payments || [], shouldConfirmPendingVoucherPayments);
+    }
     if (!hasPaymentOverride) {
       if (shouldConfirmPendingVoucherPayments) {
         this.confirmPendingVoucherPayments({
@@ -3910,6 +4183,7 @@ class OrderModule extends _BaseModule.BaseModule {
     })) || this.store.summary || (0, _utils.createEmptySummary)();
     const effectiveCacheId = params?.cacheId ?? this.cacheId;
     const hasPaymentStatusOverride = params?.paymentStatus !== undefined;
+    const shouldOverridePaymentStatus = hasPaymentStatusOverride && !isOnlineStorePlatform && !shouldConfirmPendingVoucherPayments;
     const hasSmallTicketDataFlagOverride = params?.smallTicketDataFlag !== undefined;
     const enhancePayload = hasPaymentOverride || hasPaymentStatusOverride || hasSmallTicketDataFlagOverride || params?.enhancePayload ? (payload, ctx) => {
       const nextPayload = {
@@ -3917,7 +4191,7 @@ class OrderModule extends _BaseModule.BaseModule {
         ...(hasPaymentOverride ? {
           payments: preparedPaymentOverride || []
         } : {}),
-        ...(hasPaymentStatusOverride && !shouldConfirmPendingVoucherPayments ? {
+        ...(shouldOverridePaymentStatus ? {
           payment_status: params?.paymentStatus
         } : {}),
         ...(hasSmallTicketDataFlagOverride ? {
@@ -3937,6 +4211,7 @@ class OrderModule extends _BaseModule.BaseModule {
       type: submitSnapshot.type ?? params?.type,
       summary: latestSummary,
       request_unique_idempotency_token: params?.request_unique_idempotency_token,
+      includePaymentStatus: !isOnlineStorePlatform,
       enhance: enhancePayload
     });
     if (params?.syncMode) {
@@ -4868,7 +5143,7 @@ class OrderModule extends _BaseModule.BaseModule {
     };
     if (result.metadata) delete result.metadata.price_schema_version;
     const restored = (0, _bundleDiscountHydration.restoreHydratedBundleDiscounts)(result, _utils.normalizeOrderProductDiscountList);
-    return this.sanitizeOrderProductForTempOrder(restored);
+    return this.sanitizeOrderProductForTempOrder(this.normalizeVirtualSettlementProductIfEnabled(restored));
   }
   getLastOrderInfo() {
     return this.store?.lastOrderInfo;