@pisell/pisellos 2.2.302 → 2.2.303

package/lib/solution/Sales/index.js

@@ -9,6 +9,7 @@ var _exportNames = {
 };
 exports.default = exports.SalesImpl = exports.Sales = void 0;
 var _dayjs = _interopRequireDefault(require("dayjs"));
+var _lodashEs = require("lodash-es");
 var _BaseModule = require("../../modules/BaseModule");
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
@@ -22,8 +23,11 @@ Object.keys(_types).forEach(function (key) {
     }
   });
 });
+var _OpenData = require("../../modules/OpenData");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const UNPAID_PAYMENT_STATUSES = new Set(['unpaid', 'partially_paid', 'payment_processing']);
+const INVOICE_OPEN_DATA_SECTION_CODES = ['documents'];
+const INVOICE_OPEN_DATA_CACHE_TTL = 5 * 60 * 1000;
 
 /**
  * Sales 解决方案基础骨架
@@ -46,11 +50,22 @@ class SalesImpl extends _BaseModule.BaseModule {
   otherParams = {};
   request;
   logger; // LoggerManager 实例
-
+  invoiceOpenDataModule = null;
+  invoiceOpenDataTarget = null;
+  invoiceOpenDataInFlight = null;
+  invoiceOpenDataInFlightTarget = null;
   constructor(name, version) {
     super(name, version);
   }
   async initialize(core, options = {}) {
+    if (this.invoiceOpenDataModule) {
+      try {
+        this.clearOpenDataCache();
+        this.invoiceOpenDataModule.destroy();
+      } catch (error) {
+        console.warn('[Sales] 旧 Invoice OpenData 子模块销毁失败', error);
+      }
+    }
     this.core = core;
     this.options = options;
     this.otherParams = options.otherParams || {};
@@ -71,6 +86,18 @@ class SalesImpl extends _BaseModule.BaseModule {
     // 在这里补充从 Server/Order 读取 currentDay 原始数据并转换为预约列表。
 
     this.logger = appPlugin?.getApp().logger;
+    this.invoiceOpenDataTarget = null;
+    this.invoiceOpenDataInFlight = null;
+    this.invoiceOpenDataInFlightTarget = null;
+    this.invoiceOpenDataModule = new _OpenData.OpenDataModule(`${this.name}_invoiceOpenData`);
+    this.core.registerModule(this.invoiceOpenDataModule, {
+      initialState: {},
+      otherParams: {
+        fatherModule: this.name,
+        openCache: false,
+        platform: this.otherParams?.platform
+      }
+    });
     await this.core.effects.emit(`${this.name}:onInited`, {});
   }
 
@@ -139,11 +166,151 @@ class SalesImpl extends _BaseModule.BaseModule {
     return orderModule.changeBookingStatus(params);
   }
 
+  /**
+   * 将显式 channel 或当前运行上下文归一为 Invoice OpenData 使用的销售入口。
+   * Legacy Sales 的系统上下文没有可打印的 system target，因此统一回退 pos。
+   */
+  getInvoiceSalesChannel(channel) {
+    const contextChannel = this.core?.context?.getChannel?.();
+    const normalized = String(channel ?? contextChannel ?? '').trim();
+    return !normalized || normalized === 'system' ? 'pos' : normalized;
+  }
+  async loadInvoiceOpenData(businessCode, channel) {
+    if (!this.invoiceOpenDataModule) {
+      throw new Error('Sales Invoice OpenData 模块未初始化');
+    }
+    const target = `${businessCode}+${channel}`;
+    const cachedData = this.invoiceOpenDataModule.getOpenData();
+    const lastFetchedAt = this.invoiceOpenDataModule.getLastFetchedAt();
+    if (cachedData && this.invoiceOpenDataTarget === target && typeof lastFetchedAt === 'number' && Date.now() - lastFetchedAt < INVOICE_OPEN_DATA_CACHE_TTL) {
+      if (typeof this.invoiceOpenDataModule.ensureInvoiceTemplateSettings === 'function') {
+        await this.invoiceOpenDataModule.ensureInvoiceTemplateSettings(target);
+      }
+      return cachedData;
+    }
+    if (this.invoiceOpenDataInFlight) {
+      if (this.invoiceOpenDataInFlightTarget === target) {
+        return this.invoiceOpenDataInFlight;
+      }
+      try {
+        await this.invoiceOpenDataInFlight;
+      } catch {
+        // 另一 target 的失败不应阻断当前 target 获取自己的 Documents 配置。
+      }
+      return this.loadInvoiceOpenData(businessCode, channel);
+    }
+    const request = this.invoiceOpenDataModule.fetchOpenData({
+      scope: 'board',
+      target,
+      section_code: [...INVOICE_OPEN_DATA_SECTION_CODES]
+    });
+    this.invoiceOpenDataInFlight = request;
+    this.invoiceOpenDataInFlightTarget = target;
+    try {
+      const openData = await request;
+      // clearOpenDataCache() 或后续请求接管后，旧响应不得复活 target 归属。
+      if (this.invoiceOpenDataInFlight === request) {
+        this.invoiceOpenDataTarget = target;
+      }
+      return openData;
+    } finally {
+      if (this.invoiceOpenDataInFlight === request) {
+        this.invoiceOpenDataInFlight = null;
+        this.invoiceOpenDataInFlightTarget = null;
+      }
+    }
+  }
+  logInvoiceOpenDataFallback(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (this.logger?.addLog) {
+      this.logger.addLog({
+        type: 'warning',
+        title: 'Sales Invoice OpenData 加载失败，使用默认配置',
+        metadata: {
+          message
+        }
+      });
+      return;
+    }
+    console.warn('[Sales] Invoice OpenData 加载失败，使用默认配置', error);
+  }
+  async resolveInvoiceConfigs(businessCode, channel) {
+    try {
+      await this.loadInvoiceOpenData(businessCode, channel);
+      if (this.invoiceOpenDataTarget !== `${businessCode}+${channel}`) {
+        return {
+          invoice: (0, _OpenData.getDefaultInvoiceLayoutConfig)(),
+          templateSettings: (0, _OpenData.getDefaultInvoiceTemplateSettings)()
+        };
+      }
+      return {
+        invoice: this.invoiceOpenDataModule?.getInvoiceLayoutConfig() ?? (0, _OpenData.getDefaultInvoiceLayoutConfig)(),
+        templateSettings: this.invoiceOpenDataModule?.getInvoiceTemplateSettings() ?? (0, _OpenData.getDefaultInvoiceTemplateSettings)()
+      };
+    } catch (error) {
+      this.logInvoiceOpenDataFallback(error);
+      return {
+        invoice: (0, _OpenData.getDefaultInvoiceLayoutConfig)(),
+        templateSettings: (0, _OpenData.getDefaultInvoiceTemplateSettings)()
+      };
+    }
+  }
+  async printLocalOrderReceipt(lookup, options) {
+    const normalizedLookup = typeof lookup === 'string' ? lookup.trim() : lookup;
+    if (normalizedLookup === '' || normalizedLookup === null || normalizedLookup === undefined) {
+      throw new Error('Sales 本地小票打印需要订单标识');
+    }
+    const businessCode = String(options?.businessCode ?? '').trim();
+    if (!businessCode) {
+      throw new Error('Sales 本地小票打印需要 businessCode');
+    }
+    const channel = this.getInvoiceSalesChannel(options?.channel);
+    const {
+      invoice,
+      templateSettings
+    } = await this.resolveInvoiceConfigs(businessCode, channel);
+    const lookupPayload = typeof normalizedLookup === 'number' ? {
+      order_id: normalizedLookup
+    } : {
+      external_sale_number: normalizedLookup
+    };
+    return this.request.post('/local/print-order', {
+      ...lookupPayload,
+      lookup_order_from_db: 1,
+      small_ticket_data_flag: 1,
+      business_code: businessCode,
+      order_sales_channel: channel,
+      invoice: (0, _lodashEs.cloneDeep)(invoice),
+      template_settings: (0, _lodashEs.cloneDeep)(templateSettings)
+    }, {
+      osServer: true,
+      customToast: () => {}
+    });
+  }
+
+  /** 清除独立 Documents 缓存；下一次打印会按当前 target 重新获取。 */
+  clearOpenDataCache() {
+    this.invoiceOpenDataInFlight = null;
+    this.invoiceOpenDataInFlightTarget = null;
+    this.invoiceOpenDataTarget = null;
+    this.invoiceOpenDataModule?.clearCache();
+  }
+
   // -------------------------------------------------------------------------
   // 生命周期
   // -------------------------------------------------------------------------
 
   async destroy() {
+    this.clearOpenDataCache();
+    const invoiceOpenDataModule = this.invoiceOpenDataModule;
+    this.invoiceOpenDataModule = null;
+    if (invoiceOpenDataModule) {
+      try {
+        await invoiceOpenDataModule.destroy();
+      } catch (error) {
+        console.warn('[Sales] Invoice OpenData 子模块销毁失败', error);
+      }
+    }
     await this.core.effects.emit(`${this.name}:onDestroy`, {});
     super.destroy();
   }

package/lib/solution/Sales/types.d.ts

@@ -50,6 +50,12 @@ export interface GetResourceBookingItemParams {
     bookingList: BookingData[];
     deviceTime?: string;
 }
+export interface SalesPrintLocalOrderReceiptOptions {
+    /** 当前销售业务类型，用于隔离 Documents Invoice 配置。 */
+    businessCode: string;
+    /** 当前销售入口；缺失或为 system 时按 pos 处理。 */
+    channel?: string;
+}
 /**
  * Sales 解决方案状态
  *
@@ -82,6 +88,10 @@ export interface SalesModuleAPI {
     cancelOrder: (orderIds: Array<number | string>) => Promise<any>;
     /** 变更预约状态 */
     changeBookingStatus: (params: ChangeBookingStatusParams) => Promise<any>;
+    /** 按本地订单标识打印小票；本地未命中时由 OS Server 负责远端兜底。 */
+    printLocalOrderReceipt: <T = any>(lookup: string | number, options: SalesPrintLocalOrderReceiptOptions) => Promise<T>;
+    /** 清除 Legacy Sales 独立维护的 Documents OpenData 缓存。 */
+    clearOpenDataCache: () => void;
     /** 获取资源维度的预约占用列表 */
     getResourceBookingList: (currentTime: string, bookingList: BookingData[], deviceTime?: string) => Promise<SalesResourceBookingItem[]>;
     /** 获取单个资源维度的预约占用、已完成、未支付列表 */

package/lib/solution/ScanOrder/index.d.ts

@@ -13,6 +13,7 @@ interface ScanOrderItemRuleRuntimeConfig {
     pax?: Partial<PaxInfo>;
     historicalItems?: CartItemSummary[];
     serviceType?: string;
+    channel?: string;
     submissionIndex?: number;
     custom?: Record<string, any>;
 }

package/lib/solution/ScanOrder/index.js

@@ -1200,7 +1200,11 @@ class ScanOrderImpl extends _BaseSales.BaseSalesImpl {
     return sourceMap;
   }
   getItemRuleRuntimeConfig() {
-    return this.itemRuleRuntimeConfig || {};
+    const runtimeConfig = this.itemRuleRuntimeConfig || {};
+    return {
+      ...runtimeConfig,
+      channel: runtimeConfig.channel ?? runtimeConfig.custom?.channel ?? this.otherParams?.channel
+    };
   }
   async ensureItemRuleConfigsLoaded() {
     if (this.itemRuleConfigs.length > 0) return this.itemRuleConfigs;

package/lib/solution/ScanOrder/utils.d.ts

@@ -78,6 +78,7 @@ export declare function buildItemRuleBusinessData(params: {
         pax?: Partial<PaxInfo>;
         historicalItems?: CartItemSummary[];
         serviceType?: string;
+        channel?: string;
         submissionIndex?: number;
         custom?: Record<string, any>;
     };

package/lib/solution/ScanOrder/utils.js

@@ -333,6 +333,7 @@ function buildItemRuleBusinessData(params) {
     cartItems,
     historicalItems,
     serviceType: runtimeConfig.serviceType || 'dine-in',
+    channel: runtimeConfig.channel ?? runtimeConfig.custom?.channel,
     submissionIndex: typeof runtimeConfig.submissionIndex === 'number' ? toNonNegativeInt(runtimeConfig.submissionIndex) : tempOrder.order_id ? 1 : 0,
     custom: runtimeConfig.custom || {},
     strategyConfigs: itemRuleConfigs

package/lib/solution/UnifiedBookingSales/index.d.ts

@@ -1,11 +1,12 @@
 import type { Module, ModuleOptions, PisellCore } from '../../types';
 import type { ProductData } from '../../modules';
-import type { OpenDataConfig } from '../../modules/OpenData';
+import { type InvoiceLayoutConfig, type InvoiceTemplateSettings, type OpenDataConfig } from '../../modules/OpenData';
 import type { LoadScheduleAvailableDateParams, ScheduleItem } from '../../modules/Schedule/types';
-import type { ProductListLoadProductsParams } from '../../modules/ProductList';
+import type { ProductListLoadProductsParams, ProductListStoreQueryParams } from '../../modules/ProductList';
 import type { AvailabilityDateRange, AvailabilityOccupancy, AvailabilityProduct, AvailabilityResource, GetProductTimeRangesRequest } from '../../modules/ResourcePlanner';
-import type { AvailabilityContextRef, ContextualAvailabilityQuery, ContextualAvailabilityQueryResult, ContextualCommitAvailabilitySelectionParams, ContextualProductTimeRangeGroup, UnifiedBookingSalesAddRetailProductParams, UnifiedBookingSalesApplyPlannerDiscountsParams, UnifiedBookingSalesCommitAvailabilitySelectionResult, UnifiedBookingSalesDiscountResult, UnifiedBookingSalesLoadProductsByScheduleDateParams, UnifiedBookingSalesLoadOpenDataParams, UnifiedBookingSalesPrepareAvailabilityProjectionParams, UnifiedBookingSalesPolicyResponse, UnifiedBookingSalesStageRetailProductsParams, UnifiedBookingSalesState } from './types';
+import type { AvailabilityContextRef, ContextualAvailabilityQuery, ContextualAvailabilityQueryResult, ContextualCommitAvailabilitySelectionParams, ContextualProductTimeRangeGroup, UnifiedBookingSalesAddRetailProductParams, UnifiedBookingSalesApplyPlannerDiscountsParams, UnifiedBookingSalesCommitAvailabilitySelectionResult, UnifiedBookingSalesDiscountResult, UnifiedBookingSalesLoadProductsByScheduleDateParams, UnifiedBookingSalesLoadOpenDataParams, UnifiedBookingSalesPrepareAvailabilityProjectionParams, UnifiedBookingSalesPolicyResponse, UnifiedBookingSalesResolveProductAllergyRequirementParams, UnifiedBookingSalesStageRetailProductsParams, UnifiedBookingSalesState } from './types';
 import { BookingTicket } from '../BookingTicket';
+import type { AllergyRequirement } from '../../model/strategy/adapter/itemRule';
 export * from './types';
 export { AvailabilityError } from '../../modules/ResourcePlanner';
 /**
@@ -59,9 +60,6 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
     protected defaultVersion: string;
     protected store: UnifiedBookingSalesState;
     private unifiedProductCatalog;
-    private openDataTarget;
-    private loadOpenDataInFlight;
-    private loadOpenDataInFlightTarget;
     private availabilityRuntimeOffsetMinutes;
     private availabilityScheduleCatalog;
     private availabilityProjectionSequence;
@@ -76,6 +74,9 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
     private availabilityRemoteResourceQuerySequence;
     private availabilityRemoteResourceEpoch;
     private availabilityCommitLocks;
+    private allergyItemRuleEvaluator;
+    private allergyItemRuleConfigs;
+    private allergyItemRuleConfigsPromise;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     protected getSubmitOrderSalesChannel(): string;
     private createAvailabilityFacadeError;
@@ -147,6 +148,18 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
      */
     loadOpenData(params: UnifiedBookingSalesLoadOpenDataParams): Promise<OpenDataConfig>;
     getOpenData(): Promise<OpenDataConfig | null>;
+    private resetAllergyItemRuleState;
+    private fetchAllergyItemRuleConfigs;
+    private ensureAllergyItemRuleConfigsLoaded;
+    /**
+     * 评估当前渠道与商品是否命中 ALLERGY_CHECK。
+     * 只返回优先级最高 Action 中当前商品 Target 的 dataSource，不跨商品或 Action 合并。
+     */
+    resolveProductAllergyRequirement(params: UnifiedBookingSalesResolveProductAllergyRequirementParams): Promise<AllergyRequirement | null>;
+    clearOpenDataCache(): void;
+    getInvoiceLayoutConfig(): Promise<InvoiceLayoutConfig>;
+    getInvoiceTemplateSettings(): Promise<InvoiceTemplateSettings>;
+    protected isInvoiceOpenDataCacheCurrent(): boolean;
     /**
      * Load a resource policy without depending on the legacy appointmentBooking solution.
      */
@@ -159,6 +172,7 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
         callback?: (result: any) => void;
         subscriberId?: string;
     }): Promise<ProductData[]>;
+    queryProducts(params?: ProductListStoreQueryParams): Promise<ProductData[]>;
     /** Date-first entry point. It delegates protocol details and cache ownership to ScheduleModule. */
     loadScheduleAvailableDate(params: LoadScheduleAvailableDateParams): Promise<import("../../modules/Date/types").ITime[]>;
     /**

package/lib/solution/UnifiedBookingSales/index.js

@@ -33,6 +33,7 @@ var _dayjs = _interopRequireDefault(require("dayjs"));
 var _lodashEs = require("lodash-es");
 var _modules = require("../../modules");
 var _utils = require("../../modules/BookingContext/utils");
+var _OpenData = require("../../modules/OpenData");
 var _getDateIsInSchedule = require("../../modules/Schedule/getDateIsInSchedule");
 var _ResourcePlanner = require("../../modules/ResourcePlanner");
 var _types = require("./types");
@@ -51,8 +52,9 @@ var _remoteOccupancyCache = require("./remoteOccupancyCache");
 var _BookingTicket = require("../BookingTicket");
 var _localClock = require("../../modules/ResourcePlanner/localClock");
 var _platform = require("../../utils/platform");
+var _itemRule = require("../../model/strategy/adapter/itemRule");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-const OPEN_DATA_SECTION_CODES = ['sale', 'reservation', 'fulfillment', 'menu', 'workflow', 'basic', 'checkout', 'availability'];
+const OPEN_DATA_SECTION_CODES = ['sale', 'reservation', 'fulfillment', 'menu', 'workflow', 'documents', 'basic', 'checkout', 'availability'];
 const OPEN_DATA_CACHE_TTL = 5 * 60 * 1000;
 function normalizePositiveInteger(value) {
   const normalized = Number(value);
@@ -83,6 +85,22 @@ function getCandidateStartTime(candidate) {
     return undefined;
   }
 }
+function normalizePositiveIntegerList(value) {
+  if (!Array.isArray(value)) return [];
+  return Array.from(new Set(value.map(item => normalizePositiveInteger(item)).filter(item => item !== undefined)));
+}
+function toConfiguredBoolean(value) {
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'number') return value !== 0;
+  if (typeof value === 'string') {
+    return ['1', 'true', 'yes', 'y', 'on'].includes(value.trim().toLowerCase());
+  }
+  return false;
+}
+function normalizeItemRuleStrategyConfigs(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter(config => Boolean(config && typeof config === 'object' && config.metadata?.type === 'item_rule'));
+}
 function isRecord(value) {
   return !!value && typeof value === 'object' && !Array.isArray(value);
 }
@@ -1182,9 +1200,6 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
   defaultVersion = '1.0.0';
   store = {};
   unifiedProductCatalog = [];
-  openDataTarget = null;
-  loadOpenDataInFlight = null;
-  loadOpenDataInFlightTarget = null;
   availabilityRuntimeOffsetMinutes = null;
   availabilityScheduleCatalog = null;
   availabilityProjectionSequence = 0;
@@ -1199,11 +1214,15 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
   availabilityRemoteResourceQuerySequence = 0;
   availabilityRemoteResourceEpoch = 0;
   availabilityCommitLocks = new Set();
+  allergyItemRuleEvaluator = new _itemRule.ItemRuleEvaluator();
+  allergyItemRuleConfigs = [];
+  allergyItemRuleConfigsPromise = null;
   async initialize(core, options = {}) {
     this.availabilityScheduleCatalog = null;
     this.openDataTarget = null;
     this.availabilityRuntimeOffsetMinutes = (0, _localClock.captureRuntimeOffsetMinutes)();
     this.clearAvailabilityRemoteResourceState();
+    this.resetAllergyItemRuleState();
     await super.initialize(core, options);
     const openDataBusinessCode = String(this.otherParams?.businessCode ?? this.otherParams?.business_code ?? '').trim();
     const openDataChannel = String(this.otherParams?.channel ?? '').trim();
@@ -1348,6 +1367,7 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     cover = false
   } = {}) {
     const previousScope = this.getAvailabilityScopeDescriptor(this.otherParams || {});
+    const previousItemRuleConfig = this.otherParams?.itemRule;
     const explicitlySetsOpenData = Object.prototype.hasOwnProperty.call(params, 'openData');
     await super.setOtherParams(params, {
       cover
@@ -1360,11 +1380,15 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     if (shouldResetAvailabilityState) {
       await this.resetAvailabilityProjectionState('set_other_params_reset');
     }
+    if (shouldResetAvailabilityState || explicitlySetsOpenData || previousItemRuleConfig !== this.otherParams?.itemRule) {
+      this.resetAllergyItemRuleState();
+    }
   }
   async destroy() {
     this.availabilityScheduleCatalog = null;
     this.availabilityRuntimeOffsetMinutes = null;
     await this.resetAvailabilityProjectionState('destroy');
+    this.resetAllergyItemRuleState();
     await super.destroy();
   }
   createAvailabilityContextId() {
@@ -1679,6 +1703,9 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     const cachedData = this.store.openData.getOpenData();
     const lastFetchedAt = this.store.openData.getLastFetchedAt();
     if (!params.force && this.openDataTarget === target && cachedData && lastFetchedAt && Date.now() - lastFetchedAt < OPEN_DATA_CACHE_TTL) {
+      if (typeof this.store.openData.ensureInvoiceTemplateSettings === 'function') {
+        await this.store.openData.ensureInvoiceTemplateSettings(target);
+      }
       return cachedData;
     }
     if (this.loadOpenDataInFlight) {
@@ -1689,35 +1716,155 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
       return this.loadOpenData(params);
     }
     this.loadOpenDataInFlightTarget = target;
-    this.loadOpenDataInFlight = this.store.openData.fetchOpenData({
+    const request = this.store.openData.fetchOpenData({
       scope: 'board',
       target,
       section_code: [...OPEN_DATA_SECTION_CODES]
     });
+    this.loadOpenDataInFlight = request;
     try {
-      const openData = await this.loadOpenDataInFlight;
-      this.openDataTarget = target;
-      this.otherParams.openData = openData;
-      this.otherParams.businessCode = businessCode;
-      this.otherParams.channel = channel;
+      const openData = await request;
+      if (this.loadOpenDataInFlight === request) {
+        this.openDataTarget = target;
+        this.otherParams.openData = openData;
+        this.otherParams.businessCode = businessCode;
+        this.otherParams.channel = channel;
+      }
       return openData;
     } finally {
-      this.loadOpenDataInFlight = null;
-      this.loadOpenDataInFlightTarget = null;
+      if (this.loadOpenDataInFlight === request) {
+        this.loadOpenDataInFlight = null;
+        this.loadOpenDataInFlightTarget = null;
+      }
     }
   }
   async getOpenData() {
     const businessCode = String(this.otherParams?.businessCode || '').trim();
     const channel = String(this.otherParams?.channel || '').trim();
     if (!businessCode || !channel) return null;
-    const target = `${businessCode}+${channel}`;
-    const cachedData = this.store.openData?.getOpenData() || null;
-    if (cachedData && this.openDataTarget === target) return cachedData;
     return this.loadOpenData({
       businessCode,
       channel
     });
   }
+  resetAllergyItemRuleState() {
+    this.allergyItemRuleConfigs = [];
+    this.allergyItemRuleConfigsPromise = null;
+    this.allergyItemRuleEvaluator.setStrategyConfigs([]);
+  }
+  async fetchAllergyItemRuleConfigs(strategyModelIds) {
+    if (!strategyModelIds.length) return [];
+    try {
+      const response = await this.request.get('/promotion', {
+        skip: 1,
+        num: 99,
+        status: 'active',
+        ids: strategyModelIds
+      });
+      if (response?.code !== 200 || !Array.isArray(response?.data?.list)) {
+        throw new Error('[UnifiedBookingSales] 商品过敏策略加载失败');
+      }
+      const list = response.data.list;
+      return normalizeItemRuleStrategyConfigs(list.map(item => item?.metadata));
+    } catch (error) {
+      // this.logMethodError('fetchAllergyItemRuleConfigs', error, {
+      //   strategyModelIds,
+      // });
+      throw error;
+    }
+  }
+  async ensureAllergyItemRuleConfigsLoaded() {
+    if (this.allergyItemRuleConfigs.length > 0) {
+      return this.allergyItemRuleConfigs;
+    }
+    if (this.allergyItemRuleConfigsPromise) {
+      return this.allergyItemRuleConfigsPromise;
+    }
+    this.allergyItemRuleConfigsPromise = (async () => {
+      const staticConfigs = normalizeItemRuleStrategyConfigs(this.otherParams?.itemRule?.strategyConfigs);
+      if (staticConfigs.length > 0) {
+        this.allergyItemRuleConfigs = staticConfigs;
+        this.allergyItemRuleEvaluator.setStrategyConfigs(staticConfigs);
+        return staticConfigs;
+      }
+      const openData = await this.getOpenData();
+      const enabled = toConfiguredBoolean(openData?.['sale.enable_item_rules']);
+      const strategyModelIds = normalizePositiveIntegerList(openData?.['sale.enabled_item_rules']);
+      if (!enabled || !strategyModelIds.length) {
+        this.allergyItemRuleEvaluator.setStrategyConfigs([]);
+        return [];
+      }
+      const loaded = await this.fetchAllergyItemRuleConfigs(strategyModelIds);
+      this.allergyItemRuleConfigs = loaded;
+      this.allergyItemRuleEvaluator.setStrategyConfigs(loaded);
+      return loaded;
+    })();
+    return this.allergyItemRuleConfigsPromise;
+  }
+
+  /**
+   * 评估当前渠道与商品是否命中 ALLERGY_CHECK。
+   * 只返回优先级最高 Action 中当前商品 Target 的 dataSource，不跨商品或 Action 合并。
+   */
+  async resolveProductAllergyRequirement(params) {
+    const productId = normalizePositiveInteger(params.productId);
+    if (!productId) return null;
+    const strategyConfigs = await this.ensureAllergyItemRuleConfigsLoaded();
+    if (!strategyConfigs.length) return null;
+    const productVariantId = normalizePositiveInteger(params.productVariantId);
+    const runtimeConfig = this.otherParams?.itemRule || {};
+    const runtimePax = runtimeConfig.pax || {};
+    const cartItems = (this.getOrderProducts?.() || []).map(item => ({
+      product_id: Number(item?.product_id ?? item?.id),
+      product_variant_id: Number(item?.product_variant_id ?? 0) || undefined,
+      quantity: Number(item?.num ?? item?.quantity ?? 0)
+    })).filter(item => Number.isFinite(item.product_id) && item.product_id > 0 && Number.isFinite(item.quantity) && item.quantity > 0);
+    return this.allergyItemRuleEvaluator.getAllergyRequirement({
+      pax: {
+        total: Number(runtimePax.total ?? 0) || 0,
+        adult: Number(runtimePax.adult ?? 0) || 0,
+        child: Number(runtimePax.child ?? 0) || 0
+      },
+      cartItems,
+      serviceType: String(runtimeConfig.serviceType ?? this.otherParams?.serviceType ?? ''),
+      channel: String(params.channel ?? this.otherParams?.channel ?? this.otherParams?.platform ?? ''),
+      currentProduct: {
+        product_id: productId,
+        ...(productVariantId ? {
+          product_variant_id: productVariantId
+        } : {})
+      },
+      submissionIndex: Number(runtimeConfig.submissionIndex ?? 0) || 0,
+      strategyConfigs,
+      custom: runtimeConfig.custom
+    });
+  }
+  clearOpenDataCache() {
+    this.openDataTarget = null;
+    this.loadOpenDataInFlight = null;
+    this.loadOpenDataInFlightTarget = null;
+    super.clearOpenDataCache();
+  }
+  async getInvoiceLayoutConfig() {
+    const openData = await this.getOpenData();
+    if (!openData || !this.store.openData) {
+      return (0, _OpenData.getDefaultInvoiceLayoutConfig)();
+    }
+    return this.store.openData.getInvoiceLayoutConfig();
+  }
+  async getInvoiceTemplateSettings() {
+    const openData = await this.getOpenData();
+    if (!openData || !this.store.openData) {
+      return (0, _OpenData.getDefaultInvoiceTemplateSettings)();
+    }
+    return this.store.openData.getInvoiceTemplateSettings();
+  }
+  isInvoiceOpenDataCacheCurrent() {
+    const businessCode = String(this.otherParams?.businessCode || '').trim();
+    const channel = String(this.otherParams?.channel || '').trim();
+    if (!businessCode || !channel) return false;
+    return this.openDataTarget === `${businessCode}+${channel}`;
+  }
 
   /**
    * Load a resource policy without depending on the legacy appointmentBooking solution.
@@ -1754,6 +1901,10 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     await this.core.effects.emit(`${this.name}:onProductsLoaded`, result);
     return result;
   }
+  async queryProducts(params = {}) {
+    if (!this.store.products) throw new Error('[UnifiedBookingSales] products 模块未初始化');
+    return this.store.products.queryProducts(params);
+  }
 
   /** Date-first entry point. It delegates protocol details and cache ownership to ScheduleModule. */
   async loadScheduleAvailableDate(params) {
@@ -3304,7 +3455,9 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
       } else {
         const beforeProductLineUids = new Set((this.getTempOrder()?.products || []).map(line => getProductLineUid(line)).filter(Boolean));
         const beforeBookingUids = new Set((this.getTempOrder()?.bookings || []).map(item => getBookingUid(item)).filter(Boolean));
-        const products = await this.addProductToOrder(transformed, booking);
+        const products = await this.addProductToOrder(transformed, booking, params.salesNotes?.length ? {
+          salesNotes: params.salesNotes
+        } : undefined);
         const addedLines = products.filter(line => sameAvailabilityId(line.product_id ?? line.id, refreshedCandidate.productId) && line.metadata?.availability_candidate_key === refreshedCandidate.key && !beforeProductLineUids.has(getProductLineUid(line)));
         productLineUids = addedLines.map(line => getProductLineUid(line)).filter(Boolean);
         const addedBookings = (this.getTempOrder()?.bookings || []).filter(item => item.metadata?.availability_candidate_key === refreshedCandidate.key && !beforeBookingUids.has(getBookingUid(item)));