@pisell/pisellos 0.0.567 → 0.0.569

package/lib/solution/BaseSales/utils/cartPromotion.js

@@ -0,0 +1,1155 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.appendPromotionTags = appendPromotionTags;
+exports.buildConsolidateKeyForPromotion = buildConsolidateKeyForPromotion;
+exports.calculateUnfulfilledPromotions = calculateUnfulfilledPromotions;
+exports.extractProductMatchIdentifiersFromStrategyConfig = extractProductMatchIdentifiersFromStrategyConfig;
+exports.getOrderProductBasePrice = getOrderProductBasePrice;
+exports.getOrderProductOriginalPriceForPromotion = getOrderProductOriginalPriceForPromotion;
+exports.getOrderProductUid = getOrderProductUid;
+exports.mergeIdenticalPromotionCartLines = mergeIdenticalPromotionCartLines;
+exports.processCartPromotion = processCartPromotion;
+exports.resolveStrategyEligibleProducts = resolveStrategyEligibleProducts;
+exports.resolveStrategyRequiredQuantity = resolveStrategyRequiredQuantity;
+var _decimal = _interopRequireDefault(require("decimal.js"));
+var _lodashEs = require("lodash-es");
+var _utils = require("../../../modules/Order/utils");
+var _utils2 = require("../../ScanOrder/utils");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * Cart promotion 工具集（OS 内部纯函数）
+ *
+ * 这是 `private-materials/components/booking/hooks/usePromotion.ts` 中促销/赠品
+ * 核心计算（evaluator → 拆分 / 计价 → 赠品差异化 / 未满足提示 / 标签）的 OS 等价实现。
+ *
+ * 与 legacy 的关键差异：
+ * - legacy 操作 booking `_extend.*` 形状；OS 操作 `OrderProduct.metadata.*` 形状。
+ * - 行唯一标识不再用 `_id`，统一改用 `metadata.unique_identification_number`。
+ * - 赠品标签存到 `metadata._giftInfo`；主商品促销信息存到 `metadata._promotion`；
+ *   商品卡列表的促销 tag 存到 `metadata._promotionTags`。
+ *
+ * 仅暴露纯函数，不持有任何状态；评估器以参数注入。
+ *
+ * @example
+ * const evaluator = appHelper.utils.promotionEvaluator;
+ * const result = processCartPromotion(tempOrder.products, evaluator);
+ * // result.products: 处理后的商品（带 _promotion / 拆分）
+ * // result.giftActions: 需要 add / reduce / remove 的赠品操作
+ * // result.unfulfilledPromotions: 未满足策略列表（购物车底部 alert）
+ */
+
+// ============================================
+// 类型定义
+// ============================================
+
+/** Cart 评估器协议（只描述本文件用到的方法，避免循环依赖） */
+
+/** 单个赠品减量项 */
+
+/** 赠品新增项 */
+
+/** 赠品操作集合（OS 侧根据它落地 tempOrder.products） */
+
+/** 未满足促销提示项（购物车底部 alert 数据源） */
+
+/** 商品卡促销标签结构（写入 `metadata._promotionTags`） */
+
+/** processCartPromotion 输出 */
+
+// ============================================
+// 字段适配 helper
+// ============================================
+
+/**
+ * 获取商品的「主商品基础价」用于评估器入参。
+ *
+ * 优先级（与 OS v2 schema 一致）：
+ * 1. `metadata.source_product_price`
+ * 2. `metadata.main_product_original_price` 减去 option 合计
+ * 3. `original_price`
+ */
+function getOrderProductBasePrice(product) {
+  const metadata = product?.metadata || {};
+  const optionSum = (0, _utils.sumOptionUnitPrice)((0, _utils.getProductSkuOptions)(product)).toNumber();
+  if (metadata.source_product_price !== undefined) {
+    const v = Number(metadata.source_product_price);
+    return Number.isFinite(v) ? v : 0;
+  }
+  if (metadata.main_product_original_price !== undefined) {
+    const v = Number(metadata.main_product_original_price) - optionSum;
+    return Number.isFinite(v) ? v : 0;
+  }
+  const v = Number(product?.original_price ?? product?.selling_price ?? 0);
+  return Number.isFinite(v) ? v : 0;
+}
+
+/**
+ * 促销均摊专用原价（对齐 legacy `getMainOriginalPrice` 语义）。
+ *
+ * 必须用券前原价做 X_ITEMS_FOR_Y_PRICE 比例拆分；`source_product_price` 在上一轮 applyPromotion
+ * 后可能已被写成促销价（如 5 / 9 / 1），若继续用它会导致同商品两行出现 9+1 而非 5+5。
+ *
+ * @example
+ * getOrderProductOriginalPriceForPromotion({ metadata: { source_product_price: '9', main_product_original_price: '5.80' } });
+ * // => 5.8
+ */
+function getOrderProductOriginalPriceForPromotion(product) {
+  const metadata = product?.metadata || {};
+  const optionSum = (0, _utils.sumOptionUnitPrice)((0, _utils.getProductSkuOptions)(product)).toNumber();
+  if (metadata.main_product_original_price !== undefined && metadata.main_product_original_price !== null && metadata.main_product_original_price !== '') {
+    const v = Number(metadata.main_product_original_price) - optionSum;
+    if (Number.isFinite(v) && v >= 0) return v;
+  }
+  const promoOriginal = metadata._promotion?.originalPrice;
+  if (promoOriginal !== undefined && promoOriginal !== null && promoOriginal !== '') {
+    const v = Number(promoOriginal);
+    if (Number.isFinite(v) && v >= 0) return v;
+  }
+  return getOrderProductBasePrice(product);
+}
+
+/**
+ * 写入/清除促销 discount_list（type=promotion）。
+ *
+ * applyDiscount → applyProductDiscountPrices 会从 source_product_price 减去 discount_list 合计
+ * 重算 main_product_selling_price；保留券前 source 时必须同步写入促销差额，否则会还原成原价。
+ *
+ * @example
+ * updatePromotionDiscountList(line, { title: '2 items for $10', amount: '17.00', original_amount: '22.00', fixed_amount: '17.00' });
+ */
+function updatePromotionDiscountList(item, promotionDiscount) {
+  let discountList = Array.isArray(item.discount_list) ? [...item.discount_list] : [];
+  discountList = discountList.filter(d => d?.type !== 'promotion');
+  if (promotionDiscount) {
+    discountList.push({
+      type: 'promotion',
+      amount: promotionDiscount.amount,
+      discount: {
+        original_amount: promotionDiscount.original_amount,
+        fixed_amount: promotionDiscount.fixed_amount,
+        title: promotionDiscount.title,
+        resource_id: ''
+      }
+    });
+  }
+  if (discountList.length > 0) {
+    item.discount_list = discountList;
+  } else {
+    delete item.discount_list;
+  }
+}
+const X_ITEMS_FOR_Y_PRICE = 'X_ITEMS_FOR_Y_PRICE';
+const BUY_X_GET_Y_FREE = 'BUY_X_GET_Y_FREE';
+
+/**
+ * 将促销单价写入 OrderProduct（含 metadata 三字段 + promotion discount_list）。
+ *
+ * @example
+ * applyPromoUnitPriceToLine(newItem, { promoUnitPrice: '5.00', originalBasePrice: 1, strategyTitle: '2 for 10' });
+ */
+function applyPromoUnitPriceToLine(item, input) {
+  const metadata = item.metadata || (item.metadata = {});
+  const optionSum = (0, _utils.sumOptionUnitPrice)((0, _utils.getProductSkuOptions)(item)).toNumber();
+  const promoUnitPrice = new _decimal.default(Number(input.promoUnitPrice) || 0).toDecimalPlaces(2).toFixed(2);
+  const mainSelling = new _decimal.default(Number(promoUnitPrice) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
+  const catalogSource = new _decimal.default(input.originalBasePrice).toDecimalPlaces(2).toFixed(2);
+  metadata.source_product_price = catalogSource;
+  metadata.main_product_original_price = new _decimal.default(Number(catalogSource) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
+  metadata.main_product_selling_price = mainSelling;
+  metadata.price_schema_version = 2;
+  item.selling_price = (0, _utils.composeLinePrice)({
+    mainPrice: mainSelling,
+    bundle: item.product_bundle
+  });
+  item.original_price = (0, _utils.composeLinePrice)({
+    mainPrice: metadata.main_product_original_price,
+    bundle: item.product_bundle,
+    useOriginalBundle: true
+  });
+  const discountAmount = new _decimal.default(input.originalBasePrice).minus(Number(promoUnitPrice) || 0).toDecimalPlaces(2).toFixed(2);
+  if (Number(catalogSource) !== Number(promoUnitPrice)) {
+    updatePromotionDiscountList(item, {
+      title: input.strategyTitle || '',
+      amount: discountAmount,
+      original_amount: catalogSource,
+      fixed_amount: discountAmount
+    });
+  } else {
+    updatePromotionDiscountList(item, null);
+  }
+}
+function getPromotionActionType(promotion) {
+  if (promotion?.actionType) return String(promotion.actionType);
+  const actions = promotion?.strategyMetadata?.actions;
+  if (Array.isArray(actions) && actions[0]?.type) return String(actions[0].type);
+  return undefined;
+}
+
+/**
+ * 同款行凑满 X件Y元 且仅该行参与时，按 Y/X 计算期望单价（2 件 $10 → $5）。
+ *
+ * @example
+ * resolveXItemsExpectedUnitPrice({ actionType: 'X_ITEMS_FOR_Y_PRICE', actionDetail: { x: 2, price: 10 } }, 2);
+ */
+function resolveXItemsExpectedUnitPrice(promotion, sourceCartNum) {
+  if (getPromotionActionType(promotion) !== X_ITEMS_FOR_Y_PRICE) return undefined;
+  const detail = promotion?.actionDetail;
+  const x = Number(detail?.x);
+  const y = Number(detail?.price);
+  if (!Number.isFinite(x) || x <= 0 || !Number.isFinite(y)) return undefined;
+  if (sourceCartNum < x) return undefined;
+  return Number(new _decimal.default(y).div(x).toDecimalPlaces(2).toFixed(2));
+}
+
+/**
+ * 合并「同商品 + 同规格指纹 + 同促销策略 + 同促销单价」的参与促销行（num 累加）。
+ * 避免 Browse Items 连续加购同款时拆成多行且单价被错误均摊。
+ *
+ * @example
+ * mergeIdenticalPromotionCartLines(processedProducts);
+ */
+function mergeIdenticalPromotionCartLines(products) {
+  if (!Array.isArray(products) || products.length <= 1) {
+    return [...(products || [])];
+  }
+  const merged = [];
+  const indexByKey = new Map();
+  for (const line of products) {
+    if (getGiftInfo(line)) {
+      merged.push(line);
+      continue;
+    }
+    const promotion = line?.metadata?._promotion;
+    if (!promotion?.inPromotion || !promotion.strategyId) {
+      merged.push(line);
+      continue;
+    }
+    const fingerprint = (0, _utils2.buildProductLineFingerprint)((0, _utils.getProductSkuOptions)(line), line.product_bundle);
+    const unitPrice = String(line.metadata?.source_product_price ?? line.selling_price ?? '');
+    const promoUnitPrice = String(promotion.finalPrice ?? line.metadata?.main_product_selling_price ?? '');
+    const noteSignature = getProductLineNoteSignature(line);
+    const lineMergeBoundary = getPromotionLineMergeBoundary(line);
+    const bookingUid = line?.booking_uid ?? line?.metadata?.booking_uid;
+    const orderDetailId = line?.order_detail_id ?? line?.orderDetailId;
+    const mergeKey = [line.product_id, line.product_variant_id ?? 0, fingerprint, noteSignature, lineMergeBoundary, bookingUid ? String(bookingUid) : '', orderDetailId !== undefined && orderDetailId !== null && orderDetailId !== '' ? String(orderDetailId) : '', promotion.strategyId, unitPrice, promoUnitPrice].join('#');
+    const hitIndex = indexByKey.get(mergeKey);
+    if (hitIndex === undefined) {
+      indexByKey.set(mergeKey, merged.length);
+      merged.push(line);
+      continue;
+    }
+    const target = merged[hitIndex];
+    target.num = (0, _utils2.getSafeProductNum)(Number(target.num || 0) + Number(line.num || 0));
+  }
+  return merged;
+}
+
+/**
+ * 同一原购物车行被多个「inPromotion」评估结果命中时（如买赠不改价 + X件Y元），
+ * 优先保留 X件Y元 定价，并恢复加购前的行数量。
+ *
+ * @example
+ * dedupePromotionProcessedLines(processedProducts);
+ */
+function dedupePromotionProcessedLines(lines) {
+  if (!Array.isArray(lines) || lines.length <= 1) return [...(lines || [])];
+  const passthrough = [];
+  const buckets = new Map();
+  for (const line of lines) {
+    const promo = line?.metadata?._promotion;
+    const originalUid = String(line._originalProductUid || getOrderProductUid(line) || '');
+    if (!promo?.inPromotion || !originalUid) {
+      passthrough.push(line);
+      continue;
+    }
+    const group = buckets.get(originalUid) || [];
+    group.push(line);
+    buckets.set(originalUid, group);
+  }
+  const promotionDelta = line => {
+    const promo = line.metadata?._promotion;
+    const original = Number(promo?.originalPrice);
+    const final = Number(promo?.finalPrice);
+    if (!Number.isFinite(original) || !Number.isFinite(final)) return 0;
+    return Math.abs(original - final);
+  };
+  const deduped = [...passthrough];
+  for (const [originalUid, group] of buckets) {
+    if (group.length === 1) {
+      deduped.push(group[0]);
+      continue;
+    }
+    const sourceCartNum = Math.max(...group.map(line => Number(line._sourceCartNum || line.num || 0)));
+    const pricingLines = group.filter(line => promotionDelta(line) > 0);
+    const xItemsLines = (pricingLines.length ? pricingLines : group).filter(line => getPromotionActionType(line.metadata?._promotion) === X_ITEMS_FOR_Y_PRICE);
+    const pool = xItemsLines.length ? xItemsLines : pricingLines.length ? pricingLines : group;
+    let winner = pool[0];
+    const expectedUnit = resolveXItemsExpectedUnitPrice(winner.metadata?._promotion, sourceCartNum);
+    if (expectedUnit != null && pool.length > 1) {
+      winner = pool.reduce((best, line) => {
+        const bestDiff = Math.abs(Number(best.metadata?._promotion?.finalPrice) - expectedUnit);
+        const lineDiff = Math.abs(Number(line.metadata?._promotion?.finalPrice) - expectedUnit);
+        return lineDiff < bestDiff ? line : best;
+      }, pool[0]);
+    } else if (pool.length > 1 && !expectedUnit) {
+      winner = pool.reduce((best, line) => {
+        const bestFinal = Number(best.metadata?._promotion?.finalPrice);
+        const lineFinal = Number(line.metadata?._promotion?.finalPrice);
+        const original = Number(line.metadata?._promotion?.originalPrice);
+        if (Number.isFinite(original) && lineFinal >= original && bestFinal >= original) {
+          return lineFinal < bestFinal ? line : best;
+        }
+        return promotionDelta(line) > promotionDelta(best) ? line : best;
+      }, pool[0]);
+    }
+
+    // X件Y元：评估器会按单件均摊产出多条 inPromotion 行（如 $1 + $9），
+    // dedupe 应合并为「同组 X件Y元 行 num 之和」，不能用 sourceCartNum（整单 3 件）。
+    const winnerIsXItems = getPromotionActionType(winner.metadata?._promotion) === X_ITEMS_FOR_Y_PRICE;
+    if (winnerIsXItems) {
+      const xItemsGroupLines = group.filter(line => getPromotionActionType(line.metadata?._promotion) === X_ITEMS_FOR_Y_PRICE);
+      const evaluatedPromoQty = xItemsGroupLines.reduce((sum, line) => sum + Number(line.num || 0), 0);
+      winner.num = (0, _utils2.getSafeProductNum)(evaluatedPromoQty || winner.num || 1);
+    } else {
+      winner.num = (0, _utils2.getSafeProductNum)(sourceCartNum || winner.num || 1);
+    }
+    const recomputeUnit = resolveXItemsExpectedUnitPrice(winner.metadata?._promotion, sourceCartNum);
+    if (recomputeUnit != null) {
+      const promo = winner.metadata._promotion;
+      applyPromoUnitPriceToLine(winner, {
+        promoUnitPrice: recomputeUnit,
+        originalBasePrice: Number(promo.originalPrice),
+        strategyTitle: promo.strategyMetadata?.name
+      });
+      promo.finalPrice = recomputeUnit;
+    }
+    for (const line of group) {
+      const giftInfo = line.metadata?._promotion?.giftInfo;
+      if (giftInfo && winner.metadata?._promotion && !winner.metadata._promotion.giftInfo) {
+        winner.metadata._promotion.giftInfo = giftInfo;
+      }
+    }
+    deduped.push(winner);
+  }
+  return deduped;
+}
+
+/** 获取行 uid（统一以 `metadata.unique_identification_number` 为唯一键） */
+function getOrderProductUid(product) {
+  return String(product?.metadata?.unique_identification_number ?? product?.unique_identification_number ?? '');
+}
+function getGiftInfo(product) {
+  return product?.metadata?._giftInfo || product?._giftInfo || null;
+}
+function getProductLineNoteSignature(product) {
+  const note = product?.note;
+  if (typeof note !== 'string') return '';
+  const normalizedNote = note.trim();
+  if (!normalizedNote) return '';
+  const uid = getOrderProductUid(product);
+  return uid ? `note:${uid}` : `note:${normalizedNote}`;
+}
+
+/**
+ * 编辑订单时，历史行仍参与整车促销评估，但不能与本次新增行合并。
+ * 以历史行 uid 作为促销前后的行边界；新增行返回空边界，仍保留原有合并语义。
+ */
+function getPromotionLineMergeBoundary(product) {
+  if (product?.metadata?.is_edit_for_runtime !== true) return '';
+  return `edit:${getOrderProductUid(product)}`;
+}
+function isPersistedGeneratedVoucher(product) {
+  const orderDetailId = product?.order_detail_id ?? product?.orderDetailId;
+  if (orderDetailId === undefined || orderDetailId === null || orderDetailId === '') {
+    return false;
+  }
+  const metadata = product?.metadata || {};
+  return product?.extension_type === 'product_voucher' || metadata.parent_order_detail_id !== undefined || metadata.gift_card_type !== undefined;
+}
+function getProductBundleForEvaluator(product) {
+  const bundles = Array.isArray(product?.product_bundle) ? product.product_bundle : [];
+  return bundles.map(b => ({
+    product_id: b?.bundle_product_id ?? b?._bundle_product_id ?? b?.product_id,
+    product_variant_id: b?.bundle_variant_id ?? b?.product_variant_id ?? 0,
+    quantity: Number(b?.num ?? b?.quantity ?? 1) || 1,
+    price: Number(b?.bundle_selling_price ?? b?.price ?? 0) || 0,
+    original_price: Number(b?.original_price ?? b?.product_price ?? b?.price ?? 0) || 0,
+    id: b?.bundle_id ?? b?.id ?? 0,
+    _bundle_product_id: b?._bundle_product_id ?? b?.bundle_product_id ?? b?.product_id
+  }));
+}
+
+/**
+ * 促销评估前合并同 SKU 拆分行（含促销/原价行），避免加购后仅前 2 件享受优惠。
+ * 带 `booking_uid` 的预约行不参与合并（每次加车独立 booking + 商品行）。
+ *
+ * @example
+ * consolidateMainProductsForPromotion([
+ *   { item: promoLineNum2, originalListIndex: 0 },
+ *   { item: regularLineNum2, originalListIndex: 1 },
+ * ]);
+ * // => 单行 num=4，清除 _promotion 后重新评估
+ */
+function buildConsolidateKeyForPromotion(item) {
+  const fingerprint = (0, _utils2.buildProductLineFingerprint)((0, _utils.getProductSkuOptions)(item), item.product_bundle);
+  const noteSignature = getProductLineNoteSignature(item);
+  const lineMergeBoundary = getPromotionLineMergeBoundary(item);
+  const bookingUid = item?.booking_uid ?? item?.metadata?.booking_uid;
+  const orderDetailId = item?.order_detail_id ?? item?.orderDetailId;
+  if (orderDetailId !== undefined && orderDetailId !== null && orderDetailId !== '') {
+    return [item.product_id, item.product_variant_id ?? 0, fingerprint, noteSignature, lineMergeBoundary, String(orderDetailId)].join('#');
+  }
+  if (bookingUid !== undefined && bookingUid !== null && String(bookingUid) !== '') {
+    return [item.product_id, item.product_variant_id ?? 0, fingerprint, noteSignature, lineMergeBoundary, String(bookingUid)].join('#');
+  }
+  return [item.product_id, item.product_variant_id ?? 0, fingerprint, noteSignature, lineMergeBoundary].join('#');
+}
+function consolidateMainProductsForPromotion(entries) {
+  if (!Array.isArray(entries) || entries.length <= 1) {
+    return [...(entries || [])];
+  }
+  const groups = new Map();
+  for (const {
+    item,
+    originalListIndex
+  } of entries) {
+    const key = buildConsolidateKeyForPromotion(item);
+    const wasInPromotion = item?.metadata?._promotion?.inPromotion === true;
+    const existing = groups.get(key);
+    if (!existing) {
+      const mergedItem = (0, _lodashEs.cloneDeep)(item);
+      const metadata = mergedItem.metadata || {};
+      delete metadata._promotion;
+      mergedItem.metadata = metadata;
+      if (Array.isArray(mergedItem.product_bundle)) {
+        for (const bundle of mergedItem.product_bundle) {
+          if (bundle && typeof bundle === 'object') delete bundle._promotion;
+        }
+      }
+      if (wasInPromotion) {
+        mergedItem._wasInPromotionBeforeConsolidate = true;
+      }
+      groups.set(key, {
+        item: mergedItem,
+        originalListIndex
+      });
+      continue;
+    }
+    existing.item.num = (0, _utils2.getSafeProductNum)(Number(existing.item.num || 0) + Number(item.num || 0));
+    if (wasInPromotion) {
+      existing.item._wasInPromotionBeforeConsolidate = true;
+    }
+  }
+  return Array.from(groups.values());
+}
+
+/**
+ * X件Y元 整组凑满时按每组 x 件拆开展示（4 件 → 2 行各 2 件 $10）。
+ *
+ * @example
+ * splitXItemsPromoLinesByGroup(mergedLines, strategyActionMap);
+ */
+function splitXItemsPromoLinesByGroup(lines, strategyActionMap) {
+  const result = [];
+  for (const line of lines) {
+    const promo = line?.metadata?._promotion;
+    if (!promo?.inPromotion || !promo.strategyId) {
+      result.push(line);
+      continue;
+    }
+    if (getPromotionActionType(promo) !== X_ITEMS_FOR_Y_PRICE) {
+      result.push(line);
+      continue;
+    }
+    const actionMeta = strategyActionMap.get(promo.strategyId);
+    const detail = actionMeta?.actionDetail ?? promo.actionDetail;
+    const x = Number(detail?.x);
+    const num = Number(line.num || 0);
+    const isCumulative = detail?.cumulative !== false;
+    if (!isCumulative || !Number.isFinite(x) || x <= 0 || num <= x || num % x !== 0) {
+      result.push(line);
+      continue;
+    }
+    const groupCount = num / x;
+    for (let i = 0; i < groupCount; i++) {
+      const splitLine = (0, _lodashEs.cloneDeep)(line);
+      splitLine.num = (0, _utils2.getSafeProductNum)(x);
+      splitLine.metadata = {
+        ...(splitLine.metadata || {}),
+        unique_identification_number: (0, _utils.createUuidV4)()
+      };
+      result.push(splitLine);
+    }
+  }
+  return result;
+}
+
+/** 生成新 numeric id（仅用于评估器内部追踪） */
+function generateNumericId() {
+  return Math.floor(Math.random() * 1_000_000_000) + Date.now();
+}
+
+/**
+ * 把 OrderProduct 转成 evaluator 的 PromotionProduct（仅评估期使用）。
+ *
+ * 注意：评估器是「无状态、按 product_id + variant 组」工作的；这里给每行分配一个
+ * numericId 用于关联回原 OrderProduct（通过 originalItemMap）。
+ */
+function convertToPromotionProduct(product, index) {
+  const metadata = product?.metadata || {};
+  const numericId = generateNumericId();
+  const originalItem = product;
+  return {
+    id: numericId,
+    product_id: Number(product?.product_id ?? 0) || 0,
+    product_variant_id: Number(product?.product_variant_id ?? 0) || 0,
+    name: metadata.product_name || product?.title || '',
+    price: getOrderProductOriginalPriceForPromotion(product),
+    quantity: Number(product?.num ?? 1) || 1,
+    bundle: getProductBundleForEvaluator(product),
+    _originalItem: originalItem,
+    _originalId: getOrderProductUid(product),
+    _originalIndex: index
+  };
+}
+
+// ============================================
+// 主流程：processCartPromotion
+// ============================================
+
+/**
+ * 计算赠品差异化操作（toAdd / toReduce / toRemove）。
+ *
+ * 与 legacy `calculateGiftActions` 等价；唯一差别是行键从 `_id` 改成 `metadata.unique_identification_number`。
+ */
+function calculateGiftActions(gifts, existingGifts) {
+  const toAdd = [];
+  const toReduce = [];
+  const toRemove = [];
+
+  // 按 strategyId 分组现有赠品
+  const existingByStrategy = new Map();
+  for (const gift of existingGifts) {
+    const strategyId = getGiftInfo(gift)?.strategyId;
+    if (!strategyId) continue;
+    const existing = existingByStrategy.get(strategyId);
+    const qty = Number(gift?.num ?? 1) || 1;
+    if (existing) {
+      existing.items.push(gift);
+      existing.totalQuantity += qty;
+    } else {
+      existingByStrategy.set(strategyId, {
+        items: [gift],
+        totalQuantity: qty
+      });
+    }
+  }
+  const processedStrategyIds = new Set();
+  for (const giftInfo of gifts) {
+    const {
+      strategyId,
+      strategyName,
+      giftCount,
+      giftOptions,
+      sourceProductIds
+    } = giftInfo;
+    processedStrategyIds.add(strategyId);
+    const existing = existingByStrategy.get(strategyId);
+    const existingCount = existing?.totalQuantity ?? 0;
+    const diff = giftCount - existingCount;
+    if (diff > 0) {
+      // 判断「用户手动减赠品」: 若评估器的 giftCount 没变，diff>0 说明是手动减，跳过补回
+      const lastEvaluated = getGiftInfo(existing?.items?.[0])?.lastEvaluatedGiftCount;
+      const strategyChanged = lastEvaluated === undefined || giftCount !== lastEvaluated;
+      if (strategyChanged) {
+        toAdd.push({
+          strategyId,
+          strategyName,
+          giftCount: diff,
+          giftOptions,
+          sourceProductIds
+        });
+      }
+    } else if (diff < 0) {
+      // 减赠品：后进先出
+      let remaining = Math.abs(diff);
+      const reduceItems = [];
+      const removeIds = [];
+      const reversed = [...(existing?.items || [])].reverse();
+      for (const giftItem of reversed) {
+        if (remaining <= 0) break;
+        const uid = getOrderProductUid(giftItem);
+        const qty = Number(giftItem?.num ?? 1) || 1;
+        if (qty <= remaining) {
+          removeIds.push(uid);
+          remaining -= qty;
+        } else {
+          reduceItems.push({
+            uid,
+            currentQuantity: qty,
+            newQuantity: qty - remaining
+          });
+          remaining = 0;
+        }
+      }
+      if (reduceItems.length > 0) toReduce.push({
+        strategyId,
+        items: reduceItems
+      });
+      toRemove.push(...removeIds);
+    }
+  }
+
+  // 失效策略的赠品：全部 remove
+  for (const [strategyId, existing] of existingByStrategy) {
+    if (processedStrategyIds.has(strategyId)) continue;
+    for (const giftItem of existing.items) {
+      toRemove.push(getOrderProductUid(giftItem));
+    }
+  }
+  return {
+    toAdd,
+    toReduce,
+    toRemove
+  };
+}
+
+/**
+ * 从策略配置的 product_match 规则提取可参与商品列表。
+ *
+ * @example
+ * extractProductMatchIdentifiersFromStrategyConfig(strategyConfig);
+ * // => [{ product_id: 60736, product_variant_id: 0 }]
+ */
+function extractProductMatchIdentifiersFromStrategyConfig(strategyConfig) {
+  const rules = strategyConfig?.conditions?.rules;
+  if (!Array.isArray(rules)) return [];
+  for (const rule of rules) {
+    if (rule?.field === 'productIdAndVariantId' && (rule?.operator === 'product_match' || rule?.operator === 'object_in') && Array.isArray(rule?.value)) {
+      return rule.value.map(item => ({
+        product_id: Number(item?.product_id) || 0,
+        product_variant_id: Number(item?.product_variant_id) || 0
+      })).filter(item => item.product_id > 0);
+    }
+  }
+  return [];
+}
+
+/**
+ * 解析策略凑单所需件数（evaluator 原始返回可能不含 requiredQuantity）。
+ *
+ * @example
+ * resolveStrategyRequiredQuantity({ actionType: 'X_ITEMS_FOR_Y_PRICE', actionDetail: { x: 2 } });
+ */
+function resolveStrategyRequiredQuantity(matched) {
+  const preset = Number(matched.requiredQuantity);
+  if (Number.isFinite(preset) && preset > 0) return preset;
+  const detail = matched.actionDetail || {};
+  if (matched.actionType === 'X_ITEMS_FOR_Y_PRICE') {
+    return Number(detail.x) || 2;
+  }
+  if (matched.actionType === 'BUY_X_GET_Y_FREE') {
+    return Number(detail.buyQuantity) || 1;
+  }
+  return 1;
+}
+
+/**
+ * 解析 Browse Items 弹窗候选商品（优先 eligibleProducts，否则读 strategyConfig）。
+ *
+ * @example
+ * resolveStrategyEligibleProducts(matchedStrategy);
+ */
+function resolveStrategyEligibleProducts(matched) {
+  if (Array.isArray(matched.eligibleProducts) && matched.eligibleProducts.length > 0) {
+    return matched.eligibleProducts;
+  }
+  return extractProductMatchIdentifiersFromStrategyConfig(matched.strategyConfig);
+}
+
+/**
+ * 计算未满足促销条件（用于购物车底部「再买 N 件即可享受 XX」alert）。
+ *
+ * 数据源：商品的 `metadata._promotion.inPromotion === false`（来自 processCartPromotion
+ * 第 8 步追加的「有适用策略但当前未参与促销」标记）。
+ */
+function calculateUnfulfilledPromotions(processedProducts, applicableStrategiesResult, mainProducts) {
+  const unfulfilledMap = new Map();
+  for (let i = 0; i < processedProducts.length; i++) {
+    const product = processedProducts[i];
+    const promotion = product?.metadata?._promotion;
+    if (!promotion || promotion.inPromotion !== false) continue;
+    const strategyId = promotion.strategyId;
+    if (!strategyId) continue;
+    const lookupUid = String(product?._originalProductUid ?? product?.metadata?.unique_identification_number ?? '');
+    const originalIndex = mainProducts.findIndex(item => getOrderProductUid(item) === lookupUid);
+    if (originalIndex === -1) continue;
+    const strategyData = applicableStrategiesResult[originalIndex];
+    if (!strategyData || !strategyData.hasApplicableStrategy) continue;
+    const matched = strategyData.applicableStrategies.find(s => s.strategyId === strategyId);
+    if (!matched) continue;
+    const quantity = Number(product?.num ?? 1) || 1;
+    if (unfulfilledMap.has(strategyId)) {
+      unfulfilledMap.get(strategyId).currentQuantity += quantity;
+    } else {
+      unfulfilledMap.set(strategyId, {
+        strategyId,
+        strategyName: matched.strategyName,
+        actionType: matched.actionType,
+        currentQuantity: quantity,
+        requiredQuantity: resolveStrategyRequiredQuantity(matched),
+        needQuantity: 0,
+        eligibleProducts: resolveStrategyEligibleProducts(matched),
+        strategyMetadata: matched.strategyMetadata,
+        display: matched.display
+      });
+    }
+  }
+  const result = [];
+  for (const data of unfulfilledMap.values()) {
+    const needQuantity = data.requiredQuantity - data.currentQuantity;
+    if (needQuantity > 0) {
+      result.push({
+        ...data,
+        needQuantity
+      });
+    }
+  }
+  return result;
+}
+
+/**
+ * 给商品列表追加促销标签（写入 `metadata._promotionTags`），供 ProductCard 渲染。
+ *
+ * - 没有适用策略的商品会清除 `_promotionTags`（避免脏数据）。
+ * - 仅基于 product_id 匹配（matchVariant=false），与商品卡通用场景对齐。
+ *
+ * @example
+ * const list = appendPromotionTags(catalog, evaluator);
+ * // list[i].metadata._promotionTags = [{ text, type, strategyId }]
+ */
+function appendPromotionTags(products, evaluator) {
+  if (!Array.isArray(products) || products.length === 0 || !evaluator) {
+    return products || [];
+  }
+
+  // 评估器期望的 product shape，最少字段集
+  const evaluatorInput = products.map((item, index) => ({
+    id: index,
+    product_id: Number(item?.id ?? item?.product_id ?? 0) || 0,
+    product_variant_id: Number(item?.product_variant_id ?? 0) || 0,
+    name: item?.title || item?.name || '',
+    price: Number(item?.price ?? 0) || 0,
+    quantity: Number(item?.quantity ?? 1) || 1,
+    bundle: []
+  }));
+  const strategies = evaluator.getProductsApplicableStrategies({
+    products: evaluatorInput
+  }, false);
+  return products.map((item, index) => {
+    const data = strategies[index];
+    const tags = [];
+    if (data?.hasApplicableStrategy) {
+      for (const strategy of data.applicableStrategies) {
+        if (strategy.display) {
+          tags.push({
+            text: strategy.display.text,
+            type: strategy.display.type,
+            strategyId: strategy.strategyId
+          });
+        }
+      }
+    }
+    // 商品卡兼容两种位置：顶层 `_promotionTags` 与 `metadata._promotionTags`
+    // ProductCard 现有实现读顶层（详见 productSelect/ProductCard/index.tsx），
+    // 此处同时写顶层以保持视图直连；OrderProduct 行版本走 metadata（避免顶层非协议字段）。
+    if (tags.length === 0) {
+      const {
+        _promotionTags,
+        ...rest
+      } = item;
+      void _promotionTags;
+      return rest;
+    }
+    return {
+      ...item,
+      _promotionTags: tags
+    };
+  });
+}
+
+/**
+ * 处理购物车的促销计算与赠品差异化。
+ *
+ * 流程：
+ * 1. 分离 main / gift / edit-product 三类（带 `booking_id` 的编辑态商品不参与促销）
+ * 2. 转 PromotionProduct 喂评估器 → 拿到 `evaluateCartWithPricing` 与 `getProductsApplicableStrategies`
+ * 3. 把 PricedProduct 映射回 OrderProduct 形态：
+ *    - 参与促销的，写 `metadata._promotion` + 调整 `selling_price` / `main_product_selling_price`
+ *    - 拆分的，生成新 uid，复制原行其它字段
+ * 4. 计算 `_giftInfo` 挂主商品（每个策略首个主商品）
+ * 5. 计算 `giftActions`（toAdd / toReduce / toRemove）
+ * 6. 计算 `unfulfilledPromotions`
+ *
+ * @example
+ * const { products, giftActions, unfulfilledPromotions } = processCartPromotion(
+ *   tempOrder.products,
+ *   evaluator,
+ * );
+ */
+function processCartPromotion(list, evaluator, options) {
+  const empty = {
+    products: Array.isArray(list) ? [...list] : [],
+    totalDiscount: 0,
+    gifts: [],
+    giftActions: {
+      toAdd: [],
+      toReduce: [],
+      toRemove: []
+    },
+    unfulfilledPromotions: []
+  };
+  if (!list || list.length === 0 || !evaluator) return empty;
+
+  // 0. 分类
+  const mainProductsWithIndex = [];
+  const existingGiftsWithIndex = [];
+  const editProductsWithIndex = [];
+  for (let i = 0; i < list.length; i++) {
+    const item = list[i];
+    const giftInfo = getGiftInfo(item);
+    if (isPersistedGeneratedVoucher(item)) {
+      editProductsWithIndex.push({
+        item,
+        originalListIndex: i
+      });
+    } else if (giftInfo) {
+      existingGiftsWithIndex.push({
+        item,
+        originalListIndex: i
+      });
+    } else if (item?.booking_id !== undefined && item?.booking_id !== null && item.booking_id !== 0 && item.booking_id !== '0') {
+      editProductsWithIndex.push({
+        item,
+        originalListIndex: i
+      });
+    } else {
+      mainProductsWithIndex.push({
+        item,
+        originalListIndex: i
+      });
+    }
+  }
+  const consolidatedMainProductsWithIndex = consolidateMainProductsForPromotion(mainProductsWithIndex);
+  const mainProducts = consolidatedMainProductsWithIndex.map(x => x.item);
+  const existingGifts = existingGiftsWithIndex.map(x => x.item);
+  if (mainProducts.length === 0) {
+    const editProducts = editProductsWithIndex.map(x => x.item);
+    if (existingGifts.length > 0) {
+      const toRemove = [];
+      for (const gift of existingGifts) {
+        const uid = getOrderProductUid(gift);
+        if (uid) toRemove.push(uid);
+      }
+      return {
+        products: editProducts,
+        totalDiscount: 0,
+        gifts: [],
+        giftActions: {
+          toAdd: [],
+          toReduce: [],
+          toRemove
+        },
+        unfulfilledPromotions: []
+      };
+    }
+    return {
+      ...empty,
+      products: editProducts.length > 0 ? editProducts : [...list]
+    };
+  }
+
+  // 1. 转 PromotionProduct
+  const promotionProducts = [];
+  const originalItemMap = new Map();
+  const productsForStrategies = consolidatedMainProductsWithIndex.map(({
+    item
+  }, i) => ({
+    id: i,
+    product_id: Number(item?.product_id ?? 0) || 0,
+    product_variant_id: Number(item?.product_variant_id ?? 0) || 0,
+    name: item?.metadata?.product_name || item?.title || '',
+    price: getOrderProductBasePrice(item),
+    quantity: Number(item?.num ?? 1) || 1,
+    bundle: getProductBundleForEvaluator(item)
+  }));
+  for (let i = 0; i < consolidatedMainProductsWithIndex.length; i++) {
+    const {
+      item,
+      originalListIndex
+    } = consolidatedMainProductsWithIndex[i];
+    const promotionProduct = convertToPromotionProduct(item, originalListIndex);
+    promotionProducts.push(promotionProduct);
+    originalItemMap.set(promotionProduct.id, {
+      item,
+      index: originalListIndex
+    });
+  }
+
+  // 2. 拿适用策略
+  const applicableStrategiesResult = evaluator.getProductsApplicableStrategies({
+    products: productsForStrategies,
+    channel: options?.channel
+  });
+  const strategyActionMap = new Map();
+  for (const row of applicableStrategiesResult || []) {
+    for (const strategy of row?.applicableStrategies || []) {
+      if (!strategy?.strategyId) continue;
+      strategyActionMap.set(strategy.strategyId, {
+        actionType: strategy.actionType,
+        actionDetail: strategy.actionDetail
+      });
+    }
+  }
+
+  // 3. 评估器
+  const result = evaluator.evaluateCartWithPricing({
+    products: promotionProducts,
+    channel: options?.channel
+  });
+
+  // 4. 收集每个策略的 sourceProductIds（参与策略的主商品 uid）
+  const strategySourceProductIds = new Map();
+  for (const priced of result.products) {
+    if (priced.inPromotion && priced.strategyId) {
+      const sourceId = priced.originalId ?? priced.id;
+      const originalData = originalItemMap.get(sourceId);
+      if (originalData) {
+        const uid = getOrderProductUid(originalData.item);
+        if (!uid) continue;
+        const arr = strategySourceProductIds.get(priced.strategyId) || [];
+        if (!arr.includes(uid)) arr.push(uid);
+        strategySourceProductIds.set(priced.strategyId, arr);
+      }
+    }
+  }
+
+  // 5. 扩展 gifts，加 sourceProductIds
+  const extendedGifts = result.gifts.map(gift => ({
+    ...gift,
+    sourceProductIds: strategySourceProductIds.get(gift.strategyId) || []
+  }));
+
+  // 6. PricedProduct → OrderProduct（含拆分与价格调整）
+  const strategyGiftInfoMap = new Map();
+  for (const gift of extendedGifts) strategyGiftInfoMap.set(gift.strategyId, gift);
+  const strategyGiftInfoOwner = new Map();
+  const processedProducts = [];
+  for (const priced of result.products) {
+    const rawSourceId = priced.originalId ?? priced.id;
+    const sourceId = Number(rawSourceId);
+    const originalData = Number.isFinite(sourceId) ? originalItemMap.get(sourceId) : undefined;
+    if (!originalData) continue;
+    const {
+      item: originalItem,
+      index: originalIndex
+    } = originalData;
+    const pricedProductId = Number(priced.product_id ?? 0);
+    const originalProductId = Number(originalItem.product_id ?? 0);
+    if (pricedProductId > 0 && originalProductId > 0 && pricedProductId !== originalProductId) {
+      continue;
+    }
+    const newItem = (0, _lodashEs.cloneDeep)(originalItem);
+    const metadata = newItem.metadata || {};
+    const sourceCartNum = (0, _utils2.getSafeProductNum)(originalItem.num);
+    newItem._sourceCartNum = sourceCartNum;
+
+    // 清掉历史促销字段
+    const wasInPromotion = metadata._promotion?.inPromotion === true || originalItem._wasInPromotionBeforeConsolidate === true;
+    delete metadata._promotion;
+    if (Array.isArray(newItem.product_bundle)) {
+      for (const b of newItem.product_bundle) {
+        if (b && typeof b === 'object') delete b._promotion;
+      }
+    }
+    const originalBasePrice = getOrderProductOriginalPriceForPromotion(originalItem);
+    const shouldModifyPrice = priced.inPromotion || wasInPromotion;
+    const priceUnchangedPromo = priced.inPromotion && Number(priced.finalPrice) === Number(originalBasePrice);
+    if (shouldModifyPrice) {
+      if (priced.inPromotion && !priceUnchangedPromo) {
+        const promoUnitPrice = new _decimal.default(priced.finalPrice).toDecimalPlaces(2).toFixed(2);
+        applyPromoUnitPriceToLine(newItem, {
+          promoUnitPrice,
+          originalBasePrice,
+          strategyTitle: priced.strategyMetadata?.name
+        });
+      } else {
+        // 撤销上一轮促销：还原 selling_price 到 main_product_original_price 派生值
+        const optionSum = (0, _utils.sumOptionUnitPrice)((0, _utils.getProductSkuOptions)(newItem)).toNumber();
+        const sourceRestore = new _decimal.default(originalBasePrice).toDecimalPlaces(2).toFixed(2);
+        const mainRestore = new _decimal.default(Number(sourceRestore) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
+        metadata.source_product_price = sourceRestore;
+        metadata.main_product_selling_price = mainRestore;
+        metadata.price_schema_version = 2;
+        newItem.selling_price = (0, _utils.composeLinePrice)({
+          mainPrice: mainRestore,
+          bundle: newItem.product_bundle
+        });
+        updatePromotionDiscountList(newItem, null);
+      }
+    }
+    newItem.num = priced.isSplit ? (0, _utils2.getSafeProductNum)(priced.quantity) : sourceCartNum;
+
+    // 拆分行：生成新 uid，复制原行
+    if (priced.isSplit) {
+      metadata.unique_identification_number = (0, _utils.createUuidV4)();
+    }
+    if (priced.strategyId) {
+      const actionMeta = strategyActionMap.get(priced.strategyId);
+      const promotionInfo = {
+        strategyId: priced.strategyId,
+        strategyMetadata: priced.strategyMetadata,
+        inPromotion: priced.inPromotion,
+        originalPrice: originalBasePrice,
+        finalPrice: priced.finalPrice,
+        actionType: actionMeta?.actionType,
+        actionDetail: actionMeta?.actionDetail
+      };
+      const bundleIdx = priced.matchedBundleIndex;
+      if (bundleIdx !== undefined && Array.isArray(newItem.product_bundle) && newItem.product_bundle[bundleIdx]) {
+        newItem.product_bundle[bundleIdx]._promotion = promotionInfo;
+      } else {
+        metadata._promotion = promotionInfo;
+      }
+    }
+    newItem.metadata = metadata;
+
+    // 5.1 第一个参与「买X送Y」策略的主商品，挂 giftInfo
+    if (priced.inPromotion && priced.strategyId) {
+      const gift = strategyGiftInfoMap.get(priced.strategyId);
+      if (gift && Array.isArray(gift.giftOptions) && gift.giftOptions.length > 0 && !strategyGiftInfoOwner.has(priced.strategyId)) {
+        const giftInfoData = {
+          strategyName: gift.strategyName,
+          giftCount: gift.giftCount,
+          giftOptions: gift.giftOptions
+        };
+        const bundleIdx = priced.matchedBundleIndex;
+        if (bundleIdx !== undefined && Array.isArray(newItem.product_bundle) && newItem.product_bundle[bundleIdx]?._promotion) {
+          newItem.product_bundle[bundleIdx]._promotion.giftInfo = giftInfoData;
+        } else if (metadata._promotion) {
+          metadata._promotion.giftInfo = giftInfoData;
+        }
+        strategyGiftInfoOwner.set(priced.strategyId, getOrderProductUid(newItem));
+      }
+    }
+
+    // 记录原商品 uid（用于排序与未满足匹配）
+    newItem._sortIndex = originalIndex;
+    newItem._sortSubIndex = priced.inPromotion ? 0 : 1;
+    newItem._originalProductUid = getOrderProductUid(originalItem);
+    processedProducts.push(newItem);
+  }
+
+  // 7. 赠品/编辑商品原样拼回；同时同步赠品的 sourceProductIds / sourceProductId
+  for (const {
+    item,
+    originalListIndex
+  } of existingGiftsWithIndex) {
+    const next = item;
+    next._sortIndex = originalListIndex;
+    next._sortSubIndex = 0;
+    const strategyId = getGiftInfo(next)?.strategyId;
+    if (strategyId) {
+      const latest = strategyGiftInfoMap.get(strategyId);
+      const owner = strategyGiftInfoOwner.get(strategyId);
+      if (latest && next.metadata?._giftInfo) {
+        next.metadata._giftInfo.sourceProductIds = latest.sourceProductIds;
+      }
+      if (owner && next.metadata?._giftInfo) {
+        next.metadata._giftInfo.sourceProductId = owner;
+      }
+    }
+    processedProducts.push(next);
+  }
+  for (const {
+    item,
+    originalListIndex
+  } of editProductsWithIndex) {
+    const next = item;
+    next._sortIndex = originalListIndex;
+    next._sortSubIndex = 0;
+    processedProducts.push(next);
+  }
+
+  // 8. 排序回原顺序，参与促销的拆分行排在前
+  processedProducts.sort((a, b) => {
+    if (a._sortIndex !== b._sortIndex) return a._sortIndex - b._sortIndex;
+    return a._sortSubIndex - b._sortSubIndex;
+  });
+
+  // 8.1 同款参与促销行：先去重（买赠+满减并存）再合并 num
+  const dedupedPromotionLines = dedupePromotionProcessedLines(processedProducts);
+  processedProducts.splice(0, processedProducts.length, ...dedupedPromotionLines);
+  const mergedPromotionLines = mergeIdenticalPromotionCartLines(processedProducts);
+  processedProducts.splice(0, processedProducts.length, ...mergedPromotionLines);
+  const splitPromoLines = splitXItemsPromoLinesByGroup(processedProducts, strategyActionMap);
+  processedProducts.splice(0, processedProducts.length, ...splitPromoLines);
+
+  // 9. 给「有适用策略但未参与促销」的主商品打 inPromotion:false
+  for (const product of processedProducts) {
+    const metadata = product.metadata || {};
+    if (metadata._promotion) continue;
+    if (getGiftInfo(product)) continue;
+    const lookupUid = String(product._originalProductUid ?? getOrderProductUid(product));
+    const originalIndex = mainProducts.findIndex(item => getOrderProductUid(item) === lookupUid);
+    if (originalIndex === -1) continue;
+    const strategyData = applicableStrategiesResult[originalIndex];
+    if (!strategyData || !strategyData.hasApplicableStrategy) continue;
+    const first = strategyData.applicableStrategies[0];
+    if (!first) continue;
+    const originalPrice = getOrderProductOriginalPriceForPromotion(mainProducts[originalIndex]);
+    metadata._promotion = {
+      strategyId: first.strategyId,
+      strategyMetadata: first.strategyMetadata,
+      inPromotion: false,
+      originalPrice,
+      finalPrice: originalPrice
+    };
+    product.metadata = metadata;
+  }
+
+  // 10. 赠品操作（在更新 lastEvaluatedGiftCount 前做对比）
+  const giftActions = calculateGiftActions(extendedGifts, existingGifts);
+
+  // 10.1 更新 lastEvaluatedGiftCount，便于下次评估时判别「策略已变」
+  for (const gift of existingGifts) {
+    const strategyId = getGiftInfo(gift)?.strategyId;
+    if (!strategyId) continue;
+    const latest = strategyGiftInfoMap.get(strategyId);
+    if (latest && gift.metadata?._giftInfo) {
+      gift.metadata._giftInfo.lastEvaluatedGiftCount = latest.giftCount;
+    }
+  }
+
+  // 11. 未满足促销
+  const unfulfilledPromotions = calculateUnfulfilledPromotions(processedProducts, applicableStrategiesResult, mainProducts);
+
+  // 12. 清理排序辅助字段
+  for (const product of processedProducts) {
+    delete product._sortIndex;
+    delete product._sortSubIndex;
+    delete product._originalProductUid;
+    delete product._sourceCartNum;
+    delete product._wasInPromotionBeforeConsolidate;
+  }
+  return {
+    products: processedProducts,
+    totalDiscount: result.totalDiscount,
+    gifts: extendedGifts,
+    giftActions,
+    unfulfilledPromotions
+  };
+}