@pisell/pisellos 2.2.265 → 2.2.270

package/dist/model/strategy/adapter/promotion/type.d.ts

@@ -12,6 +12,8 @@ export declare const PROMOTION_ACTION_TYPES: {
     readonly X_ITEMS_FOR_Y_PRICE: "X_ITEMS_FOR_Y_PRICE";
     /** 买X送Y（买X件送Y件，可累计） */
     readonly BUY_X_GET_Y_FREE: "BUY_X_GET_Y_FREE";
+    /** 商品奖励（满足条件后，订单内指定目标商品享优惠） */
+    readonly ITEM_REWARD: "ITEM_REWARD";
     /** 固定折扣 */
     readonly DISCOUNT_RATE: "DISCOUNT_RATE";
     /** 固定减价 */
@@ -66,6 +68,59 @@ export interface BuyXGetYFreeConfig {
     /** 可选的赠品列表 */
     giftProducts?: ProductIdentifier[];
 }
+/**
+ * 商品奖励优惠方式
+ *
+ * - free: 目标商品最终价为 0
+ * - percent_off: 目标商品按百分比折扣，rewardValue 为 0-100
+ * - amount_off: 每个目标商品固定减免 rewardValue
+ * - fixed_price: 目标商品改为固定价 rewardValue
+ */
+export type ItemRewardMethod = 'free' | 'percent_off' | 'amount_off' | 'fixed_price';
+/**
+ * 商品奖励数量规则
+ *
+ * - per_condition_quantity: 每满足 N 个条件商品，奖励 Y 个目标商品
+ * - all_targets: 满足条件后奖励全部目标商品
+ * - max_per_order: 满足条件后每单最多奖励固定数量目标商品
+ */
+export type ItemRewardQuantityRule = 'per_condition_quantity' | 'all_targets' | 'max_per_order';
+/** 商品奖励目标选择规则 */
+export type ItemRewardTargetSelection = 'consumer_best';
+/**
+ * 商品奖励 - Action Value
+ *
+ * @example
+ * value: {
+ *   rewardMethod: 'free',
+ *   quantityRule: 'per_condition_quantity',
+ *   triggerQuantity: 1,
+ *   rewardQuantity: 1,
+ * }
+ */
+export interface ItemRewardValue {
+    /** 奖励方式 */
+    rewardMethod: ItemRewardMethod;
+    /** 奖励值：percent_off/amount_off/fixed_price 使用，free 可省略 */
+    rewardValue?: number;
+    /** 奖励数量规则 */
+    quantityRule: ItemRewardQuantityRule;
+    /** 每满足 N 个条件商品；默认 1 */
+    triggerQuantity?: number;
+    /** 奖励 Y 个目标商品；默认 1 */
+    rewardQuantity?: number;
+    /** 每单最多奖励 Y 个目标商品；max_per_order 使用 */
+    maxRewardQuantity?: number;
+}
+/**
+ * 商品奖励 - Action Config
+ */
+export interface ItemRewardConfig {
+    /** 奖励对象，本期支持指定商品/变体；product_variant_id=0 表示任意变体 */
+    rewardTargets?: ProductIdentifier[];
+    /** 目标商品超额时的选择规则；本期支持 consumer_best */
+    targetSelection?: ItemRewardTargetSelection;
+}
 /**
  * 商品标识
  *
@@ -102,10 +157,19 @@ export interface BuyXGetYFreeAction extends Omit<ActionEffect, 'type' | 'value'
     valueType: 'object';
     config?: BuyXGetYFreeConfig;
 }
+/**
+ * 商品奖励 Action
+ */
+export interface ItemRewardAction extends Omit<ActionEffect, 'type' | 'value' | 'config'> {
+    type: typeof PROMOTION_ACTION_TYPES.ITEM_REWARD;
+    value: ItemRewardValue;
+    valueType: 'object';
+    config?: ItemRewardConfig;
+}
 /**
  * 促销活动 Action 联合类型
  */
-export type PromotionAction = XItemsForYPriceAction | BuyXGetYFreeAction;
+export type PromotionAction = XItemsForYPriceAction | BuyXGetYFreeAction | ItemRewardAction;
 /**
  * 促销相关运算符
  */
@@ -170,6 +234,8 @@ export interface PromotionProduct {
     quantity: number;
     /** 原价 */
     original_price?: number;
+    /** 内部字段：编辑态订单行只允许参与 ITEM_REWARD，避免旧促销误算历史行 */
+    _promotionOnlyForItemReward?: boolean;
 }
 /**
  * 促销活动适配器转换结果
@@ -195,7 +261,7 @@ export interface PromotionTransformResult {
 /**
  * Action 详情联合类型
  */
-export type PromotionActionDetail = XItemsForYPriceActionDetail | BuyXGetYFreeActionDetail;
+export type PromotionActionDetail = XItemsForYPriceActionDetail | BuyXGetYFreeActionDetail | ItemRewardActionDetail;
 /**
  * X件Y元 Action 详情
  */
@@ -226,6 +292,28 @@ export interface BuyXGetYFreeActionDetail {
     /** 可选的赠品列表 */
     giftProducts: ProductIdentifier[];
 }
+/**
+ * 商品奖励 Action 详情
+ */
+export interface ItemRewardActionDetail {
+    type: typeof PROMOTION_ACTION_TYPES.ITEM_REWARD;
+    /** 奖励方式 */
+    rewardMethod: ItemRewardMethod;
+    /** 奖励值：percent_off/amount_off/fixed_price 使用，free 为 0 */
+    rewardValue: number;
+    /** 奖励数量规则 */
+    quantityRule: ItemRewardQuantityRule;
+    /** 每满足 N 个条件商品；默认 1 */
+    triggerQuantity: number;
+    /** 奖励 Y 个目标商品；默认 1 */
+    rewardQuantity: number;
+    /** 每单最多奖励 Y 个目标商品；max_per_order 使用 */
+    maxRewardQuantity?: number;
+    /** 奖励对象，本期支持指定商品/变体 */
+    rewardTargets: ProductIdentifier[];
+    /** 目标商品超额时的选择规则 */
+    targetSelection: ItemRewardTargetSelection;
+}
 /**
  * X件Y元 - 业务层计算结果
  *

package/dist/model/strategy/adapter/promotion/type.js

@@ -16,6 +16,8 @@ export var PROMOTION_ACTION_TYPES = {
   X_ITEMS_FOR_Y_PRICE: 'X_ITEMS_FOR_Y_PRICE',
   /** 买X送Y（买X件送Y件，可累计） */
   BUY_X_GET_Y_FREE: 'BUY_X_GET_Y_FREE',
+  /** 商品奖励（满足条件后，订单内指定目标商品享优惠） */
+  ITEM_REWARD: 'ITEM_REWARD',
   /** 固定折扣 */
   DISCOUNT_RATE: 'DISCOUNT_RATE',
   /** 固定减价 */
@@ -54,6 +56,41 @@ export var PROMOTION_ACTION_TYPES = {
  * 买X送Y - Action Config
  */
 
+/**
+ * 商品奖励优惠方式
+ *
+ * - free: 目标商品最终价为 0
+ * - percent_off: 目标商品按百分比折扣，rewardValue 为 0-100
+ * - amount_off: 每个目标商品固定减免 rewardValue
+ * - fixed_price: 目标商品改为固定价 rewardValue
+ */
+
+/**
+ * 商品奖励数量规则
+ *
+ * - per_condition_quantity: 每满足 N 个条件商品，奖励 Y 个目标商品
+ * - all_targets: 满足条件后奖励全部目标商品
+ * - max_per_order: 满足条件后每单最多奖励固定数量目标商品
+ */
+
+/** 商品奖励目标选择规则 */
+
+/**
+ * 商品奖励 - Action Value
+ *
+ * @example
+ * value: {
+ *   rewardMethod: 'free',
+ *   quantityRule: 'per_condition_quantity',
+ *   triggerQuantity: 1,
+ *   rewardQuantity: 1,
+ * }
+ */
+
+/**
+ * 商品奖励 - Action Config
+ */
+
 // ============================================
 // 商品标识
 // ============================================
@@ -78,6 +115,10 @@ export var PROMOTION_ACTION_TYPES = {
  * 买X送Y Action
  */
 
+/**
+ * 商品奖励 Action
+ */
+
 /**
  * 促销活动 Action 联合类型
  */
@@ -146,6 +187,10 @@ var obj = {
  * 买X送Y Action 详情
  */
 
+/**
+ * 商品奖励 Action 详情
+ */
+
 // ============================================
 // 业务层输出类型（供参考）
 // ============================================

package/dist/modules/OpenData/index.d.ts

@@ -27,6 +27,8 @@ export declare class OpenDataModule extends BaseModule implements Module {
     fetchOpenData(params: OpenDataFetchParams): Promise<OpenDataConfig>;
     getOpenData(): OpenDataConfig | null;
     getLastFetchedAt(): number | null;
+    /** 清除内存与 sessionStorage 镜像中的 OpenData，供宿主切店时调用。 */
+    clearCache(): void;
     checkAvailability(scheduleModule?: ScheduleModule): OpenDataAvailabilityResult;
     storeChange(): void;
 }

package/dist/modules/OpenData/index.js

@@ -166,6 +166,14 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
       var _this$store$lastFetch;
       return (_this$store$lastFetch = this.store.lastFetchedAt) !== null && _this$store$lastFetch !== void 0 ? _this$store$lastFetch : null;
     }
+
+    /** 清除内存与 sessionStorage 镜像中的 OpenData，供宿主切店时调用。 */
+  }, {
+    key: "clearCache",
+    value: function clearCache() {
+      this.store.data = null;
+      this.store.lastFetchedAt = null;
+    }
   }, {
     key: "checkAvailability",
     value: function checkAvailability(scheduleModule) {

package/dist/modules/Order/index.d.ts

@@ -485,7 +485,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     generateIdempotencyToken(): string;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "virtual" | "appointment_booking";
+        type: "appointment_booking" | "virtual";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;

package/dist/modules/Order/index.js

@@ -85,6 +85,10 @@ function isPaidPaymentRecord(payment) {
 function isCommittedVoucherPaymentRecord(payment) {
   return isVoucherPaymentRecord(payment) && (payment === null || payment === void 0 ? void 0 : payment.status) !== 'voided' && (hasSyncedOrderPaymentRecord(payment) || isPaidPaymentRecord(payment));
 }
+function getVoucherPaymentLifecycleKey(payment) {
+  if (!isVoucherPaymentRecord(payment)) return null;
+  return "".concat(String(payment.voucher_id), "::").concat(String(payment.status || ''));
+}
 export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(OrderModule, _BaseModule);
   var _super = _createSuper(OrderModule);
@@ -3630,14 +3634,17 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       }).map(function (payment) {
         return String(payment.order_payment_id);
       }));
-      var committedVoucherIds = new Set(committedVoucherPayments.map(function (payment) {
-        return String(payment.voucher_id);
+      var committedVoucherLifecycleKeys = new Set(committedVoucherPayments.map(function (payment) {
+        return getVoucherPaymentLifecycleKey(payment);
+      }).filter(function (key) {
+        return key !== null;
       }));
       var replaceableVouchers = mappedVouchers.filter(function (payment) {
         if (hasSyncedOrderPaymentRecord(payment) && committedVoucherPaymentIds.has(String(payment.order_payment_id))) {
           return false;
         }
-        if (payment.voucher_id !== undefined && committedVoucherIds.has(String(payment.voucher_id))) {
+        var lifecycleKey = getVoucherPaymentLifecycleKey(payment);
+        if (lifecycleKey && committedVoucherLifecycleKeys.has(lifecycleKey)) {
           return false;
         }
         return true;

package/dist/modules/Order/utils.js

@@ -533,7 +533,8 @@ export function resolveEffectivePerUnitDiscount(product) {
     return sum + Number((discount === null || discount === void 0 ? void 0 : discount.amount) || 0);
   }, 0);
   var hasPromoDiscountItem = discountList.some(function (item) {
-    return (item === null || item === void 0 ? void 0 : item.type) === 'promotion';
+    var _item$metadata, _item$metadata2;
+    return (item === null || item === void 0 ? void 0 : item.type) === 'promotion' || (item === null || item === void 0 ? void 0 : item.type) === 'product' && (item === null || item === void 0 || (_item$metadata = item.metadata) === null || _item$metadata === void 0 ? void 0 : _item$metadata.source) === 'promotion' && (item === null || item === void 0 || (_item$metadata2 = item.metadata) === null || _item$metadata2 === void 0 ? void 0 : _item$metadata2.actionType) === 'ITEM_REWARD';
   });
   if (hasPromoDiscountItem) return fromList;
   var metadata = (product === null || product === void 0 ? void 0 : product.metadata) || {};

package/dist/modules/Rules/index.d.ts

@@ -35,6 +35,7 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
     excludeDiscountListByType(discountList: Discount[], type: string): Discount[];
     /** 手动改价场景：去掉 promotion，保留 type=product 等行内折扣 */
     resolveDiscountListForManualOverride(discountList: Discount[]): Discount[];
+    private isItemRewardProductDiscount;
     private getUnavailableReason;
     calcDiscount({ discountList, productList, holders, isFormSubject, orderTotalAmount }: {
         discountList: Discount[];

package/dist/modules/Rules/index.js

@@ -241,6 +241,17 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
     value: function resolveDiscountListForManualOverride(discountList) {
       return this.excludeDiscountListByType(discountList, 'promotion');
     }
+  }, {
+    key: "isItemRewardProductDiscount",
+    value: function isItemRewardProductDiscount(product) {
+      var _product$_promotion;
+      var discountList = Array.isArray(product === null || product === void 0 ? void 0 : product.discount_list) ? product.discount_list : [];
+      return (product === null || product === void 0 || (_product$_promotion = product._promotion) === null || _product$_promotion === void 0 ? void 0 : _product$_promotion.actionType) === 'ITEM_REWARD' && discountList.some(function (item) {
+        var _item$metadata, _item$metadata2;
+        return (item === null || item === void 0 ? void 0 : item.type) === 'product' && (item === null || item === void 0 || (_item$metadata = item.metadata) === null || _item$metadata === void 0 ? void 0 : _item$metadata.source) === 'promotion' && (item === null || item === void 0 || (_item$metadata2 = item.metadata) === null || _item$metadata2 === void 0 ? void 0 : _item$metadata2.actionType) === 'ITEM_REWARD';
+      });
+    }
+
     // 获取券不可用的原因
   }, {
     key: "getUnavailableReason",
@@ -729,6 +740,9 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             startDate: (_flatItem$parentProdu = flatItem.parentProduct) === null || _flatItem$parentProdu === void 0 ? void 0 : _flatItem$parentProdu.startDate
           };
         }
+        if (_this3.isItemRewardProductDiscount(product)) {
+          return false;
+        }
 
         // 编辑的商品使用了优惠券不可用
         var isAvailableProduct = flatItem.type === 'main' ? !((_product2 = product) !== null && _product2 !== void 0 && _product2.booking_id && (_product3 = product) !== null && _product3 !== void 0 && (_product3 = _product3.discount_list) !== null && _product3 !== void 0 && _product3.length && (_product4 = product) !== null && _product4 !== void 0 && (_product4 = _product4.discount_list) !== null && _product4 !== void 0 && _product4.every(function (d) {
@@ -915,6 +929,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           };
           originProduct = flatItem.originProduct;
         }
+        var isItemRewardProductDiscount = _this3.isItemRewardProductDiscount(product);
         addModeDiscount.forEach(function (discount) {
           var _product6, _product7, _product8, _product9, _flatItem$bundleItem3, _flatItem$bundleItem4, _discount$config;
           var limitedData = discount === null || discount === void 0 ? void 0 : discount.limited_relation_product_data;
@@ -940,7 +955,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           var isBundleAvailable = _this3.checkPackageSubItemUsageRules(discount, flatItem);
 
           // 判断优惠券是否适用于该商品
-          if (isAvailableProduct && isLimitedProduct && timeLimit && isBundleAvailable && (_discount$config = discount.config) !== null && _discount$config !== void 0 && _discount$config.isAvailable) {
+          if (isAvailableProduct && !isItemRewardProductDiscount && isLimitedProduct && timeLimit && isBundleAvailable && (_discount$config = discount.config) !== null && _discount$config !== void 0 && _discount$config.isAvailable) {
             var _discountApplicabilit, _discount$metadata4, _discount$metadata5;
             // 记录此优惠券适用的商品
             (_discountApplicabilit = discountApplicability.get(discount.id)) === null || _discountApplicabilit === void 0 || _discountApplicabilit.push(product.id);
@@ -1085,6 +1100,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         // 找到适用于此商品的所有优惠券，仅考虑isSelected不为false的优惠券
         var applicableDiscounts = sortedDiscountList.filter(function (discount) {
           var _product$discount_lis3, _product$discount_lis4;
+          if (_this3.isItemRewardProductDiscount(product)) return false;
           // 🔥 检查策略可用性（针对 good_pass 和折扣卡）
           var discountType = discount.tag || discount.type;
           var currentOriginUid = getOriginProductUid(originProduct);
@@ -1172,6 +1188,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
         // 如果是手动折扣，则不适用优惠券
         var isManualDiscount = false;
+        var isItemRewardProductDiscount = false;
         if (flatItem.type === 'main') {
           var _product$discount_lis5, _product$discount_lis6, _product12, _product12$every;
           // 主商品：判断自身是否手动折扣
@@ -1183,7 +1200,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           }) && (!((_product$discount_lis6 = product.discount_list) !== null && _product$discount_lis6 !== void 0 && _product$discount_lis6.length) || ((_product12 = product) === null || _product12 === void 0 || (_product12 = _product12.discount_list) === null || _product12 === void 0 || (_product12$every = _product12.every) === null || _product12$every === void 0 ? void 0 : _product12$every.call(_product12, function (item) {
             return item.type === 'product';
           })));
-          if (product.inPromotion) {
+          isItemRewardProductDiscount = _this3.isItemRewardProductDiscount(product);
+          if (product.inPromotion && !isItemRewardProductDiscount) {
             isManualDiscount = false;
           }
         } else {
@@ -1293,15 +1311,17 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               var main_product_selling_price = product.price;
               if ((product.discount_list || []).some(function (item) {
                 return item.type === 'promotion';
-              }) || isBoolean(product.vouchersApplicable) && !product.vouchersApplicable) {
+              }) || isItemRewardProductDiscount || isBoolean(product.vouchersApplicable) && !product.vouchersApplicable) {
                 var _product$total, _product$main_product;
                 total = (_product$total = product.total) !== null && _product$total !== void 0 ? _product$total : product.origin_total;
                 main_product_selling_price = (_product$main_product = product.main_product_selling_price) !== null && _product$main_product !== void 0 ? _product$main_product : main_product_selling_price;
               }
-              processedProductsMap.set(product._id, [_this3.hooks.setProduct(originProduct, _objectSpread(_objectSpread({}, isManualDiscount ? {
+              processedProductsMap.set(product._id, [_this3.hooks.setProduct(originProduct, _objectSpread(_objectSpread({}, isManualDiscount ? _objectSpread({
                 price: product.price,
-                main_product_selling_price: product.price
-              } : {
+                main_product_selling_price: isItemRewardProductDiscount ? main_product_selling_price : product.price
+              }, isItemRewardProductDiscount ? {
+                total: total
+              } : {}) : {
                 _id: product._id.split('___')[0] + '___' + index,
                 total: total,
                 price: product.price,
@@ -1750,11 +1770,11 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
                   processedItems.forEach(function (item) {
                     // 🔥 更新 discount_list 中的 num，使其与拆分后的 item.num 一致
                     var updatedDiscountList = (item.discount_list || []).map(function (discount) {
-                      var _item$metadata;
+                      var _item$metadata3;
                       return _objectSpread(_objectSpread({}, discount), {}, {
                         metadata: _objectSpread(_objectSpread({}, discount.metadata), {}, {
                           num: item.num,
-                          custom_product_bundle_map_id: (_item$metadata = item.metadata) === null || _item$metadata === void 0 ? void 0 : _item$metadata.custom_product_bundle_map_id
+                          custom_product_bundle_map_id: (_item$metadata3 = item.metadata) === null || _item$metadata3 === void 0 ? void 0 : _item$metadata3.custom_product_bundle_map_id
                         })
                         // num: item.num, // 使用拆分后的 num
                       });
@@ -1773,11 +1793,11 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
                   if (item.processed) {
                     // 🔥 同样需要更新 discount_list 中的 num
                     var _updatedDiscountList = (item.discount_list || []).map(function (discount) {
-                      var _item$metadata2;
+                      var _item$metadata4;
                       return _objectSpread(_objectSpread({}, discount), {}, {
                         metadata: _objectSpread(_objectSpread({}, discount.metadata), {}, {
                           num: item.num,
-                          custom_product_bundle_map_id: (_item$metadata2 = item.metadata) === null || _item$metadata2 === void 0 ? void 0 : _item$metadata2.custom_product_bundle_map_id
+                          custom_product_bundle_map_id: (_item$metadata4 = item.metadata) === null || _item$metadata4 === void 0 ? void 0 : _item$metadata4.custom_product_bundle_map_id
                         })
                         // num: item.num, // 使用当前的 num
                       });
@@ -1818,8 +1838,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
               // 🔥 使用更新后的列表计算折扣金额
               var mainDiscountList = updatedMainDiscountList.filter(function (item) {
-                var _item$metadata3;
-                return !(item !== null && item !== void 0 && (_item$metadata3 = item.metadata) !== null && _item$metadata3 !== void 0 && _item$metadata3.custom_product_bundle_map_id);
+                var _item$metadata5;
+                return !(item !== null && item !== void 0 && (_item$metadata5 = item.metadata) !== null && _item$metadata5 !== void 0 && _item$metadata5.custom_product_bundle_map_id);
               });
               if (mainDiscountList && mainDiscountList.length > 0) {
                 var _Decimal$minus$toNumb, _mainProductData$orig;
@@ -1892,8 +1912,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
                 // 🔥 使用更新后的列表计算折扣金额
                 var mainDiscountListOriginal = updatedMainDiscountListOriginal.filter(function (item) {
-                  var _item$metadata4;
-                  return !(item !== null && item !== void 0 && (_item$metadata4 = item.metadata) !== null && _item$metadata4 !== void 0 && _item$metadata4.custom_product_bundle_map_id);
+                  var _item$metadata6;
+                  return !(item !== null && item !== void 0 && (_item$metadata6 = item.metadata) !== null && _item$metadata6 !== void 0 && _item$metadata6.custom_product_bundle_map_id);
                 });
                 if (mainDiscountListOriginal && mainDiscountListOriginal.length > 0) {
                   var _Decimal$minus$toNumb2, _mainProductData$orig2;

package/dist/solution/BaseSales/index.d.ts

@@ -48,6 +48,11 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     protected store: BaseSalesState;
     protected otherParams: Record<string, any>;
     protected cacheId: string | undefined;
+    /**
+     * 由已在初始化阶段解析过设备短号的业务解决方案写入。
+     * 未设置时，支付编号仍按原逻辑实时读取设备信息。
+     */
+    protected paymentNumberDevicePrefix: string | null;
     /**
      * window / request 暴露为 public：现存外部工具（如 BookingTicket Scan）通过
      * `solution.window` / `solution.request` 直接访问插件，保持原有契约不破坏。
@@ -141,6 +146,11 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      */
     protected readSessionCacheData(): Record<string, any>;
     protected getAppData<T>(key: string): T | undefined;
+    /**
+     * 复用业务解决方案初始化时已解析的支付设备短号。
+     * 空值会清除缓存，使后续支付恢复实时读取设备信息的兼容路径。
+     */
+    protected setPaymentNumberDevicePrefix(prefix: unknown): void;
     private getPaymentNumberDevicePrefixSync;
     private getPaymentNumberDevicePrefixAsync;
     private syncAppDataToTempOrder;
@@ -284,7 +294,10 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * 同步兼容入口。无法等待 IoT 短号时，按调用当下的 device_id 或 LOCAL 生成。
      */
     addOrderPayment(payment: OrderPaymentSource): OrderPaymentData[];
-    /** 创建新支付项时读取最新设备短号，不缓存运行时设备信息。 */
+    /**
+     * 创建新支付项时优先使用业务解决方案初始化阶段缓存的设备短号；
+     * 未缓存的通用 BaseSales 保持实时读取设备信息的兼容语义。
+     */
     addOrderPaymentAsync(payment: OrderPaymentSource): Promise<OrderPaymentData[]>;
     private addOrderPaymentWithDevicePrefix;
     /** 更新当前订单中的指定支付项。 */

package/dist/solution/BaseSales/index.js

@@ -304,6 +304,11 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     });
     _defineProperty(_assertThisInitialized(_this), "otherParams", {});
     _defineProperty(_assertThisInitialized(_this), "cacheId", void 0);
+    /**
+     * 由已在初始化阶段解析过设备短号的业务解决方案写入。
+     * 未设置时，支付编号仍按原逻辑实时读取设备信息。
+     */
+    _defineProperty(_assertThisInitialized(_this), "paymentNumberDevicePrefix", null);
     /**
      * window / request 暴露为 public：现存外部工具（如 BookingTicket Scan）通过
      * `solution.window` / `solution.request` 直接访问插件，保持原有契约不破坏。
@@ -1148,6 +1153,17 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
       var coreData = app === null || app === void 0 || (_app$models = app.models) === null || _app$models === void 0 || (_app$models$getStore = _app$models.getStore) === null || _app$models$getStore === void 0 || (_app$models$getStore$ = (_app$models$getStore$2 = _app$models$getStore.call(_app$models)).getDataByModel) === null || _app$models$getStore$ === void 0 ? void 0 : _app$models$getStore$.call(_app$models$getStore$2, 'core', 'core');
       return coreData === null || coreData === void 0 ? void 0 : coreData[key];
     }
+
+    /**
+     * 复用业务解决方案初始化时已解析的支付设备短号。
+     * 空值会清除缓存，使后续支付恢复实时读取设备信息的兼容路径。
+     */
+  }, {
+    key: "setPaymentNumberDevicePrefix",
+    value: function setPaymentNumberDevicePrefix(prefix) {
+      var normalized = String(prefix !== null && prefix !== void 0 ? prefix : '').trim();
+      this.paymentNumberDevicePrefix = normalized || null;
+    }
   }, {
     key: "getPaymentNumberDevicePrefixSync",
     value: function getPaymentNumberDevicePrefixSync() {
@@ -1162,6 +1178,9 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
     value: function getPaymentNumberDevicePrefixAsync() {
       var _this8 = this;
       if (!this.appPlugin) return Promise.resolve('LOCAL');
+      if (this.paymentNumberDevicePrefix) {
+        return Promise.resolve(this.paymentNumberDevicePrefix);
+      }
       return resolvePaymentNumberDevicePrefix(function (key) {
         return _this8.getAppData(key);
       });
@@ -1222,6 +1241,7 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               options = _args11.length > 1 && _args11[1] !== undefined ? _args11[1] : {};
               this.core = core;
               this.initializeOptions = options || {};
+              this.paymentNumberDevicePrefix = null;
               // this.store = { ...this.store, ...(options.store as Partial<BaseSalesState>) };
               this.otherParams = options.otherParams || {};
               this.cacheId = (_this$otherParams4 = this.otherParams) === null || _this$otherParams4 === void 0 ? void 0 : _this$otherParams4.cacheId;
@@ -1232,11 +1252,11 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
               // 获取 logger 实例
               this.appPlugin = core.getPlugin('app');
               if (this.appPlugin) {
-                _context11.next = 11;
+                _context11.next = 12;
                 break;
               }
               throw new Error('Checkout 解决方案需要 app 插件支持');
-            case 11:
+            case 12:
               app = this.appPlugin.getApp();
               this.logger = app.logger;
               targetCacheData = this.readSessionCacheData();
@@ -1263,21 +1283,21 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 }));
               });
               if (!(this.store.schedule && !this.isScheduleListLoaded(this.store.schedule))) {
-                _context11.next = 19;
+                _context11.next = 20;
                 break;
               }
-              _context11.next = 19;
+              _context11.next = 20;
               return this.store.schedule.loadAllSchedule();
-            case 19:
+            case 20:
               if (this.store.order && typeof ((_this$otherParams5 = this.otherParams) === null || _this$otherParams5 === void 0 ? void 0 : _this$otherParams5.enableTempOrderPersist) === 'boolean') {
                 this.store.order.setEnableTempOrderPersist(this.otherParams.enableTempOrderPersist);
               }
-              _context11.next = 22;
+              _context11.next = 23;
               return this.getPaymentMethodsAsync();
-            case 22:
+            case 23:
               this.registerServerOrderChangeSync();
               this.core.effects.emit("".concat(this.name, ":onInited"), {});
-            case 24:
+            case 25:
             case "end":
               return _context11.stop();
           }
@@ -1311,13 +1331,14 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
                 }
               });
               this.currentSalesDetail = null;
+              this.paymentNumberDevicePrefix = null;
               this.queuedServerOrderChanges = [];
               this.salesDetailLoadSequence += 1;
-              _context12.next = 8;
+              _context12.next = 9;
               return this.core.effects.emit("".concat(this.name, ":onDestroy"), {});
-            case 8:
-              _get(_getPrototypeOf(BaseSalesImpl.prototype), "destroy", this).call(this);
             case 9:
+              _get(_getPrototypeOf(BaseSalesImpl.prototype), "destroy", this).call(this);
+            case 10:
             case "end":
               return _context12.stop();
           }
@@ -3106,7 +3127,10 @@ export var BaseSalesImpl = /*#__PURE__*/function (_BaseModule) {
       return this.addOrderPaymentWithDevicePrefix(payment, hasPaymentNumber ? 'LOCAL' : this.getPaymentNumberDevicePrefixSync());
     }
 
-    /** 创建新支付项时读取最新设备短号，不缓存运行时设备信息。 */
+    /**
+     * 创建新支付项时优先使用业务解决方案初始化阶段缓存的设备短号；
+     * 未缓存的通用 BaseSales 保持实时读取设备信息的兼容语义。
+     */
   }, {
     key: "addOrderPaymentAsync",
     value: (function () {

package/dist/solution/BaseSales/utils/cartPromotion.d.ts

@@ -78,6 +78,7 @@ export interface CartPromotionEvaluator {
         }>;
         hasApplicableStrategy: boolean;
     }>;
+    getStrategyConfigs?: () => unknown[];
 }
 /** 单个赠品减量项 */
 export interface GiftReduceItem {
@@ -267,7 +268,8 @@ export declare function appendPromotionTags<T extends Record<string, any>>(produ
  * 处理购物车的促销计算与赠品差异化。
  *
  * 流程：
- * 1. 分离 main / gift / edit-product 三类（带 `booking_id` 的编辑态商品不参与促销）
+ * 1. 分离 main / gift / edit-product 三类（普通促销下带 `booking_id` 的编辑态商品不参与；
+ *    配置 ITEM_REWARD 时，编辑态商品也参与商品奖励重算）
  * 2. 转 PromotionProduct 喂评估器 → 拿到 `evaluateCartWithPricing` 与 `getProductsApplicableStrategies`
  * 3. 把 PricedProduct 映射回 OrderProduct 形态：
  *    - 参与促销的，写 `metadata._promotion` + 调整 `selling_price` / `main_product_selling_price`