@pisell/pisellos 2.1.58 → 2.1.60

package/dist/model/strategy/adapter/walletPass/example.js

@@ -0,0 +1,258 @@
+/**
+ * WalletPass 评估器使用示例
+ */
+
+import { WalletPassEvaluator } from "./evaluator";
+
+// ============================================
+// 准备测试数据
+// ============================================
+
+// 1. 商品列表
+var products = [{
+  product_id: 60734,
+  price: 80,
+  quantity: 1,
+  name: '商品A'
+}, {
+  product_id: 60735,
+  price: 50,
+  quantity: 2,
+  name: '商品B'
+}];
+
+// 订单总金额 = 80 + 50*2 = 180
+
+// 2. Voucher 列表
+var vouchers = [{
+  id: 'VOUCHER_001',
+  amount: 10,
+  balance: 10,
+  type: 'cash_voucher'
+}, {
+  id: 'VOUCHER_002',
+  amount: 20,
+  balance: 20,
+  type: 'cash_voucher'
+}, {
+  id: 'VOUCHER_003',
+  amount: 50,
+  balance: 50,
+  type: 'cash_voucher'
+}];
+
+// 3. 策略配置
+var strategyConfigs = [
+// 策略1: 满100减10，适用于 VOUCHER_001
+{
+  metadata: {
+    id: 'STRATEGY_001',
+    name: '满100减10',
+    type: 'wallet_pass',
+    custom: {
+      maxDeductionAmount: 10,
+      // 最大抵扣10元
+      maxUsagePerOrder: 1,
+      // 每单最多用1张
+      deductTaxAndFee: true,
+      // 抵扣税费
+      applicableProductIds: [60734, 60735] // 适用于这两个商品
+    }
+  },
+  conditions: {
+    operator: 'and',
+    rules: [
+    // 匹配 voucher ID
+    {
+      type: 'operator',
+      field: 'voucherId',
+      operator: 'in',
+      value: ['VOUCHER_001']
+    },
+    // 适用商品总额需 >= 100
+    {
+      type: 'operator',
+      field: 'applicableProductTotal',
+      operator: '>=',
+      value: 100
+    }],
+    actionIds: ['deduct_10']
+  },
+  actions: [{
+    id: 'deduct_10',
+    type: 'DEDUCT_AMOUNT',
+    value: 10,
+    target: 'applicable_products',
+    priority: 1
+  }]
+},
+// 策略2: 满150减20，适用于 VOUCHER_002
+{
+  metadata: {
+    id: 'STRATEGY_002',
+    name: '满150减20',
+    type: 'wallet_pass',
+    custom: {
+      maxDeductionAmount: 20,
+      maxUsagePerOrder: 1,
+      deductTaxAndFee: true,
+      applicableProductIds: [60734, 60735]
+    }
+  },
+  conditions: {
+    operator: 'and',
+    rules: [{
+      type: 'operator',
+      field: 'voucherId',
+      operator: 'in',
+      value: ['VOUCHER_002']
+    }, {
+      type: 'operator',
+      field: 'applicableProductTotal',
+      operator: '>=',
+      value: 150
+    }],
+    actionIds: ['deduct_20']
+  },
+  actions: [{
+    id: 'deduct_20',
+    type: 'DEDUCT_AMOUNT',
+    value: 20,
+    target: 'applicable_products',
+    priority: 1
+  }]
+},
+// 策略3: 满200减50，适用于 VOUCHER_003
+{
+  metadata: {
+    id: 'STRATEGY_003',
+    name: '满200减50',
+    type: 'wallet_pass',
+    custom: {
+      maxDeductionAmount: 50,
+      maxUsagePerOrder: 2,
+      deductTaxAndFee: false,
+      applicableProductIds: [60734, 60735]
+    }
+  },
+  conditions: {
+    operator: 'and',
+    rules: [{
+      type: 'operator',
+      field: 'voucherId',
+      operator: 'in',
+      value: ['VOUCHER_003']
+    }, {
+      type: 'operator',
+      field: 'applicableProductTotal',
+      operator: '>=',
+      value: 200
+    }],
+    actionIds: ['deduct_50']
+  },
+  actions: [{
+    id: 'deduct_50',
+    type: 'DEDUCT_AMOUNT',
+    value: 50,
+    target: 'applicable_products',
+    priority: 1
+  }]
+}];
+
+// ============================================
+// 执行评估
+// ============================================
+
+function runExample() {
+  console.log('========== WalletPass 评估器示例 ==========\n');
+
+  // 创建评估器实例
+  var evaluator = new WalletPassEvaluator();
+
+  // 执行评估
+  var results = evaluator.evaluate({
+    orderTotalAmount: 180,
+    products: products,
+    vouchers: vouchers,
+    strategyConfigs: strategyConfigs
+  });
+
+  // 输出结果
+  console.log('订单信息：');
+  console.log("- \u603B\u91D1\u989D: ".concat(180, " \u5143"));
+  console.log("- \u5546\u54C1: ".concat(products.map(function (p) {
+    return "".concat(p.name, "(").concat(p.quantity, "\u4EF6)");
+  }).join(', '), "\n"));
+  console.log('评估结果：\n');
+  results.forEach(function (result, index) {
+    console.log("Voucher ".concat(index + 1, ": ").concat(result.voucher.id));
+    console.log("  \u9762\u989D: ".concat(result.voucher.amount, " \u5143"));
+    console.log("  \u53EF\u7528: ".concat(result.isApplicable ? '✅ 是' : '❌ 否'));
+    if (result.isApplicable) {
+      console.log("  \u6700\u5927\u62B5\u6263: ".concat(result.maxDeduction, " \u5143"));
+      console.log("  \u6BCF\u5355\u53EF\u7528: ".concat(result.canUseCount, " \u5F20"));
+      console.log("  \u62B5\u6263\u7A0E\u8D39: ".concat(result.deductTaxAndFee ? '是' : '否'));
+      console.log("  \u9002\u7528\u5546\u54C1: ".concat(result.applicableProductIds.join(', ')));
+    } else {
+      console.log("  \u539F\u56E0: ".concat(result.reason));
+      console.log("  \u539F\u56E0\u7801: ".concat(result.reasonCode));
+    }
+    console.log('');
+  });
+
+  // 筛选可用的 vouchers
+  var availableVouchers = results.filter(function (r) {
+    return r.isApplicable;
+  });
+  console.log("\n\u5171 ".concat(availableVouchers.length, " \u5F20\u53EF\u7528"));
+  if (availableVouchers.length > 0) {
+    console.log('可用 voucher ID:');
+    availableVouchers.forEach(function (v) {
+      console.log("  - ".concat(v.voucher.id, ": \u6700\u591A\u62B5\u6263 ").concat(v.maxDeduction, " \u5143"));
+    });
+  }
+}
+
+// 运行示例
+runExample();
+
+// ============================================
+// 预期输出
+// ============================================
+/*
+========== WalletPass 评估器示例 ==========
+
+订单信息：
+- 总金额: 180 元
+- 商品: 商品A(1件), 商品B(2件)
+
+评估结果：
+
+Voucher 1: VOUCHER_001
+  面额: 10 元
+  可用: ✅ 是
+  最大抵扣: 10 元
+  每单可用: 1 张
+  抵扣税费: 是
+  适用商品: 60734, 60735
+
+Voucher 2: VOUCHER_002
+  面额: 20 元
+  可用: ✅ 是
+  最大抵扣: 20 元
+  每单可用: 1 张
+  抵扣税费: 是
+  适用商品: 60734, 60735
+
+Voucher 3: VOUCHER_003
+  面额: 50 元
+  可用: ❌ 否
+  原因: Conditions not met
+  原因码: CONDITION_NOT_MET
+
+
+共 2 张可用
+可用 voucher ID:
+  - VOUCHER_001: 最多抵扣 10 元
+  - VOUCHER_002: 最多抵扣 20 元
+*/

package/dist/model/strategy/adapter/walletPass/index.d.ts

@@ -0,0 +1,32 @@
+import { EvaluationResult, RuntimeContext } from '../../type';
+import { BusinessAdapter } from '../type';
+import { WalletPassBusinessData, WalletPassTransformResult } from './type';
+/**
+ * Wallet Pass 适配器
+ * 用于将 wallet pass 业务数据转换为策略引擎可识别的格式
+ */
+export default class WalletPassAdapter implements BusinessAdapter {
+    name: string;
+    version: string;
+    /**
+     * 准备运行时上下文
+     * 将业务数据转换为策略引擎可识别的 RuntimeContext
+     */
+    prepareContext(businessData: WalletPassBusinessData): RuntimeContext;
+    /**
+     * 转换执行结果
+     * 将策略引擎的通用结果转换为业务层需要的格式
+     */
+    transformResult(result: EvaluationResult, businessData?: WalletPassBusinessData): WalletPassTransformResult;
+    /**
+     * 格式化配置
+     */
+    formatConfig(result: EvaluationResult, businessData?: WalletPassBusinessData): {
+        result: EvaluationResult;
+        businessData?: WalletPassBusinessData;
+    };
+    /**
+     * 计算适用商品的总金额和数量
+     */
+    private calculateApplicableProducts;
+}

package/dist/model/strategy/adapter/walletPass/index.js

@@ -0,0 +1,182 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { getApplicableProductIds, getMainProductPrice, getBundleItemPrice, getProductQuantity, getBundleItemIsOriginalPrice } from "./utils";
+
+/**
+ * Wallet Pass 适配器
+ * 用于将 wallet pass 业务数据转换为策略引擎可识别的格式
+ */
+var WalletPassAdapter = /*#__PURE__*/function () {
+  function WalletPassAdapter() {
+    _classCallCheck(this, WalletPassAdapter);
+    _defineProperty(this, "name", 'WalletPassAdapter');
+    _defineProperty(this, "version", '1.0.0');
+  }
+  _createClass(WalletPassAdapter, [{
+    key: "prepareContext",
+    value:
+    /**
+     * 准备运行时上下文
+     * 将业务数据转换为策略引擎可识别的 RuntimeContext
+     */
+    function prepareContext(businessData) {
+      var _strategyConfig$metad, _strategyConfig$metad2;
+      var orderTotalAmount = businessData.orderTotalAmount,
+        products = businessData.products,
+        voucher = businessData.voucher,
+        strategyConfig = businessData.strategyConfig;
+
+      // 提取订单中的商品ID
+      var productIds = products.map(function (p) {
+        return p.product_id;
+      });
+
+      // 从 voucher 中获取适用商品ID
+      var applicableProductIds = getApplicableProductIds(voucher);
+
+      // 获取 deductTaxAndFee 配置
+      var deductTaxAndFee = (_strategyConfig$metad = strategyConfig === null || strategyConfig === void 0 || (_strategyConfig$metad2 = strategyConfig.metadata) === null || _strategyConfig$metad2 === void 0 || (_strategyConfig$metad2 = _strategyConfig$metad2.custom) === null || _strategyConfig$metad2 === void 0 ? void 0 : _strategyConfig$metad2.deductTaxAndFee) !== null && _strategyConfig$metad !== void 0 ? _strategyConfig$metad : true;
+
+      // 计算适用商品的总金额和数量
+      var _this$calculateApplic = this.calculateApplicableProducts(products, applicableProductIds, deductTaxAndFee),
+        applicableTotal = _this$calculateApplic.applicableTotal,
+        applicableCount = _this$calculateApplic.applicableCount;
+      return {
+        entities: {
+          voucher: voucher,
+          products: products,
+          order: {
+            orderTotalAmount: orderTotalAmount,
+            products: products
+          }
+        },
+        attributes: {
+          // 订单消费金额
+          orderTotalAmount: orderTotalAmount,
+          // 适用商品金额
+          applicableProductTotalAmount: applicableTotal,
+          // 适用商品购买数量
+          applicableProductCount: applicableCount,
+          // 当前评估的 voucher ID
+          voucherProductId: voucher.product_id,
+          // 订单中的商品ID
+          productIds: productIds
+        },
+        metadata: {
+          timestamp: Date.now()
+        }
+      };
+    }
+
+    /**
+     * 转换执行结果
+     * 将策略引擎的通用结果转换为业务层需要的格式
+     */
+  }, {
+    key: "transformResult",
+    value: function transformResult(result, businessData) {
+      // 从策略配置中获取业务配置
+      var strategyConfig = businessData === null || businessData === void 0 ? void 0 : businessData.strategyConfig;
+      var businessConfig = (strategyConfig === null || strategyConfig === void 0 ? void 0 : strategyConfig.metadata.custom) || {};
+
+      // 从 voucher 中获取适用商品ID
+      var voucher = businessData === null || businessData === void 0 ? void 0 : businessData.voucher;
+      var applicableProductIds = voucher ? getApplicableProductIds(voucher) : null;
+      if (!result.applicable) {
+        return {
+          isApplicable: false,
+          canUseCount: 0,
+          maxDeduction: 0,
+          deductTaxAndFee: false,
+          applicableProductIds: [],
+          reason: result.message,
+          reasonCode: result.code,
+          strategyResult: result
+        };
+      }
+
+      // 从配置中获取业务字段（不需要计算）
+      var maxDeduction = businessConfig.maxDeductionAmount || 0;
+      var canUseCount = businessConfig.maxUsagePerOrder || 0;
+      var deductTaxAndFee = businessConfig.deductTaxAndFee || false;
+      return {
+        isApplicable: true,
+        canUseCount: canUseCount,
+        maxDeduction: maxDeduction,
+        deductTaxAndFee: deductTaxAndFee,
+        applicableProductIds: applicableProductIds || [],
+        strategyResult: result
+      };
+    }
+
+    /**
+     * 格式化配置
+     */
+  }, {
+    key: "formatConfig",
+    value: function formatConfig(result, businessData) {
+      return {
+        result: result,
+        businessData: businessData
+      };
+    }
+
+    /**
+     * 计算适用商品的总金额和数量
+     */
+  }, {
+    key: "calculateApplicableProducts",
+    value: function calculateApplicableProducts(products, applicableProductIds) {
+      var deductTaxAndFee = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+      var total = 0;
+      var count = 0;
+
+      // 如果为空数组，不适用任何商品
+      if (applicableProductIds !== null && applicableProductIds.length === 0) {
+        return {
+          applicableTotal: 0,
+          applicableCount: 0
+        };
+      }
+      products.forEach(function (product) {
+        var productQuantity = getProductQuantity(product);
+
+        // 检查主商品是否适用
+        var isMainProductApplicable = applicableProductIds === null || applicableProductIds.includes(product.product_id);
+        if (isMainProductApplicable) {
+          // 计算主商品价格（包含加减价子商品）
+          total += getMainProductPrice(product, deductTaxAndFee) * productQuantity;
+          count += productQuantity;
+        }
+
+        // 检查原价子商品（需要单独判断适用性）
+        if (product.product_bundle && product.product_bundle.length > 0) {
+          product.product_bundle.forEach(function (bundleItem) {
+            // 只处理原价子商品，加减价子商品已包含在主商品价格中
+            if (getBundleItemIsOriginalPrice(bundleItem)) {
+              // 检查子商品是否适用
+              var isBundleItemApplicable = applicableProductIds === null || applicableProductIds.includes(bundleItem.bundle_product_id);
+              if (isBundleItemApplicable) {
+                // 计算原价子商品价格
+                var bundleItemQuantity = bundleItem.num * productQuantity;
+                total += getBundleItemPrice(bundleItem, productQuantity, deductTaxAndFee);
+                count += bundleItemQuantity;
+              }
+            }
+          });
+        }
+      });
+      return {
+        applicableTotal: total,
+        applicableCount: count
+      };
+    }
+  }]);
+  return WalletPassAdapter;
+}();
+export { WalletPassAdapter as default };

package/dist/model/strategy/adapter/walletPass/locales.d.ts

@@ -0,0 +1 @@
+export declare const locales: Record<string, Record<string, string>>;

package/dist/model/strategy/adapter/walletPass/locales.js

@@ -0,0 +1,23 @@
+export var locales = {
+  'zh-CN': {
+    'not_meet_the_required_conditions': '未达到使用条件',
+    'exceeds_the_maximum_deduction_limit': '超出最大抵扣金额限制',
+    'usage_limit_reached': '已达到使用次数上限',
+    'not_available_for_this_channel': '当前渠道不可使用',
+    'not_valid_for_this_order_type': '当前订单类型不适用'
+  },
+  'en': {
+    'not_meet_the_required_conditions': 'Not meet the required conditions.',
+    'exceeds_the_maximum_deduction_limit': 'Exceeds the maximum deduction limit.',
+    'usage_limit_reached': 'Usage limit reached.',
+    'not_available_for_this_channel': 'Not available for this channel.',
+    'not_valid_for_this_order_type': 'Not valid for this order type.'
+  },
+  'zh-HK': {
+    'not_meet_the_required_conditions': '未達使用條件',
+    'exceeds_the_maximum_deduction_limit': '超出最大抵扣金額限制',
+    'usage_limit_reached': '已達使用次數上限',
+    'not_available_for_this_channel': '當前渠道不可使用',
+    'not_valid_for_this_order_type': '當前訂單類型不適用'
+  }
+};

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

@@ -0,0 +1,163 @@
+import { EvaluationResult, StrategyConfig } from '../../type';
+/**
+ * Voucher 数据结构
+ */
+export interface Voucher {
+    id: number;
+    amount: number;
+    balance: number;
+    type?: string;
+    usedCount?: number;
+    available_product_type?: 'product_all' | 'product_collection' | 'products';
+    available_product_ids?: number[];
+    product_id: number;
+    unified_available_status: number;
+    /** 用户手动编辑的金额，优先于 recommended_usage_amount 使用 */
+    edit_current_amount?: number;
+    /** 前端基于策略返回的 不可用状态 */
+    _unified_available_status?: number;
+    /** 前端基于策略返回的 可用最大金额 */
+    _available_max_amount?: number;
+    /** 前端基于策略返回的 不可用原因 */
+    reason?: string;
+    /** 前端基于策略返回的 不可用原因码 */
+    reasonCode?: string;
+    /** 后端计算推荐使用金额 */
+    recommended_usage_amount: number;
+    /** 后端计算推荐使用金额（仅商品） 不包含税费附加费 */
+    recommended_pure_product_usage_amount: number;
+    /** 实际抵扣金额 */
+    actualDeduction: number;
+    /** 抵扣详情 */
+    deductionDetails: any[];
+    config?: {
+        /** 最大抵扣金额 */
+        maxDeductionAmount: number;
+        /** 每单最多使用张数（同一 product_id 的券）。默认为 0，表示不限制数量。 */
+        maxUsagePerOrder: number;
+        /** 是否抵扣税费与附加费 */
+        deductTaxAndFee: boolean;
+        /** 适用粒度（多商品共用） 默认开启勾选项 */
+        allowCrossProduct: boolean;
+        /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
+        applicableProductLimit: number;
+    };
+}
+/**
+ * 商品数据结构
+ */
+export interface Product {
+    product_id: number;
+    price: number;
+    quantity: number;
+    name?: string;
+    selling_price?: number;
+    /** 主商品折扣前金额，不包含套餐子商品 */
+    main_product_original_price?: number;
+    /** 主商品折扣后金额，不包含套餐子商品 */
+    main_product_selling_price?: number;
+    /** 主商品税费 */
+    tax_fee: number;
+    metadata: {
+        main_product_attached_bundle_tax_fee?: number;
+        main_product_attached_bundle_surcharge_fee?: number;
+        surcharge_rounding_remainder?: number;
+        main_product_selling_price: number;
+    };
+    is_price_include_tax: 0 | 1;
+    product_bundle: {
+        is_price_include_tax: 0 | 1;
+        bundle_id: number;
+        bundle_product_id: number;
+        bundle_variant_id: number;
+        price_type: string;
+        price_type_ext: string;
+        bundle_selling_price: number;
+        num: number;
+        is_charge_tax: number;
+        tax_fee: number;
+        metadata: {
+            surcharge_fee: number;
+            surcharge_rounding_remainder?: number;
+        };
+    }[];
+}
+/**
+ * Voucher 评估结果
+ */
+export interface VoucherEvaluationResult {
+    voucher: Voucher;
+    /** 是否可用 */
+    isApplicable: boolean;
+    /** 每单可使用张数 */
+    canUseCount: number;
+    /** 最大抵扣金额 */
+    maxDeduction: number;
+    /** 是否抵扣税费与附加费 */
+    deductTaxAndFee: boolean;
+    /** 适用商品ID列表 */
+    applicableProductIds: number[];
+    /** 不可用原因 */
+    reason?: string;
+    /** 不可用原因码 */
+    reasonCode?: string;
+    strategyResult?: EvaluationResult;
+}
+/**
+ * 评估器输入参数
+ */
+export interface EvaluatorInput {
+    /** 订单总金额 */
+    orderTotalAmount: number;
+    /** 商品列表 */
+    products: Product[];
+    /** 代金券列表 */
+    vouchers: Voucher[];
+    /** 策略配置列表 */
+    strategyConfigs?: StrategyConfig<{
+        /** 最大抵扣金额 */
+        maxDeductionAmount: number;
+        /** 每单最多使用张数（同一 product_id 的券）。默认为 0，表示不限制数量。 */
+        maxUsagePerOrder: number;
+        /** 是否抵扣税费与附加费 */
+        deductTaxAndFee: boolean;
+        /** 适用粒度（多商品共用） 默认开启勾选项 */
+        allowCrossProduct: boolean;
+        /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
+        applicableProductLimit: number;
+    }>[];
+}
+/**
+ * WalletPassAdapter 业务数据输入
+ */
+export interface WalletPassBusinessData {
+    /** 订单总金额 */
+    orderTotalAmount: number;
+    /** 商品列表 */
+    products: Product[];
+    /** 当前评估的 voucher */
+    voucher: Voucher;
+    /** 策略配置 */
+    strategyConfig: StrategyConfig;
+}
+/**
+ * WalletPassAdapter 转换结果
+ */
+export interface WalletPassTransformResult {
+    /** 是否可用 */
+    isApplicable: boolean;
+    /** 每单可使用张数 */
+    canUseCount: number;
+    /** 最大抵扣金额 */
+    maxDeduction: number;
+    /** 是否抵扣税费与附加费 */
+    deductTaxAndFee: boolean;
+    /** 适用商品ID列表 */
+    applicableProductIds: number[];
+    /** 不可用原因 */
+    reason?: string;
+    /** 不可用原因码 */
+    reasonCode?: string;
+    /** 原始策略评估结果 */
+    strategyResult?: EvaluationResult;
+}

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

@@ -0,0 +1 @@
+export {};