@pisell/pisellos 0.10.40 → 0.10.42

package/dist/modules/Rules/index.js

@@ -2,6 +2,10 @@ var _excluded = ["_original_add_price"],
   _excluded2 = ["_original_price", "_original_add_price"];
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
@@ -39,6 +43,7 @@ import { isBoolean } from 'lodash-es';
 import dayjs from 'dayjs';
 import { isOrderLevelFixedAmountDiscount } from "../../solution/ShopDiscount/utils";
 import { calculateOrderLevelDiscountAllocation } from "../../solution/ShopDiscount/utils";
+import { compareEntitlementPassPriority, getRemainingEntitlementUses, isEntitlementPass, isFullCoveragePass, resolveEntitlementQuota } from "../Discount/entitlementPass";
 export var RulesModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(RulesModule, _BaseModule);
   var _super = _createSuper(RulesModule);
@@ -181,7 +186,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
       // 合并新旧折扣列表，并计算折扣结果,注意，如果旧折扣里有 isEditMode 为 true 的优惠券，则不合并
       // 保留之前扫码得到的商品券（isScan: true）
       var filteredOldDiscountList = oldDiscountList.filter(function (discount) {
-        return !discount.isEditMode && (discount.tag !== 'good_pass' || discount.isScan);
+        return !discount.isEditMode && (!isFullCoveragePass(discount) || discount.isScan);
       });
       var mergedDiscountList = uniqueById([].concat(_toConsumableArray(filteredOldDiscountList), _toConsumableArray(newDiscountList)));
       var result = this.calcDiscount({
@@ -378,8 +383,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         if (!selectedDiscount) return false;
         var uid = getOriginProductUid(originProduct);
         if (!uid || !reapplyBookingDiscountProductUids.has(uid)) return false;
-        var discountType = selectedDiscount.tag || selectedDiscount.type;
-        return selectedDiscount.isEditMode === true && selectedDiscount.isSelected === true && ['good_pass', 'discount_card', 'product_discount_card'].includes(discountType);
+        var discountType = selectedDiscount.tag || selectedDiscount.type || '';
+        return selectedDiscount.isEditMode === true && selectedDiscount.isSelected === true && ['entitlement_pass', 'good_pass', 'discount_card', 'product_discount_card'].includes(discountType);
       };
       var resolveReapplyBookingDiscountPercent = function resolveReapplyBookingDiscountPercent(originProduct, selectedDiscount) {
         var _discount2;
@@ -427,8 +432,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         };
       }
       var canUseEditModeDiscountForReapply = function canUseEditModeDiscountForReapply(discount) {
-        var discountType = discount.tag || discount.type;
-        return reapplyBookingDiscountProductUids.size > 0 && discount.isEditMode === true && discount.isSelected === true && ['good_pass', 'discount_card', 'product_discount_card'].includes(discountType);
+        var discountType = discount.tag || discount.type || '';
+        return reapplyBookingDiscountProductUids.size > 0 && discount.isEditMode === true && discount.isSelected === true && ['entitlement_pass', 'good_pass', 'discount_card', 'product_discount_card'].includes(discountType);
       };
 
       // 过滤掉手动取消false的优惠券，但仅用于应用优惠逻辑。
@@ -510,6 +515,9 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         var isGoodPass = function isGoodPass(discount) {
           return discount.tag === 'good_pass';
         };
+        var isEntitlement = function isEntitlement(discount) {
+          return isEntitlementPass(discount);
+        };
 
         // 辅助函数：判断是否是订单级折扣卡
         var isOrderLevelDiscount = function isOrderLevelDiscount(discount) {
@@ -578,6 +586,14 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           }
           return 0;
         }
+        var entitlementA = isEntitlement(a);
+        var entitlementB = isEntitlement(b);
+        if (entitlementA || entitlementB) {
+          if (entitlementA && entitlementB) {
+            return compareEntitlementPassPriority(a, b);
+          }
+          return entitlementA ? -1 : 1;
+        }
 
         // 1. 先按优先级排序
         var priorityA = getPriority(a);
@@ -650,15 +666,23 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
       var evaluator = this.getWalletPassEvaluator();
       if (evaluator) {
         addModeDiscount.forEach(function (discount) {
-          var discountType = discount.tag || discount.type;
-          // 只对 good_pass 和 discount_card 类型执行策略检查
-          if (['good_pass', 'discount_card', 'product_discount_card'].includes(discountType)) {
+          var discountType = discount.tag || discount.type || '';
+          // 对两类全额抵扣卡和折扣卡执行附加策略检查。
+          if (['entitlement_pass', 'good_pass', 'discount_card', 'product_discount_card'].includes(discountType)) {
             var _discount$limited_rel, _discount$limited_rel2;
+            var entitlementQuota = isEntitlementPass(discount) ? resolveEntitlementQuota(discount) : null;
+            if (isEntitlementPass(discount) && !entitlementQuota) {
+              discount.config = {
+                isAvailable: false
+              };
+              return;
+            }
+
             // 转换 discount 为 Voucher 格式
             var voucher = {
               id: discount.id,
               amount: Number(discount.par_value || 0),
-              balance: Number(discount.balance || 0),
+              balance: (entitlementQuota === null || entitlementQuota === void 0 ? void 0 : entitlementQuota.type) === 'unlimited' ? Number.MAX_SAFE_INTEGER : (entitlementQuota === null || entitlementQuota === void 0 ? void 0 : entitlementQuota.type) === 'limited' ? entitlementQuota.balance : Number(discount.balance || 0),
               type: discountType,
               product_id: discount.product_id,
               unified_available_status: 1,
@@ -716,11 +740,154 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
       });
        */
 
-      // 标记已使用的优惠券
+      // good_pass / 折扣卡保持原有的一次性使用标记。
       var usedDiscounts = new Map();
 
+      // Entitlement Pass 单独记录本次重算新增分配的次数。
+      var entitlementUsageCounts = new Map();
+
       // 🔥 统计每个 product_id（商品券商品id）已使用的数量，用于 maxUsagePerOrder 限制
       var usedProductIdCounts = new Map();
+      var markDiscountUsed = function markDiscountUsed(discount) {
+        var count = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1;
+        if (isEntitlementPass(discount)) {
+          entitlementUsageCounts.set(discount.id, (entitlementUsageCounts.get(discount.id) || 0) + count);
+          return;
+        }
+        usedDiscounts.set(discount.id, true);
+      };
+      var isDiscountUsed = function isDiscountUsed(discount) {
+        if (isEntitlementPass(discount)) {
+          return (entitlementUsageCounts.get(discount.id) || 0) > 0;
+        }
+        return usedDiscounts.get(discount.id) === true;
+      };
+      var buildFullCoveragePassUsageGroups = function buildFullCoveragePassUsageGroups(discounts, requestedCount) {
+        var _firstGoodPass$config;
+        var groups = [];
+        var pendingUsedDiscounts = new Set(Array.from(usedDiscounts.entries()).filter(function (_ref6) {
+          var _ref7 = _slicedToArray(_ref6, 2),
+            used = _ref7[1];
+          return used;
+        }).map(function (_ref8) {
+          var _ref9 = _slicedToArray(_ref8, 1),
+            discountId = _ref9[0];
+          return discountId;
+        }));
+        var pendingEntitlementCounts = new Map(entitlementUsageCounts);
+        var pendingProductCounts = new Map(usedProductIdCounts);
+        var firstGoodPass = discounts.find(function (discount) {
+          return isFullCoveragePass(discount) && !isEntitlementPass(discount);
+        });
+        var legacyGoodPassPerLineLimit = firstGoodPass ? Number(((_firstGoodPass$config = firstGoodPass.config) === null || _firstGoodPass$config === void 0 ? void 0 : _firstGoodPass$config.maxUsagePerOrder) || 0) : 0;
+        var allocatedGoodPassCount = 0;
+        var remaining = Math.max(Math.floor(requestedCount), 0);
+        var _iterator5 = _createForOfIteratorHelper(discounts),
+          _step5;
+        try {
+          var _loop = function _loop() {
+              var _discount$config;
+              var discount = _step5.value;
+              if (remaining <= 0) return 0; // break
+              if (!isFullCoveragePass(discount)) return 1; // continue
+              var currentEntitlementCount = pendingEntitlementCounts.get(discount.id) || 0;
+              var availableCount = isEntitlementPass(discount) ? getRemainingEntitlementUses(discount, currentEntitlementCount, remaining) : pendingUsedDiscounts.has(discount.id) ? 0 : 1;
+              if (!isEntitlementPass(discount) && legacyGoodPassPerLineLimit > 0) {
+                availableCount = Math.min(availableCount, Math.max(Math.floor(legacyGoodPassPerLineLimit) - allocatedGoodPassCount, 0));
+              }
+              var maxUsagePerOrder = Number(((_discount$config = discount.config) === null || _discount$config === void 0 ? void 0 : _discount$config.maxUsagePerOrder) || 0);
+              if (isEntitlementPass(discount) && maxUsagePerOrder > 0) {
+                var currentProductCount = pendingProductCounts.get(discount.product_id) || 0;
+                availableCount = Math.min(availableCount, Math.max(Math.floor(maxUsagePerOrder) - currentProductCount, 0));
+              }
+              var allocatedCount = Math.min(availableCount, remaining);
+              if (allocatedCount <= 0) return 1; // continue
+              var existingGroup = groups.find(function (group) {
+                return String(group.discount.id) === String(discount.id);
+              });
+              if (existingGroup) {
+                existingGroup.count += allocatedCount;
+              } else {
+                groups.push({
+                  discount: discount,
+                  count: allocatedCount
+                });
+              }
+              if (isEntitlementPass(discount)) {
+                pendingEntitlementCounts.set(discount.id, currentEntitlementCount + allocatedCount);
+              } else {
+                pendingUsedDiscounts.add(discount.id);
+                allocatedGoodPassCount += allocatedCount;
+              }
+              pendingProductCounts.set(discount.product_id, (pendingProductCounts.get(discount.product_id) || 0) + allocatedCount);
+              remaining -= allocatedCount;
+            },
+            _ret;
+          for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+            _ret = _loop();
+            if (_ret === 0) break;
+            if (_ret === 1) continue;
+          }
+        } catch (err) {
+          _iterator5.e(err);
+        } finally {
+          _iterator5.f();
+        }
+        return groups;
+      };
+      var mergeEntitlementAppliedProductDetails = function mergeEntitlementAppliedProductDetails(details) {
+        var mergedDetails = [];
+        var mergedIndexByKey = new Map();
+        var toComparableNumber = function toComparableNumber(value) {
+          var numberValue = Number(value);
+          return Number.isFinite(numberValue) ? String(numberValue) : String(value !== null && value !== void 0 ? value : '');
+        };
+        var _iterator6 = _createForOfIteratorHelper(details || []),
+          _step6;
+        try {
+          for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+            var _detail$discount$reso, _detail$discount, _detail$discount$prod, _detail$discount2, _detail$metadata$cust, _detail$metadata, _detail$discount3, _ref10, _detail$metadata$num, _detail$metadata2, _ref11, _existed$metadata$num, _existed$metadata;
+            var detail = _step6.value;
+            if (!isEntitlementPass(detail)) {
+              mergedDetails.push(detail);
+              continue;
+            }
+            var resourceId = (_detail$discount$reso = detail === null || detail === void 0 || (_detail$discount = detail.discount) === null || _detail$discount === void 0 ? void 0 : _detail$discount.resource_id) !== null && _detail$discount$reso !== void 0 ? _detail$discount$reso : detail === null || detail === void 0 ? void 0 : detail.resource_id;
+            if (resourceId === undefined || resourceId === null) {
+              mergedDetails.push(detail);
+              continue;
+            }
+            var key = [resourceId, (_detail$discount$prod = detail === null || detail === void 0 || (_detail$discount2 = detail.discount) === null || _detail$discount2 === void 0 ? void 0 : _detail$discount2.product_id) !== null && _detail$discount$prod !== void 0 ? _detail$discount$prod : '', (_detail$metadata$cust = detail === null || detail === void 0 || (_detail$metadata = detail.metadata) === null || _detail$metadata === void 0 ? void 0 : _detail$metadata.custom_product_bundle_map_id) !== null && _detail$metadata$cust !== void 0 ? _detail$metadata$cust : '', toComparableNumber(detail === null || detail === void 0 ? void 0 : detail.amount), toComparableNumber(detail === null || detail === void 0 || (_detail$discount3 = detail.discount) === null || _detail$discount3 === void 0 ? void 0 : _detail$discount3.fixed_amount)].join('|');
+            var rawUsageCount = Number((_ref10 = (_detail$metadata$num = detail === null || detail === void 0 || (_detail$metadata2 = detail.metadata) === null || _detail$metadata2 === void 0 ? void 0 : _detail$metadata2.num) !== null && _detail$metadata$num !== void 0 ? _detail$metadata$num : detail === null || detail === void 0 ? void 0 : detail._num) !== null && _ref10 !== void 0 ? _ref10 : 1);
+            var usageCount = Number.isFinite(rawUsageCount) && rawUsageCount > 0 ? rawUsageCount : 1;
+            var mergedIndex = mergedIndexByKey.get(key);
+            if (mergedIndex === undefined) {
+              mergedIndexByKey.set(key, mergedDetails.length);
+              mergedDetails.push(_objectSpread(_objectSpread({}, detail), {}, {
+                metadata: _objectSpread(_objectSpread({}, (detail === null || detail === void 0 ? void 0 : detail.metadata) || {}), {}, {
+                  num: usageCount
+                }),
+                _num: usageCount
+              }));
+              continue;
+            }
+            var existed = mergedDetails[mergedIndex];
+            var existedUsageCount = Number((_ref11 = (_existed$metadata$num = existed === null || existed === void 0 || (_existed$metadata = existed.metadata) === null || _existed$metadata === void 0 ? void 0 : _existed$metadata.num) !== null && _existed$metadata$num !== void 0 ? _existed$metadata$num : existed === null || existed === void 0 ? void 0 : existed._num) !== null && _ref11 !== void 0 ? _ref11 : 1);
+            var totalUsageCount = existedUsageCount + usageCount;
+            mergedDetails[mergedIndex] = _objectSpread(_objectSpread({}, existed), {}, {
+              metadata: _objectSpread(_objectSpread({}, (existed === null || existed === void 0 ? void 0 : existed.metadata) || {}), {}, {
+                num: totalUsageCount
+              }),
+              _num: totalUsageCount
+            });
+          }
+        } catch (err) {
+          _iterator6.e(err);
+        } finally {
+          _iterator6.f();
+        }
+        return mergedDetails;
+      };
 
       // 记录每个优惠券适用的商品ID
       var discountApplicability = new Map();
@@ -769,7 +936,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
         // 编辑的商品使用了优惠券不可用
         var isAvailableProduct = flatItem.type === 'main' ? !((_product = product) !== null && _product !== void 0 && _product.booking_id && (_product2 = product) !== null && _product2 !== void 0 && (_product2 = _product2.discount_list) !== null && _product2 !== void 0 && _product2.length && (_product3 = product) !== null && _product3 !== void 0 && (_product3 = _product3.discount_list) !== null && _product3 !== void 0 && _product3.every(function (d) {
-          return d.id && ['good_pass', 'discount_card', 'product_discount_card'].includes(d.tag || d.type);
+          return d.id && ['entitlement_pass', 'good_pass', 'discount_card', 'product_discount_card'].includes(d.tag || d.type);
         })) : !(flatItem !== null && flatItem !== void 0 && flatItem.booking_id && !!(flatItem !== null && flatItem !== void 0 && (_flatItem$bundleItem = flatItem.bundleItem) !== null && _flatItem$bundleItem !== void 0 && (_flatItem$bundleItem = _flatItem$bundleItem.discount_list) !== null && _flatItem$bundleItem !== void 0 && _flatItem$bundleItem.length) && flatItem !== null && flatItem !== void 0 && (_flatItem$bundleItem2 = flatItem.bundleItem) !== null && _flatItem$bundleItem2 !== void 0 && (_flatItem$bundleItem2 = _flatItem$bundleItem2.discount_list) !== null && _flatItem$bundleItem2 !== void 0 && _flatItem$bundleItem2.every(function (d) {
           return d.id;
         }));
@@ -869,7 +1036,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         // 收集该折扣卡适用的商品（排除被其他专属折扣卡占用的商品）
         var applicableProducts = [];
         sortedFlattenedList.forEach(function (flatItem) {
-          var _flatItem$parentProdu2, _flatItem$parentProdu3, _product$price, _ref6, _flatItem$original_pr;
+          var _flatItem$parentProdu2, _flatItem$parentProdu3, _product$price, _ref12, _flatItem$original_pr;
           // 🔥 检查该商品是否被其他专属折扣卡占用
           var occupyingDiscountId = occupiedItems.get(flatItem._id);
           if (occupyingDiscountId !== undefined && occupyingDiscountId !== discount.id) {
@@ -897,7 +1064,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
           // 对于主商品：使用 price
           // 对于子商品：优先使用 flatItem.original_price，否则使用 flatItem.price
-          var originalAmount = flatItem.type === 'main' ? Number((_product$price = product.price) !== null && _product$price !== void 0 ? _product$price : 0) : Number((_ref6 = (_flatItem$original_pr = flatItem.original_price) !== null && _flatItem$original_pr !== void 0 ? _flatItem$original_pr : flatItem.price) !== null && _ref6 !== void 0 ? _ref6 : 0);
+          var originalAmount = flatItem.type === 'main' ? Number((_product$price = product.price) !== null && _product$price !== void 0 ? _product$price : 0) : Number((_ref12 = (_flatItem$original_pr = flatItem.original_price) !== null && _flatItem$original_pr !== void 0 ? _flatItem$original_pr : flatItem.price) !== null && _ref12 !== void 0 ? _ref12 : 0);
 
           // 传递 parentQuantity 用于差值处理时判断是否是真正的"数量为1"
           var productData = {
@@ -954,7 +1121,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         }
         var isItemRewardProductDiscount = _this4.isItemRewardProductDiscount(product);
         addModeDiscount.forEach(function (discount) {
-          var _product5, _product6, _product7, _product8, _flatItem$bundleItem3, _flatItem$bundleItem4, _discount$config;
+          var _product5, _product6, _product7, _product8, _flatItem$bundleItem3, _flatItem$bundleItem4, _discount$config2;
           var limitedData = discount === null || discount === void 0 ? void 0 : discount.limited_relation_product_data;
           // 拿到discount配置的holder信息 product信息 product.holder 加在 isLimitedProduct
           var _tempVar = (flatItem === null || flatItem === void 0 ? void 0 : flatItem.type) === 'bundle' ? flatItem === null || flatItem === void 0 ? void 0 : flatItem.parentProduct : flatItem === null || flatItem === void 0 ? void 0 : flatItem.product;
@@ -969,7 +1136,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
           // 编辑的商品 使用了优惠券不可用
           var isAvailableProduct = flatItem.type === 'main' ? !((_product6 = product) !== null && _product6 !== void 0 && _product6.booking_id && (_product7 = product) !== null && _product7 !== void 0 && (_product7 = _product7.discount_list) !== null && _product7 !== void 0 && _product7.length && (_product8 = product) !== null && _product8 !== void 0 && (_product8 = _product8.discount_list) !== null && _product8 !== void 0 && _product8.every(function (discount) {
-            return discount.id && ['good_pass', 'discount_card', 'product_discount_card'].includes(discount.tag || discount.type);
+            return discount.id && ['entitlement_pass', 'good_pass', 'discount_card', 'product_discount_card'].includes(discount.tag || discount.type);
           })) : !(flatItem !== null && flatItem !== void 0 && flatItem.booking_id && !!(flatItem !== null && flatItem !== void 0 && (_flatItem$bundleItem3 = flatItem.bundleItem) !== null && _flatItem$bundleItem3 !== void 0 && (_flatItem$bundleItem3 = _flatItem$bundleItem3.discount_list) !== null && _flatItem$bundleItem3 !== void 0 && _flatItem$bundleItem3.length) && flatItem !== null && flatItem !== void 0 && (_flatItem$bundleItem4 = flatItem.bundleItem) !== null && _flatItem$bundleItem4 !== void 0 && (_flatItem$bundleItem4 = _flatItem$bundleItem4.discount_list) !== null && _flatItem$bundleItem4 !== void 0 && _flatItem$bundleItem4.every(function (discount) {
             return discount.id;
           }));
@@ -978,7 +1145,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           var isBundleAvailable = _this4.checkPackageSubItemUsageRules(discount, flatItem);
 
           // 判断优惠券是否适用于该商品
-          if (isAvailableProduct && !isItemRewardProductDiscount && isLimitedProduct && timeLimit && isBundleAvailable && (_discount$config = discount.config) !== null && _discount$config !== void 0 && _discount$config.isAvailable) {
+          if (isAvailableProduct && !isItemRewardProductDiscount && isLimitedProduct && timeLimit && isBundleAvailable && (_discount$config2 = discount.config) !== null && _discount$config2 !== void 0 && _discount$config2.isAvailable && (!isEntitlementPass(discount) || getRemainingEntitlementUses(discount, 0, 1) > 0)) {
             var _discountApplicabilit, _discount$metadata4, _discount$metadata5;
             // 记录此优惠券适用的商品
             (_discountApplicabilit = discountApplicability.get(discount.id)) === null || _discountApplicabilit === void 0 || _discountApplicabilit.push(product.id);
@@ -986,10 +1153,10 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             // 记录可抵扣的商品详情
             var applicableProducts = discountApplicableProducts.get(discount.id) || [];
             var discountType = discount.tag || discount.type;
-            var isGoodPass = discountType === 'good_pass';
+            var isFullCoverage = isFullCoveragePass(discount);
 
             // 使用数量
-            var num = isGoodPass || (flatItem === null || flatItem === void 0 ? void 0 : flatItem.type) === 'main' ? 1 : product.num;
+            var num = isFullCoverage || (flatItem === null || flatItem === void 0 ? void 0 : flatItem.type) === 'main' ? 1 : product.num;
             var productData = {
               amount: product.price * num,
               type: discountType,
@@ -1027,13 +1194,13 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         };
         var optionDiscountAmount = 0;
         var discountedOptions = options.map(function (option) {
-          var _ref7, _ref8, _option$_original_pri, _ref9, _option$num, _rest$price, _option$_original_pri2;
+          var _ref13, _ref14, _option$_original_pri, _ref15, _option$num, _rest$price, _option$_original_pri2;
           // 折前单价：优先 price，缺失再 add_price；已写回折后价时用 _original_price（或旧字段 _original_add_price）
-          var rawUnit = (_ref7 = (_ref8 = (_option$_original_pri = option._original_price) !== null && _option$_original_pri !== void 0 ? _option$_original_pri : option._original_add_price) !== null && _ref8 !== void 0 ? _ref8 : option.price) !== null && _ref7 !== void 0 ? _ref7 : option.add_price;
+          var rawUnit = (_ref13 = (_ref14 = (_option$_original_pri = option._original_price) !== null && _option$_original_pri !== void 0 ? _option$_original_pri : option._original_add_price) !== null && _ref14 !== void 0 ? _ref14 : option.price) !== null && _ref13 !== void 0 ? _ref13 : option.add_price;
           var baseUnitNum = Number(rawUnit !== null && rawUnit !== void 0 ? rawUnit : 0);
           if (baseUnitNum <= 0) return option;
           var discountedPrice = getDiscountAmount(discount, baseUnitNum, baseUnitNum);
-          var optQty = Number((_ref9 = (_option$num = option.num) !== null && _option$num !== void 0 ? _option$num : option.quantity) !== null && _ref9 !== void 0 ? _ref9 : 1);
+          var optQty = Number((_ref15 = (_option$num = option.num) !== null && _option$num !== void 0 ? _option$num : option.quantity) !== null && _ref15 !== void 0 ? _ref15 : 1);
           optionDiscountAmount = new Decimal(optionDiscountAmount).plus(new Decimal(baseUnitNum).minus(discountedPrice).mul(optQty)).toNumber();
           var _original_add_price = option._original_add_price,
             rest = _objectWithoutProperties(option, _excluded);
@@ -1067,9 +1234,9 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
       var getOptionTotal = function getOptionTotal(options) {
         if (!(options !== null && options !== void 0 && options.length)) return 0;
         return options.reduce(function (sum, opt) {
-          var _ref10, _opt$price, _ref11, _opt$num;
-          var unit = Number((_ref10 = (_opt$price = opt.price) !== null && _opt$price !== void 0 ? _opt$price : opt.add_price) !== null && _ref10 !== void 0 ? _ref10 : 0);
-          var n = Number((_ref11 = (_opt$num = opt.num) !== null && _opt$num !== void 0 ? _opt$num : opt.quantity) !== null && _ref11 !== void 0 ? _ref11 : 1);
+          var _ref16, _opt$price, _ref17, _opt$num;
+          var unit = Number((_ref16 = (_opt$price = opt.price) !== null && _opt$price !== void 0 ? _opt$price : opt.add_price) !== null && _ref16 !== void 0 ? _ref16 : 0);
+          var n = Number((_ref17 = (_opt$num = opt.num) !== null && _opt$num !== void 0 ? _opt$num : opt.quantity) !== null && _ref17 !== void 0 ? _ref17 : 1);
           return new Decimal(sum).plus(new Decimal(unit).mul(n)).toNumber();
         }, 0);
       };
@@ -1106,7 +1273,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           var _discount$id, _discount$discount4;
           var discountIdentity = (_discount$id = discount.id) !== null && _discount$id !== void 0 ? _discount$id : (_discount$discount4 = discount.discount) === null || _discount$discount4 === void 0 ? void 0 : _discount$discount4.resource_id;
           var discountType = discount.tag || discount.type;
-          return Boolean(discountIdentity && ['good_pass', 'discount_card', 'product_discount_card'].includes(discountType));
+          return Boolean(discountIdentity && ['entitlement_pass', 'good_pass', 'discount_card', 'product_discount_card'].includes(discountType));
         }));
 
         // 已持久化且已有钱包券/折扣卡的商品行跳过，保留后端历史折扣结果。
@@ -1124,8 +1291,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         var applicableDiscounts = sortedDiscountList.filter(function (discount) {
           var _product$discount_lis3, _product$discount_lis4;
           if (_this4.isItemRewardProductDiscount(product)) return false;
-          // 🔥 检查策略可用性（针对 good_pass 和折扣卡）
-          var discountType = discount.tag || discount.type;
+          // 🔥 检查策略可用性（针对全额抵扣卡和折扣卡）
+          var discountType = discount.tag || discount.type || '';
           var currentOriginUid = getOriginProductUid(originProduct);
           var isReapplyEditModeDiscountForProduct = discount.isEditMode && reapplyBookingDiscountProductUids.size > 0 && currentOriginUid && reapplyBookingDiscountProductUids.has(String(currentOriginUid)) && discount.isSelected === true;
           if (discount.isEditMode && reapplyBookingDiscountProductUids.size > 0) {
@@ -1133,31 +1300,36 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             if (!uid || !reapplyBookingDiscountProductUids.has(uid)) return false;
             if (!discount.isSelected) return false;
           }
-          if (['good_pass', 'discount_card', 'product_discount_card'].includes(discountType) && !isReapplyEditModeDiscountForProduct) {
-            var _discount$config2;
+          if (['entitlement_pass', 'good_pass', 'discount_card', 'product_discount_card'].includes(discountType) && !isReapplyEditModeDiscountForProduct) {
+            var _discount$config3;
             // 如果策略检查后没有config，说明不可用
-            if (discount.config === undefined || !(discount !== null && discount !== void 0 && (_discount$config2 = discount.config) !== null && _discount$config2 !== void 0 && _discount$config2.isAvailable)) {
+            if (discount.config === undefined || !(discount !== null && discount !== void 0 && (_discount$config3 = discount.config) !== null && _discount$config3 !== void 0 && _discount$config3.isAvailable)) {
               return false;
             }
           }
 
           // 如果商品价格为 0，其实不需要使用任何优惠券，直接 return true
-          // 商品券时主商品价格为0不可用
-          if ((Number(product.price) <= 0 || !product.price) && !((_product$discount_lis3 = product.discount_list) !== null && _product$discount_lis3 !== void 0 && _product$discount_lis3.length) && (discount.tag || discount.type) === 'good_pass') return false;
+          // 全额抵扣卡在主商品价格为 0 时不可用。
+          if ((Number(product.price) <= 0 || !product.price) && !((_product$discount_lis3 = product.discount_list) !== null && _product$discount_lis3 !== void 0 && _product$discount_lis3.length) && isFullCoveragePass(discount)) return false;
 
           // 折扣卡商品价格为0时不可用
           if ((Number(product.price) <= 0 || !product.price) && !((_product$discount_lis4 = product.discount_list) !== null && _product$discount_lis4 !== void 0 && _product$discount_lis4.find(function (n) {
             var _n$discount;
             return ((_n$discount = n.discount) === null || _n$discount === void 0 ? void 0 : _n$discount.resource_id) === discount.id;
-          })) && (discount.tag || discount.type) !== 'good_pass') return false;
-          // 如果优惠券已被使用，则跳过
-          var targetUsedDiscounts = usedDiscounts.get(discount.id);
-          if (targetUsedDiscounts && (discount.tag || discount.type) === 'good_pass') return false;
+          })) && !isFullCoveragePass(discount)) return false;
+          // good_pass 保持一张实例只使用一次。
+          if ((discount.tag || discount.type) === 'good_pass' && usedDiscounts.get(discount.id)) {
+            return false;
+          }
+          // 有限次数卡按后端实时 balance 约束本次新增分配；无限卡不看余额。
+          if (isEntitlementPass(discount) && getRemainingEntitlementUses(discount, entitlementUsageCounts.get(discount.id) || 0, 1) <= 0) {
+            return false;
+          }
 
           // 🔥 检查 maxUsagePerOrder 限制：同一 product_id 的商品券使用数量不能超过配置值
-          if ((discount.tag || discount.type) === 'good_pass') {
-            var _discount$config3;
-            var maxUsagePerOrder = (_discount$config3 = discount.config) === null || _discount$config3 === void 0 ? void 0 : _discount$config3.maxUsagePerOrder;
+          if (isFullCoveragePass(discount)) {
+            var _discount$config4;
+            var maxUsagePerOrder = (_discount$config4 = discount.config) === null || _discount$config4 === void 0 ? void 0 : _discount$config4.maxUsagePerOrder;
             if (maxUsagePerOrder && maxUsagePerOrder > 0) {
               var currentUsedCount = usedProductIdCounts.get(discount.product_id) || 0;
               if (currentUsedCount >= maxUsagePerOrder) {
@@ -1204,38 +1376,40 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         // 用户显式点击某张卡券时，本次选择优先于自动排序和扫码默认选择。
         // 目标仍必须在当前商品的 applicableDiscounts 中，因此不会绕过 Holder、时间或商品范围校验。
         var explicitlySelectedDiscount = (options === null || options === void 0 ? void 0 : options.isSelected) === true && options.discountId !== undefined ? applicableDiscounts.find(function (discount) {
-          var discountType = discount.tag || discount.type;
-          return String(discount.id) === String(options.discountId) && ['good_pass', 'discount_card', 'product_discount_card'].includes(discountType);
+          var discountType = discount.tag || discount.type || '';
+          return String(discount.id) === String(options.discountId) && ['entitlement_pass', 'good_pass', 'discount_card', 'product_discount_card'].includes(discountType);
         }) : undefined;
         // 折扣卡会复用于整条商品行；商品券必须继续按单张拆分，不能复用该分支。
-        var explicitlySelectedDiscountCard = explicitlySelectedDiscount && (explicitlySelectedDiscount.tag || explicitlySelectedDiscount.type) !== 'good_pass' ? explicitlySelectedDiscount : undefined;
+        var explicitlySelectedDiscountCard = explicitlySelectedDiscount && !isFullCoveragePass(explicitlySelectedDiscount) ? explicitlySelectedDiscount : undefined;
 
         // 商品数量等变化会触发无 discountId 的重算。只要当前行已应用的折扣卡仍在
         // applicableDiscounts 中，就应保留该行选择，避免被自动排序中力度更大的卡替换。
         var appliedDiscountCardIds = new Set((product.discount_list || []).filter(function (item) {
           return ['discount_card', 'product_discount_card'].includes((item === null || item === void 0 ? void 0 : item.tag) || (item === null || item === void 0 ? void 0 : item.type));
         }).map(function (item) {
-          var _ref12, _item$discount$resour, _item$discount;
-          return (_ref12 = (_item$discount$resour = item === null || item === void 0 || (_item$discount = item.discount) === null || _item$discount === void 0 ? void 0 : _item$discount.resource_id) !== null && _item$discount$resour !== void 0 ? _item$discount$resour : item === null || item === void 0 ? void 0 : item.resource_id) !== null && _ref12 !== void 0 ? _ref12 : item === null || item === void 0 ? void 0 : item.id;
+          var _ref18, _item$discount$resour, _item$discount;
+          return (_ref18 = (_item$discount$resour = item === null || item === void 0 || (_item$discount = item.discount) === null || _item$discount === void 0 ? void 0 : _item$discount.resource_id) !== null && _item$discount$resour !== void 0 ? _item$discount$resour : item === null || item === void 0 ? void 0 : item.resource_id) !== null && _ref18 !== void 0 ? _ref18 : item === null || item === void 0 ? void 0 : item.id;
         }).filter(function (id) {
           return id !== undefined && id !== null;
         }).map(String));
         var appliedDiscountCard = options !== null && options !== void 0 && options.scan ? undefined : applicableDiscounts.find(function (discount) {
-          var discountType = discount.tag || discount.type;
+          var discountType = discount.tag || discount.type || '';
           return discount.isSelected === true && ['discount_card', 'product_discount_card'].includes(discountType) && appliedDiscountCardIds.has(String(discount.id));
         });
 
-        // 优先级：本次显式选择 > 当前行既有选择 > 扫码选择 > 自动排序第一项。
+        // Entitlement Pass 始终按协议优先级使用；没有新卡时沿用原选择优先级。
         var scannedSelectedDiscountCard = applicableDiscounts.find(function (n) {
-          return n.isScan && n.isSelected && (n.tag || n.type) !== 'good_pass';
+          return n.isScan && n.isSelected && !isFullCoveragePass(n);
         });
         var selectedDiscountCard = explicitlySelectedDiscountCard || appliedDiscountCard || scannedSelectedDiscountCard;
-        var selectedDiscount = explicitlySelectedDiscount || selectedDiscountCard || applicableDiscounts[0];
-        var prioritizedApplicableDiscounts = explicitlySelectedDiscount && (explicitlySelectedDiscount.tag || explicitlySelectedDiscount.type) === 'good_pass' ? [explicitlySelectedDiscount].concat(_toConsumableArray(applicableDiscounts.filter(function (discount) {
-          var discountType = discount.tag || discount.type;
-          return discountType === 'good_pass' && String(discount.id) !== String(explicitlySelectedDiscount.id);
+        var highestPriorityEntitlementPass = applicableDiscounts.find(function (discount) {
+          return isEntitlementPass(discount);
+        });
+        var selectedDiscount = highestPriorityEntitlementPass || explicitlySelectedDiscount || selectedDiscountCard || applicableDiscounts[0];
+        var prioritizedApplicableDiscounts = !highestPriorityEntitlementPass && explicitlySelectedDiscount && isFullCoveragePass(explicitlySelectedDiscount) ? [explicitlySelectedDiscount].concat(_toConsumableArray(applicableDiscounts.filter(function (discount) {
+          return isFullCoveragePass(discount) && String(discount.id) !== String(explicitlySelectedDiscount.id);
         })), _toConsumableArray(applicableDiscounts.filter(function (discount) {
-          return (discount.tag || discount.type) !== 'good_pass';
+          return !isFullCoveragePass(discount);
         }))) : applicableDiscounts;
 
         // 如果是手动折扣，则不适用优惠券
@@ -1247,8 +1421,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           isManualDiscount = typeof product.isManualDiscount === 'boolean' ? product.isManualDiscount : ((_product$discount_lis5 = product.discount_list) === null || _product$discount_lis5 === void 0 ? void 0 : _product$discount_lis5.some(function (item) {
             return item.type === 'product';
           })) || product.total != product.origin_total && (product.bundle || []).every(function (item) {
-            var _ref13;
-            return !((_ref13 = item.discount_list || []) !== null && _ref13 !== void 0 && _ref13.length);
+            var _ref19;
+            return !((_ref19 = item.discount_list || []) !== null && _ref19 !== void 0 && _ref19.length);
           }) && (!((_product$discount_lis6 = product.discount_list) !== null && _product$discount_lis6 !== void 0 && _product$discount_lis6.length) || ((_product11 = product) === null || _product11 === void 0 || (_product11 = _product11.discount_list) === null || _product11 === void 0 || (_product11$every = _product11.every) === null || _product11$every === void 0 ? void 0 : _product11$every.call(_product11, function (item) {
             return item.type === 'product';
           })));
@@ -1264,8 +1438,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             isManualDiscount = typeof parentProduct.isManualDiscount === 'boolean' ? parentProduct.isManualDiscount : ((_parentProduct$discou = parentProduct.discount_list) === null || _parentProduct$discou === void 0 ? void 0 : _parentProduct$discou.some(function (item) {
               return item.type === 'product';
             })) || parentProduct.total != parentProduct.origin_total && (parentProduct.bundle || []).every(function (item) {
-              var _ref14;
-              return !((_ref14 = item.discount_list || []) !== null && _ref14 !== void 0 && _ref14.length);
+              var _ref20;
+              return !((_ref20 = item.discount_list || []) !== null && _ref20 !== void 0 && _ref20.length);
             }) && (!((_parentProduct$discou2 = parentProduct.discount_list) !== null && _parentProduct$discou2 !== void 0 && _parentProduct$discou2.length) || (parentProduct === null || parentProduct === void 0 || (_parentProduct$discou3 = parentProduct.discount_list) === null || _parentProduct$discou3 === void 0 || (_parentProduct$discou4 = _parentProduct$discou3.every) === null || _parentProduct$discou4 === void 0 ? void 0 : _parentProduct$discou4.call(_parentProduct$discou3, function (item) {
               return item.type === 'product';
             })));
@@ -1358,8 +1532,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
                 discount_list: isManualDiscount ? _this4.resolveDiscountListForManualOverride(product.discount_list) : _this4.filterDiscountListByType(product.discount_list, 'promotion')
               }))]);
             } else {
-              var _ref15, _product$_promotion$f, _product12, _product$origin_total;
-              var total = product.inPromotion ? (_ref15 = (_product$_promotion$f = (_product12 = product) === null || _product12 === void 0 || (_product12 = _product12._promotion) === null || _product12 === void 0 ? void 0 : _product12.finalPrice) !== null && _product$_promotion$f !== void 0 ? _product$_promotion$f : product.origin_total) !== null && _ref15 !== void 0 ? _ref15 : product.total : (_product$origin_total = product.origin_total) !== null && _product$origin_total !== void 0 ? _product$origin_total : product.total;
+              var _ref21, _product$_promotion$f, _product12, _product$origin_total;
+              var total = product.inPromotion ? (_ref21 = (_product$_promotion$f = (_product12 = product) === null || _product12 === void 0 || (_product12 = _product12._promotion) === null || _product12 === void 0 ? void 0 : _product12.finalPrice) !== null && _product$_promotion$f !== void 0 ? _product$_promotion$f : product.origin_total) !== null && _ref21 !== void 0 ? _ref21 : product.total : (_product$origin_total = product.origin_total) !== null && _product$origin_total !== void 0 ? _product$origin_total : product.total;
               var main_product_selling_price = product.price;
               if ((product.discount_list || []).some(function (item) {
                 return item.type === 'promotion';
@@ -1400,21 +1574,15 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           return;
         }
 
-        // 是否需要拆分（商品券需要拆分）
-        var isNeedSplit = (selectedDiscount.tag || selectedDiscount.type) === 'good_pass';
+        // good_pass 与 Entitlement Pass 都沿用全额抵扣卡的商品行拆分机制。
+        var isNeedSplit = isFullCoveragePass(selectedDiscount);
 
         // 需要拆分出来的数量
         var totalQuantity = product.quantity || product.num || 1;
-        var availableGoodPassCount = applicableDiscounts.filter(function (item) {
-          return (item.tag || item.type) === 'good_pass';
-        }).length;
-
-        // 🔥 如果selectedDiscount有config配置，则使用config.maxUsagePerOrder限制使用次数
-        var maxUsageLimit = availableGoodPassCount;
-        if (selectedDiscount.config && selectedDiscount.config.maxUsagePerOrder) {
-          maxUsageLimit = Math.min(availableGoodPassCount, selectedDiscount.config.maxUsagePerOrder);
-        }
-        var splitCount = isNeedSplit ? Math.min(product.quantity || product.num || 1, maxUsageLimit) : 1;
+        var fullCoveragePassUsageGroups = isNeedSplit ? buildFullCoveragePassUsageGroups(prioritizedApplicableDiscounts, totalQuantity) : [];
+        var splitCount = isNeedSplit ? fullCoveragePassUsageGroups.reduce(function (total, group) {
+          return total + group.count;
+        }, 0) : 1;
         var arr = [];
 
         // 🔥 主商品和bundle子商品分别处理
@@ -1423,8 +1591,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           if (splitCount < totalQuantity && isNeedSplit) {
             var _product$origin_total2, _product$main_product2;
             var remainingQuantity = totalQuantity - splitCount;
-            var applicableNonGoodPassById = new Map(applicableDiscounts.filter(function (discount) {
-              return (discount.tag || discount.type) !== 'good_pass';
+            var applicableNonFullCoveragePassById = new Map(applicableDiscounts.filter(function (discount) {
+              return !isFullCoveragePass(discount);
             }).map(function (discount) {
               return [String(discount.id), discount];
             }));
@@ -1432,19 +1600,19 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               var _discount$discount$re, _discount$discount5;
               var discountType = discount.tag || discount.type;
               if (discountType === 'promotion') return true;
-              if (discountType === 'good_pass') return false;
+              if (isFullCoveragePass(discount)) return false;
               var resourceId = (_discount$discount$re = (_discount$discount5 = discount.discount) === null || _discount$discount5 === void 0 ? void 0 : _discount$discount5.resource_id) !== null && _discount$discount$re !== void 0 ? _discount$discount$re : discount.id;
-              return resourceId !== undefined && resourceId !== null && applicableNonGoodPassById.has(String(resourceId));
+              return resourceId !== undefined && resourceId !== null && applicableNonFullCoveragePassById.has(String(resourceId));
             }).map(function (discount) {
               var _discount$discount$re2, _discount$discount6;
               if ((discount.tag || discount.type) === 'promotion') return discount;
               var resourceId = (_discount$discount$re2 = (_discount$discount6 = discount.discount) === null || _discount$discount6 === void 0 ? void 0 : _discount$discount6.resource_id) !== null && _discount$discount$re2 !== void 0 ? _discount$discount$re2 : discount.id;
-              var matchedDiscount = applicableNonGoodPassById.get(String(resourceId));
+              var matchedDiscount = applicableNonFullCoveragePassById.get(String(resourceId));
               if (matchedDiscount) {
                 // 实际场景：3 件折扣卡商品中拆出 1 件改用商品券后，
                 // 剩余 2 件仍在使用原折扣卡；必须同步登记折扣卡的使用状态，
                 // 否则 updatedDiscountList 会把它改成未选中并清空 savedAmount。
-                usedDiscounts.set(matchedDiscount.id, true);
+                markDiscountUsed(matchedDiscount);
                 var appliedProducts = appliedDiscountProducts.get(matchedDiscount.id) || [];
                 appliedProducts.push(_objectSpread(_objectSpread({}, discount), {}, {
                   _num: remainingQuantity
@@ -1457,7 +1625,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               });
             });
             var hasRetainedWalletDiscount = remainderDiscountList.some(function (discount) {
-              return !['promotion', 'good_pass'].includes(discount.tag || discount.type);
+              return (discount.tag || discount.type) !== 'promotion' && !isFullCoveragePass(discount);
             });
             var _total = (_product$origin_total2 = product.origin_total) !== null && _product$origin_total2 !== void 0 ? _product$origin_total2 : product.total;
             if ((product.discount_list || []).some(function (item) {
@@ -1468,7 +1636,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             }
             arr.push(_this4.hooks.setProduct(originProduct, _objectSpread({
               // 商品券只替换被拆出的 splitCount 件。余量行原本仍有效的折扣卡
-              // 不能随 good_pass 拆分一起清除；已取消或已失效的折扣不会进入此列表。
+              // 不能随全额抵扣卡拆分一起清除；已取消或已失效的折扣不会进入此列表。
               discount_list: remainderDiscountList,
               quantity: remainingQuantity,
               _id: product._id.split('___')[0],
@@ -1477,15 +1645,21 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               main_product_selling_price: (_product$main_product2 = product.main_product_selling_price) !== null && _product$main_product2 !== void 0 ? _product$main_product2 : product.price
             } : {})));
           }
-          for (var i = 0; i < splitCount; i++) {
+          var discountUsageGroups = isNeedSplit ? fullCoveragePassUsageGroups : [{
+            discount: selectedDiscount,
+            count: 1
+          }];
+          for (var i = 0; i < discountUsageGroups.length; i++) {
             var _originProduct4, _selectedDiscount$con, _product$options, _product$options2, _selectedDiscount$met, _selectedDiscount$met2, _reapplyDiscountPerce;
-            var _selectedDiscount = isNeedSplit ? prioritizedApplicableDiscounts[i] : selectedDiscountCard || applicableDiscounts[i];
+            var _discountUsageGroups$ = discountUsageGroups[i],
+              _selectedDiscount = _discountUsageGroups$.discount,
+              appliedUseCount = _discountUsageGroups$.count;
             // 标记优惠券为已使用
-            usedDiscounts.set(_selectedDiscount.id, true);
+            markDiscountUsed(_selectedDiscount, appliedUseCount);
             // 🔥 更新 product_id 使用计数
-            if ((_selectedDiscount.tag || _selectedDiscount.type) === 'good_pass') {
+            if (isFullCoveragePass(_selectedDiscount)) {
               var currentCount = usedProductIdCounts.get(_selectedDiscount.product_id) || 0;
-              usedProductIdCounts.set(_selectedDiscount.product_id, currentCount + 1);
+              usedProductIdCounts.set(_selectedDiscount.product_id, currentCount + appliedUseCount);
             }
 
             // 记录实际应用了优惠券的商品信息
@@ -1547,7 +1721,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             var mainProductDiscountAmount = amount;
             var lineDiscountAmount = new Decimal(mainProductDiscountAmount).plus(optionDiscountAmount).toNumber();
             var discountType = _selectedDiscount.tag || _selectedDiscount.type;
-            var isGoodPass = discountType === 'good_pass';
+            var isFullCoverage = isFullCoveragePass(_selectedDiscount);
             var discountDetail = {
               amount: lineDiscountAmount,
               type: _selectedDiscount.tag === 'product_discount_card' ? 'discount_card' : discountType,
@@ -1563,10 +1737,10 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
                 discount_product_id: _selectedDiscount.product_id
               },
               // 前端使用的num数量，为了计算优惠金额
-              _num: isGoodPass ? 1 : product.num,
+              _num: isFullCoverage ? appliedUseCount : product.num,
               config: _selectedDiscount === null || _selectedDiscount === void 0 ? void 0 : _selectedDiscount.config,
               metadata: _objectSpread(_objectSpread({
-                num: 1,
+                num: isFullCoverage ? appliedUseCount : 1,
                 discount_rule_uncheck_flag: _selectedDiscount === null || _selectedDiscount === void 0 ? void 0 : _selectedDiscount.discount_rule_uncheck_flag
               }, productDiscountDifference !== undefined && {
                 product_discount_difference: productDiscountDifference
@@ -1584,9 +1758,9 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             if (product.isClient) {
               arr.push(_this4.hooks.setProduct(originProduct, {
                 discount_list: [discountDetail],
-                // good_pass：主商品价以折后价为准；勿用 product.price - amount（amount 含 option 优惠时会算错）
-                price: isGoodPass ? mainProductSellingPrice : product.price,
-                quantity: isNeedSplit ? 1 : product.quantity,
+                // 全额抵扣卡：主商品价以折后价为准；勿用 product.price - amount（amount 含 option 优惠时会算错）
+                price: isFullCoverage ? mainProductSellingPrice : product.price,
+                quantity: isNeedSplit ? appliedUseCount : product.quantity,
                 origin_total: getProductOriginTotalPrice({
                   product: {
                     original_price: product.original_price
@@ -1603,8 +1777,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               arr.push(_this4.hooks.setProduct(originProduct, {
                 discount_list: _this4.filterDiscountListByType(product.discount_list, 'promotion').concat([discountDetail]),
                 _id: product._id.split('___')[0] + '___' + _selectedDiscount.id + index,
-                price: _selectedDiscount.tag === 'good_pass' ? 0 : product.price,
-                quantity: isNeedSplit ? 1 : product.quantity,
+                price: isFullCoverage ? 0 : product.price,
+                quantity: isNeedSplit ? appliedUseCount : product.quantity,
                 total: _total2,
                 origin_total: productOriginTotal,
                 main_product_selling_price: mainProductSellingPrice,
@@ -1621,15 +1795,17 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             var discountNum = splitCount;
             var normalNum = totalQuantity - discountNum;
 
-            // 生成有折扣的商品（每张商品券对应 num: 1）
-            for (var _i = 0; _i < discountNum; _i++) {
+            // 同一卡实例的本次新增使用合并为一条，metadata.num 记录实际次数。
+            for (var _i = 0; _i < fullCoveragePassUsageGroups.length; _i++) {
               var _selectedDiscount2$me;
-              var _selectedDiscount2 = prioritizedApplicableDiscounts[_i];
-              usedDiscounts.set(_selectedDiscount2.id, true);
+              var _fullCoveragePassUsag = fullCoveragePassUsageGroups[_i],
+                _selectedDiscount2 = _fullCoveragePassUsag.discount,
+                _appliedUseCount = _fullCoveragePassUsag.count;
+              markDiscountUsed(_selectedDiscount2, _appliedUseCount);
               // 🔥 更新 product_id 使用计数
-              if ((_selectedDiscount2.tag || _selectedDiscount2.type) === 'good_pass') {
+              if (isFullCoveragePass(_selectedDiscount2)) {
                 var _currentCount = usedProductIdCounts.get(_selectedDiscount2.product_id) || 0;
-                usedProductIdCounts.set(_selectedDiscount2.product_id, _currentCount + 1);
+                usedProductIdCounts.set(_selectedDiscount2.product_id, _currentCount + _appliedUseCount);
               }
 
               // 🔥 生成唯一的 _id
@@ -1641,7 +1817,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               debugger;
               var _discountDetail = {
                 amount: bundleDiscountAmount,
-                type: 'good_pass',
+                type: _selectedDiscount2.tag || _selectedDiscount2.type,
                 discount: {
                   fixed_amount: product.origin_total,
                   discount_calculation_mode: _selectedDiscount2 === null || _selectedDiscount2 === void 0 || (_selectedDiscount2$me = _selectedDiscount2.metadata) === null || _selectedDiscount2$me === void 0 ? void 0 : _selectedDiscount2$me.discount_calculation_mode,
@@ -1655,9 +1831,9 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
                   // 🔥 使用拆分后的唯一 _id
                   custom_product_bundle_map_id: uniqueId,
                   discount_rule_uncheck_flag: _selectedDiscount2 === null || _selectedDiscount2 === void 0 ? void 0 : _selectedDiscount2.discount_rule_uncheck_flag,
-                  num: 1
+                  num: _appliedUseCount
                 },
-                _num: 1,
+                _num: _appliedUseCount,
                 config: _selectedDiscount2 === null || _selectedDiscount2 === void 0 ? void 0 : _selectedDiscount2.config
               };
 
@@ -1668,11 +1844,11 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
               processedItems.push(_objectSpread(_objectSpread({}, flatItem), {}, {
                 // 🔥 使用唯一的 _id
                 _id: uniqueId,
-                num: 1,
-                quantity: 1,
+                num: _appliedUseCount,
+                quantity: _appliedUseCount,
                 price: discountedPrice,
                 // 折扣后的价格
-                total: discountedPrice,
+                total: new Decimal(discountedPrice).mul(_appliedUseCount).toNumber(),
                 discount_list: [_discountDetail],
                 processed: true,
                 _discountId: _selectedDiscount2.id
@@ -1694,9 +1870,9 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             var _selectedDiscount3$me, _selectedDiscount3$me2, _reapplyDiscountPerce2, _flatItem$parentProdu9;
             // 折扣卡：不拆分数量，直接应用
             var _selectedDiscount3 = selectedDiscountCard || applicableDiscounts[0];
-            usedDiscounts.set(_selectedDiscount3.id, true);
+            markDiscountUsed(_selectedDiscount3);
             // 🔥 更新 product_id 使用计数（虽然此处主要是折扣卡，但保持一致性）
-            if ((_selectedDiscount3.tag || _selectedDiscount3.type) === 'good_pass') {
+            if (isFullCoveragePass(_selectedDiscount3)) {
               var _currentCount2 = usedProductIdCounts.get(_selectedDiscount3.product_id) || 0;
               usedProductIdCounts.set(_selectedDiscount3.product_id, _currentCount2 + 1);
             }
@@ -1826,11 +2002,10 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             // 没有bundle，直接使用主商品处理结果
             result.push.apply(result, _toConsumableArray(mainProductArr));
           } else {
-            // 🔥 有bundle，需要检查子商品是否应用了商品券
+            // 🔥 有 bundle，需要检查子商品是否应用了全额抵扣卡
             // 1. 先收集所有bundle子商品的处理结果
             var bundleProcessingInfo = new Map();
-            var hasGoodPassApplied = false; // 标记是否有子商品应用了商品券
-
+            var hasFullCoveragePassApplied = false;
             if (product.bundle && Array.isArray(product.bundle)) {
               product.bundle.forEach(function (bundleItem, bundleIndex) {
                 var bundleItemId = "".concat(product._id, "_bundle_").concat(bundleIndex);
@@ -1841,15 +2016,14 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
                 } else {
                   // 处理过的bundle item
                   bundleProcessingInfo.set(bundleIndex, processedBundleItems);
-                  // 🔥 检查是否应用了商品券（good_pass）
-                  var hasGoodPass = processedBundleItems.some(function (item) {
+                  var hasFullCoveragePass = processedBundleItems.some(function (item) {
                     var _item$discount_list;
                     return (_item$discount_list = item.discount_list) === null || _item$discount_list === void 0 ? void 0 : _item$discount_list.some(function (discount) {
-                      return discount.type === 'good_pass' || discount.tag === 'good_pass';
+                      return isFullCoveragePass(discount);
                     });
                   });
-                  if (hasGoodPass) {
-                    hasGoodPassApplied = true;
+                  if (hasFullCoveragePass) {
+                    hasFullCoveragePassApplied = true;
                   }
                 }
               });
@@ -1857,7 +2031,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
             // 🔥 2. 如果有子商品应用了商品券，且主商品数量大于1，需要拆分主商品
             var mainProductQuantity = mainProductArr[0] ? _this4.hooks.getProduct(mainProductArr[0]).quantity : 1;
-            if (hasGoodPassApplied && mainProductArr.length === 1 && mainProductQuantity > 1) {
+            if (hasFullCoveragePassApplied && mainProductArr.length === 1 && mainProductQuantity > 1) {
               var mainProduct = mainProductArr[0];
               var mainProductData = _this4.hooks.getProduct(mainProduct);
 
@@ -2058,7 +2232,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             } else {
               // 🔥 没有子商品被拆分，使用原有逻辑
               mainProductArr.forEach(function (mainProduct) {
-                var _ref17, _mainProductData$main, _mainProductData$disc, _mainProductData$disc2, _mainProductData$disc3;
+                var _ref23, _mainProductData$main, _mainProductData$disc, _mainProductData$disc2, _mainProductData$disc3;
                 var mainProductData = _this4.hooks.getProduct(mainProduct);
 
                 // 重组bundle
@@ -2073,9 +2247,9 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
                     } else {
                       // 🔥 关键：拆分后的bundle item
                       processedBundleItems.forEach(function (item) {
-                        var _item$price, _ref16, _item$bundle_selling_;
+                        var _item$price, _ref22, _item$bundle_selling_;
                         var nextBundlePrice = (_item$price = item.price) !== null && _item$price !== void 0 ? _item$price : bundleItem.price;
-                        var nextBundleSellingPrice = (_ref16 = (_item$bundle_selling_ = item.bundle_selling_price) !== null && _item$bundle_selling_ !== void 0 ? _item$bundle_selling_ : item.price) !== null && _ref16 !== void 0 ? _ref16 : bundleItem.bundle_selling_price;
+                        var nextBundleSellingPrice = (_ref22 = (_item$bundle_selling_ = item.bundle_selling_price) !== null && _item$bundle_selling_ !== void 0 ? _item$bundle_selling_ : item.price) !== null && _ref22 !== void 0 ? _ref22 : bundleItem.bundle_selling_price;
                         // 🔥 更新 discount_list 中的 num，使其与拆分后的 item.num 一致
                         var updatedDiscountList = (item.discount_list || []).map(function (discount) {
                           var _discount$metadata10;
@@ -2102,7 +2276,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
                 // 主商品已经在前面的 setProduct 中应用过折扣；这里只替换 bundle，
                 // 避免把主商品 discount_list 再扣一次。
-                var mainSellingPrice = (_ref17 = (_mainProductData$main = mainProductData.main_product_selling_price) !== null && _mainProductData$main !== void 0 ? _mainProductData$main : mainProductData.price) !== null && _ref17 !== void 0 ? _ref17 : 0;
+                var mainSellingPrice = (_ref23 = (_mainProductData$main = mainProductData.main_product_selling_price) !== null && _mainProductData$main !== void 0 ? _mainProductData$main : mainProductData.price) !== null && _ref23 !== void 0 ? _ref23 : 0;
                 var newTotal = Number(mainSellingPrice || 0);
                 var newOriginTotal = Number(mainProductData.original_price || mainProductData.price || 0);
 
@@ -2171,6 +2345,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
 
         // 获取此优惠券实际应用的商品详情
         var appliedProductDetails = appliedDiscountProducts.get(discount.id) || [];
+        var committedAppliedProductDetails = isEntitlementPass(discount) ? mergeEntitlementAppliedProductDetails(discount.committedAppliedProductDetails || []) : [];
+        var allAppliedProductDetails = isEntitlementPass(discount) ? mergeEntitlementAppliedProductDetails([].concat(_toConsumableArray(committedAppliedProductDetails), _toConsumableArray(appliedProductDetails))) : appliedProductDetails;
 
         // 根据是否有适用商品决定isAvailable
         var isAvailable = applicableProducts.length > 0;
@@ -2184,11 +2360,11 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             applicableProductIds: applicableProducts,
             // 添加可抵扣的商品详情
             applicableProductDetails: applicableProductDetails,
-            // 添加实际抵扣的商品详情（对于未选中的优惠券，为空数组）
-            appliedProductDetails: []
+            // 已提交的历史使用不可撤销；只取消本次新增分配。
+            appliedProductDetails: committedAppliedProductDetails
           });
         }
-        if (usedDiscounts.get(discount.id)) {
+        if (isDiscountUsed(discount)) {
           return _objectSpread(_objectSpread({}, discount), {}, {
             isSelected: true,
             isManualSelect: options !== null && options !== void 0 && options.scan ? false : discount.isManualSelect,
@@ -2199,7 +2375,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
             // 添加可抵扣的商品详情
             applicableProductDetails: applicableProductDetails,
             // 添加实际抵扣的商品详情
-            appliedProductDetails: appliedProductDetails
+            appliedProductDetails: allAppliedProductDetails
           });
         }
         var isSelected = typeof discount.isSelected === 'boolean' ? discount.isSelected : undefined;
@@ -2207,7 +2383,7 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
         // 如果是可用的 并且没有手动标记 则设置为选中
         if (isAvailable && appliedProductDetails.length && !discount.isManualSelect) {
           isSelected = true;
-        } else if (!appliedProductDetails.length) {
+        } else if (!appliedProductDetails.length && !committedAppliedProductDetails.length) {
           isSelected = false;
         }
         return _objectSpread(_objectSpread({}, discount), {}, {
@@ -2220,8 +2396,8 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
           applicableProductIds: applicableProducts,
           // 添加可抵扣的商品详情
           applicableProductDetails: applicableProductDetails,
-          // 添加实际抵扣的商品详情（对于未使用的优惠券，为空数组）
-          appliedProductDetails: []
+          // 编辑订单的历史使用继续保留，本次没有新增使用。
+          appliedProductDetails: committedAppliedProductDetails
         });
       });
       return {
@@ -2251,15 +2427,15 @@ export var RulesModule = /*#__PURE__*/function (_BaseModule) {
       var ruleType = usageRules.type;
       // 套餐适用范围配置
       var packageScope = usageRules === null || usageRules === void 0 ? void 0 : usageRules.package_scope;
-      var _ref18 = packageScope || {},
-        _ref18$type = _ref18.type,
-        scopeType = _ref18$type === void 0 ? 'product_all' : _ref18$type,
-        _ref18$exclude_bundle = _ref18.exclude_bundle_product_ids,
-        exclude_bundle_product_ids = _ref18$exclude_bundle === void 0 ? [] : _ref18$exclude_bundle,
-        _ref18$include_bundle = _ref18.include_bundle_product_ids,
-        include_bundle_product_ids = _ref18$include_bundle === void 0 ? [] : _ref18$include_bundle,
-        _ref18$filter = _ref18.filter,
-        filter = _ref18$filter === void 0 ? 0 : _ref18$filter;
+      var _ref24 = packageScope || {},
+        _ref24$type = _ref24.type,
+        scopeType = _ref24$type === void 0 ? 'product_all' : _ref24$type,
+        _ref24$exclude_bundle = _ref24.exclude_bundle_product_ids,
+        exclude_bundle_product_ids = _ref24$exclude_bundle === void 0 ? [] : _ref24$exclude_bundle,
+        _ref24$include_bundle = _ref24.include_bundle_product_ids,
+        include_bundle_product_ids = _ref24$include_bundle === void 0 ? [] : _ref24$include_bundle,
+        _ref24$filter = _ref24.filter,
+        filter = _ref24$filter === void 0 ? 0 : _ref24$filter;
       var isMainProduct = flatItem.type === 'main'; // 单独购买
       var isBundleItem = flatItem.type === 'bundle'; // 套餐中购买
       var bundleMainProductId = (_flatItem$product = flatItem.product) === null || _flatItem$product === void 0 ? void 0 : _flatItem$product.product_id;