@pisell/pisellos 0.10.43 → 0.10.45

package/lib/solution/RegisterAndLogin/config.js

@@ -15,6 +15,8 @@ exports.getChannelConfig = getChannelConfig;
  * API 配置接口
  */
 
+const h5CustomerAuthApiNames = new Set(['sendEmailVerificationCode', 'sendEmailLoginCode', 'sendSmsRegisterCode', 'sendEmailRegisterLink', 'verifyEmailRegistrationLink', 'emailPasswordLogin', 'emailCodeRegister', 'phoneCodeRegister', 'resendEmailRegisterLink', 'checkEmailLinkCode', 'sendSmsLoginCode', 'phoneCodeLogin', 'guestLogin', 'checkEmailExists', 'checkEmailCode', 'checkMobileCode', 'phonePasswordLogin', 'sendPasswordResetEmail', 'sendPasswordResetSms', 'sendResetPasswordLink', 'checkResetPasswordCode', 'resetPasswordByCode', 'resetPasswordByEmail', 'resetPasswordByPhone', 'verifyCode', 'register', 'login', 'oauthLogin', 'facebookLogin', 'appleLogin']);
+
 /**
  * 渠道配置接口
  */
@@ -278,6 +280,31 @@ const onlineStoreConfig = {
     })
   }
 };
+function withH5AuthPrefix(config) {
+  const nextConfig = {};
+  Object.entries(config).forEach(([key, apiConfig]) => {
+    if (!apiConfig.url.startsWith('/auth/')) {
+      nextConfig[key] = apiConfig;
+      return;
+    }
+    nextConfig[key] = {
+      ...apiConfig,
+      url: apiConfig.url.startsWith('/h5/') ? apiConfig.url : `/h5${apiConfig.url}`,
+      options: params => {
+        const {
+          withCredentials,
+          ...baseOptions
+        } = (typeof apiConfig.options === 'function' ? apiConfig.options(params) : apiConfig.options) || {};
+        return {
+          ...baseOptions,
+          prefix: false
+        };
+      }
+    };
+  });
+  return nextConfig;
+}
+const h5OnlineStoreConfig = withH5AuthPrefix(onlineStoreConfig);
 
 /**
  * 默认配置（通用配置）
@@ -1066,6 +1093,7 @@ const shopWebposConfig = {
  */
 const channelConfigMap = exports.channelConfigMap = {
   'online-store': onlineStoreConfig,
+  'online-store-h5': h5OnlineStoreConfig,
   'default': defaultConfig,
   'webpos': webposConfig,
   'shop.webpos': shopWebposConfig
@@ -1083,9 +1111,16 @@ function getChannelConfig(channel) {
  * 负责根据配置执行 API 调用
  */
 class ApiCaller {
-  constructor(request, config) {
+  constructor(request, config, options = {}) {
     this.request = request;
     this.config = config;
+    this.options = options;
+  }
+  resolveUrl(url) {
+    if (!this.options.baseUrl || !url.startsWith('/h5/auth/')) {
+      return url;
+    }
+    return `${this.options.baseUrl.replace(/\/$/, '')}${url}`;
   }
 
   /**
@@ -1111,6 +1146,12 @@ class ApiCaller {
       ...options,
       ...additionalOptions
     };
+    if (apiConfig.url.startsWith('/h5/auth/') && h5CustomerAuthApiNames.has(apiName)) {
+      requestOptions.h5CustomerAuth = true;
+      if (this.options.shopDomain) {
+        requestOptions.h5AuthShopDomain = this.options.shopDomain;
+      }
+    }
 
     // 处理动态 headers
     if (requestOptions.headers && typeof requestOptions.headers === 'function') {
@@ -1123,19 +1164,19 @@ class ApiCaller {
     switch (apiConfig.method) {
       case 'GET':
         if (transformedParams && Object.keys(transformedParams).length > 0) {
-          response = await this.request.get(apiConfig.url, transformedParams, requestOptions);
+          response = await this.request.get(this.resolveUrl(apiConfig.url), transformedParams, requestOptions);
         } else {
-          response = await this.request.get(apiConfig.url, undefined, requestOptions);
+          response = await this.request.get(this.resolveUrl(apiConfig.url), undefined, requestOptions);
         }
         break;
       case 'POST':
-        response = await this.request.post(apiConfig.url, transformedParams, requestOptions);
+        response = await this.request.post(this.resolveUrl(apiConfig.url), transformedParams, requestOptions);
         break;
       case 'PUT':
-        response = await this.request.put(apiConfig.url, transformedParams, requestOptions);
+        response = await this.request.put(this.resolveUrl(apiConfig.url), transformedParams, requestOptions);
         break;
       case 'DELETE':
-        response = await this.request.delete(apiConfig.url, requestOptions);
+        response = await this.request.delete(this.resolveUrl(apiConfig.url), requestOptions);
         break;
       default:
         throw new Error(`不支持的 HTTP 方法: ${apiConfig.method}`);
@@ -1150,7 +1191,7 @@ class ApiCaller {
  * 创建 API 调用器
  */
 exports.ApiCaller = ApiCaller;
-function createApiCaller(request, channel) {
+function createApiCaller(request, channel, options) {
   const config = getChannelConfig(channel);
-  return new ApiCaller(request, config);
+  return new ApiCaller(request, config, options);
 }

package/lib/solution/RegisterAndLogin/index.js

@@ -227,7 +227,10 @@ class RegisterAndLoginImpl extends _BaseModule.BaseModule {
     }
 
     // 创建 API 调用器
-    this.apiCaller = (0, _config.createApiCaller)(this.request, this.channel);
+    this.apiCaller = (0, _config.createApiCaller)(this.request, this.channel, {
+      baseUrl: this.otherParams.h5AuthBaseUrl,
+      shopDomain: this.otherParams.h5AuthShopDomain
+    });
 
     // 尝试从本地存储恢复登录状态
     await this.restoreLoginState();

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/ShopDiscount/index.d.ts

@@ -43,6 +43,7 @@ export declare class ShopDiscountImpl extends BaseModule implements Module {
     batchSearchByProductIds(productIds: number[]): Promise<Discount[]>;
     scanCode(code: string, customerId?: number): Promise<{
         isAvailable: boolean;
+        isAccepted?: boolean;
         productList: Record<string, any>[];
         discountList: Discount[];
         type: "server" | "clientCalc";

package/lib/solution/ShopDiscount/index.js

@@ -10,6 +10,7 @@ var _Rules = require("../../modules/Rules");
 var _entitlementPass = require("../../modules/Discount/entitlementPass");
 var _utils = require("./utils");
 var _types = require("../../modules/Rules/types");
+var _availability = require("../../modules/Discount/availability");
 var _decimal = _interopRequireDefault(require("decimal.js"));
 var _lodashEs = require("lodash-es");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -349,6 +350,7 @@ class ShopDiscountImpl extends _BaseModule.BaseModule {
       const {
         productList: newProductList,
         discountList: newDiscountList,
+        evaluatedDiscountList,
         isAvailable,
         unavailableReason
       } = rulesModule.isDiscountListAvailable({
@@ -363,6 +365,7 @@ class ShopDiscountImpl extends _BaseModule.BaseModule {
         productList: this.store.productList || [],
         discountList: this.getDiscountList()
       };
+      let isAccepted = isAvailable;
       if (isAvailable) {
         this.setDiscountList(newDiscountList || []);
         this.store.originalDiscountList = newDiscountList || [];
@@ -370,12 +373,34 @@ class ShopDiscountImpl extends _BaseModule.BaseModule {
         if (this.isWalkIn() && resultDiscountList.length && this.options.otherParams?.platform === 'shop' && !((resultDiscountList[0].customer_id || 1) === 1)) {
           await this.getCustomerWallet(resultDiscountList[0].customer_id);
         }
+      } else {
+        const scannedIds = new Set(withScanList.map(discount => String(discount.id)));
+        const retainedScannedDiscounts = (evaluatedDiscountList || withScanList).filter(discount => scannedIds.has(String(discount.id)) && !(0, _availability.getDiscountLifecycleReason)(discount));
+        if (retainedScannedDiscounts.length) {
+          const retainedDiscounts = new Map(this.getDiscountList().map(discount => [String(discount.id), discount]));
+          retainedScannedDiscounts.forEach(discount => {
+            retainedDiscounts.set(String(discount.id), {
+              ...discount,
+              isScan: true,
+              isAvailable: false,
+              isSelected: false,
+              reasonCode: discount.reasonCode || 'product_not_applicable',
+              appliedProductDetails: [],
+              savedAmount: 0
+            });
+          });
+          this.setDiscountList([...retainedDiscounts.values()]);
+          this.store.originalDiscountList = this.getDiscountList();
+          await this.store.discount?.setOriginalDiscountList(this.getDiscountList());
+          isAccepted = true;
+        }
       }
       return {
         type: "clientCalc",
         isAvailable: isAvailable || false,
+        isAccepted: Boolean(isAccepted),
         productList: newProductList || this.store.productList || [],
-        discountList: newDiscountList || this.getDiscountList(),
+        discountList: this.getDiscountList(),
         unavailableReason
       };
     } catch (error) {
@@ -525,6 +550,7 @@ class ShopDiscountImpl extends _BaseModule.BaseModule {
         with_discount_card: 1,
         with_wallet_pass_holder: 1,
         with_entitlement_pass: 1,
+        filter_order_wallet_pass_usage: 0,
         request_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
         ...(orderId ? {
           order_id: orderId
@@ -559,8 +585,8 @@ class ShopDiscountImpl extends _BaseModule.BaseModule {
       this.store.originalDiscountList = newDiscountList;
       await this.store.discount?.setOriginalDiscountList(newDiscountList);
 
-      // 根据当前预约时间过滤优惠券列表
-      const filteredDiscountList = this.filterDiscountListByBookingTime(newDiscountList, this.store.currentBookingTime);
+      // 日程限制交给 Rules 计算可用状态，展示列表保留当前不可用的卡券。
+      const filteredDiscountList = newDiscountList;
       this.store.filteredDiscountList = filteredDiscountList;
       this.setDiscountList(filteredDiscountList || []);
       if (this.store.productList?.length) {

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

@@ -59,12 +59,14 @@ export interface ScheduleItem {
 }
 export declare const getDateIsInSchedule: (dateTime: string, scheduleList: ScheduleItem[]) => boolean;
 /**
- * 根据预约时间过滤优惠券列表
+ * 根据商品使用时间过滤优惠券列表（预约开始时间或普通商品的当前时间）
  * @param discountList 优惠券列表
- * @param bookingTime 预约时间 (格式: YYYY-MM-DD HH:mm:ss)
+ * @param bookingTime 使用时间 (格式: YYYY-MM-DD HH:mm:ss)，未确定时不提前过滤
  * @returns 过滤后的优惠券列表
  */
 export declare const filterDiscountListByBookingTime: (discountList: Discount[], bookingTime: string | null) => Discount[];
+/** 与抵扣计算共用时间判断，区分未开始、有效期不匹配和日程限制。 */
+export declare const getDiscountTimeUnavailableReason: (discount: Discount, useTime: string) => 'not_started' | 'time_limit' | 'outside_schedule' | undefined;
 /**
  * 判断是否是订单级别的固定金额折扣卡
  * @param discount 折扣

package/lib/solution/ShopDiscount/utils.js

@@ -3,11 +3,15 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.uniqueById = exports.isOrderLevelFixedAmountDiscount = exports.isNormalProductByDurationSchedule = exports.isAllNormalProduct = exports.getDiscountListAmountTotal = exports.getDiscountListAmount = exports.getDiscountAmount = exports.getDateIsInSchedule = exports.filterDiscountListByBookingTime = exports.calculateOrderLevelDiscountAllocation = void 0;
+exports.uniqueById = exports.isOrderLevelFixedAmountDiscount = exports.isNormalProductByDurationSchedule = exports.isAllNormalProduct = exports.getDiscountTimeUnavailableReason = exports.getDiscountListAmountTotal = exports.getDiscountListAmount = exports.getDiscountAmount = exports.getDateIsInSchedule = exports.filterDiscountListByBookingTime = exports.calculateOrderLevelDiscountAllocation = void 0;
 var _decimal = _interopRequireDefault(require("decimal.js"));
 var _dayjs = _interopRequireDefault(require("dayjs"));
+var _isSameOrAfter = _interopRequireDefault(require("dayjs/plugin/isSameOrAfter"));
+var _isSameOrBefore = _interopRequireDefault(require("dayjs/plugin/isSameOrBefore"));
 var _entitlementPass = require("../../modules/Discount/entitlementPass");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+_dayjs.default.extend(_isSameOrAfter.default);
+_dayjs.default.extend(_isSameOrBefore.default);
 const uniqueById = (arr, key = 'id') => {
   const seen = new Set();
   return arr.filter(item => !seen.has(item[key]) && seen.add(item[key]));
@@ -377,41 +381,53 @@ const isInWeeklyRepeatForDate = (targetDate, startDate, repeatRule) => {
 };
 
 /**
- * 根据预约时间过滤优惠券列表
+ * 根据商品使用时间过滤优惠券列表（预约开始时间或普通商品的当前时间）
  * @param discountList 优惠券列表
- * @param bookingTime 预约时间 (格式: YYYY-MM-DD HH:mm:ss)
+ * @param bookingTime 使用时间 (格式: YYYY-MM-DD HH:mm:ss)，未确定时不提前过滤
  * @returns 过滤后的优惠券列表
  */
 const filterDiscountListByBookingTime = (discountList, bookingTime) => {
-  if (!bookingTime) {
-    return discountList;
-  }
-  return discountList.filter(discount => {
+  if (!bookingTime) return discountList;
+  return discountList.filter(discount => !getDiscountTimeUnavailableReason(discount, bookingTime));
+};
+
+/** 与抵扣计算共用时间判断，区分未开始、有效期不匹配和日程限制。 */
+exports.filterDiscountListByBookingTime = filterDiscountListByBookingTime;
+const getDiscountTimeUnavailableReason = (discount, useTime) => {
+  const useTimeDayjs = (0, _dayjs.default)(useTime);
+  if (!useTimeDayjs.isValid()) return 'time_limit';
+  try {
     if (discount?.metadata?.validity_type === "custom_schedule_validity") {
-      return getDateIsInSchedule(bookingTime, discount.custom_schedule_snapshot?.data || []);
+      return getDateIsInSchedule(useTime, discount.custom_schedule_snapshot?.data || []) ? undefined : 'outside_schedule';
     }
-    try {
-      const isHasStart = !!discount.start_date && !!discount.start_time;
-      const startDate = (0, _dayjs.default)(`${discount.start_date} ${discount.start_time}`);
-      const bookingTimeDayjs = (0, _dayjs.default)(bookingTime);
-
-      // 判断预约时间是否在开始时间之后
-      const isAfterStart = isHasStart ? bookingTimeDayjs.isSameOrAfter(startDate) : true;
-
-      // 判断预约时间是否在过期时间之前（expire_time 为空时为长期有效）
-      const isBeforeExpire = discount.expire_time ? bookingTimeDayjs.isSameOrBefore((0, _dayjs.default)(discount.expire_time)) : true;
-      return isAfterStart && isBeforeExpire;
-    } catch (error) {
-      return true;
+    const isHasStart = !!discount.start_date && !!discount.start_time;
+    const startDate = (0, _dayjs.default)(`${discount.start_date} ${discount.start_time}`);
+
+    // 开始时刻包含在有效期内。
+    if (isHasStart) {
+      if (!startDate.isValid()) return 'time_limit';
+      if (useTimeDayjs.isBefore(startDate)) return 'not_started';
     }
-  });
+
+    // 到期时刻不再可用；expire_time 为空时为长期有效。
+    const expireTime = discount.expire_time ? (0, _dayjs.default)(discount.expire_time) : null;
+    const isBeforeExpire = expireTime ? expireTime.isValid() && useTimeDayjs.isBefore(expireTime) : true;
+    if (!isBeforeExpire) return 'time_limit';
+    const validity = discount.extension_data?.find(field => field.field_key === 'valid_times')?.value;
+    if (validity?.restrict_use_by_schedule === true && !getDateIsInSchedule(useTime, discount.custom_schedule_snapshot?.data || [])) {
+      return 'outside_schedule';
+    }
+    return undefined;
+  } catch (error) {
+    return 'time_limit';
+  }
 };
 /**
  * 判断是否是订单级别的固定金额折扣卡
  * @param discount 折扣
  * @returns 是否是订单级别的固定金额折扣卡
  */
-exports.filterDiscountListByBookingTime = filterDiscountListByBookingTime;
+exports.getDiscountTimeUnavailableReason = getDiscountTimeUnavailableReason;
 const isOrderLevelFixedAmountDiscount = discount => {
   return discount.tag === 'product_discount_card' && discount?.metadata?.discount_card_type === 'fixed_amount' && discount?.metadata?.discount_calculation_mode === 'order_level';
 };

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

@@ -2,10 +2,11 @@ import type { Module, ModuleOptions, PisellCore } from '../../types';
 import type { ProductData } from '../../modules';
 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';
 /**
@@ -73,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;
@@ -144,6 +148,14 @@ 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>;
@@ -160,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

@@ -52,6 +52,7 @@ 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', 'documents'];
 const OPEN_DATA_CACHE_TTL = 5 * 60 * 1000;
@@ -84,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);
 }
@@ -1197,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();
@@ -1346,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
@@ -1358,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() {
@@ -1721,6 +1747,98 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
       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;
@@ -1783,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) {
@@ -3333,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)));

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

@@ -1,8 +1,12 @@
 import type { InvoiceLayoutConfig, InvoiceTemplateSettings, OpenDataConfig } from '../../modules/OpenData';
-import type { ProductListLoadProductsParams } from '../../modules/ProductList';
+import type { ProductListLoadProductsParams, ProductListStoreQueryParams } from '../../modules/ProductList';
+import type { ProductData } from '../../modules/Product/types';
 import type { LoadScheduleAvailableDateParams } from '../../modules/Schedule/types';
 import type { AvailabilityDateRange, AvailabilityErrorCode, AvailabilityId, AvailabilityOccupancy, AvailabilityProduct, AvailabilityProjection, AvailabilityQuery, AvailabilityRequirementSelection, AvailabilityResource, AvailabilitySelectionValidationResult, DateAvailabilityQueryResult, GetProductTimeRangesRequest, ProductAvailabilityQueryResult, ProductTimeRange, ProductTimeRangeGroup, ResourceAvailabilityGroup, ResourceAvailabilityRangeGroup, TimeAvailabilityGroup, TimeAvailabilityItem } from '../../modules/ResourcePlanner';
 import type { BookingTicketState } from '../BookingTicket/types';
+import type { AllergyRequirement } from '../../model/strategy/adapter/itemRule';
+import type { SalesNoteDraftInput } from '../../modules/Order/types';
+export type { ProductListStoreQueryParams } from '../../modules/ProductList';
 export type { AvailabilityAbsoluteRange, AvailabilityAssignment, AvailabilityCell, AvailabilityDateRange, AvailabilityDisplayRange, AvailabilityErrorCode, AvailabilityId, AvailabilityMode, AvailabilityOccupancy, AvailabilityProduct, AvailabilityProductKind, AvailabilityProjection, AvailabilityProjectionInput, AvailabilityProjectionMeta, AvailabilityQuery, AvailabilityQueryResult, AvailabilityRequirementGroup, AvailabilityRequirementGroupResult, AvailabilityRequirementSelection, AvailabilityResource, AvailabilityResourceOption, AvailabilityResourceType, AvailabilityResourceWindow, AvailabilityScheduleMode, AvailabilityScheduleRef, AvailabilityScheduleRule, AvailabilitySelectionValidationParams, AvailabilitySelectionValidationResult, AvailabilitySessionRange, AvailabilityStatus, DateAvailabilityGroup, DateAvailabilityItem, DateAvailabilityQuery, DateAvailabilityQueryResult, GetProductTimeRangesRequest, ProductAvailabilityGroup, ProductAvailabilityItem, ProductAvailabilityQuery, ProductAvailabilityQueryResult, ProductTimeRange, ProductTimeRangeGroup, QueryAvailabilityBaseRequest, ResourceAvailabilityGroup, ResourceAvailabilityQuery, ResourceAvailabilityQueryResult, ResourceAvailabilityRangeGroup, TimeAvailabilityGroup, TimeAvailabilityItem, TimeAvailabilityQuery, TimeAvailabilityQueryResult, } from '../../modules/ResourcePlanner';
 export interface UnifiedBookingSalesState extends BookingTicketState {
 }
@@ -24,6 +28,12 @@ export declare enum UnifiedBookingSalesHooks {
 export interface UnifiedBookingSalesOtherParams extends Record<string, any> {
     enableSessionStoragePersist?: boolean;
 }
+export type UnifiedBookingSalesAllergyRequirement = AllergyRequirement;
+export interface UnifiedBookingSalesResolveProductAllergyRequirementParams {
+    productId: number | string;
+    productVariantId?: number | string;
+    channel?: string;
+}
 export interface UnifiedBookingSalesLoadOpenDataParams {
     businessCode: string;
     channel: string;
@@ -151,6 +161,8 @@ export interface ContextualCommitAvailabilitySelectionParams {
     requirementSelections: AvailabilityRequirementSelection[];
     partySize: number;
     bookingCount?: number;
+    /** 新增商品行时与商品、预约在同一次 Order mutation 内写入的 Sales Notes。 */
+    salesNotes?: SalesNoteDraftInput[];
     /** 编辑预约时，允许本次显式报价覆盖已落库订单行的历史价格。 */
     allowBookingReprice?: boolean;
     /** 编辑预约重报价后，允许订单模块重新应用已选编辑态折扣。 */
@@ -214,6 +226,7 @@ export interface UnifiedBookingSalesApi {
     /** Date-first calendar availability backed by ScheduleModule. */
     loadScheduleAvailableDate: (params: LoadScheduleAvailableDateParams) => Promise<unknown>;
     loadProductsByScheduleDate: (params: UnifiedBookingSalesLoadProductsByScheduleDateParams) => Promise<unknown[]>;
+    queryProducts: (params?: ProductListStoreQueryParams) => Promise<ProductData[]>;
     stageRetailProducts: (params: UnifiedBookingSalesStageRetailProductsParams) => Promise<Record<string, any> | null>;
     addRetailProduct: (params: UnifiedBookingSalesAddRetailProductParams) => Promise<Record<string, any>[]>;
     prepareAvailabilityProjection: (params: UnifiedBookingSalesPrepareAvailabilityProjectionParams) => Promise<AvailabilityContextRef>;