@pisell/pisellos 2.1.59 → 2.1.60

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

@@ -0,0 +1,207 @@
+// src/model/strategy/adapter/walletPass/example.ts
+var import_evaluator = require("./evaluator");
+var products = [
+  {
+    product_id: 60734,
+    price: 80,
+    quantity: 1,
+    name: "商品A"
+  },
+  {
+    product_id: 60735,
+    price: 50,
+    quantity: 2,
+    name: "商品B"
+  }
+];
+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"
+  }
+];
+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");
+  const evaluator = new import_evaluator.WalletPassEvaluator();
+  const results = evaluator.evaluate({
+    orderTotalAmount: 180,
+    products,
+    vouchers,
+    strategyConfigs
+  });
+  console.log("订单信息：");
+  console.log(`- 总金额: ${180} 元`);
+  console.log(`- 商品: ${products.map((p) => `${p.name}(${p.quantity}件)`).join(", ")}
+`);
+  console.log("评估结果：\n");
+  results.forEach((result, index) => {
+    console.log(`Voucher ${index + 1}: ${result.voucher.id}`);
+    console.log(`  面额: ${result.voucher.amount} 元`);
+    console.log(`  可用: ${result.isApplicable ? "✅ 是" : "❌ 否"}`);
+    if (result.isApplicable) {
+      console.log(`  最大抵扣: ${result.maxDeduction} 元`);
+      console.log(`  每单可用: ${result.canUseCount} 张`);
+      console.log(`  抵扣税费: ${result.deductTaxAndFee ? "是" : "否"}`);
+      console.log(`  适用商品: ${result.applicableProductIds.join(", ")}`);
+    } else {
+      console.log(`  原因: ${result.reason}`);
+      console.log(`  原因码: ${result.reasonCode}`);
+    }
+    console.log("");
+  });
+  const availableVouchers = results.filter((r) => r.isApplicable);
+  console.log(`
+共 ${availableVouchers.length} 张可用`);
+  if (availableVouchers.length > 0) {
+    console.log("可用 voucher ID:");
+    availableVouchers.forEach((v) => {
+      console.log(`  - ${v.voucher.id}: 最多抵扣 ${v.maxDeduction} 元`);
+    });
+  }
+}
+runExample();

package/lib/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/lib/model/strategy/adapter/walletPass/index.js

@@ -0,0 +1,142 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/model/strategy/adapter/walletPass/index.ts
+var walletPass_exports = {};
+__export(walletPass_exports, {
+  default: () => WalletPassAdapter
+});
+module.exports = __toCommonJS(walletPass_exports);
+var import_utils = require("./utils");
+var WalletPassAdapter = class {
+  constructor() {
+    this.name = "WalletPassAdapter";
+    this.version = "1.0.0";
+  }
+  /**
+   * 准备运行时上下文
+   * 将业务数据转换为策略引擎可识别的 RuntimeContext
+   */
+  prepareContext(businessData) {
+    var _a, _b;
+    const { orderTotalAmount, products, voucher, strategyConfig } = businessData;
+    const productIds = products.map((p) => p.product_id);
+    const applicableProductIds = (0, import_utils.getApplicableProductIds)(voucher);
+    const deductTaxAndFee = ((_b = (_a = strategyConfig == null ? void 0 : strategyConfig.metadata) == null ? void 0 : _a.custom) == null ? void 0 : _b.deductTaxAndFee) ?? true;
+    const { applicableTotal, applicableCount } = this.calculateApplicableProducts(
+      products,
+      applicableProductIds,
+      deductTaxAndFee
+    );
+    return {
+      entities: {
+        voucher,
+        products,
+        order: {
+          orderTotalAmount,
+          products
+        }
+      },
+      attributes: {
+        // 订单消费金额
+        orderTotalAmount,
+        // 适用商品金额
+        applicableProductTotalAmount: applicableTotal,
+        // 适用商品购买数量
+        applicableProductCount: applicableCount,
+        // 当前评估的 voucher ID
+        voucherProductId: voucher.product_id,
+        // 订单中的商品ID
+        productIds
+      },
+      metadata: {
+        timestamp: Date.now()
+      }
+    };
+  }
+  /**
+   * 转换执行结果
+   * 将策略引擎的通用结果转换为业务层需要的格式
+   */
+  transformResult(result, businessData) {
+    const strategyConfig = businessData == null ? void 0 : businessData.strategyConfig;
+    const businessConfig = (strategyConfig == null ? void 0 : strategyConfig.metadata.custom) || {};
+    const voucher = businessData == null ? void 0 : businessData.voucher;
+    const applicableProductIds = voucher ? (0, import_utils.getApplicableProductIds)(voucher) : null;
+    if (!result.applicable) {
+      return {
+        isApplicable: false,
+        canUseCount: 0,
+        maxDeduction: 0,
+        deductTaxAndFee: false,
+        applicableProductIds: [],
+        reason: result.message,
+        reasonCode: result.code,
+        strategyResult: result
+      };
+    }
+    const maxDeduction = businessConfig.maxDeductionAmount || 0;
+    const canUseCount = businessConfig.maxUsagePerOrder || 0;
+    const deductTaxAndFee = businessConfig.deductTaxAndFee || false;
+    return {
+      isApplicable: true,
+      canUseCount,
+      maxDeduction,
+      deductTaxAndFee,
+      applicableProductIds: applicableProductIds || [],
+      strategyResult: result
+    };
+  }
+  /**
+   * 格式化配置
+   */
+  formatConfig(result, businessData) {
+    return { result, businessData };
+  }
+  /**
+   * 计算适用商品的总金额和数量
+   */
+  calculateApplicableProducts(products, applicableProductIds, deductTaxAndFee = true) {
+    let total = 0;
+    let count = 0;
+    if (applicableProductIds !== null && applicableProductIds.length === 0) {
+      return { applicableTotal: 0, applicableCount: 0 };
+    }
+    products.forEach((product) => {
+      const productQuantity = (0, import_utils.getProductQuantity)(product);
+      const isMainProductApplicable = applicableProductIds === null || applicableProductIds.includes(product.product_id);
+      if (isMainProductApplicable) {
+        total += (0, import_utils.getMainProductPrice)(product, deductTaxAndFee) * productQuantity;
+        count += productQuantity;
+      }
+      if (product.product_bundle && product.product_bundle.length > 0) {
+        product.product_bundle.forEach((bundleItem) => {
+          if ((0, import_utils.getBundleItemIsOriginalPrice)(bundleItem)) {
+            const isBundleItemApplicable = applicableProductIds === null || applicableProductIds.includes(bundleItem.bundle_product_id);
+            if (isBundleItemApplicable) {
+              const bundleItemQuantity = bundleItem.num * productQuantity;
+              total += (0, import_utils.getBundleItemPrice)(bundleItem, productQuantity, deductTaxAndFee);
+              count += bundleItemQuantity;
+            }
+          }
+        });
+      }
+    });
+    return { applicableTotal: total, applicableCount: count };
+  }
+};

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

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

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

@@ -0,0 +1,51 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/model/strategy/adapter/walletPass/locales.ts
+var locales_exports = {};
+__export(locales_exports, {
+  locales: () => locales
+});
+module.exports = __toCommonJS(locales_exports);
+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": "當前訂單類型不適用"
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  locales
+});

package/lib/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/lib/model/strategy/adapter/walletPass/type.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/model/strategy/adapter/walletPass/type.ts
+var type_exports = {};
+module.exports = __toCommonJS(type_exports);

package/lib/model/strategy/adapter/walletPass/utils.d.ts

@@ -0,0 +1,50 @@
+import { Product, Voucher } from './type';
+export declare const getApplicableProductIds: (voucher: Voucher) => number[] | null;
+/**
+ * 优惠券处理函数
+ * @param applicableVouchers 可用的券列表
+ * @param orderTotalAmount 订单总金额
+ * @param products 订单商品列表
+ * @returns 返回推荐券列表和全部列表，每个券包含 _available_max_amount 和 _unified_available_status
+ */
+export declare function processVouchers(applicableVouchers: Voucher[], orderTotalAmount: number, products: Product[]): {
+    recommended: any[];
+    transformList: any[];
+};
+/**
+ * 重新计算优惠券状态（基于已选券的增量计算）
+ * @param allVouchers 所有原始券列表
+ * @param selectedVouchers 已选中的券列表（按选中顺序）
+ * @param orderTotalAmount 订单总金额
+ * @param products 订单商品列表
+ * @returns 返回更新后的所有券列表和已选券的详细抵扣信息
+ */
+export declare function recalculateVouchers(allVouchers: any[], selectedVouchers: any[], orderTotalAmount: number, products: any[]): {
+    allWithUpdatedStatus: any[];
+    selectedWithDetails: any[];
+};
+/**
+ * 获取主商品价格
+ * @param product 商品
+ * @param isDeductTaxAndFee 是否抵扣税费与附加费
+ * @returns 商品价格
+ */
+export declare const getMainProductPrice: (product: Product, isDeductTaxAndFee: boolean) => number;
+/**
+ * 获取套餐子商品价格
+ * @param bundleItem 套餐子商品
+ * @param parentQuantity 父商品数量
+ * @param isDeductTaxAndFee 是否抵扣税费与附加费
+ * @returns 子商品总价格
+ */
+export declare const getBundleItemPrice: (bundleItem: any, parentQuantity: number, isDeductTaxAndFee: boolean) => number;
+/**
+ * 获取商品数量
+ * @param product 商品
+ * @returns 商品数量
+ */
+export declare const getProductQuantity: (product: any) => any;
+export declare const getBundleItemIsOriginalPrice: (item: any) => boolean;
+export declare const getBundleItemIsMarkupPrice: (item: any) => boolean;
+export declare const getBundleItemIsDiscountPrice: (item: any) => boolean;
+export declare const getBundleItemIsMarkupOrDiscountPrice: (item: any) => boolean;