@pisell/pisellos 2.2.244 → 2.2.246

package/lib/solution/BaseSales/index.js

@@ -34,13 +34,106 @@ __export(BaseSales_exports, {
 });
 module.exports = __toCommonJS(BaseSales_exports);
 var import_BaseModule = require("../../modules/BaseModule");
+var import_types = require("./types");
 var import_Order = require("../../modules/Order");
 var import_decimal = __toESM(require("decimal.js"));
-var import_types = require("../BookingByStep/types");
+var import_lodash_es = require("lodash-es");
+var import_types2 = require("../BookingByStep/types");
 var import_utils = require("../../modules/Order/utils");
 var import_dayjs = __toESM(require("dayjs"));
 __reExport(BaseSales_exports, require("./types"), module.exports);
+var import_Quotation = require("../../modules/Quotation");
 var import_transformBaseProductToOrderProduct = require("./utils/transformBaseProductToOrderProduct");
+var import_quotationPrice = require("./utils/quotationPrice");
+function isBaseSalesManualProductDiscountProduct(product) {
+  var _a, _b;
+  return ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.is_manual_discount) === true || ((_b = product == null ? void 0 : product.metadata) == null ? void 0 : _b.is_manual_discount) === 1 || ((product == null ? void 0 : product.discount_list) || []).some((item) => (item == null ? void 0 : item.type) === "product");
+}
+function getBaseSalesProductUid(product) {
+  var _a;
+  const uid = ((_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.unique_identification_number) || (product == null ? void 0 : product.unique_identification_number);
+  if (uid === void 0 || uid === null || uid === "")
+    return null;
+  return String(uid);
+}
+function preserveManualProductDiscountProducts(previousProducts, nextProducts) {
+  const previousByUid = /* @__PURE__ */ new Map();
+  (previousProducts || []).forEach((product, index) => {
+    const uid = getBaseSalesProductUid(product);
+    if (uid)
+      previousByUid.set(uid, product);
+    previousByUid.set(`__index__:${index}`, product);
+  });
+  return (nextProducts || []).map((product, index) => {
+    const uid = getBaseSalesProductUid(product);
+    const previous = (uid ? previousByUid.get(uid) : void 0) || previousByUid.get(`__index__:${index}`);
+    return previous && isBaseSalesManualProductDiscountProduct(previous) ? previous : product;
+  });
+}
+function getBaseSalesUniqueArrayMetadataKey(key) {
+  if (key === "products" || key === "bookings")
+    return "unique_identification_number";
+  if (key === "payments" || key === "payment")
+    return "unique_payment_number";
+  return null;
+}
+function getBaseSalesMetadataUid(item, metadataKey) {
+  var _a;
+  const uid = ((_a = item == null ? void 0 : item.metadata) == null ? void 0 : _a[metadataKey]) ?? (item == null ? void 0 : item[metadataKey]);
+  if (uid === void 0 || uid === null || uid === "")
+    return null;
+  return String(uid);
+}
+function mergeBaseSalesUniqueArray(currentValue, loadedValue, metadataKey) {
+  const result = [];
+  const indexByUid = /* @__PURE__ */ new Map();
+  const appendOrReplaceByUid = (item) => {
+    const clonedItem = (0, import_lodash_es.cloneDeep)(item);
+    const uid = getBaseSalesMetadataUid(clonedItem, metadataKey);
+    if (!uid) {
+      result.push(clonedItem);
+      return;
+    }
+    const existingIndex = indexByUid.get(uid);
+    if (existingIndex !== void 0) {
+      result[existingIndex] = clonedItem;
+      return;
+    }
+    indexByUid.set(uid, result.length);
+    result.push(clonedItem);
+  };
+  currentValue.forEach(appendOrReplaceByUid);
+  loadedValue.forEach(appendOrReplaceByUid);
+  return result;
+}
+function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord) {
+  if (!currentTempOrder)
+    return loadedRecord;
+  const mergedRecord = (0, import_lodash_es.mergeWith)(
+    (0, import_lodash_es.cloneDeep)(currentTempOrder),
+    (0, import_lodash_es.cloneDeep)(loadedRecord || {}),
+    (currentValue, loadedValue, key) => {
+      if (Array.isArray(currentValue) && Array.isArray(loadedValue)) {
+        const metadataKey = getBaseSalesUniqueArrayMetadataKey(key);
+        if (metadataKey) {
+          return mergeBaseSalesUniqueArray(currentValue, loadedValue, metadataKey);
+        }
+        return [
+          ...(0, import_lodash_es.cloneDeep)(currentValue),
+          ...(0, import_lodash_es.cloneDeep)(loadedValue)
+        ];
+      }
+      if (Array.isArray(loadedValue))
+        return (0, import_lodash_es.cloneDeep)(loadedValue);
+      if (Array.isArray(currentValue) && loadedValue === void 0) {
+        return (0, import_lodash_es.cloneDeep)(currentValue);
+      }
+      return void 0;
+    }
+  );
+  delete mergedRecord.request_unique_idempotency_token;
+  return mergedRecord;
+}
 var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
@@ -48,20 +141,22 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     this.defaultVersion = "1.0.0";
     this.isSolution = true;
     this.initializeOptions = {};
-    // LoggerManager 实例
     this.store = {
       order: void 0
     };
     this.otherParams = {};
     // 当前缓存中已加载的最新 SalesDetail；只读 getter 走它对外暴露详情数据。
     this.currentSalesDetail = null;
+    this.discountConfigCacheKey = null;
+    this.hasManualDiscountSelection = false;
+    this.paymentMethodsCache = [];
   }
   /**
    * 子类可覆盖此方法以追加/收敛要注册的子模块。
-   * 默认包含通用销售模块：products / order / salesSummary / schedule / payment。
+   * 默认包含通用销售模块：products / order / salesSummary / schedule / payment / quotation。
    */
   getRegisteredModuleNames() {
-    return ["products", "order", "salesSummary", "schedule", "payment"];
+    return ["products", "order", "salesSummary", "schedule", "payment", "quotation"];
   }
   /**
    * 记录信息日志
@@ -102,16 +197,223 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       });
     }
   }
+  hydrateOrderPaymentNames(payments) {
+    if (!payments.length)
+      return [];
+    if (!this.paymentMethodsCache.length) {
+      return payments.map((payment) => ({ ...payment }));
+    }
+    const paymentMethodById = /* @__PURE__ */ new Map();
+    const paymentMethodByCode = /* @__PURE__ */ new Map();
+    this.paymentMethodsCache.forEach((method) => {
+      if ((method == null ? void 0 : method.id) !== void 0 && (method == null ? void 0 : method.id) !== null) {
+        paymentMethodById.set(String(method.id), method);
+      }
+      if (method == null ? void 0 : method.code) {
+        paymentMethodByCode.set(String(method.code), method);
+      }
+    });
+    return payments.map((payment) => {
+      const nextPayment = { ...payment };
+      if (nextPayment.name)
+        return nextPayment;
+      const paymentMethod = paymentMethodById.get(String(nextPayment.custom_payment_id)) || paymentMethodByCode.get(String(nextPayment.code));
+      if (!(paymentMethod == null ? void 0 : paymentMethod.name))
+        return nextPayment;
+      return {
+        ...nextPayment,
+        name: paymentMethod.name
+      };
+    });
+  }
   get payment() {
     return this.store.payment;
   }
+  getCurrentOrderCustomerId() {
+    var _a, _b;
+    const tempOrder = (_b = (_a = this.store.order) == null ? void 0 : _a.getTempOrder) == null ? void 0 : _b.call(_a);
+    const customerId = tempOrder == null ? void 0 : tempOrder.customer_id;
+    if (customerId === null || customerId === void 0)
+      return void 0;
+    return customerId;
+  }
+  applyQuotationScheduleResolver(quotation) {
+    const scheduleModule = this.store.schedule;
+    if (!scheduleModule)
+      return;
+    quotation.setScheduleResolver((id) => {
+      var _a;
+      const schedules = ((_a = scheduleModule.getScheduleListByIds) == null ? void 0 : _a.call(scheduleModule, [id])) || [];
+      return schedules[0];
+    });
+  }
+  async loadQuotationForPriceQuery(params) {
+    var _a;
+    if (!params.quotation)
+      return;
+    this.applyQuotationScheduleResolver(params.quotation);
+    await params.quotation.loadQuotations({
+      channel: params.channel || ((_a = this.otherParams) == null ? void 0 : _a.channel),
+      customer_id: params.customer_id
+    });
+  }
+  getPriceQueryProductId(product) {
+    const productId = Number((product == null ? void 0 : product.product_id) ?? (product == null ? void 0 : product.id));
+    if (!Number.isFinite(productId))
+      return null;
+    return productId;
+  }
+  getPriceQuerySchedule(params) {
+    const booking = params.booking || {};
+    if (typeof booking.start_date === "string" && booking.start_date.trim()) {
+      const scheduleDate = booking.start_date.trim();
+      const startTime = typeof booking.start_time === "string" && booking.start_time.trim() ? booking.start_time.trim() : "00:00:00";
+      const datetime = (0, import_dayjs.default)(`${scheduleDate} ${startTime}`);
+      return {
+        schedule_date: scheduleDate,
+        schedule_datetime: datetime.isValid() ? datetime.format("YYYY-MM-DD HH:mm:ss") : `${scheduleDate} ${startTime}`
+      };
+    }
+    if (typeof params.datetime === "string" && params.datetime.trim()) {
+      const datetime = (0, import_dayjs.default)(params.datetime.trim());
+      if (datetime.isValid()) {
+        return {
+          schedule_date: datetime.format("YYYY-MM-DD"),
+          schedule_datetime: datetime.format("YYYY-MM-DD HH:mm:ss")
+        };
+      }
+    }
+    const now = (0, import_dayjs.default)();
+    return {
+      schedule_date: now.format("YYYY-MM-DD"),
+      schedule_datetime: now.format("YYYY-MM-DD HH:mm:ss")
+    };
+  }
+  async loadProductForPriceQuery(params, customerId) {
+    var _a, _b;
+    const product = params.product || {};
+    const productId = this.getPriceQueryProductId(product);
+    if (productId === null || !this.request)
+      return null;
+    const schedule = this.getPriceQuerySchedule(params);
+    try {
+      const response = await this.request.post("/product/query", {
+        ids: [productId],
+        open_quotation: 1,
+        open_bundle: 1,
+        status: "published",
+        num: 1,
+        skip: 1,
+        customer_id: customerId,
+        schedule_date: schedule.schedule_date,
+        schedule_datetime: schedule.schedule_datetime,
+        application_code: params.channel || ((_a = this.otherParams) == null ? void 0 : _a.channel)
+      }, {
+        osServer: true,
+        customToast: () => {
+        }
+      });
+      const list = ((_b = response == null ? void 0 : response.data) == null ? void 0 : _b.list) || (response == null ? void 0 : response.list) || [];
+      if (!Array.isArray(list))
+        return null;
+      return list.find((item) => Number((item == null ? void 0 : item.id) ?? (item == null ? void 0 : item.product_id)) === productId) || null;
+    } catch (error) {
+      this.logWarning("loadProductForPriceQuery: 商品重查失败，使用入参 fallback", {
+        productId,
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return null;
+    }
+  }
+  getAuthoritativeBundleItems(product) {
+    if (Array.isArray(product == null ? void 0 : product.product_bundle))
+      return product.product_bundle;
+    const groups = Array.isArray(product == null ? void 0 : product.bundle_group) ? product.bundle_group : Array.isArray(product == null ? void 0 : product.bundleGroup) ? product.bundleGroup : [];
+    return groups.flatMap((group) => {
+      const items = Array.isArray(group == null ? void 0 : group.bundle_item) ? group.bundle_item : Array.isArray(group == null ? void 0 : group.bundleItem) ? group.bundleItem : [];
+      return items.map((item) => ({
+        ...item,
+        group_id: (item == null ? void 0 : item.group_id) ?? (group == null ? void 0 : group.id),
+        bundle_group_id: (item == null ? void 0 : item.bundle_group_id) ?? (item == null ? void 0 : item.group_id) ?? (group == null ? void 0 : group.id)
+      }));
+    });
+  }
+  findAuthoritativeBundleItem(bundle, candidates) {
+    const bundleId = bundle.bundle_id ?? bundle.id;
+    if (bundleId != null) {
+      const matchedById = candidates.find((item) => String((item == null ? void 0 : item.bundle_id) ?? (item == null ? void 0 : item.id)) === String(bundleId));
+      if (matchedById)
+        return matchedById;
+    }
+    const productId = bundle.bundle_product_id ?? bundle._bundle_product_id;
+    const groupId = bundle.bundle_group_id ?? bundle.group_id;
+    return candidates.find((item) => {
+      const itemProductId = (item == null ? void 0 : item.bundle_product_id) ?? (item == null ? void 0 : item._bundle_product_id);
+      const itemGroupId = (item == null ? void 0 : item.bundle_group_id) ?? (item == null ? void 0 : item.group_id);
+      if (productId == null || String(itemProductId) !== String(productId))
+        return false;
+      if (groupId == null)
+        return true;
+      return String(itemGroupId) === String(groupId);
+    }) || null;
+  }
+  getAuthoritativeBundleUnitPrice(bundle) {
+    return bundle.price ?? bundle.bundle_selling_price ?? bundle.custom_price ?? bundle.product_price ?? bundle.base_price;
+  }
+  mergeProductForPriceQuery(product, authoritativeProduct) {
+    if (!authoritativeProduct)
+      return product;
+    const selectedBundles = Array.isArray(product.product_bundle) ? product.product_bundle : [];
+    const authoritativeBundles = this.getAuthoritativeBundleItems(authoritativeProduct);
+    const productBundle = selectedBundles.map((bundle) => {
+      const authoritativeBundle = this.findAuthoritativeBundleItem(bundle, authoritativeBundles);
+      const unitPrice = authoritativeBundle ? this.getAuthoritativeBundleUnitPrice(authoritativeBundle) : void 0;
+      if (unitPrice === void 0 || unitPrice === null || unitPrice === "")
+        return bundle;
+      return {
+        ...bundle,
+        price: unitPrice,
+        bundle_selling_price: unitPrice,
+        base_price: (authoritativeBundle == null ? void 0 : authoritativeBundle.base_price) ?? bundle.base_price,
+        product_price: (authoritativeBundle == null ? void 0 : authoritativeBundle.product_price) ?? bundle.product_price
+      };
+    });
+    return {
+      ...product,
+      ...authoritativeProduct,
+      id: product.id ?? authoritativeProduct.id,
+      product_id: product.product_id ?? authoritativeProduct.product_id ?? authoritativeProduct.id,
+      product_variant_id: product.product_variant_id ?? authoritativeProduct.product_variant_id ?? 0,
+      num: product.num ?? product.quantity ?? authoritativeProduct.num,
+      quantity: product.quantity ?? product.num ?? authoritativeProduct.quantity,
+      product_sku: (() => {
+        const authoritativeSku = (0, import_utils.ensureProductSku)(authoritativeProduct);
+        const productSku = (0, import_utils.ensureProductSku)(product);
+        const hasProductSku = product.product_sku && typeof product.product_sku === "object";
+        return {
+          ...authoritativeSku,
+          ...productSku,
+          option: hasProductSku ? productSku.option : authoritativeSku.option
+        };
+      })(),
+      product_bundle: productBundle,
+      metadata: product.metadata ?? authoritativeProduct.metadata
+    };
+  }
+  getSubmitOrderSalesChannel() {
+    var _a;
+    return (_a = this.otherParams) == null ? void 0 : _a.channel;
+  }
   /**
    * 工厂入口：根据子模块名实例化对应模块。
    * 默认使用 BookingByStep 公共 `createModule`。子类若需引入额外类型（如 customer），
    * 可覆盖此方法并把未识别的 name 委托给 `super.createSubModule(name)`。
    */
   createSubModule(moduleName) {
-    return (0, import_types.createModule)(moduleName, this.name);
+    if (moduleName === "quotation") {
+      return new import_Quotation.QuotationModule(`${this.name}_quotation`);
+    }
+    return (0, import_types2.createModule)(moduleName, this.name);
   }
   getSubModuleHooks(moduleName) {
     var _a, _b;
@@ -123,6 +425,43 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     }
     return optionHooks[moduleName] || ((_b = this.otherParams[moduleName]) == null ? void 0 : _b.hooks) || otherHooks[moduleName];
   }
+  /**
+   * 构造传给 BaseSales 子模块的完整运行态参数，保证初始化和后续同步语义一致。
+   *
+   * @example
+   * const params = this.buildSubModuleOtherParams();
+   * this.core.registerModule(orderModule, { otherParams: params });
+   */
+  buildSubModuleOtherParams() {
+    return {
+      ...this.otherParams,
+      salesSummaryModuleName: `${this.name}_salesSummary`,
+      fatherModule: this.name,
+      openCache: this.cacheId ? true : false,
+      cacheId: this.cacheId
+    };
+  }
+  /**
+   * 将父级 otherParams 的变更显式同步给已注册的子模块。
+   *
+   * @example
+   * await this.syncOtherParamsToSubModules({ channel: 'pos' });
+   */
+  async syncOtherParamsToSubModules(changedParams, { cover = false } = {}) {
+    const nextSubModuleOtherParams = this.buildSubModuleOtherParams();
+    await Promise.all(
+      Object.values(this.store).map(async (subModule) => {
+        const targetModule = subModule;
+        if (!targetModule || typeof targetModule.updateOtherParams !== "function") {
+          return;
+        }
+        await targetModule.updateOtherParams(nextSubModuleOtherParams, {
+          changedParams,
+          cover
+        });
+      })
+    );
+  }
   /**
    * 读取 sessionStorage[this.name][cacheId]，作为子模块 initialState 的来源。
    * sessionStorage 损坏时静默忽略，按空状态注册。
@@ -140,19 +479,64 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       return {};
     }
   }
+  getAppData(key) {
+    var _a, _b, _c, _d, _e, _f;
+    const getData = (_b = (_a = this.appPlugin).getData) == null ? void 0 : _b.call(_a);
+    if (typeof getData === "function")
+      return getData(key);
+    const app = this.appPlugin.getApp();
+    const coreData = (_f = (_d = (_c = app == null ? void 0 : app.models) == null ? void 0 : _c.getStore) == null ? void 0 : (_e = _d.call(_c)).getDataByModel) == null ? void 0 : _f.call(_e, "core", "core");
+    return coreData == null ? void 0 : coreData[key];
+  }
+  syncAppDataToTempOrder(tempOrder) {
+    const isPriceIncludeTax = this.getAppData("is_price_include_tax");
+    const taxCountryCode = this.getAppData("tax_country_code");
+    const currencyCode = this.getAppData("shop_currency_code");
+    const currencySymbol = this.getAppData("shop_symbol");
+    let isChanged = false;
+    if (isPriceIncludeTax !== void 0) {
+      const nextIsPriceIncludeTax = Number(isPriceIncludeTax);
+      if ((nextIsPriceIncludeTax === 0 || nextIsPriceIncludeTax === 1) && tempOrder.is_price_include_tax !== nextIsPriceIncludeTax) {
+        tempOrder.is_price_include_tax = nextIsPriceIncludeTax;
+        isChanged = true;
+      }
+    }
+    if (taxCountryCode !== void 0) {
+      const nextTaxCountryCode = String(taxCountryCode || "");
+      if (tempOrder.tax_country_code !== nextTaxCountryCode) {
+        tempOrder.tax_country_code = nextTaxCountryCode;
+        isChanged = true;
+      }
+    }
+    if (currencyCode !== void 0) {
+      const nextCurrencyCode = String(currencyCode || "");
+      if (tempOrder.currency_code !== nextCurrencyCode) {
+        tempOrder.currency_code = nextCurrencyCode;
+        isChanged = true;
+      }
+    }
+    if (currencySymbol !== void 0) {
+      const nextCurrencySymbol = String(currencySymbol || "");
+      if (tempOrder.currency_symbol !== nextCurrencySymbol) {
+        tempOrder.currency_symbol = nextCurrencySymbol;
+        isChanged = true;
+      }
+    }
+    return isChanged;
+  }
   async initialize(core, options = {}) {
-    var _a;
+    var _a, _b;
     this.core = core;
     this.initializeOptions = options || {};
     this.otherParams = options.otherParams || {};
     this.cacheId = (_a = this.otherParams) == null ? void 0 : _a.cacheId;
     this.window = core.getPlugin("window");
     this.request = core.getPlugin("request");
-    const appPlugin = core.getPlugin("app");
-    if (!appPlugin) {
+    this.appPlugin = core.getPlugin("app");
+    if (!this.appPlugin) {
       throw new Error("Checkout 解决方案需要 app 插件支持");
     }
-    const app = appPlugin.getApp();
+    const app = this.appPlugin.getApp();
     this.logger = app.logger;
     const targetCacheData = this.readSessionCacheData();
     const moduleNames = this.getRegisteredModuleNames();
@@ -166,18 +550,18 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       this.core.registerModule(targetModule, {
         initialState: (targetCacheData == null ? void 0 : targetCacheData[targetModule.name]) || {},
         ...hooks ? { hooks } : {},
-        otherParams: {
-          ...this.otherParams,
-          salesSummaryModuleName: `${this.name}_salesSummary`,
-          fatherModule: this.name,
-          openCache: this.cacheId ? true : false,
-          cacheId: this.cacheId
-        }
+        otherParams: this.buildSubModuleOtherParams()
       });
     });
     if (this.store.schedule) {
       await this.store.schedule.loadAllSchedule();
     }
+    if (this.store.order && typeof ((_b = this.otherParams) == null ? void 0 : _b.enableTempOrderPersist) === "boolean") {
+      this.store.order.setEnableTempOrderPersist(
+        this.otherParams.enableTempOrderPersist
+      );
+    }
+    await this.getPaymentMethodsAsync();
     this.core.effects.emit(`${this.name}:onInited`, {});
   }
   async destroy() {
@@ -197,7 +581,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   }
   /**
    * 加载销售订单到统一 tempOrder 工作区。
-   * 有 app.sqlite 时优先读取本地记录；本地未命中或 forceRemote=true 时再拉云端。
+   * 统一通过 OrderModule 的 sales detail lookup 加载订单详情。
    *
    * 子类可在 `super.loadSalesDetail` 之后基于返回的 `sales` 做业务侧装配
    * （比如把 `sales.customer` 写入 CustomerModule、emit 业务 hook 等）。
@@ -207,25 +591,21 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("order 模块未初始化");
     const params = typeof orderIdOrParams === "object" ? orderIdOrParams : { orderId: orderIdOrParams };
     const externalSaleNumber = params.externalSaleNumber || params.external_sale_number;
-    if (!params.forceRemote) {
-      const localRecord = params.orderId !== void 0 ? await this.store.order.getLocalOrderByOrderId(params.orderId) : externalSaleNumber ? await this.store.order.getLocalOrderByExternalSaleNumber(externalSaleNumber) : params.orderNumber ? await this.store.order.getLocalOrderByOrderNumber(params.orderNumber) : null;
-      if (localRecord) {
-        const sales2 = await this.store.order.hydrateTempOrderFromRecord(localRecord, { recalcOnHydrate: false });
-        this.currentSalesDetail = sales2;
-        await this.core.effects.emit(`${this.name}:onSalesOrderLoaded`, { sales: sales2 });
-        return sales2;
-      }
-    }
-    if (params.orderId === void 0 || params.orderId === null) {
-      throw new Error("加载销售详情需要 orderId，或本地库中存在对应 externalSaleNumber/orderNumber");
+    const lookup = params.orderId ?? externalSaleNumber ?? params.orderNumber;
+    if (lookup === void 0 || lookup === null || lookup === "") {
+      throw new Error("加载销售详情需要 orderId、externalSaleNumber 或 orderNumber");
     }
-    const res = await this.store.order.getOrderInfoByRemote(Number(params.orderId));
+    const res = await this.store.order.getSalesOrderByLookup({
+      lookup,
+      forceRemote: params.forceRemote
+    });
     if (!res || res.code !== 200) {
-      const message = res && (res.message || res.msg) || `加载销售详情失败: ${params.orderId}`;
+      const message = res && (res.message || res.msg) || `加载销售详情失败: ${lookup}`;
       throw new Error(message);
     }
-    const sales = await this.store.order.hydrateTempOrderFromRecord(res.data, { recalcOnHydrate: false });
-    await this.store.order.saveDraft();
+    const currentTempOrder = params.merge ? this.store.order.getTempOrder() : null;
+    const record = params.merge ? mergeSalesDetailRecordWithTempOrder(currentTempOrder, res.data) : res.data;
+    const sales = await this.store.order.hydrateTempOrderFromRecord(record, { recalcOnHydrate: false });
     this.currentSalesDetail = sales;
     await this.core.effects.emit(`${this.name}:onSalesOrderLoaded`, { sales });
     return sales;
@@ -286,6 +666,13 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     const result = ((_a = this.store.order) == null ? void 0 : _a.getTempOrder()) || null;
     return result;
   }
+  async replaceTempOrder(tempOrder) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const nextTempOrder = await this.store.order.replaceTempOrder(tempOrder);
+    await this.effectsEmit("onTempOrderReplaced", { tempOrder: nextTempOrder });
+    return nextTempOrder;
+  }
   getOrderIdentity() {
     if (!this.store.order)
       return null;
@@ -311,26 +698,48 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       return "";
     return this.store.order.getTempOrderNote();
   }
-  updateTempOrderNote(note) {
+  updateTempOrderNote(note, sync = false) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      const result = this.store.order.updateTempOrderNote(note);
+      const result = this.store.order.updateTempOrderNote(note, sync);
       return result;
     } catch (error) {
       throw error;
     }
   }
+  updateRemoteOrderNote(orderId, note) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    this.store.order.syncTempOrderNoteToRemote(orderId, note);
+  }
   updateTempOrderShopDiscount(amount) {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
     return this.store.order.updateTempOrderShopDiscount(amount);
   }
+  updateTempOrderDepositAmount(amount) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    return this.store.order.updateTempOrderDepositAmount(amount);
+  }
   updateTempOrderContactsInfo(contactsInfo) {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
     return this.store.order.updateTempOrderContactsInfo(contactsInfo);
   }
+  /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化。 */
+  setEnableTempOrderPersist(enabled) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    this.store.order.setEnableTempOrderPersist(enabled);
+  }
+  /** 是否允许 saveDraft 写入 IndexedDB 草稿。 */
+  isTempOrderPersistEnabled() {
+    if (!this.store.order)
+      return false;
+    return this.store.order.isTempOrderPersistEnabled();
+  }
   ensureTempOrder() {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
@@ -342,6 +751,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
       const tempOrder = await this.store.order.addNewOrder();
+      if (this.syncAppDataToTempOrder(tempOrder) && this.isTempOrderPersistEnabled()) {
+        this.store.order.persistTempOrder();
+        await this.store.order.saveDraft();
+      }
       return tempOrder;
     } catch (error) {
       throw error;
@@ -360,6 +773,43 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
         throw new Error("scanOrder 解决方案需要 order 模块支持");
       }
       const tempOrder = this.store.order.restoreOrder();
+      this.currentSalesDetail = null;
+      this.discountConfigCacheKey = null;
+      this.hasManualDiscountSelection = false;
+      await this.effectsEmit("onTempOrderReplaced", { tempOrder });
+      if (this.syncAppDataToTempOrder(tempOrder) && this.isTempOrderPersistEnabled()) {
+        this.store.order.persistTempOrder();
+        await this.store.order.saveDraft();
+      }
+      return tempOrder;
+    } catch (error) {
+      throw error;
+    }
+  }
+  /**
+   * 仅清空 tempOrder 购物车行（products / bookings / discount_list）。
+   * 同步清空内存中的 salesDetail 商品/预约视图，避免编辑态仍读到旧 bookings。
+   */
+  async clearOrderCartLines() {
+    try {
+      if (!this.store.order)
+        throw new Error("order 模块未初始化");
+      const tempOrder = await this.store.order.clearOrderCartLines();
+      if (this.currentSalesDetail) {
+        this.currentSalesDetail = {
+          ...this.currentSalesDetail,
+          products: [],
+          bookings: [],
+          rootBooking: null,
+          bookingsByProductUid: {},
+          discount_list: []
+        };
+      }
+      await this.effectsEmit("onTempOrderReplaced", { tempOrder });
+      if (this.syncAppDataToTempOrder(tempOrder) && this.isTempOrderPersistEnabled()) {
+        this.store.order.persistTempOrder();
+        await this.store.order.saveDraft();
+      }
       return tempOrder;
     } catch (error) {
       throw error;
@@ -381,6 +831,289 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw error;
     }
   }
+  getHistoricalProductDiscountList(products) {
+    const historyDiscountList = [];
+    products.forEach((item) => {
+      if (!this.isPersistedOrderProduct(item))
+        return;
+      (item.discount_list || []).forEach((discount) => {
+        var _a, _b, _c, _d, _e, _f;
+        const discountId = ((_a = discount.discount) == null ? void 0 : _a.resource_id) || discount.id;
+        if (!discountId || !["good_pass", "discount_card"].includes(discount.type))
+          return;
+        const quantity = item.quantity || item.num || item.product_quantity || 1;
+        const savedAmount = new import_decimal.default(discount.amount || 0).times(quantity).plus(((_b = discount == null ? void 0 : discount.metadata) == null ? void 0 : _b.product_discount_difference) || 0);
+        const index = historyDiscountList.findIndex((n) => n.id === discountId);
+        if (index !== -1) {
+          historyDiscountList[index] = {
+            ...historyDiscountList[index],
+            amount: new import_decimal.default(historyDiscountList[index].amount || 0).plus(discount.amount || 0).toNumber(),
+            savedAmount: savedAmount.plus(historyDiscountList[index].savedAmount || 0).toNumber()
+          };
+          return;
+        }
+        historyDiscountList.push({
+          ...discount,
+          id: discountId,
+          tag: discount.tag || discount.type,
+          name: discount.name || ((_d = (_c = discount.discount) == null ? void 0 : _c.title) == null ? void 0 : _d.auto),
+          format_title: ((_e = discount.discount) == null ? void 0 : _e.title) || discount.format_title,
+          isEditMode: true,
+          limited_relation_product_data: {},
+          savedAmount: savedAmount.toNumber(),
+          isAvailable: true,
+          isDisabled: true,
+          isSelected: true,
+          product_id: ((_f = discount.discount) == null ? void 0 : _f.product_id) || discount.product_id
+        });
+      });
+    });
+    return historyDiscountList;
+  }
+  isPersistedOrderProduct(product) {
+    const orderDetailId = product.order_detail_id ?? product.orderDetailId;
+    if (orderDetailId !== void 0 && orderDetailId !== null && orderDetailId !== "") {
+      return true;
+    }
+    const bookingId = product.booking_id ?? product.bookingId;
+    return bookingId !== void 0 && bookingId !== null && bookingId !== "";
+  }
+  mergeHistoricalDiscountList(discountList, products) {
+    const historyDiscountList = this.getHistoricalProductDiscountList(products);
+    const historyIds = new Set(historyDiscountList.map((discount) => discount.id));
+    return [
+      ...historyDiscountList,
+      ...(discountList || []).filter((discount) => !historyIds.has(discount.id))
+    ];
+  }
+  shouldSkipAutoApplyFetchedDiscountsInEditMode(params) {
+    if (params.discountAction !== "edit")
+      return false;
+    if (!params.products.length)
+      return false;
+    const hasDraftProduct = params.products.some((product) => !this.isPersistedOrderProduct(product));
+    if (hasDraftProduct)
+      return false;
+    const hasSelectedDiscount = params.currentDiscountList.some(
+      (discount) => discount.isSelected || discount.isEditMode || discount.isManualSelect
+    );
+    if (hasSelectedDiscount)
+      return false;
+    return !params.nextDiscountList.some(
+      (discount) => discount.isSelected || discount.isEditMode || discount.isManualSelect
+    );
+  }
+  mergeCurrentDiscountSelectionState(discountList, currentDiscountList) {
+    if (!currentDiscountList.length)
+      return discountList;
+    const currentDiscountMap = new Map(
+      currentDiscountList.map((discount) => [discount.id, discount])
+    );
+    return discountList.map((discount) => {
+      const currentDiscount = currentDiscountMap.get(discount.id);
+      if (!currentDiscount)
+        return discount;
+      if (currentDiscount.isManualSelect) {
+        return {
+          ...discount,
+          isSelected: false,
+          isManualSelect: true
+        };
+      }
+      if (currentDiscount.isSelected) {
+        return {
+          ...discount,
+          isSelected: true,
+          isManualSelect: false
+        };
+      }
+      return discount;
+    });
+  }
+  async loadDiscountConfig(params) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const tempOrder = this.store.order.ensureTempOrder();
+    const orderStore = this.store.order.store || {};
+    const discountModule = orderStore.discount;
+    const rulesModule = orderStore.rules;
+    const orderId = tempOrder.order_id || ((_b = (_a = this.getOrderIdentity) == null ? void 0 : _a.call(this)) == null ? void 0 : _b.orderId);
+    const customerId = Number(
+      (params == null ? void 0 : params.customerId) || tempOrder.customer_id || ((_c = tempOrder.customer) == null ? void 0 : _c.id) || ((_e = (_d = tempOrder._extend) == null ? void 0 : _d.customerSnapshot) == null ? void 0 : _e.id) || ((_g = (_f = tempOrder._extend) == null ? void 0 : _f.customerSnapshot) == null ? void 0 : _g.customer_id) || 0
+    );
+    const currentDiscountList = ((_h = discountModule == null ? void 0 : discountModule.getDiscountList) == null ? void 0 : _h.call(discountModule)) || [];
+    const originalDiscountList = ((_i = discountModule == null ? void 0 : discountModule.getOriginalDiscountList) == null ? void 0 : _i.call(discountModule)) || [];
+    const hasManualDiscountSelection = this.hasManualDiscountSelection || currentDiscountList.some((discount) => discount.isManualSelect);
+    const discountAction = (params == null ? void 0 : params.action) || (orderId ? "edit" : "create");
+    const discountConfigCacheKey = [
+      customerId,
+      discountAction,
+      Number(orderId) || 0
+    ].join(":");
+    let preparedDiscountList = [];
+    if (customerId && customerId !== 1) {
+      if (this.discountConfigCacheKey === discountConfigCacheKey) {
+        preparedDiscountList = originalDiscountList;
+      } else {
+        preparedDiscountList = await this.store.order.loadDiscountConfig({
+          customerId,
+          action: discountAction,
+          orderId: Number(orderId) || void 0,
+          apply: false
+        });
+        this.discountConfigCacheKey = discountConfigCacheKey;
+        await ((_j = discountModule == null ? void 0 : discountModule.setOriginalDiscountList) == null ? void 0 : _j.call(discountModule, preparedDiscountList));
+      }
+    }
+    if (hasManualDiscountSelection && currentDiscountList.length) {
+      return {
+        productList: tempOrder.products || [],
+        discountList: currentDiscountList
+      };
+    }
+    let nextDiscountList = this.mergeHistoricalDiscountList(
+      preparedDiscountList || ((_k = discountModule == null ? void 0 : discountModule.getDiscountList) == null ? void 0 : _k.call(discountModule)) || [],
+      tempOrder.products || []
+    );
+    nextDiscountList = this.mergeCurrentDiscountSelectionState(
+      nextDiscountList,
+      currentDiscountList
+    );
+    await (discountModule == null ? void 0 : discountModule.setDiscountList(nextDiscountList));
+    const shouldSkipAutoApplyFetchedDiscounts = this.shouldSkipAutoApplyFetchedDiscountsInEditMode({
+      discountAction,
+      products: tempOrder.products || [],
+      currentDiscountList,
+      nextDiscountList
+    });
+    if (shouldSkipAutoApplyFetchedDiscounts) {
+      const summary2 = await this.store.order.recalculateSummary({ createIfMissing: true });
+      this.store.order.persistTempOrder();
+      await this.effectsEmit("onDiscountApplied", {
+        productList: tempOrder.products || [],
+        discountList: nextDiscountList,
+        selectedDiscountList: tempOrder.discount_list || [],
+        tempOrder
+      });
+      return {
+        productList: tempOrder.products || [],
+        discountList: nextDiscountList
+      };
+    }
+    if (rulesModule) {
+      const holders = ((_l = tempOrder.holder) == null ? void 0 : _l.form_record_id) ? [{ form_record_id: tempOrder.holder.form_record_id }] : [];
+      const result = rulesModule.calcDiscount({
+        productList: tempOrder.products,
+        discountList: nextDiscountList,
+        holders,
+        isFormSubject: !!((_m = tempOrder.holder) == null ? void 0 : _m.type) && tempOrder.holder.type === "form",
+        orderTotalAmount: Number(((_n = orderStore.summary) == null ? void 0 : _n.total_amount) || 0)
+      }) || { productList: tempOrder.products, discountList: nextDiscountList };
+      if (result.productList) {
+        tempOrder.products = preserveManualProductDiscountProducts(
+          tempOrder.products,
+          result.productList
+        );
+      }
+      for (const product of tempOrder.products || []) {
+        const productUid = (_o = product.metadata) == null ? void 0 : _o.unique_identification_number;
+        const runtimeOrigin = productUid ? (_r = (_q = (_p = tempOrder._extend) == null ? void 0 : _p.productsByUid) == null ? void 0 : _q[productUid]) == null ? void 0 : _r.origin : void 0;
+        if ((runtimeOrigin == null ? void 0 : runtimeOrigin.isManualDiscount) || isBaseSalesManualProductDiscountProduct(product))
+          continue;
+        const totalPerUnitDiscount = (product.discount_list || []).reduce(
+          (sum, pd) => sum + Number(pd.amount || 0),
+          0
+        );
+        const optionSum = (0, import_utils.sumOptionUnitPrice)((0, import_utils.getProductSkuOptions)(product));
+        const sourcePrice = ((_s = product.metadata) == null ? void 0 : _s.source_product_price) ?? (((_t = product.metadata) == null ? void 0 : _t.main_product_original_price) != null ? new import_decimal.default(Number(product.metadata.main_product_original_price) || 0).minus(optionSum).toFixed(2) : product.original_price ?? "0");
+        const newSourceSellingPrice = new import_decimal.default(Number(sourcePrice) || 0).minus(totalPerUnitDiscount).toDecimalPlaces(2).toString();
+        const newMainSellingPrice = new import_decimal.default(Number(newSourceSellingPrice) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
+        if (product.metadata) {
+          product.metadata.main_product_selling_price = newMainSellingPrice;
+          product.metadata.price_schema_version = 2;
+        }
+        product.selling_price = (0, import_utils.composeLinePrice)({
+          mainPrice: newMainSellingPrice,
+          bundle: product.product_bundle
+        });
+      }
+      if (result.discountList) {
+        nextDiscountList = this.mergeHistoricalDiscountList(
+          result.discountList,
+          tempOrder.products || []
+        );
+        import_Order.OrderModule.populateSavedAmounts(tempOrder.products, nextDiscountList);
+        await (discountModule == null ? void 0 : discountModule.setDiscountList(nextDiscountList));
+        tempOrder.discount_list = nextDiscountList.filter((discount) => discount.isSelected);
+      }
+    }
+    const summary = await this.store.order.recalculateSummary({ createIfMissing: true });
+    this.store.order.persistTempOrder();
+    await this.effectsEmit("onDiscountApplied", {
+      productList: tempOrder.products || [],
+      discountList: nextDiscountList,
+      selectedDiscountList: tempOrder.discount_list || [],
+      tempOrder
+    });
+    return {
+      productList: tempOrder.products || [],
+      discountList: nextDiscountList
+    };
+  }
+  async bestDiscount(cb) {
+    var _a, _b, _c, _d, _e;
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    const tempOrder = this.store.order.ensureTempOrder();
+    const orderStore = this.store.order.store || {};
+    const discountModule = orderStore.discount;
+    const rulesModule = orderStore.rules;
+    const originalDiscountList = ((_a = discountModule == null ? void 0 : discountModule.getOriginalDiscountList) == null ? void 0 : _a.call(discountModule)) || this.getDiscountList();
+    const currentDiscountList = ((_b = discountModule == null ? void 0 : discountModule.getDiscountList) == null ? void 0 : _b.call(discountModule)) || [];
+    let nextDiscountList = this.mergeHistoricalDiscountList(
+      originalDiscountList || [],
+      tempOrder.products || []
+    );
+    let result = {
+      productList: tempOrder.products || [],
+      discountList: nextDiscountList
+    };
+    await (discountModule == null ? void 0 : discountModule.setDiscountList(nextDiscountList));
+    if (rulesModule) {
+      const holders = ((_c = tempOrder.holder) == null ? void 0 : _c.form_record_id) ? [{ form_record_id: tempOrder.holder.form_record_id }] : [];
+      result = rulesModule.calcDiscount({
+        productList: tempOrder.products,
+        discountList: nextDiscountList,
+        holders,
+        isFormSubject: !!((_d = tempOrder.holder) == null ? void 0 : _d.type) && tempOrder.holder.type === "form",
+        orderTotalAmount: Number(((_e = orderStore.summary) == null ? void 0 : _e.total_amount) || 0)
+      }) || result;
+      if (result.productList) {
+        tempOrder.products = preserveManualProductDiscountProducts(
+          tempOrder.products,
+          result.productList
+        );
+      }
+      if (result.discountList) {
+        nextDiscountList = this.mergeHistoricalDiscountList(
+          result.discountList,
+          tempOrder.products || []
+        );
+        import_Order.OrderModule.populateSavedAmounts(tempOrder.products, nextDiscountList);
+        await (discountModule == null ? void 0 : discountModule.setDiscountList(nextDiscountList));
+        tempOrder.discount_list = nextDiscountList.filter((discount) => discount.isSelected);
+        result = {
+          productList: tempOrder.products,
+          discountList: nextDiscountList
+        };
+      }
+    }
+    await this.store.order.recalculateSummary({ createIfMissing: true });
+    this.store.order.persistTempOrder();
+    cb == null ? void 0 : cb(result);
+    return result;
+  }
   getDiscountList() {
     if (!this.store.order)
       return [];
@@ -406,7 +1139,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   }
   // TODO 需要优化，这段逻辑太长了，里面应该有些历史遗留问题
   async setDiscountSelected(params) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
@@ -418,6 +1151,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
           isManualSelect: !params.isSelected
         } : d
       );
+      this.hasManualDiscountSelection = true;
       const tempOrder = this.store.order.ensureTempOrder();
       const orderStore = this.store.order.store || {};
       const discountModule = orderStore.discount;
@@ -439,7 +1173,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
           }
         ) || { productList: tempOrder.products, discountList: updated };
         if (result == null ? void 0 : result.productList) {
-          tempOrder.products = result.productList;
+          tempOrder.products = preserveManualProductDiscountProducts(
+            tempOrder.products,
+            result.productList
+          );
         }
         if (result == null ? void 0 : result.discountList) {
           nextDiscountList = result.discountList;
@@ -450,6 +1187,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
             for (const d of nextDiscountList) {
               if (d.isSelected && !beforeSelectedIds.has(d.id)) {
                 d.isSelected = false;
+                d.isManualSelect = true;
               }
             }
           }
@@ -461,7 +1199,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       for (const product of tempOrder.products) {
         const productUid = (_c = product.metadata) == null ? void 0 : _c.unique_identification_number;
         const runtimeOrigin = productUid ? (_f = (_e = (_d = tempOrder._extend) == null ? void 0 : _d.productsByUid) == null ? void 0 : _e[productUid]) == null ? void 0 : _f.origin : void 0;
-        if ((runtimeOrigin == null ? void 0 : runtimeOrigin.isManualDiscount) || ((_g = product.metadata) == null ? void 0 : _g.is_manual_discount))
+        if ((runtimeOrigin == null ? void 0 : runtimeOrigin.isManualDiscount) || isBaseSalesManualProductDiscountProduct(product))
           continue;
         product.discount_list = (product.discount_list || []).filter((pd) => {
           var _a2;
@@ -472,8 +1210,8 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
           (sum, pd) => sum + (pd.amount || 0),
           0
         );
-        const optionSum = (0, import_utils.sumOptionUnitPrice)(product.product_option_item);
-        const sourcePrice = ((_h = product.metadata) == null ? void 0 : _h.source_product_price) ?? (((_i = product.metadata) == null ? void 0 : _i.main_product_original_price) != null ? new import_decimal.default(Number(product.metadata.main_product_original_price) || 0).minus(optionSum).toFixed(2) : product.original_price ?? "0");
+        const optionSum = (0, import_utils.sumOptionUnitPrice)((0, import_utils.getProductSkuOptions)(product));
+        const sourcePrice = ((_g = product.metadata) == null ? void 0 : _g.source_product_price) ?? (((_h = product.metadata) == null ? void 0 : _h.main_product_original_price) != null ? new import_decimal.default(Number(product.metadata.main_product_original_price) || 0).minus(optionSum).toFixed(2) : product.original_price ?? "0");
         const newSourceSellingPrice = new import_decimal.default(Number(sourcePrice) || 0).minus(totalPerUnitDiscount).toDecimalPlaces(2).toString();
         const newMainSellingPrice = new import_decimal.default(Number(newSourceSellingPrice) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
         if (product.metadata) {
@@ -490,6 +1228,43 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       tempOrder.discount_list = (nextDiscountList || []).filter((d) => d.isSelected);
       await this.store.order.recalculateSummary({ createIfMissing: true });
       this.store.order.persistTempOrder();
+      this.effectsEmit("onDiscountApplied", {
+        productList: tempOrder.products,
+        discountList: nextDiscountList,
+        selectedDiscountList: tempOrder.discount_list,
+        tempOrder
+      });
+    } catch (error) {
+      throw error;
+    }
+  }
+  async applyDiscountCalculationResult(result) {
+    try {
+      if (!this.store.order)
+        throw new Error("order 模块未初始化");
+      if (!result)
+        return;
+      const tempOrder = this.store.order.ensureTempOrder();
+      const orderStore = this.store.order.store || {};
+      const discountModule = orderStore.discount;
+      if (result.productList) {
+        tempOrder.products = preserveManualProductDiscountProducts(
+          tempOrder.products,
+          result.productList
+        );
+      }
+      if (result.discountList) {
+        import_Order.OrderModule.populateSavedAmounts(
+          tempOrder.products,
+          result.discountList
+        );
+        await (discountModule == null ? void 0 : discountModule.setDiscountList(result.discountList));
+        tempOrder.discount_list = result.discountList.filter(
+          (discount) => discount.isSelected
+        );
+      }
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      this.store.order.persistTempOrder();
     } catch (error) {
       throw error;
     }
@@ -508,30 +1283,142 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     if (!this.store.order) {
       throw new Error("BaseSales 解决方案需要 order 模块支持");
     }
-    this.store.order.persistTempOrder();
+    const inferredPaymentStatus = this.getSubmitPaymentStatus(params == null ? void 0 : params.paymentStatus);
     const submitParams = {
       cacheId: this.cacheId,
       platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
-      businessCode: (_b = this.otherParams) == null ? void 0 : _b.businessCode,
-      channel: (_c = this.otherParams) == null ? void 0 : _c.channel,
+      businessCode: ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
+      channel: this.getSubmitOrderSalesChannel(),
       type: (_d = this.otherParams) == null ? void 0 : _d.type,
+      request_unique_idempotency_token: this.store.order.generateIdempotencyToken(),
       ...(params == null ? void 0 : params.payments) !== void 0 ? { payments: params.payments } : {},
-      ...(params == null ? void 0 : params.paymentStatus) !== void 0 ? { paymentStatus: params.paymentStatus } : {},
+      ...inferredPaymentStatus !== void 0 ? { paymentStatus: inferredPaymentStatus } : {},
       ...(params == null ? void 0 : params.smallTicketDataFlag) !== void 0 ? { smallTicketDataFlag: params.smallTicketDataFlag } : {},
       ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
     };
     return this.store.order.submitTempOrder(submitParams);
   }
+  async submitTempOrderAsync(params) {
+    var _a, _b, _c, _d;
+    if (!this.store.order) {
+      throw new Error("BaseSales 解决方案需要 order 模块支持");
+    }
+    const inferredPaymentStatus = this.getSubmitPaymentStatus(params == null ? void 0 : params.paymentStatus);
+    const submitParams = {
+      cacheId: this.cacheId,
+      platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
+      businessCode: ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
+      channel: this.getSubmitOrderSalesChannel(),
+      type: (_d = this.otherParams) == null ? void 0 : _d.type,
+      ...(params == null ? void 0 : params.payments) !== void 0 ? { payments: params.payments } : {},
+      ...inferredPaymentStatus !== void 0 ? { paymentStatus: inferredPaymentStatus } : {},
+      ...(params == null ? void 0 : params.smallTicketDataFlag) !== void 0 ? { smallTicketDataFlag: params.smallTicketDataFlag } : {},
+      ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
+    };
+    return this.store.order.submitTempOrderAsync(submitParams);
+  }
+  async printLocalOrderReceipt(lookup) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    if (!this.store.order) {
+      throw new Error("BaseSales 解决方案需要 order 模块支持");
+    }
+    const hasLookup = lookup !== void 0 && lookup !== null && lookup !== "";
+    const lookupPayload = typeof lookup === "number" ? { order_id: lookup } : { external_sale_number: lookup };
+    const context = {
+      platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
+      businessCode: ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
+      channel: this.getSubmitOrderSalesChannel(),
+      type: (_d = this.otherParams) == null ? void 0 : _d.type
+    };
+    const payload = hasLookup ? {
+      ...lookupPayload,
+      lookup_order_from_db: 1,
+      small_ticket_data_flag: 1,
+      platform: context.platform,
+      business_code: context.businessCode,
+      order_sales_channel: context.channel,
+      type: context.type
+    } : this.store.order.buildCurrentSubmitPayloadForLocalPrint({
+      cacheId: this.cacheId,
+      platform: context.platform,
+      businessCode: context.businessCode,
+      channel: context.channel,
+      type: context.type
+    });
+    const response = await this.request.post("/local/print-order", payload, {
+      osServer: true,
+      customToast: () => {
+      }
+    });
+    if (!hasLookup) {
+      await ((_g = (_f = this.store.order).applyLocalPrintOrderNumbers) == null ? void 0 : _g.call(_f, (_e = response == null ? void 0 : response.data) == null ? void 0 : _e.order));
+    }
+    return response;
+  }
+  getSubmitPaymentStatus(paymentStatus) {
+    var _a, _b;
+    if (paymentStatus !== void 0)
+      return paymentStatus;
+    const amountSnapshot = (_b = (_a = this.store.order) == null ? void 0 : _a.getOrderAmountSnapshot) == null ? void 0 : _b.call(_a);
+    if (!amountSnapshot)
+      return void 0;
+    try {
+      return new import_decimal.default(amountSnapshot.amountGap || 0).lte(0) ? "paid" : void 0;
+    } catch {
+      return void 0;
+    }
+  }
   async syncPaymentsToOrder(params) {
+    var _a, _b;
     if (!this.store.order)
       throw new Error("order 模块未初始化");
-    return this.store.order.syncPaymentsToOrder(params);
+    const businessCode = params.businessCode ?? ((_a = this.otherParams) == null ? void 0 : _a.businessCode) ?? ((_b = this.otherParams) == null ? void 0 : _b.business_code);
+    const channel = params.channel ?? this.getSubmitOrderSalesChannel();
+    const syncParams = {
+      ...params,
+      ...businessCode !== void 0 ? { businessCode } : {},
+      ...channel !== void 0 ? { channel } : {}
+    };
+    const syncState = this.store.order.getOrderSyncState();
+    if (params.submitWhenPaid && syncState === "submitting") {
+      return this.store.order.syncPaymentsToOrder(syncParams);
+    }
+    const payments = params.payments || [];
+    await this.effectsEmit(import_types.BaseSalesHookNames.onPaymentSyncStart, {
+      payments,
+      params: syncParams,
+      amountSnapshot: this.store.order.getOrderAmountSnapshot(),
+      orderSnapshot: this.store.order.getOrderSnapshot()
+    });
+    try {
+      const syncResult = await this.store.order.syncPaymentsToOrder(syncParams);
+      await this.effectsEmit(import_types.BaseSalesHookNames.onPaymentSyncEnd, {
+        ok: true,
+        syncResult,
+        payments: this.store.order.getOrderPayments(),
+        params: syncParams,
+        amountSnapshot: this.store.order.getOrderAmountSnapshot(),
+        orderSnapshot: this.store.order.getOrderSnapshot()
+      });
+      return syncResult;
+    } catch (error) {
+      await this.effectsEmit(import_types.BaseSalesHookNames.onPaymentSyncEnd, {
+        ok: false,
+        error,
+        payments: this.store.order.getOrderPayments(),
+        params: syncParams,
+        amountSnapshot: this.store.order.getOrderAmountSnapshot(),
+        orderSnapshot: this.store.order.getOrderSnapshot()
+      });
+      throw error;
+    }
   }
   /** 读取当前 BaseSales 订单上下文中的 Sales 协议支付项。 */
   getOrderPayments() {
     if (!this.store.order)
       return [];
-    return this.store.order.getOrderPayments();
+    const payments = this.store.order.getOrderPayments();
+    return this.hydrateOrderPaymentNames(payments);
   }
   /** 覆盖当前订单支付项，内部由 OrderModule 清洗为 Sales 协议字段。 */
   setOrderPayments(payments) {
@@ -541,9 +1428,51 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   }
   /** 追加单个支付项到当前订单。 */
   addOrderPayment(payment) {
+    var _a;
     if (!this.store.order)
       throw new Error("order 模块未初始化");
-    return this.store.order.addOrderPayment(payment);
+    const paymentRecord = payment;
+    const paymentAmount = new import_decimal.default(paymentRecord.amount || 0);
+    if (paymentAmount.isZero()) {
+      this.logWarning("addOrderPayment: 支付金额为 0，跳过添加支付项", {
+        payment: paymentRecord
+      });
+      return this.store.order.getOrderPayments();
+    }
+    const metadata = paymentRecord.metadata && typeof paymentRecord.metadata === "object" ? { ...paymentRecord.metadata } : {};
+    const shopWalletPassId = (_a = this.otherParams) == null ? void 0 : _a.shop_wallet_pass_id;
+    if (shopWalletPassId !== void 0 && shopWalletPassId !== null) {
+      metadata.shop_wallet_pass_id = shopWalletPassId;
+    }
+    if (!metadata.unique_payment_number) {
+      metadata.unique_payment_number = (0, import_utils.createUuidV4)();
+    }
+    const paymentTimestamp = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
+    const paymentTime = paymentRecord.payment_time ?? paymentTimestamp;
+    const createdAt = paymentRecord.created_at ?? paymentTimestamp;
+    const payments = this.store.order.addOrderPayment({
+      ...paymentRecord,
+      metadata,
+      payment_time: paymentTime,
+      created_at: createdAt
+    });
+    const amountSnapshot = this.store.order.getOrderAmountSnapshot();
+    const syncState = this.store.order.getOrderSyncState();
+    if (amountSnapshot && syncState !== "submitting") {
+      const paymentStatus = Number(amountSnapshot.amountGap || 0) <= 0 ? "paid" : "partially_paid";
+      void this.syncPaymentsToOrder({
+        payments,
+        paymentStatus,
+        submitWhenPaid: true,
+        smallTicketDataFlag: 1
+      }).catch((error) => {
+        this.logError("auto sync payments failed", {
+          error: error instanceof Error ? error.message : String(error)
+        });
+      });
+    } else {
+    }
+    return payments;
   }
   /** 更新当前订单中的指定支付项。 */
   updateOrderPayment(paymentIdentity, updates) {
@@ -564,11 +1493,12 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     return this.store.order.updateVoucherOrderPayments(payments);
   }
   getWalletProductList() {
-    var _a, _b;
+    var _a, _b, _c;
     const tempOrder = (_a = this.store.order) == null ? void 0 : _a.getTempOrder();
     if (!((_b = tempOrder == null ? void 0 : tempOrder.products) == null ? void 0 : _b.length))
       return [];
-    return tempOrder.products.map((product) => {
+    const products = (_c = tempOrder == null ? void 0 : tempOrder.products) == null ? void 0 : _c.filter((n) => n.product_id);
+    const walletProducts = products.map((product) => {
       const metadata = product.metadata || {};
       return {
         product_id: product.product_id,
@@ -578,6 +1508,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
         is_charge_tax: product.is_charge_tax ?? 0,
         tax_fee: product.tax_fee,
         selling_price: Number(product.selling_price || 0),
+        discount_list: product.discount_list || [],
         holder_id: product.holder_id ?? metadata.holder_id,
         original_price: product.original_price,
         main_product_original_price: metadata.main_product_original_price ?? product.original_price,
@@ -591,8 +1522,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
           const bundleMetadata = bundle.metadata || {};
           return {
             is_price_include_tax: tempOrder.is_price_include_tax,
-            bundle_id: bundle.bundle_id,
-            bundle_product_id: bundle.bundle_product_id,
+            // 套餐子项在 tempOrder 上常为 id（如 1718），prepare/deduction 协议要求 bundle_id
+            bundle_id: bundle.bundle_id ?? bundle.id,
+            bundle_product_id: bundle.bundle_product_id ?? bundle._bundle_product_id,
+            bundle_group_id: bundle.bundle_group_id ?? bundle.group_id,
             bundle_variant_id: bundle.bundle_variant_id,
             price_type: bundle.price_type,
             price_type_ext: bundle.price_type_ext,
@@ -609,6 +1542,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
         })
       };
     });
+    return walletProducts;
   }
   async initWalletData(params) {
     if (!this.store.order)
@@ -672,11 +1606,25 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   }
   /** 获取可用支付方式列表，供 PaymentModal 渲染支付选项。 */
   async getPaymentMethodsAsync() {
-    if (this.store.payment) {
-      return this.store.payment.getPayMethodListAsync();
+    try {
+      const response = await this.request.get("/pay/custom-payment/all", {
+        filterPaymentMethods: true
+      }, {
+        osServer: true
+      });
+      const paymentMethods = (response == null ? void 0 : response.data) || [];
+      this.paymentMethodsCache = Array.isArray(paymentMethods) ? [...paymentMethods] : [];
+      return this.getPaymentMethods();
+    } catch (error) {
+      this.logWarning("getPaymentMethodsAsync: 获取支付方式列表失败，使用缓存列表", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return this.getPaymentMethods();
     }
-    const response = await this.request.get("/pay/custom-payment/all");
-    return (response == null ? void 0 : response.data) || [];
+  }
+  /** 同步读取初始化时缓存的支付方式列表。 */
+  getPaymentMethods() {
+    return [...this.paymentMethodsCache];
   }
   /** 轻量舍入能力，供现金支付 UI 计算 rounding_amount。 */
   roundAmount(params) {
@@ -731,6 +1679,24 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   transformBaseProductToOrderProduct(params) {
     return (0, import_transformBaseProductToOrderProduct.transformBaseProductToOrderProduct)(params);
   }
+  async calculateProductBookingPrice(params) {
+    const quotation = this.store.quotation;
+    const customerId = params.customer_id ?? this.getCurrentOrderCustomerId();
+    const authoritativeProduct = await this.loadProductForPriceQuery(params, customerId);
+    const product = this.mergeProductForPriceQuery(params.product, authoritativeProduct);
+    await this.loadQuotationForPriceQuery({
+      quotation,
+      customer_id: customerId,
+      channel: params.channel
+    });
+    return (0, import_quotationPrice.calculateBaseSalesProductBookingPrice)({
+      ...params,
+      product,
+      fallback_price: authoritativeProduct ? void 0 : params.fallback_price,
+      customer_id: customerId,
+      quotation
+    });
+  }
   async addProductToOrder(product, booking) {
     try {
       if (!this.store.order)
@@ -741,16 +1707,35 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw error;
     }
   }
-  async updateProductInOrder(params) {
+  async updateOrderProduct(params) {
+    try {
+      if (!this.store.order)
+        throw new Error("order 模块未初始化");
+      const products = await this.store.order.updateOrderProduct(params);
+      return products;
+    } catch (error) {
+      throw error;
+    }
+  }
+  async updateOrderProductQuantity(params) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      const products = await this.store.order.updateProductInOrder(params);
+      const products = await this.store.order.updateOrderProductQuantity(params);
       return products;
     } catch (error) {
       throw error;
     }
   }
+  updateOrderBooking(params) {
+    try {
+      if (!this.store.order)
+        throw new Error("order 模块未初始化");
+      return this.store.order.updateOrderBooking(params);
+    } catch (error) {
+      throw error;
+    }
+  }
   /**
    * 设置单行商品备注（与整单 `updateTempOrderNote` 区分）。
    * 多行同 SKU 时必须传入与删除/更新一致的 unique_identification_number。
@@ -765,27 +1750,87 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       if (identity.unique_identification_number !== void 0) {
         params.unique_identification_number = identity.unique_identification_number;
       }
-      if (identity.product_option_item !== void 0) {
-        params.product_option_item = identity.product_option_item;
+      if (identity.product_sku !== void 0) {
+        params.product_sku = identity.product_sku;
       }
       if (identity.product_bundle !== void 0)
         params.product_bundle = identity.product_bundle;
-      const products = await this.updateProductInOrder(params);
+      const products = await this.updateOrderProduct(params);
       return products;
     } catch (error) {
       throw error;
     }
   }
-  async removeProductFromOrder(identity) {
+  /**
+   * 批量删除购物车行，末尾仅一次促销重算。
+   *
+   * @example
+   * await baseSales.removeProductsFromOrder([identityA, identityB]);
+   */
+  async removeProductsFromOrder(identities) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      const products = await this.store.order.removeProductFromOrder(identity);
-      return products;
+      return await this.store.order.removeProductsFromOrder(identities);
     } catch (error) {
       throw error;
     }
   }
+  async removeProductFromOrder(identity) {
+    return this.removeProductsFromOrder([identity]);
+  }
+  // ─── 促销/赠品 透传（迁移自 booking usePromotion） ────────────────
+  /**
+   * 注入促销评估器到底层 OrderModule。
+   *
+   * @example
+   * solution.setPromotionEvaluator(appHelper.utils.promotionEvaluator);
+   */
+  setPromotionEvaluator(evaluator) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    this.store.order.setPromotionEvaluator(evaluator);
+  }
+  /**
+   * 注入赠品选择 resolver。UI 层（SalesSdk）通过 bridge 提供。
+   *
+   * @example
+   * solution.setGiftSelectResolver(async (ctx) => bridge.request(ctx));
+   */
+  setGiftSelectResolver(resolver) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    this.store.order.setGiftSelectResolver(resolver);
+  }
+  /**
+   * 为商品目录追加促销标签，供 SalesSdkProductProvider 等商品列表入口复用。
+   *
+   * @example
+   * const products = solution.appendPromotionTags(catalogProducts);
+   */
+  appendPromotionTags(products) {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    return this.store.order.appendPromotionTags(products);
+  }
+  /**
+   * 主动触发一次促销应用（一般写路径会自动触发，少数场景如客户切换后可手动调）。
+   */
+  async applyPromotion() {
+    if (!this.store.order)
+      throw new Error("order 模块未初始化");
+    await this.store.order.applyPromotion();
+  }
+  /** 最近一次促销计算输出的未满足提示。 */
+  getUnfulfilledPromotions() {
+    var _a;
+    return ((_a = this.store.order) == null ? void 0 : _a.getUnfulfilledPromotions()) || [];
+  }
+  /** 最近一次促销计算输出的赠品操作 diff。 */
+  getLastGiftActions() {
+    var _a;
+    return ((_a = this.store.order) == null ? void 0 : _a.getLastGiftActions()) || null;
+  }
   // 获取商品列表
   // TODO 需要跟 webpos 内的对齐一下
   async getProductList() {
@@ -807,11 +1852,14 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     return this.otherParams;
   }
   async setOtherParams(params, { cover = false } = {}) {
+    var _a;
     if (cover) {
-      this.otherParams = params;
+      this.otherParams = { ...params };
     } else {
       this.otherParams = { ...this.otherParams, ...params };
     }
+    this.cacheId = (_a = this.otherParams) == null ? void 0 : _a.cacheId;
+    await this.syncOtherParamsToSubModules(params, { cover });
   }
 };
 // Annotate the CommonJS export names for ESM import in node: