@pisell/private-materials 6.11.123 → 6.11.125

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

@@ -1,84 +0,0 @@
-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

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

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

@@ -1,32 +0,0 @@
-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

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

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

@@ -1,165 +0,0 @@
-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

@@ -1,50 +0,0 @@
-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

@@ -1,107 +0,0 @@
-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

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

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

@@ -1,228 +0,0 @@
-/**
- * 策略配置主结构
- */
-export interface StrategyConfig<T = Record<string, any>> {
-    /** 元信息 */
-    metadata: StrategyMetadata<T>;
-    /** 条件组（可嵌套，每层可绑定动作） */
-    conditions: ConditionGroup;
-    /** 动作列表（带唯一ID） */
-    actions: ActionEffect[];
-    /** 展示配置（可选） */
-    display?: DisplayConfig;
-}
-/**
- * 策略元信息
- */
-export interface StrategyMetadata<T = Record<string, any>> {
-    /** 策略ID */
-    id: string;
-    /** 策略名称 */
-    name: string | Record<string, string>;
-    /** 策略类型（完全可扩展） */
-    type: string;
-    /** 计算类型 */
-    calculationType?: 'single' | 'cumulative';
-    /** 版本 */
-    version?: string;
-    /** 描述 */
-    description?: string | Record<string, string>;
-    /** 自定义元数据 */
-    custom?: T;
-}
-/**
- * 条件组（支持嵌套）
- */
-export interface ConditionGroup {
-    /** 逻辑运算符 */
-    operator: 'and' | 'or' | 'not';
-    /** 条件规则列表（可以是单条件或嵌套的条件组） */
-    rules: Array<ConditionRule | ConditionGroup>;
-    /** 关联的动作ID列表（必填，可以为空数组） */
-    actionIds: string[];
-}
-/**
- * 条件规则（原子条件）
- * 支持 code 模式使用 eval 执行
- */
-export interface ConditionRule {
-    /** 类型 */
-    type: 'code' | 'operator';
-    /** 代码（code模式使用，使用eval执行） */
-    code?: string;
-    /** 维度（完全可扩展） */
-    dimension?: string;
-    /** 字段名 */
-    field?: string;
-    /** 运算符 */
-    operator?: string;
-    /** 比较值 */
-    value?: any;
-    /** 值类型 */
-    valueType?: 'number' | 'string' | 'boolean' | 'array' | 'object' | 'date';
-    /** 值单位 */
-    valueUnit?: string;
-    /** 额外配置 */
-    config?: Record<string, any>;
-}
-/**
- * 动作效果
- */
-export interface ActionEffect {
-    /** 动作的唯一标识 */
-    id: string;
-    /** 效果类型（完全可扩展） */
-    type: string;
-    /** 运算符（可选） */
-    operator?: string;
-    /** 值 */
-    value: any;
-    /** 值类型 */
-    valueType?: 'number' | 'string' | 'boolean' | 'array' | 'object';
-    /** 值单位 */
-    valueUnit?: string;
-    /** 作用目标 */
-    target: string;
-    /** 优先级（数字越大优先级越高） */
-    priority?: number;
-    /** 配置（完全可扩展） */
-    config?: Record<string, any>;
-}
-/**
- * 展示配置
- */
-export interface DisplayConfig {
-    /** 商品卡片展示 */
-    productCard?: {
-        text: string | Record<string, string>;
-        type: 'tag' | 'badge' | 'label';
-        image?: string;
-        style?: Record<string, any>;
-    };
-    /** 详情页展示 */
-    detail?: {
-        title: string | Record<string, string>;
-        description: string | Record<string, string>;
-        image?: string;
-    };
-    /** 自定义展示配置 */
-    custom?: Record<string, any>;
-}
-/**
- * 运行时上下文结构
- */
-export interface RuntimeContext {
-    /** 实体数据（完全开放，由业务层定义） */
-    entities: Record<string, any>;
-    /** 属性数据（扁平化的计算值，用于条件判断） */
-    attributes: Record<string, any>;
-    /** 上下文元数据 */
-    metadata: ContextMetadata;
-}
-/**
- * 上下文元数据
- */
-export interface ContextMetadata {
-    /** 请求ID（用于追踪） */
-    requestId?: string;
-    /** 时间戳 */
-    timestamp: number;
-    /** 语言 */
-    locale?: string;
-    /** 自定义元数据 */
-    custom?: Record<string, any>;
-}
-/**
- * 评估结果结构
- */
-export interface EvaluationResult {
-    /** 是否成功执行（引擎层面） */
-    success: boolean;
-    /** 策略是否适用（业务层面） */
-    applicable: boolean;
-    /** 结果码 */
-    code: string;
-    /** 消息（多语言key或直接文本） */
-    message?: string;
-    /** 匹配信息 */
-    matched: MatchedInfo;
-    /** 匹配的动作列表（按priority排序） */
-    matchedActions: ActionEffect[];
-    /** 输出结果（完全开放，由适配器定义） */
-    outputs: Record<string, any>;
-    /** 执行轨迹（可选，用于调试） */
-    trace?: ExecutionTrace;
-    /** 策略配置 */
-    config: StrategyConfig;
-}
-/**
- * 匹配信息
- */
-export interface MatchedInfo {
-    /** 条件是否满足 */
-    conditions: boolean;
-    /** 收集到的 actionIds */
-    actionIds: string[];
-    /** 详细匹配信息 */
-    details: Record<string, any>;
-}
-/**
- * 执行轨迹
- */
-export interface ExecutionTrace {
-    /** 执行步骤 */
-    steps: TraceStep[];
-    /** 总耗时（毫秒） */
-    duration: number;
-    /** 错误信息 */
-    errors?: Array<{
-        step: string;
-        error: string;
-        timestamp: number;
-    }>;
-}
-/**
- * 追踪步骤
- */
-export interface TraceStep {
-    /** 步骤名称 */
-    step: string;
-    /** 步骤状态 */
-    status: 'success' | 'failed' | 'skipped';
-    /** 耗时（毫秒） */
-    duration: number;
-    /** 详细信息 */
-    details?: Record<string, any>;
-}
-/** 成功码 */
-export declare const SUCCESS_CODES: {
-    readonly SUCCESS: "SUCCESS";
-};
-/** 不适用码 */
-export declare const NOT_APPLICABLE_CODES: {
-    readonly CONDITION_NOT_MET: "CONDITION_NOT_MET";
-};
-/** 错误码 */
-export declare const ERROR_CODES: {
-    readonly INVALID_CONFIG: "INVALID_CONFIG";
-    readonly INVALID_CONTEXT: "INVALID_CONTEXT";
-    readonly EVALUATION_ERROR: "EVALUATION_ERROR";
-    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
-};
-/**
- * 引擎配置选项
- */
-export interface EngineOptions {
-    /** 是否启用调试模式 */
-    debug?: boolean;
-    /** 是否启用追踪 */
-    enableTrace?: boolean;
-    /** 运算符处理器映射 */
-    operatorHandlers?: Record<string, OperatorHandler>;
-    /** 自定义错误处理器 */
-    errorHandler?: (error: Error, context: RuntimeContext) => void;
-}
-/**
- * 运算符处理器
- */
-export declare type OperatorHandler = (fieldValue: any, compareValue: any, rule: ConditionRule) => boolean;