@pisell/pisellos 2.2.302 → 2.2.304

package/lib/modules/Order/index.js

@@ -9,6 +9,7 @@ var _types = require("./types");
 var _utils = require("./utils");
 var _utils2 = require("../Product/utils");
 var _dayjs = _interopRequireDefault(require("dayjs"));
+var _salesNotes = require("./salesNotes");
 var _paymentUtils = require("./payment-utils");
 var _paymentNumber = require("../../utils/payment-number");
 var _cartPromotion = require("../../solution/BaseSales/utils/cartPromotion");
@@ -17,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");
@@ -70,6 +72,13 @@ function getVoucherPaymentLifecycleKey(payment) {
   if (!isVoucherPaymentRecord(payment)) return null;
   return `${String(payment.voucher_id)}::${String(payment.status || '')}`;
 }
+function hasPersistedOrderId(orderId) {
+  if (orderId === undefined || orderId === null || orderId === '') return false;
+  if (typeof orderId === 'string' && orderId.startsWith('LOCAL_')) return false;
+  const normalizedOrderId = Number(orderId);
+  if (Number.isFinite(normalizedOrderId)) return normalizedOrderId > 0;
+  return String(orderId).trim() !== '';
+}
 class OrderModule extends _BaseModule.BaseModule {
   defaultName = 'order';
   defaultVersion = '1.0.0';
@@ -93,8 +102,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 的未满足促销提示 */
@@ -260,12 +271,12 @@ class OrderModule extends _BaseModule.BaseModule {
         product.product_bundle = product.product_bundle.map(bundle => {
           const hasBundleDiscount = Array.isArray(bundle?.discount_list) && bundle.discount_list.length > 0;
           if (hasBundleDiscount) return bundle;
-          const restoredPrice = bundle?.original_price ?? bundle?.product_price ?? bundle?.price;
+          const restoredPrice = bundle?.price ?? bundle?.original_price ?? bundle?.product_price;
           if (restoredPrice === undefined || restoredPrice === null || restoredPrice === '') return bundle;
           return {
             ...bundle,
             price: restoredPrice,
-            bundle_selling_price: restoredPrice
+            bundle_selling_price: bundle?.bundle_selling_price ?? restoredPrice
           };
         });
       }
@@ -297,6 +308,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 = [];
@@ -309,6 +321,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) {
@@ -363,6 +378,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';
+  }
+
   /**
    * 记录信息日志
    */
@@ -450,6 +471,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
@@ -457,6 +479,14 @@ class OrderModule extends _BaseModule.BaseModule {
     });
     const discountList = prepareConfigResult?.discountList;
     this.store.availableWalletIds = prepareConfigResult?.availableWalletIds || [];
+    this.store.virtualCurrencyList = prepareConfigResult?.virtualCurrencyList || [];
+    if (prepareConfigResult) {
+      this.writePointCardSnapshotFromPrepareConfig({
+        orderId,
+        customerId: params.customerId,
+        availableWalletPassList: prepareConfigResult.availableWalletPassList || []
+      });
+    }
     if (discountList) {
       const currentDiscountList = this.store.discount?.getDiscountList() || [];
       const currentEditDiscounts = currentDiscountList.filter(discount => discount?.isEditMode);
@@ -484,6 +514,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;
@@ -507,6 +540,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
     })) || {
@@ -602,6 +645,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() || [];
@@ -678,7 +729,7 @@ class OrderModule extends _BaseModule.BaseModule {
   }
 
   /**
-   * 应用购物车促销：计算 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied。
+   * 只执行购物车促销评估与赠品写回，不发布稳定态事件。
    *
    * 调用时机：写路径（add/update/remove/clear/setCustomer）末尾自动触发；外部一般无需手动调。
    *
@@ -686,22 +737,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 {
@@ -793,14 +849,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;
@@ -904,6 +992,7 @@ class OrderModule extends _BaseModule.BaseModule {
     this.store.tempOrder = {
       ...this.store.tempOrder,
       products: [...this.store.tempOrder.products],
+      notes: [...(this.store.tempOrder.notes || [])],
       bookings: this.store.tempOrder.bookings ? [...this.store.tempOrder.bookings] : []
     };
     this.persistTempOrder();
@@ -916,6 +1005,32 @@ class OrderModule extends _BaseModule.BaseModule {
       now: (0, _utils.formatDateTime)(new Date())
     });
   }
+  clearTempOrderPointCardSnapshot(tempOrder) {
+    const orderMetaList = (0, _utils.normalizeOrderMetaList)(tempOrder.order_meta_list);
+    if (!orderMetaList) return;
+    const nextOrderMetaList = {
+      ...orderMetaList
+    };
+    delete nextOrderMetaList.point_cards_snapshot;
+    if (Object.keys(nextOrderMetaList).length === 0) {
+      delete tempOrder.order_meta_list;
+      return;
+    }
+    tempOrder.order_meta_list = nextOrderMetaList;
+  }
+  writePointCardSnapshotFromPrepareConfig(params) {
+    const tempOrder = this.store.tempOrder;
+    if (!tempOrder) return;
+    if (String(tempOrder.customer_id ?? '') !== String(params.customerId)) return;
+    const effectiveOrderId = params.orderId ?? tempOrder.order_id;
+    if (hasPersistedOrderId(effectiveOrderId)) return;
+    tempOrder.order_meta_list = {
+      ...((0, _utils.normalizeOrderMetaList)(tempOrder.order_meta_list) || {}),
+      point_cards_snapshot: (0, _utils.buildPointCardSnapshotFromWalletPassList)(params.availableWalletPassList)
+    };
+    this.persistTempOrder();
+    this.saveDraftInBackground();
+  }
   createExternalSaleNumber() {
     const timestamp = (0, _dayjs.default)().format('YYYYMMDDHHmmssSSS');
     const random6 = String(Math.floor(Math.random() * 1000000)).padStart(6, '0');
@@ -1828,7 +1943,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) {
@@ -2149,6 +2265,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
       } : {})
@@ -2236,6 +2353,179 @@ class OrderModule extends _BaseModule.BaseModule {
   getTempOrderNote() {
     return this.store.tempOrder?.note || '';
   }
+  ensureSalesNotesRuntimeState(tempOrder) {
+    const hadNotesSnapshot = Array.isArray(tempOrder.notes);
+    if (!Array.isArray(tempOrder.notes)) tempOrder.notes = [];
+    if (!tempOrder._extend || typeof tempOrder._extend !== 'object') {
+      tempOrder._extend = {
+        productsByUid: {}
+      };
+    }
+    if (!tempOrder._extend.salesNotesState) {
+      tempOrder._extend.salesNotesState = {
+        loaded: hadNotesSnapshot,
+        dirty: false
+      };
+    }
+    return tempOrder._extend.salesNotesState;
+  }
+  ensureSalesNotesLoadedForMutation(tempOrder) {
+    const state = this.ensureSalesNotesRuntimeState(tempOrder);
+    if (state.loaded) return;
+    if (tempOrder.order_id === null || tempOrder.order_id === undefined) {
+      state.loaded = true;
+      tempOrder.notes = [];
+      return;
+    }
+    throw new Error('[Order Notes] 当前订单 Notes 尚未完整加载，禁止提交部分快照');
+  }
+  normalizeSalesNoteUuid(value, field) {
+    const uuid = String(value ?? '').trim();
+    if (!uuid) throw new Error(`[Order Notes] ${field} 不能为空`);
+    if (uuid.length > 255) {
+      throw new Error(`[Order Notes] ${field} 不能超过 255 个字符`);
+    }
+    return uuid;
+  }
+  getSalesNotePrimaryRelation(note) {
+    return note.note_relations.find(relation => relation.is_primary === 1) || null;
+  }
+  removeSalesNotesForMissingProductLines(tempOrder) {
+    const state = this.ensureSalesNotesRuntimeState(tempOrder);
+    if (!state.loaded || !Array.isArray(tempOrder.notes) || tempOrder.notes.length === 0) {
+      return;
+    }
+    const remainingProductUids = new Set((tempOrder.products || []).map(product => product.metadata?.unique_identification_number || product.unique_identification_number).filter(uid => typeof uid === 'string' && uid.length > 0));
+    const nextNotes = tempOrder.notes.filter(note => {
+      const primary = this.getSalesNotePrimaryRelation(note);
+      if (!primary || primary.target_type !== 'order_detail') return true;
+      return remainingProductUids.has(primary.target_uuid);
+    });
+    if (nextNotes.length === tempOrder.notes.length) return;
+    tempOrder.notes = nextNotes;
+    state.dirty = true;
+  }
+  setSalesNoteOnTempOrder(tempOrder, input) {
+    this.ensureSalesNotesLoadedForMutation(tempOrder);
+    const note_type = String(input.note_type || '').trim();
+    const policy = (0, _salesNotes.getSalesNotePolicy)(note_type);
+    if (!policy) {
+      throw new Error(`[Order Notes] 当前未注册备注类型: ${note_type || '(empty)'}`);
+    }
+    if (input.target?.target_type !== 'order_detail') {
+      throw new Error('[Order Notes] 本期只支持 order_detail 作为主体');
+    }
+    const target_uuid = this.normalizeSalesNoteUuid(input.target.target_uuid, 'target_uuid');
+    const targetProductExists = (tempOrder.products || []).some(product => {
+      const productLineUid = product.metadata?.unique_identification_number || product.unique_identification_number;
+      return String(productLineUid ?? '') === target_uuid;
+    });
+    if (!targetProductExists) {
+      throw new Error('[Order Notes] 目标商品行不存在');
+    }
+    const text = (0, _salesNotes.buildSalesNoteText)(input.text);
+    const notes = tempOrder.notes || [];
+    // 当前 allergy policy 固定同一商品行只保留一条；业务调用方不参与去重规则。
+    const existingIndex = policy.uniquePerPrimaryTarget ? notes.findIndex(note => {
+      const primary = this.getSalesNotePrimaryRelation(note);
+      return note.note_type === note_type && primary?.target_type === 'order_detail' && primary.target_uuid === target_uuid;
+    }) : -1;
+    const existing = existingIndex >= 0 ? notes[existingIndex] : null;
+    const existingPrimary = existing?.note_relations.find(relation => relation.is_primary === 1 && relation.target_type === 'order_detail');
+    const existingOrderRelation = existing?.note_relations.find(relation => relation.is_primary === 0 && relation.target_type === 'order');
+    const note = {
+      uuid: existing?.uuid || (0, _utils.createUuidV4)(),
+      note_type: policy.note_type,
+      content: {
+        text
+      },
+      importance: policy.importance,
+      note_relations: [{
+        uuid: existingPrimary?.uuid || (0, _utils.createUuidV4)(),
+        relation_type: policy.primary_relation_type,
+        target_type: 'order_detail',
+        target_uuid,
+        is_primary: 1
+      }, {
+        uuid: existingOrderRelation?.uuid || (0, _utils.createUuidV4)(),
+        relation_type: policy.secondary_order_relation_type,
+        target_type: 'order',
+        target_uuid: String(tempOrder.shop_order_number ?? ''),
+        is_primary: 0
+      }]
+    };
+    const duplicateIndex = notes.findIndex((item, index) => item.uuid === note.uuid && index !== existingIndex);
+    if (duplicateIndex >= 0) {
+      throw new Error('[Order Notes] uuid 已被其他 Note 使用');
+    }
+    tempOrder.notes = existingIndex >= 0 ? notes.map((item, index) => index === existingIndex ? note : item) : [...notes, note];
+    const state = this.ensureSalesNotesRuntimeState(tempOrder);
+    state.loaded = true;
+    state.dirty = true;
+    return note;
+  }
+  getSalesNotes() {
+    const tempOrder = this.ensureTempOrder();
+    this.ensureSalesNotesRuntimeState(tempOrder);
+    return (0, _lodashEs.cloneDeep)(tempOrder.notes || []);
+  }
+  createSalesNotesMutationSnapshot() {
+    const tempOrder = this.ensureTempOrder();
+    const state = this.ensureSalesNotesRuntimeState(tempOrder);
+    return {
+      orderIdentity: {
+        orderId: tempOrder.order_id ?? null,
+        externalSaleNumber: String(tempOrder.external_sale_number || '')
+      },
+      notes: (0, _lodashEs.cloneDeep)(tempOrder.notes || []),
+      state: (0, _lodashEs.cloneDeep)(state)
+    };
+  }
+  restoreSalesNotesMutationSnapshot(snapshot) {
+    if (!snapshot || !Array.isArray(snapshot.notes) || !snapshot.orderIdentity || typeof snapshot.orderIdentity.externalSaleNumber !== 'string' || typeof snapshot.state?.loaded !== 'boolean' || typeof snapshot.state?.dirty !== 'boolean') {
+      throw new Error('[Order Notes] 无效的 mutation snapshot');
+    }
+    const tempOrder = this.store.tempOrder;
+    if (!tempOrder) throw new Error('[Order Notes] 当前订单不存在');
+    const snapshotOrderId = snapshot.orderIdentity.orderId;
+    const currentOrderId = tempOrder.order_id;
+    const hasSnapshotOrderId = snapshotOrderId !== null && snapshotOrderId !== undefined && String(snapshotOrderId).trim().length > 0;
+    const hasCurrentOrderId = currentOrderId !== null && currentOrderId !== undefined && String(currentOrderId).trim().length > 0;
+    const isSameOrder = hasSnapshotOrderId && hasCurrentOrderId ? String(snapshotOrderId) === String(currentOrderId) : Boolean(snapshot.orderIdentity.externalSaleNumber) && snapshot.orderIdentity.externalSaleNumber === String(tempOrder.external_sale_number || '');
+    if (!isSameOrder) {
+      throw new Error('[Order Notes] 当前订单已切换，拒绝恢复旧订单快照');
+    }
+    this.ensureSalesNotesRuntimeState(tempOrder);
+    tempOrder.notes = (0, _lodashEs.cloneDeep)(snapshot.notes);
+    tempOrder._extend.salesNotesState = (0, _lodashEs.cloneDeep)(snapshot.state);
+    this.notifyTempOrderChanged();
+  }
+  async setSalesNote(input) {
+    const tempOrder = this.ensureTempOrder();
+    const note = this.setSalesNoteOnTempOrder(tempOrder, input);
+    this.notifyTempOrderChanged();
+    return (0, _lodashEs.cloneDeep)(note);
+  }
+  async removeSalesNote(uuid) {
+    const tempOrder = this.ensureTempOrder();
+    this.ensureSalesNotesLoadedForMutation(tempOrder);
+    const normalizedUuid = this.normalizeSalesNoteUuid(uuid, 'uuid');
+    const notes = tempOrder.notes || [];
+    const nextNotes = notes.filter(note => note.uuid !== normalizedUuid);
+    if (nextNotes.length === notes.length) return;
+    tempOrder.notes = nextNotes;
+    const state = this.ensureSalesNotesRuntimeState(tempOrder);
+    state.dirty = true;
+    this.notifyTempOrderChanged();
+  }
+  async clearSalesNotes() {
+    const tempOrder = this.ensureTempOrder();
+    tempOrder.notes = [];
+    const state = this.ensureSalesNotesRuntimeState(tempOrder);
+    state.loaded = true;
+    state.dirty = true;
+    this.notifyTempOrderChanged();
+  }
   updateTempOrderShopDiscount(amount) {
     const tempOrder = this.ensureTempOrder();
     const discount = _decimal.default.max(new _decimal.default(Number(amount) || 0), 0).toDecimalPlaces(2).toFixed(2);
@@ -2275,6 +2565,31 @@ class OrderModule extends _BaseModule.BaseModule {
     this.persistTempOrder();
     return tempOrder.buzzer;
   }
+  updateTempOrderShopServiceData(patch) {
+    const tempOrder = this.ensureTempOrder();
+    const metadata = tempOrder.metadata && typeof tempOrder.metadata === 'object' && !Array.isArray(tempOrder.metadata) ? tempOrder.metadata : {};
+    const currentShopServiceData = metadata.shop_service_data && typeof metadata.shop_service_data === 'object' && !Array.isArray(metadata.shop_service_data) ? metadata.shop_service_data : {};
+    const shopServiceData = {
+      ...currentShopServiceData,
+      ...patch
+    };
+    tempOrder.metadata = {
+      ...metadata,
+      shop_service_data: shopServiceData
+    };
+    this.persistTempOrder();
+    return shopServiceData;
+  }
+  updateTempOrderPickupReferenceMode(mode) {
+    return this.updateTempOrderShopServiceData({
+      pickup_reference_mode: mode
+    });
+  }
+  updateTempOrderServiceType(serviceType) {
+    return this.updateTempOrderShopServiceData({
+      service_type: serviceType
+    });
+  }
   updateTempOrderContactsInfo(contactsInfo) {
     const tempOrder = this.ensureTempOrder();
     tempOrder.contacts_info = contactsInfo && typeof contactsInfo === 'object' && !Array.isArray(contactsInfo) ? contactsInfo : null;
@@ -2384,6 +2699,10 @@ class OrderModule extends _BaseModule.BaseModule {
       email: tempOrder.email
     });
     const nextCustomerId = tempOrder.customer_id ?? null;
+    if (String(previousCustomerId ?? '') !== String(nextCustomerId ?? '') && !hasPersistedOrderId(tempOrder.order_id)) {
+      this.store.availableWalletIds = [];
+      this.clearTempOrderPointCardSnapshot(tempOrder);
+    }
     this.persistTempOrder();
     return {
       customerId: tempOrder.customer_id,
@@ -2419,6 +2738,10 @@ class OrderModule extends _BaseModule.BaseModule {
     const nextCustomerId = tempOrder.customer_id ?? null;
     if (String(previousCustomerId ?? '') !== String(nextCustomerId ?? '')) {
       this.store.availableWalletIds = [];
+      this.store.virtualCurrencyList = [];
+      if (!hasPersistedOrderId(tempOrder.order_id)) {
+        this.clearTempOrderPointCardSnapshot(tempOrder);
+      }
       (0, _utils.clearTempOrderHolderAssignments)(tempOrder);
       this.clearCustomerBoundDiscounts(tempOrder);
       this.applyDiscount();
@@ -2457,6 +2780,10 @@ class OrderModule extends _BaseModule.BaseModule {
     tempOrder.customer = null;
     if (tempOrder._extend) delete tempOrder._extend.customerSnapshot;
     this.store.availableWalletIds = [];
+    this.store.virtualCurrencyList = [];
+    if (!hasPersistedOrderId(tempOrder.order_id)) {
+      this.clearTempOrderPointCardSnapshot(tempOrder);
+    }
     this.clearCustomerBoundDiscounts(tempOrder);
     this.applyDiscount();
     this.persistTempOrder();
@@ -2776,6 +3103,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 ───
 
@@ -2787,13 +3186,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);
@@ -2801,6 +3200,7 @@ class OrderModule extends _BaseModule.BaseModule {
       createIfMissing: true
     });
     this.persistTempOrder();
+    this.emitPromotionApplied(promotionPayload);
   }
 
   /**
@@ -2821,9 +3221,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 || {}),
@@ -2864,6 +3265,7 @@ class OrderModule extends _BaseModule.BaseModule {
     const matchedProduct = matchedIndex === -1 ? null : tempOrder.products[matchedIndex];
     const existedFingerprint = matchedProduct ? (0, _utils3.buildProductLineFingerprint)((0, _utils.getProductSkuOptions)(matchedProduct), matchedProduct.product_bundle) : '';
     const commitProductLine = shouldMerge => {
+      let committedProduct;
       if (matchedIndex === -1 || !matchedProduct || !shouldMerge) {
         this.captureProductRuntime(tempOrder, productToAdd, normalizedIncoming);
         if (linked) {
@@ -2879,16 +3281,17 @@ class OrderModule extends _BaseModule.BaseModule {
         } else {
           tempOrder.products = [...tempOrder.products, normalizedIncoming];
         }
+        committedProduct = normalizedIncoming;
       } 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] = {
@@ -2914,6 +3317,7 @@ class OrderModule extends _BaseModule.BaseModule {
           num: nextNum
         };
         this.captureProductRuntime(tempOrder, productToAdd, tempOrder.products[matchedIndex], targetUid);
+        committedProduct = tempOrder.products[matchedIndex];
         if (matchedIndex !== tempOrder.products.length - 1) {
           const mergedProduct = tempOrder.products[matchedIndex];
           tempOrder.products = [...tempOrder.products.slice(0, matchedIndex), ...tempOrder.products.slice(matchedIndex + 1), mergedProduct];
@@ -2922,10 +3326,10 @@ class OrderModule extends _BaseModule.BaseModule {
       if (linked) {
         tempOrder.bookings = [...(tempOrder.bookings || []), linked.booking];
       }
+      return committedProduct;
     };
     if (!matchedProduct) {
-      commitProductLine(false);
-      return;
+      return commitProductLine(false);
     }
     const shouldMerge = this.shouldMergeProductToOrder({
       incomingProduct: productToAdd,
@@ -2940,7 +3344,68 @@ class OrderModule extends _BaseModule.BaseModule {
     if (shouldMerge && typeof shouldMerge === 'object' && typeof shouldMerge.then === 'function') {
       return Promise.resolve(shouldMerge).then(commitProductLine);
     }
-    commitProductLine(shouldMerge);
+    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
+    };
   }
 
   /**
@@ -2952,36 +3417,99 @@ class OrderModule extends _BaseModule.BaseModule {
    */
   async addProductToOrder(product, booking, options) {
     const tempOrder = this.ensureTempOrder();
+    const salesNoteDrafts = (options?.salesNotes || []).map(draft => ({
+      note_type: String(draft.note_type || '').trim(),
+      text: {
+        kind: 'resolved',
+        text: (0, _salesNotes.buildSalesNoteText)(draft.text)
+      }
+    }));
+    const mutationSnapshot = salesNoteDrafts.length > 0 ? {
+      products: (0, _lodashEs.cloneDeep)(tempOrder.products || []),
+      bookings: (0, _lodashEs.cloneDeep)(tempOrder.bookings || []),
+      notes: (0, _lodashEs.cloneDeep)(tempOrder.notes || []),
+      extend: (0, _lodashEs.cloneDeep)(tempOrder._extend || {})
+    } : null;
+    const attachSalesNoteDrafts = orderProduct => {
+      if (!salesNoteDrafts.length) return;
+      const productLineUid = orderProduct.metadata?.unique_identification_number || orderProduct.unique_identification_number;
+      if (!productLineUid) {
+        throw new Error('[Order Notes] 商品行缺少 unique_identification_number');
+      }
+      salesNoteDrafts.forEach(draft => {
+        this.setSalesNoteOnTempOrder(tempOrder, {
+          note_type: draft.note_type,
+          target: {
+            target_type: 'order_detail',
+            target_uuid: String(productLineUid)
+          },
+          text: draft.text
+        });
+      });
+    };
+    const rollbackProductAndNotesMutation = () => {
+      if (!mutationSnapshot) return;
+      tempOrder.products = mutationSnapshot.products;
+      tempOrder.bookings = mutationSnapshot.bookings;
+      tempOrder.notes = mutationSnapshot.notes;
+      tempOrder._extend = mutationSnapshot.extend;
+    };
     const insertAfterProductUid = options?.insertAfterProductUid;
     const anchorIndex = booking && insertAfterProductUid ? tempOrder.products.findIndex(line => {
       const uid = line.metadata?.unique_identification_number || line.unique_identification_number;
       return uid !== undefined && uid !== null && String(uid) === String(insertAfterProductUid);
     }) : -1;
     let insertAtIndex = anchorIndex >= 0 ? anchorIndex + 1 : undefined;
-    if (booking) {
-      const productRecord = product;
-      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), {
+    try {
+      if (booking) {
+        const productRecord = product;
+        const splitCount = (0, _utils3.getSafeProductNum)(productRecord.num ?? productRecord.product_quantity ?? 1);
+        if (splitCount > 1) {
+          for (let i = 0; i < splitCount; i += 1) {
+            const splitLine = this.createSplitBookingLine(productRecord, booking, i, splitCount);
+            if (i > 0) {
+              delete splitLine.product.unique_identification_number;
+              delete splitLine.product.identity_key;
+              if (splitLine.product.metadata) {
+                splitLine.product.metadata = {
+                  ...splitLine.product.metadata
+                };
+                delete splitLine.product.metadata.unique_identification_number;
+                delete splitLine.product.metadata.identity_key;
+              }
+              delete splitLine.booking.booking_uid;
+              if (splitLine.booking.metadata) {
+                splitLine.booking.metadata = {
+                  ...splitLine.booking.metadata
+                };
+                delete splitLine.booking.metadata.unique_identification_number;
+              }
+            }
+            const committedProduct = await this.appendProductLineToTempOrder(tempOrder, splitLine.product, splitLine.booking, {
+              insertAtIndex,
+              disableMerge: options?.disableMerge
+            });
+            attachSalesNoteDrafts(committedProduct);
+            if (insertAtIndex !== undefined) insertAtIndex += 1;
+          }
+        } else {
+          const committedProduct = await this.appendProductLineToTempOrder(tempOrder, product, (0, _lodashEs.cloneDeep)(booking), {
             insertAtIndex,
             disableMerge: options?.disableMerge
           });
-          if (appendResult) await appendResult;
-          if (insertAtIndex !== undefined) insertAtIndex += 1;
+          attachSalesNoteDrafts(committedProduct);
         }
-        await this.finalizeProductOrderMutation(tempOrder);
-        return tempOrder.products;
+      } else {
+        const committedProduct = await this.appendProductLineToTempOrder(tempOrder, product, undefined, {
+          insertAtIndex,
+          disableMerge: options?.disableMerge
+        });
+        attachSalesNoteDrafts(committedProduct);
       }
+    } catch (error) {
+      rollbackProductAndNotesMutation();
+      throw error;
     }
-    const appendResult = this.appendProductLineToTempOrder(tempOrder, product, booking, {
-      insertAtIndex,
-      disableMerge: options?.disableMerge
-    });
-    if (appendResult) await appendResult;
     await this.finalizeProductOrderMutation(tempOrder);
     this.logInfo('addProductToOrder success', {
       product_id: product.product_id,
@@ -3013,10 +3541,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;
@@ -3229,7 +3755,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) {
@@ -3272,7 +3798,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
     });
@@ -3281,6 +3807,7 @@ class OrderModule extends _BaseModule.BaseModule {
       createIfMissing: true
     });
     this.persistTempOrder();
+    this.emitPromotionApplied(promotionPayload);
     this.logInfo('updateOrderProduct success', {
       params
     });
@@ -3346,23 +3873,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
     });
@@ -3407,7 +3956,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
     });
@@ -3416,6 +3965,7 @@ class OrderModule extends _BaseModule.BaseModule {
       createIfMissing: true
     });
     this.persistTempOrder();
+    this.emitPromotionApplied(promotionPayload);
   }
 
   /**
@@ -3426,10 +3976,12 @@ class OrderModule extends _BaseModule.BaseModule {
    */
   async removeProductsFromOrder(identities, options) {
     const tempOrder = this.ensureTempOrder();
-    this.repairDuplicateProductLineIdentities(tempOrder);
     if (!identities.length) {
       return tempOrder.products;
     }
+    // 商品删除会同步删除以商品行为主关系的 Notes；快照不完整时禁止产生孤儿 Relation。
+    this.ensureSalesNotesLoadedForMutation(tempOrder);
+    this.repairDuplicateProductLineIdentities(tempOrder);
     const productsBeforeRemove = tempOrder.products || [];
     const bookingsBeforeRemove = tempOrder.bookings || [];
     const preserveDisplayPosition = options?.preserveDisplayPosition;
@@ -3489,6 +4041,7 @@ class OrderModule extends _BaseModule.BaseModule {
         tempOrder.products = nextProductIndex >= 0 ? [...productsWithoutRemaining.slice(0, nextProductIndex), remainingProduct, ...productsWithoutRemaining.slice(nextProductIndex)] : [...productsWithoutRemaining, remainingProduct];
       }
     }
+    this.removeSalesNotesForMissingProductLines(tempOrder);
     await this.finalizeAfterProductsMutation(tempOrder);
     this.logInfo('removeProductsFromOrder success', {
       identities
@@ -3501,12 +4054,15 @@ class OrderModule extends _BaseModule.BaseModule {
 
   /**
    * 仅清空购物车行（products / bookings），不重置整单。
-   * 用于「仅清空商品」；客户、备注、支付等协议字段保持不变。
+   * 普通整单 note 保持不变；以商品行为主体的 Sales Notes 同步删除。
    */
   async clearOrderCartLines() {
     const tempOrder = this.ensureTempOrder();
+    this.ensureSalesNotesLoadedForMutation(tempOrder);
     tempOrder.products = [];
     tempOrder.bookings = [];
+    (0, _virtualSettlement.releaseTempOrderSettlementState)(tempOrder);
+    this.removeSalesNotesForMissingProductLines(tempOrder);
     this.syncTempOrderHolderFromBookings(tempOrder);
     if (tempOrder._extend && typeof tempOrder._extend === 'object') {
       tempOrder._extend = {
@@ -3514,17 +4070,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) {
@@ -3614,9 +4206,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({
@@ -3636,6 +4233,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 = {
@@ -3643,7 +4241,7 @@ class OrderModule extends _BaseModule.BaseModule {
         ...(hasPaymentOverride ? {
           payments: preparedPaymentOverride || []
         } : {}),
-        ...(hasPaymentStatusOverride && !shouldConfirmPendingVoucherPayments ? {
+        ...(shouldOverridePaymentStatus ? {
           payment_status: params?.paymentStatus
         } : {}),
         ...(hasSmallTicketDataFlagOverride ? {
@@ -3663,6 +4261,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) {
@@ -3709,6 +4308,12 @@ class OrderModule extends _BaseModule.BaseModule {
       this.logSubmitBackendRejected(result, payload);
       return result;
     }
+    const isLocalPendingSubmit = this.isLocalPendingSubmitResult(result);
+    // need_sync=1 仅表示已进入本地同步队列，不能视为远端已确认 Notes。
+    if (Object.prototype.hasOwnProperty.call(payload, 'notes') && !isLocalPendingSubmit) {
+      const salesNotesState = this.ensureSalesNotesRuntimeState(tempOrder);
+      salesNotesState.dirty = false;
+    }
     const submittedOrderId = this.extractOrderIdFromSubmitResult(result);
     this.logInfo('runSubmitTempOrder: 提交成功', {
       submittedOrderId,
@@ -3722,9 +4327,10 @@ class OrderModule extends _BaseModule.BaseModule {
       tempOrder.order_id = submittedOrderId;
       const resultRecord = result;
       await this.markLocalOrderSynced(submittedOrderId, resultRecord?.data || resultRecord || {});
-    } else if (this.isLocalPendingSubmitResult(result)) {
+    }
+    if (isLocalPendingSubmit) {
       this.store.syncState = 'local';
-    } else {
+    } else if (submittedOrderId === null || submittedOrderId === undefined) {
       this.store.syncState = 'submitted';
     }
     return result;
@@ -4110,7 +4716,7 @@ class OrderModule extends _BaseModule.BaseModule {
       params.forceRemote = false;
     }
     const res = await this.request.get(`/order/sales/${encodeURIComponent(lookup)}`, {
-      with: ['products', 'bookings', 'payments', 'customer', 'summary', 'contacts_info', 'refunds'],
+      with: ['products', 'bookings', 'payments', 'customer', 'summary', 'contacts_info', 'order_meta_list', 'refunds', 'notes'],
       ...(params.forceRemote ? {
         forceRemote: true
       } : {})
@@ -4163,7 +4769,8 @@ class OrderModule extends _BaseModule.BaseModule {
     const isMergedSalesDetailHydrate = options?.source === 'mergedSalesDetail';
     const nextTempOrder = this.normalizeTempOrderForRuntime(raw, {
       // merge 前已只给远端商品补标记；这里不能把本地未提交商品一并变成 saved item。
-      makeEditMark: !isSessionStorageHydrate && !isMergedSalesDetailHydrate
+      makeEditMark: !isSessionStorageHydrate && !isMergedSalesDetailHydrate,
+      allowUnresolvedSalesNotes: isSessionStorageHydrate
     });
     this.store.tempOrder = nextTempOrder;
     if (isSessionStorageHydrate) {
@@ -4385,6 +4992,17 @@ class OrderModule extends _BaseModule.BaseModule {
     nextTempOrder.payments = Array.isArray(raw.payments) ? raw.payments.map(p => ({
       ...(p || {})
     })) : [];
+    const rawHasSalesNotes = Object.prototype.hasOwnProperty.call(raw, 'notes');
+    const restoredSalesNotesState = raw._extend?.salesNotesState;
+    const allowUnresolvedSalesNotes = options?.allowUnresolvedSalesNotes === true || restoredSalesNotesState?.dirty === true || Number(raw.is_draft_order || 0) === 1;
+    const decodedSalesNotes = rawHasSalesNotes ? (0, _salesNotes.decodeSalesNotesSnapshot)(raw.notes, {
+      allowUnresolvedOrderTarget: allowUnresolvedSalesNotes
+    }) : {
+      notes: [],
+      complete: false
+    };
+    const hasUnresolvedSalesNoteOrderTarget = decodedSalesNotes.notes.some(note => note.note_relations.some(relation => relation.is_primary === 0 && relation.relation_type === 'related_to' && relation.target_type === 'order' && relation.target_uuid === ''));
+    nextTempOrder.notes = decodedSalesNotes.notes;
     nextTempOrder.surcharges = Array.isArray(raw.surcharges) ? raw.surcharges.map(s => ({
       ...(s || {})
     })) : [];
@@ -4397,6 +5015,7 @@ class OrderModule extends _BaseModule.BaseModule {
     nextTempOrder.contacts_info = raw.contacts_info && typeof raw.contacts_info === 'object' && !Array.isArray(raw.contacts_info) ? {
       ...raw.contacts_info
     } : null;
+    nextTempOrder.order_meta_list = (0, _utils.normalizeOrderMetaList)(raw.order_meta_list);
     nextTempOrder._extend = raw._extend && typeof raw._extend === 'object' ? {
       ...raw._extend,
       productsByUid: raw._extend.productsByUid || {}
@@ -4404,6 +5023,10 @@ class OrderModule extends _BaseModule.BaseModule {
       productsByUid: {}
     };
     const tempOrderExtend = nextTempOrder._extend;
+    tempOrderExtend.salesNotesState = {
+      loaded: rawHasSalesNotes ? decodedSalesNotes.complete : restoredSalesNotesState?.loaded === true,
+      dirty: decodedSalesNotes.complete && (restoredSalesNotesState?.dirty === true || allowUnresolvedSalesNotes && hasUnresolvedSalesNoteOrderTarget)
+    };
     const productsByUid = tempOrderExtend.productsByUid || {};
     for (const [index, product] of nextTempOrder.products.entries()) {
       const uid = product.metadata?.unique_identification_number;
@@ -4550,6 +5173,23 @@ class OrderModule extends _BaseModule.BaseModule {
       row.metadata.booking_uid = row.booking_uid;
     }
     row = (0, _bundleDiscountHydration.restoreHydratedBundleDiscounts)(row, _utils.normalizeOrderProductDiscountList);
+    const rawOriginalPrice = Number(row.original_price);
+    const rawSellingPrice = Number(row.selling_price);
+    const hasProductDiscounts = Array.isArray(row.discount_list) && row.discount_list.length > 0;
+    const hasBundleDiscounts = row.product_bundle.some(bundle => Array.isArray(bundle?.discount_list) && bundle.discount_list.length > 0);
+    const isUndiscountedV2Line = String(row.metadata.price_schema_version) === '2' && Number.isFinite(rawOriginalPrice) && Number.isFinite(rawSellingPrice) && new _decimal.default(rawOriginalPrice).eq(rawSellingPrice) && !hasProductDiscounts && !hasBundleDiscounts;
+    if (isUndiscountedV2Line) {
+      const hasPriceValue = value => value !== undefined && value !== null && value !== '';
+      row.product_bundle = row.product_bundle.map(bundle => {
+        if (!bundle || (0, _utils.isMarkdownBundle)(bundle) || hasPriceValue(bundle.original_price) || hasPriceValue(bundle.product_price) || !hasPriceValue(bundle.bundle_selling_price)) {
+          return bundle;
+        }
+        return {
+          ...bundle,
+          original_price: bundle.bundle_selling_price
+        };
+      });
+    }
     const existingIdentity = row.metadata.unique_identification_number || row.unique_identification_number;
     if (!existingIdentity) {
       row.metadata.unique_identification_number = (0, _utils.createUuidV4)();
@@ -4571,14 +5211,14 @@ 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;
   }
   async getOrderInfo(order_id) {
     const res = await this.request.get(`/order/sales/${order_id}`, {
-      with: ['products', 'bookings']
+      with: ['products', 'bookings', 'notes']
     }, {
       osServer: true
     });