@pisell/private-materials 6.11.40 → 6.11.41

package/lib/components/booking/info2/model/strategy/adapter/type.d.ts

@@ -0,0 +1,28 @@
+import { EvaluationResult, RuntimeContext } from '../type';
+export interface BusinessAdapter {
+    /**
+     * 适配器名称
+     */
+    name: string;
+    /**
+     * 适配器版本
+     */
+    version: string;
+    /**
+     * 准备运行时上下文
+     * 将业务数据转换为策略引擎可识别的上下文
+     */
+    prepareContext(businessData: any): RuntimeContext;
+    /**
+     * 转换执行结果
+     * 将策略引擎的通用结果转换为业务层需要的格式
+     */
+    transformResult(result: EvaluationResult, businessData?: any): any;
+    /**
+     * 根据业务数据重新格式化配置
+     */
+    formatConfig(result: EvaluationResult, businessData?: any): {
+        result: EvaluationResult;
+        businessData?: any;
+    };
+}

package/lib/components/booking/info2/model/strategy/adapter/walletPass/evaluator.d.ts

@@ -0,0 +1,84 @@
+import { StrategyConfig } from '../../type';
+import { Voucher, Product, VoucherEvaluationResult, EvaluatorInput } from './type';
+/**
+ * Wallet Pass 评估器
+ * 用于评估哪些 voucher 可以在当前订单中使用
+ */
+export declare class WalletPassEvaluator {
+    private engine;
+    private strategyConfigs;
+    private locale;
+    constructor();
+    setStrategyConfigs(strategyConfigs: StrategyConfig[]): void;
+    getStrategyConfigs(): StrategyConfig[];
+    setLocale(locale: string): void;
+    getText(key: string): string;
+    /**
+     * 搜索券的格式
+     * @param input 输入
+     * @returns 返回搜索券的格式
+     */
+    searchVoucherFormat(input: EvaluatorInput): Voucher[];
+    /**
+     * 评估可用的 vouchers
+     */
+    evaluate(input: EvaluatorInput): VoucherEvaluationResult[];
+    /** 检查代金券/折扣卡是否可用 并返回config */
+    checkVoucherAvailability(input: EvaluatorInput): {
+        isAvailable: boolean;
+        config: {
+            [x: string]: any;
+        };
+    };
+    /**
+     * 获取推荐券
+     * @param input 输入
+     * @returns 返回推荐券列表
+     */
+    getRecommendedVouchers(input: EvaluatorInput): {
+        recommendedAmount: any;
+        recommended: any[];
+        transformList: any[];
+        noApplicableVoucher: Voucher[];
+    };
+    enhanceWithReason(voucher: any): any;
+    /**
+     * 优惠券处理函数
+     * @param applicableVouchers 可用的券列表
+     * @param orderTotalAmount 订单总金额
+     * @param products 订单商品列表
+     * @returns 返回推荐券列表和全部列表，每个券包含 _available_max_amount 和 _unified_available_status
+     */
+    processVouchers(vouchers: Voucher[], orderTotalAmount: number, products: Product[]): {
+        recommended: any[];
+        transformList: any[];
+    };
+    /**
+     * 重新计算优惠券状态（基于已选券的增量计算）
+     * @param allVouchers 所有原始券列表
+     * @param selectedVouchers 已选中的券列表（按选中顺序）
+     * @param orderTotalAmount 订单总金额
+     * @param products 订单商品列表
+     * @returns 返回更新后的所有券列表和已选券的详细抵扣信息
+     */
+    recalculateVouchers(allVouchers: any[], selectedVouchers: any[], orderTotalAmount: number, products: any[]): {
+        allWithUpdatedStatus: any[];
+        selectedWithDetails: any[];
+    };
+    /**
+     * 查找适用于指定 voucher 的策略配置
+     */
+    private findApplicableStrategies;
+    /**
+     * 检查策略中是否包含指定的 voucher ID
+     */
+    private checkVoucherInStrategy;
+    /**
+     * 递归检查条件组中是否包含 voucher ID
+     */
+    private checkVoucherInConditionGroup;
+    /**
+     * 计算适用商品的总金额和数量
+     */
+    private calculateApplicableProducts;
+}

package/lib/components/booking/info2/model/strategy/adapter/walletPass/example.d.ts

@@ -0,0 +1,4 @@
+/**
+ * WalletPass 评估器使用示例
+ */
+export {};

package/lib/components/booking/info2/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/components/booking/info2/model/strategy/adapter/walletPass/locales.d.ts

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

package/lib/components/booking/info2/model/strategy/adapter/walletPass/type.d.ts

@@ -0,0 +1,165 @@
+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;
+        tax_fee_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;
+            tax_fee_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/components/booking/info2/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;

package/lib/components/booking/info2/model/strategy/index.d.ts

@@ -0,0 +1,107 @@
+import { StrategyConfig, RuntimeContext, EvaluationResult, EngineOptions, OperatorHandler } from './type';
+/**
+ * 策略模型 - 核心实现
+ *
+ * 完全业务无关的通用策略引擎
+ * 支持条件评估、动作匹配、结果返回
+ */
+/**
+ * 策略引擎
+ *
+ * 核心职责：
+ * 1. 递归评估条件组
+ * 2. 收集满足条件的 actionIds
+ * 3. 根据 actionIds 获取 ActionEffect 对象
+ * 4. 按 priority 排序返回
+ */
+export declare class StrategyEngine {
+    private options;
+    private operatorHandlers;
+    constructor(options?: EngineOptions);
+    /**
+     * 评估策略
+     */
+    evaluate(config: StrategyConfig, context: RuntimeContext): EvaluationResult;
+    /**
+     * 递归评估条件组
+     *
+     * @param group 条件组
+     * @param context 运行时上下文
+     * @returns 评估结果对象，包含条件是否满足和收集到的 actionIds
+     */
+    private evaluateConditionGroup;
+    /**
+     * 评估条件组的逻辑运算
+     */
+    private evaluateGroupLogic;
+    /**
+     * 评估单个规则
+     */
+    private evaluateRule;
+    /**
+     * 评估代码模式条件
+     */
+    private evaluateCodeCondition;
+    /**
+     * 评估运算符模式条件
+     */
+    private evaluateOperatorCondition;
+    /**
+     * 获取字段值
+     */
+    private getFieldValue;
+    /**
+     * 评估内置运算符
+     */
+    private evaluateBuiltInOperator;
+    /**
+     * 根据 actionIds 获取 ActionEffect 对象
+     */
+    private getActionsByIds;
+    /**
+     * 按 priority 排序（降序）
+     */
+    private sortActionsByPriority;
+    /**
+     * 判断是否为条件组
+     */
+    private isConditionGroup;
+    /**
+     * 验证配置
+     */
+    private validateConfig;
+    /**
+     * 初始化内置运算符处理器
+     */
+    private initializeBuiltInOperators;
+    /**
+     * 评估商品匹配运算符
+     *
+     * 匹配规则：
+     * - 首先匹配 product_id
+     * - 如果配置的 product_variant_id = 0，只需要 product_id 匹配（表示任意变体）
+     * - 如果配置的 product_variant_id != 0，还需要 product_variant_id 精确匹配
+     *
+     * @param fieldValue 实际商品 { product_id: number, product_variant_id: number }
+     * @param configValue 配置的商品列表 Array<{ product_id: number, product_variant_id: number }>
+     * @returns 是否匹配
+     */
+    private evaluateProductMatch;
+    /**
+     * 注册自定义运算符
+     */
+    registerOperator(operator: string, handler: OperatorHandler): void;
+    /**
+     * 获取调试信息
+     */
+    getDebugInfo(): Record<string, any>;
+}
+export * from './adapter';
+/**
+ * 创建策略引擎实例
+ */
+export declare function createStrategyEngine(options?: EngineOptions): StrategyEngine;
+/**
+ * 快速评估（使用默认引擎配置）
+ */
+export declare function evaluate(config: StrategyConfig, context: RuntimeContext): EvaluationResult;

package/lib/components/booking/info2/model/strategy/strategy-example.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 策略模型使用示例
+ */
+declare function runExamples(): void;
+export { runExamples };