@pisell/pisellos 2.2.261 → 2.2.262

package/dist/model/strategy/adapter/dataVariant/examples.d.ts

@@ -0,0 +1,39 @@
+import type { StrategyConfig } from '../../type';
+import type { ScheduleItem } from '../../../../modules/Schedule/types';
+import type { DataVariantItem, DataVariantMenu, DataVariantProduct, DataVariantRuleMetadata } from './type';
+/**
+ * 构造示例用 data_variant 记录，字段结构与后端 /product/query 返回一致。
+ */
+export declare function createExampleDataVariant(ruleId: number | string, data: Record<string, any>, overrides?: Partial<Omit<DataVariantItem, 'data_variant_rule_id' | 'data'>>): DataVariantItem;
+/**
+ * 晚场餐牌价：命中日程 + 餐牌商品范围后覆盖 price / stock。
+ */
+export declare const EVENING_MENU_PRICE_STRATEGY: StrategyConfig<DataVariantRuleMetadata>;
+/**
+ * VIP 商品价：演示 product_match 与更高优先级字段覆盖。
+ */
+export declare const VIP_PRODUCT_PRICE_STRATEGY: StrategyConfig<DataVariantRuleMetadata>;
+/**
+ * 客户/渠道/业务范围价：演示 customer_id、channel、business_code 的 in 条件。
+ */
+export declare const CUSTOMER_SCOPE_PRICE_STRATEGY: StrategyConfig<DataVariantRuleMetadata>;
+/**
+ * 示例日程：2026-06-26 17:00 ~ 20:00 生效。
+ */
+export declare const DATA_VARIANT_EXAMPLE_SCHEDULES: ScheduleItem[];
+/**
+ * 示例餐牌：product_collection = 128 的商品均属于餐牌。
+ */
+export declare const DATA_VARIANT_EXAMPLE_MENUS: DataVariantMenu[];
+/**
+ * 示例商品：同时带两条 Data Variant 覆盖数据。
+ */
+export declare const DATA_VARIANT_EXAMPLE_PRODUCTS: DataVariantProduct[];
+/**
+ * Data Variant 评估器示例调用。
+ */
+export declare function runDataVariantDemo(): import("./type").ResolvedDataVariantResult;
+/**
+ * 客户/渠道/业务范围条件示例调用。
+ */
+export declare function runCustomerScopeDataVariantDemo(): import("./type").ResolvedDataVariantResult;

package/dist/model/strategy/adapter/dataVariant/examples.js

@@ -0,0 +1,277 @@
+import { DataVariantEvaluator } from "./evaluator";
+import { DATA_VARIANT_ACTION_TYPES } from "./type";
+/**
+ * 构造示例用 data_variant 记录，字段结构与后端 /product/query 返回一致。
+ */
+export function createExampleDataVariant(ruleId, data, overrides) {
+  var _overrides$id, _overrides$shop_id, _overrides$module, _overrides$module_dat, _overrides$created_at, _overrides$updated_at, _overrides$deleted_at;
+  return {
+    id: (_overrides$id = overrides === null || overrides === void 0 ? void 0 : overrides.id) !== null && _overrides$id !== void 0 ? _overrides$id : 1,
+    shop_id: (_overrides$shop_id = overrides === null || overrides === void 0 ? void 0 : overrides.shop_id) !== null && _overrides$shop_id !== void 0 ? _overrides$shop_id : 9,
+    module: (_overrides$module = overrides === null || overrides === void 0 ? void 0 : overrides.module) !== null && _overrides$module !== void 0 ? _overrides$module : 'product',
+    module_data_id: (_overrides$module_dat = overrides === null || overrides === void 0 ? void 0 : overrides.module_data_id) !== null && _overrides$module_dat !== void 0 ? _overrides$module_dat : 61416,
+    data_variant_rule_id: ruleId,
+    data: data,
+    created_at: (_overrides$created_at = overrides === null || overrides === void 0 ? void 0 : overrides.created_at) !== null && _overrides$created_at !== void 0 ? _overrides$created_at : null,
+    updated_at: (_overrides$updated_at = overrides === null || overrides === void 0 ? void 0 : overrides.updated_at) !== null && _overrides$updated_at !== void 0 ? _overrides$updated_at : null,
+    deleted_at: (_overrides$deleted_at = overrides === null || overrides === void 0 ? void 0 : overrides.deleted_at) !== null && _overrides$deleted_at !== void 0 ? _overrides$deleted_at : null
+  };
+}
+
+/**
+ * 晚场餐牌价：命中日程 + 餐牌商品范围后覆盖 price / stock。
+ */
+export var EVENING_MENU_PRICE_STRATEGY = {
+  metadata: {
+    id: '1',
+    type: 'data_variant',
+    name: {
+      'zh-CN': '晚场餐牌价',
+      en: 'Evening menu price'
+    },
+    custom: {
+      module: 'product',
+      priority: 100,
+      status: 'active',
+      updated_at: '2026-06-26 12:00:00'
+    }
+  },
+  conditions: {
+    operator: 'and',
+    rules: [{
+      type: 'operator',
+      field: 'schedule',
+      operator: 'schedule_match',
+      value: [1042]
+    }, {
+      type: 'operator',
+      field: 'product',
+      operator: 'menu_match',
+      value: [43209]
+    }],
+    actionIds: ['apply_data_variant']
+  },
+  actions: [{
+    id: 'apply_data_variant',
+    type: DATA_VARIANT_ACTION_TYPES.APPLY,
+    target: 'product',
+    value: null,
+    priority: 100
+  }]
+};
+
+/**
+ * VIP 商品价：演示 product_match 与更高优先级字段覆盖。
+ */
+export var VIP_PRODUCT_PRICE_STRATEGY = {
+  metadata: {
+    id: '2',
+    type: 'data_variant',
+    name: {
+      'zh-CN': 'VIP 商品价',
+      en: 'VIP product price'
+    },
+    custom: {
+      module: 'product',
+      priority: 200,
+      status: 'active',
+      updated_at: '2026-06-26 13:00:00'
+    }
+  },
+  conditions: {
+    operator: 'and',
+    rules: [{
+      type: 'operator',
+      field: 'productIdAndVariantId',
+      operator: 'product_match',
+      value: [{
+        product_id: 2001,
+        product_variant_id: 0
+      }]
+    }],
+    actionIds: ['apply_data_variant']
+  },
+  actions: [{
+    id: 'apply_data_variant',
+    type: DATA_VARIANT_ACTION_TYPES.APPLY,
+    target: 'product',
+    value: null,
+    priority: 200
+  }]
+};
+
+/**
+ * 客户/渠道/业务范围价：演示 customer_id、channel、business_code 的 in 条件。
+ */
+export var CUSTOMER_SCOPE_PRICE_STRATEGY = {
+  metadata: {
+    id: '3',
+    type: 'data_variant',
+    name: {
+      'zh-CN': '指定客户渠道业务价',
+      en: 'Scoped customer channel business price'
+    },
+    custom: {
+      module: 'product',
+      priority: 150,
+      status: 'active',
+      updated_at: '2026-06-26 14:00:00'
+    }
+  },
+  conditions: {
+    operator: 'and',
+    rules: [{
+      type: 'operator',
+      field: 'customer_id',
+      operator: 'in',
+      value: [333, 444]
+    }, {
+      type: 'operator',
+      field: 'channel',
+      operator: 'in',
+      value: ['pos', 'online']
+    }, {
+      type: 'operator',
+      field: 'business_code',
+      operator: 'in',
+      value: ['venue', 'retail']
+    }],
+    actionIds: ['apply_data_variant']
+  },
+  actions: [{
+    id: 'apply_data_variant',
+    type: DATA_VARIANT_ACTION_TYPES.APPLY,
+    target: 'product',
+    value: null,
+    priority: 150
+  }]
+};
+
+/**
+ * 示例日程：2026-06-26 17:00 ~ 20:00 生效。
+ */
+export var DATA_VARIANT_EXAMPLE_SCHEDULES = [{
+  id: 1042,
+  name: '晚场 17~20',
+  color: '#1890ff',
+  start_time: '2026-06-26 17:00:00',
+  end_time: '2026-06-26 20:00:00',
+  repeat_type: 'none',
+  repeat_rule: {
+    end: {
+      type: 'never',
+      end_date: null,
+      occurrence: null
+    },
+    frequency: 1,
+    excluded_date: [],
+    included_date: [],
+    frequency_date: []
+  },
+  type: 'standard',
+  time_slot: [],
+  designation: [],
+  is_all: 0,
+  created_at: '2026-06-26 00:00:00',
+  updated_at: '2026-06-26 00:00:00',
+  order_count: 0,
+  relation_count: 0
+}];
+
+/**
+ * 示例餐牌：product_collection = 128 的商品均属于餐牌。
+ */
+export var DATA_VARIANT_EXAMPLE_MENUS = [{
+  form_record_id: 43209,
+  name: 'kiosk餐牌1 17~20',
+  status: 'valid',
+  schedule: [1042],
+  partyroom_package: {
+    type: 'product_collection',
+    products: [{
+      product_collection_id: 128,
+      product_id: 0,
+      product_variant_id: 0
+    }]
+  }
+}];
+
+/**
+ * 示例商品：同时带两条 Data Variant 覆盖数据。
+ */
+export var DATA_VARIANT_EXAMPLE_PRODUCTS = [{
+  id: 2001,
+  title: '入场票',
+  price: 100,
+  stock: 50,
+  collection: [{
+    id: 128,
+    title: 'Tickets'
+  }],
+  data_variants: [createExampleDataVariant(1, {
+    price: 80,
+    stock: 20
+  }, {
+    id: 1,
+    module_data_id: 2001
+  }), createExampleDataVariant(2, {
+    price: 70,
+    title: 'VIP专属票'
+  }, {
+    id: 2,
+    module_data_id: 2001
+  }), createExampleDataVariant(3, {
+    price: 65,
+    title: 'VIP渠道价'
+  }, {
+    id: 4,
+    module_data_id: 2001
+  })]
+}, {
+  id: 2002,
+  title: '普通票',
+  price: 100,
+  stock: 50,
+  collection: [{
+    id: 999,
+    title: 'Other'
+  }],
+  data_variants: [createExampleDataVariant(1, {
+    price: 80,
+    stock: 20
+  }, {
+    id: 3,
+    module_data_id: 2002
+  })]
+}];
+
+/**
+ * Data Variant 评估器示例调用。
+ */
+export function runDataVariantDemo() {
+  var evaluator = new DataVariantEvaluator();
+  evaluator.setStrategyConfigs([EVENING_MENU_PRICE_STRATEGY, VIP_PRODUCT_PRICE_STRATEGY]);
+  var businessData = {
+    products: DATA_VARIANT_EXAMPLE_PRODUCTS,
+    scheduleDateTime: '2026-06-26 18:00:00',
+    scheduleList: DATA_VARIANT_EXAMPLE_SCHEDULES,
+    menuList: DATA_VARIANT_EXAMPLE_MENUS,
+    orderType: 'booking'
+  };
+  return evaluator.resolveProducts(businessData);
+}
+
+/**
+ * 客户/渠道/业务范围条件示例调用。
+ */
+export function runCustomerScopeDataVariantDemo() {
+  var evaluator = new DataVariantEvaluator();
+  evaluator.setStrategyConfigs([CUSTOMER_SCOPE_PRICE_STRATEGY]);
+  var businessData = {
+    products: [DATA_VARIANT_EXAMPLE_PRODUCTS[0]],
+    customerId: 333,
+    channel: 'pos',
+    businessCode: 'venue'
+  };
+  return evaluator.resolveProducts(businessData);
+}

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

@@ -0,0 +1,4 @@
+export { DataVariantAdapter } from './adapter';
+export { DataVariantEvaluator } from './evaluator';
+export { runDataVariantDemo } from './examples';
+export * from './type';

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

@@ -0,0 +1,4 @@
+export { DataVariantAdapter } from "./adapter";
+export { DataVariantEvaluator } from "./evaluator";
+export { runDataVariantDemo } from "./examples";
+export * from "./type";

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

@@ -0,0 +1,148 @@
+import type { ConditionRule, EvaluationResult, StrategyConfig } from '../../type';
+import type { ScheduleItem } from '../../../../modules/Schedule/types';
+/**
+ * Data Variant 动作类型。
+ *
+ * 当前阶段动作只用于标识“该策略可应用 data variant 覆盖”，真实覆盖数据来自商品 data_variants。
+ */
+export declare const DATA_VARIANT_ACTION_TYPES: {
+    readonly APPLY: "DATA_VARIANT_APPLY";
+};
+export type DataVariantActionType = (typeof DATA_VARIANT_ACTION_TYPES)[keyof typeof DATA_VARIANT_ACTION_TYPES];
+/**
+ * Data Variant 规则元数据。
+ *
+ * priority 数字越大优先级越高，合并时后覆盖低优先级字段。
+ */
+export interface DataVariantRuleMetadata {
+    module?: 'product' | string;
+    priority?: number;
+    status?: 'active' | 'inactive' | string;
+    updated_at?: string;
+    [key: string]: any;
+}
+/**
+ * 商品上的单条 Data Variant 记录，结构与后端 data_variant 表对齐。
+ */
+export interface DataVariantItem {
+    /** 变体记录 id */
+    id?: number;
+    /** 店铺 id */
+    shop_id?: number;
+    /** 所属模块，商品场景固定为 product */
+    module?: 'product' | string;
+    /** 模块数据 id，商品场景对应 product.id */
+    module_data_id?: number;
+    /** 关联策略模型 metadata.id / data_variant_rule.id */
+    data_variant_rule_id: number | string;
+    /** 命中策略后需要覆盖到商品上的字段 */
+    data: Record<string, any>;
+    created_at?: string | null;
+    updated_at?: string | null;
+    deleted_at?: string | null;
+}
+/**
+ * Data Variant 评估使用的轻量商品结构。
+ */
+export interface DataVariantProduct {
+    id?: number | string;
+    product_id?: number | string;
+    product_variant_id?: number | string;
+    variant_id?: number | string;
+    collection?: Array<{
+        id?: number | string;
+        [key: string]: any;
+    }>;
+    /** 后端 /product/query with dataVariants 返回的智能定价变体列表 */
+    data_variants?: DataVariantItem[];
+    _dataVariant?: DataVariantAppliedInfo;
+    [key: string]: any;
+}
+/**
+ * 餐牌商品配置项。
+ */
+export interface DataVariantMenuProductItem {
+    product_collection_id?: number | string;
+    product_id?: number | string;
+    product_variant_id?: number | string;
+}
+/**
+ * 餐牌数据的最小结构。
+ */
+export interface DataVariantMenu {
+    form_record_id: number | string;
+    status?: string;
+    schedule?: Array<number | string>;
+    partyroom_package?: {
+        type?: 'product_all' | 'product_collection' | 'products' | string;
+        products?: DataVariantMenuProductItem[];
+    };
+    [key: string]: any;
+}
+/**
+ * 单个餐牌预构建后的商品范围索引。
+ */
+export interface MenuScope {
+    isAllProducts: boolean;
+    collectionIds: Set<number>;
+    productKeys: Set<string>;
+    productAllVariantIds: Set<number>;
+}
+/**
+ * 批量评估输入。
+ */
+export interface DataVariantBusinessData {
+    products: DataVariantProduct[];
+    strategyConfigs?: StrategyConfig<DataVariantRuleMetadata>[];
+    scheduleDateTime?: string;
+    scheduleList?: ScheduleItem[];
+    menuList?: DataVariantMenu[];
+    channel?: string;
+    orderType?: string;
+    /** 当前业务编码，对应策略条件 field: business_code */
+    businessCode?: string;
+    customerId?: number | string;
+    /** 当前客户可用 wallet/pass id 合并列表，对应策略条件 field: available_wallet_ids */
+    availableWalletIds?: Array<number | string>;
+    custom?: Record<string, any>;
+}
+/**
+ * 全局预计算后的规则信息。
+ */
+export interface EffectiveRuleInfo {
+    ruleId: string;
+    priority: number;
+    strategyConfig: StrategyConfig<DataVariantRuleMetadata>;
+    productRules: ConditionRule[];
+    globalResult: EvaluationResult;
+}
+export type GlobalEffectiveRuleMap = Map<string, EffectiveRuleInfo>;
+/**
+ * 单条商品命中的变体覆盖信息。
+ */
+export interface MatchedDataVariant {
+    ruleId: string;
+    priority: number;
+    data: Record<string, any>;
+    variant: DataVariantItem;
+}
+/**
+ * 商品上记录的 Data Variant 调试信息。
+ */
+export interface DataVariantAppliedInfo {
+    appliedRuleIds: string[];
+    appliedFields: string[];
+    original: DataVariantProduct;
+}
+/**
+ * 批量解析结果。
+ */
+export interface ResolvedDataVariantResult {
+    products: DataVariantProduct[];
+    globalEffectiveRuleMap: GlobalEffectiveRuleMap;
+    menuScopeMap: Map<number, MenuScope>;
+    /** 当前策略中 schedule_match 绑定的日程提取出的时间点，格式如 ["10:00", "13:00"] */
+    scheduleTimePoints: string[];
+    rawResults: EvaluationResult[];
+}
+export type ConditionScope = 'global' | 'product';

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

@@ -0,0 +1,54 @@
+/**
+ * Data Variant 动作类型。
+ *
+ * 当前阶段动作只用于标识“该策略可应用 data variant 覆盖”，真实覆盖数据来自商品 data_variants。
+ */
+export var DATA_VARIANT_ACTION_TYPES = {
+  APPLY: 'DATA_VARIANT_APPLY'
+};
+
+/**
+ * Data Variant 规则元数据。
+ *
+ * priority 数字越大优先级越高，合并时后覆盖低优先级字段。
+ */
+
+/**
+ * 商品上的单条 Data Variant 记录，结构与后端 data_variant 表对齐。
+ */
+
+/**
+ * Data Variant 评估使用的轻量商品结构。
+ */
+
+/**
+ * 餐牌商品配置项。
+ */
+
+/**
+ * 餐牌数据的最小结构。
+ */
+
+/**
+ * 单个餐牌预构建后的商品范围索引。
+ */
+
+/**
+ * 批量评估输入。
+ */
+
+/**
+ * 全局预计算后的规则信息。
+ */
+
+/**
+ * 单条商品命中的变体覆盖信息。
+ */
+
+/**
+ * 商品上记录的 Data Variant 调试信息。
+ */
+
+/**
+ * 批量解析结果。
+ */

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

@@ -5,3 +5,7 @@ export { PromotionEvaluator } from './promotion/evaluator';
 export { PromotionAdapter } from './promotion/adapter';
 export { ItemRuleEvaluator } from './itemRule/evaluator';
 export { ItemRuleAdapter } from './itemRule/adapter';
+export { DataVariantEvaluator } from './dataVariant/evaluator';
+export { DataVariantAdapter } from './dataVariant/adapter';
+export { runDataVariantDemo } from './dataVariant/examples';
+export * from './dataVariant/type';

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

@@ -4,4 +4,8 @@ export { WalletPassEvaluator } from "./walletPass/evaluator";
 export { PromotionEvaluator } from "./promotion/evaluator";
 export { PromotionAdapter } from "./promotion/adapter";
 export { ItemRuleEvaluator } from "./itemRule/evaluator";
-export { ItemRuleAdapter } from "./itemRule/adapter";
+export { ItemRuleAdapter } from "./itemRule/adapter";
+export { DataVariantEvaluator } from "./dataVariant/evaluator";
+export { DataVariantAdapter } from "./dataVariant/adapter";
+export { runDataVariantDemo } from "./dataVariant/examples";
+export * from "./dataVariant/type";

package/dist/model/strategy/adapter/promotion/adapter.d.ts

@@ -48,10 +48,6 @@ export declare class PromotionAdapter implements BusinessAdapter {
      * 解析 买X送Y Action
      */
     private parseBuyXGetYFreeAction;
-    /**
-     * 解析 商品奖励 Action
-     */
-    private parseItemRewardAction;
     /**
      * 获取适用的商品列表
      *

package/dist/model/strategy/adapter/promotion/adapter.js

@@ -162,8 +162,6 @@ export var PromotionAdapter = /*#__PURE__*/function () {
           return this.parseXItemsForYPriceAction(action);
         case PROMOTION_ACTION_TYPES.BUY_X_GET_Y_FREE:
           return this.parseBuyXGetYFreeAction(action);
-        case PROMOTION_ACTION_TYPES.ITEM_REWARD:
-          return this.parseItemRewardAction(action);
         default:
           return undefined;
       }
@@ -206,27 +204,6 @@ export var PromotionAdapter = /*#__PURE__*/function () {
       };
     }
 
-    /**
-     * 解析 商品奖励 Action
-     */
-  }, {
-    key: "parseItemRewardAction",
-    value: function parseItemRewardAction(action) {
-      var value = action.value || {};
-      var config = action.config || {};
-      return {
-        type: PROMOTION_ACTION_TYPES.ITEM_REWARD,
-        rewardMethod: value.rewardMethod || 'free',
-        rewardValue: Number(value.rewardValue || 0),
-        quantityRule: value.quantityRule || 'per_condition_quantity',
-        triggerQuantity: Number(value.triggerQuantity || 1),
-        rewardQuantity: Number(value.rewardQuantity || 1),
-        maxRewardQuantity: value.maxRewardQuantity === undefined || value.maxRewardQuantity === null ? undefined : Number(value.maxRewardQuantity),
-        rewardTargets: Array.isArray(config.rewardTargets) ? config.rewardTargets : [],
-        targetSelection: config.targetSelection || 'consumer_best'
-      };
-    }
-
     /**
      * 获取适用的商品列表
      *

package/dist/model/strategy/adapter/promotion/evaluator.d.ts

@@ -169,21 +169,6 @@ export declare class PromotionEvaluator {
      * 支持 bundle 子商品的数量计算（主商品数量 × 子商品数量）
      */
     private processBuyXGetYFree;
-    /**
-     * 处理 商品奖励 促销
-     *
-     * 1. 使用 group.products 统计触发条件商品数量
-     * 2. 按 quantityRule 计算最多奖励的目标商品数量
-     * 3. 在全购物车商品中筛选 rewardTargets
-     * 4. 按消费者最优（可节省金额从高到低）选择目标单位
-     * 5. 对目标商品拆分并写入 finalPrice，触发商品本身不改价
-     */
-    private processItemReward;
-    private normalizePositiveInteger;
-    private getAvailablePromotionQuantity;
-    private buildItemRewardTargetUnits;
-    private resolveItemRewardFinalPrice;
-    private resolveItemRewardLimit;
     /**
      * 获取未参与任何促销的商品
      */
@@ -209,8 +194,6 @@ export declare class PromotionEvaluator {
      * 检查商品是否在策略的适用范围内
      */
     private isProductInStrategy;
-    private shouldSkipStrategyForProduct;
-    private hasActionType;
     /**
      * 查找商品匹配规则
      */