@pisell/pisellos 2.2.258 → 2.2.260

package/dist/server/modules/products/index.d.ts

@@ -18,7 +18,8 @@ export declare class ProductsModule extends BaseModule implements Module {
     private productsPriceCache;
     private readonly CACHE_MAX_DAYS;
     private formatters;
-    private isPriceFormatterRegistered;
+    private isBuiltinFormatterRegistered;
+    private isLegacyPriceFormatterEnabled;
     private quotationPriceBridge?;
     private quotationBridgeChannel?;
     private quotationBridgeLoadedKey?;
@@ -36,6 +37,8 @@ export declare class ProductsModule extends BaseModule implements Module {
     private lastPreloadCompletedAtMs;
     /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
     private productIndexDBSaveQueue;
+    /** 最近一次智能定价评估提取的 schedule 变价时间点（HH:mm），供 Server 订阅定时刷新使用 */
+    private lastScheduleTimePoints;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: any): Promise<void>;
     /**
@@ -108,6 +111,10 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private prepareProductsWithPrice;
     private getProductsPriceCacheKey;
+    /**
+     * 稳定序列化策略上下文，避免对象 key 顺序不同导致缓存 key 抖动。
+     */
+    private stringifyStable;
     private normalizeProductIds;
     /**
      * 按轻量范围返回商品 ID，不做 structuredClone。
@@ -122,14 +129,26 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private applyFormatters;
     /**
-     * 注册内置的价格格式化器
-     * 这个格式化器负责将价格数据应用到商品上
+     * 注册内置商品格式化器。
+     *
+     * 智能定价默认替代报价单逻辑；报价单 formatter 仅在 enableLegacyPriceFormatter=true 时启用。
      * @private
      */
-    private registerBuiltinPriceFormatter;
+    private registerBuiltinProductFormatters;
+    /**
+     * 是否启用旧报价单价格 formatter。
+     *
+     * 默认关闭，避免报价单逻辑覆盖智能定价结果。
+     */
+    private shouldEnableLegacyPriceFormatter;
+    /**
+     * 返回最近一次 prepareProductsWithPrice / DataVariant 评估提取的变价时间点（HH:mm）。
+     * 供 OS Server 商品 query 订阅定时刷新使用。
+     */
+    getLastScheduleTimePoints(): string[];
     /**
      * 注册商品格式化器
-     * 格式化器会按注册顺序依次执行（内置价格格式化器始终是第一个）
+     * 格式化器会按注册顺序依次执行；legacy 启用时先兜底报价，再由智能定价覆盖。
      * @param formatter 格式化函数
      * @param prepend 是否插入到队列开头（默认 false，追加到末尾）
      * @example
@@ -144,8 +163,8 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     registerFormatter(formatter: ProductFormatter, prepend?: boolean): void;
     /**
-     * 清空所有格式化器（包括内置价格格式化器）
-     * @param keepBuiltin 是否保留内置价格格式化器（默认 true）
+     * 清空所有格式化器（包括内置智能定价格式化器）
+     * @param keepBuiltin 是否保留内置智能定价格式化器（默认 true）
      */
     clearFormatters(keepBuiltin?: boolean): void;
     /**

package/dist/server/modules/products/index.js

@@ -1,12 +1,12 @@
-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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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 ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
@@ -32,7 +32,6 @@ import { BaseModule } from "../../../modules/BaseModule";
 import { QuotationModule as ClientQuotationModule } from "../../../modules/Quotation";
 import { ProductsHooks } from "./types";
 import { applyDetailValueToProducts, applyPriceDataToProducts, applyI18nToProducts, perfMark } from "../../utils/product";
-
 /**
  * IndexDB 存储名称
  */
@@ -69,8 +68,10 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     // 最多缓存7天
     // 商品格式化器列表
     _defineProperty(_assertThisInitialized(_this), "formatters", []);
-    // 是否已注册内置价格格式化器
-    _defineProperty(_assertThisInitialized(_this), "isPriceFormatterRegistered", false);
+    // 是否已注册内置商品格式化器
+    _defineProperty(_assertThisInitialized(_this), "isBuiltinFormatterRegistered", false);
+    // 旧报价单格式化器默认关闭，仅显式开启时作为兼容兜底注册
+    _defineProperty(_assertThisInitialized(_this), "isLegacyPriceFormatterEnabled", false);
     // 普通层 QuotationModule 桥接器：本地计算报价单价格，替代 /product/query/price
     _defineProperty(_assertThisInitialized(_this), "quotationPriceBridge", void 0);
     _defineProperty(_assertThisInitialized(_this), "quotationBridgeChannel", void 0);
@@ -90,6 +91,8 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "lastPreloadCompletedAtMs", 0);
     /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
     _defineProperty(_assertThisInitialized(_this), "productIndexDBSaveQueue", Promise.resolve());
+    /** 最近一次智能定价评估提取的 schedule 变价时间点（HH:mm），供 Server 订阅定时刷新使用 */
+    _defineProperty(_assertThisInitialized(_this), "lastScheduleTimePoints", []);
     return _this;
   }
   _createClass(ProductsModule, [{
@@ -128,8 +131,8 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 }
               }
 
-              // 注册内置的价格格式化器（作为第一个格式化器）
-              this.registerBuiltinPriceFormatter();
+              // 注册内置商品格式化器；智能定价默认替代报价单价格逻辑
+              this.registerBuiltinProductFormatters();
 
               // 初始化 ProductDataSource 实例
               this.initProductDataSource();
@@ -743,7 +746,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     key: "prepareProductsWithPrice",
     value: (function () {
       var _prepareProductsWithPrice = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7(schedule_date, extraContext, options) {
-        var tTotal, targetIds, isIncremental, _priceData$length, _this$core, products, ids, tIds, i, tPrice, priceData, context, tFormat, processedProducts, errorMessage;
+        var tTotal, targetIds, isIncremental, _this$core, _this$core2, products, ids, tIds, i, priceData, _priceData$length, _priceData, tPrice, context, tFormat, processedProducts, errorMessage;
         return _regeneratorRuntime().wrap(function _callee7$(_context7) {
           while (1) switch (_context7.prev = _context7.next) {
             case 0:
@@ -778,34 +781,44 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 productCount: products.length
               });
 
-              // 2. 获取价格数据（网络请求）
+              // 2. 仅在 legacy 报价单 formatter 启用时加载报价单价格；默认由智能定价覆盖商品价格。
+              priceData = [];
+              if (!this.isLegacyPriceFormatterEnabled) {
+                _context7.next = 15;
+                break;
+              }
               tPrice = performance.now();
-              _context7.next = 10;
+              _context7.next = 12;
               return this.loadProductsPrice({
                 ids: ids,
                 schedule_date: schedule_date,
                 schedule_datetime: extraContext === null || extraContext === void 0 ? void 0 : extraContext.schedule_datetime,
                 customer_id: extraContext === null || extraContext === void 0 ? void 0 : extraContext.customer_id
               });
-            case 10:
+            case 12:
               priceData = _context7.sent;
               perfMark('prepareProducts.loadPrice', performance.now() - tPrice, {
                 count: ids.length
               });
               this.logInfo('获取商品报价单价格成功', {
-                priceDataCount: (_priceData$length = priceData === null || priceData === void 0 ? void 0 : priceData.length) !== null && _priceData$length !== void 0 ? _priceData$length : 0
+                priceDataCount: (_priceData$length = (_priceData = priceData) === null || _priceData === void 0 ? void 0 : _priceData.length) !== null && _priceData$length !== void 0 ? _priceData$length : 0
               });
+            case 15:
               context = _objectSpread({
                 schedule_date: schedule_date,
                 schedule_datetime: extraContext === null || extraContext === void 0 ? void 0 : extraContext.schedule_datetime,
                 customer_id: extraContext === null || extraContext === void 0 ? void 0 : extraContext.customer_id,
                 priceData: priceData,
-                locale: (_this$core = this.core) === null || _this$core === void 0 || (_this$core = _this$core.context) === null || _this$core === void 0 ? void 0 : _this$core.locale
+                locale: (_this$core = this.core) === null || _this$core === void 0 || (_this$core = _this$core.context) === null || _this$core === void 0 ? void 0 : _this$core.locale,
+                dataVariantEvaluator: (extraContext === null || extraContext === void 0 ? void 0 : extraContext.dataVariantEvaluator) || ((_this$core2 = this.core) === null || _this$core2 === void 0 || (_this$core2 = _this$core2.context) === null || _this$core2 === void 0 ? void 0 : _this$core2.dataVariantEvaluator),
+                menuList: (extraContext === null || extraContext === void 0 ? void 0 : extraContext.menuList) || [],
+                scheduleList: (extraContext === null || extraContext === void 0 ? void 0 : extraContext.scheduleList) || [],
+                strategy_context: extraContext === null || extraContext === void 0 ? void 0 : extraContext.strategy_context
               }, extraContext); // 3. 通过格式化器流程处理商品
               tFormat = performance.now();
-              _context7.next = 17;
+              _context7.next = 19;
               return this.applyFormatters(products, context);
-            case 17:
+            case 19:
               processedProducts = _context7.sent;
               perfMark('prepareProducts.applyFormatters', performance.now() - tFormat, {
                 count: products.length,
@@ -818,20 +831,20 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 formatterCount: this.formatters.length
               });
               if (isIncremental) {
-                _context7.next = 23;
+                _context7.next = 25;
                 break;
               }
-              _context7.next = 23;
+              _context7.next = 25;
               return this.core.effects.emit(ProductsHooks.onProductsPriceApplied, processedProducts);
-            case 23:
+            case 25:
               perfMark('prepareProductsWithPrice', performance.now() - tTotal, {
                 productCount: products.length,
                 formatterCount: this.formatters.length,
                 mode: isIncremental ? 'incremental' : 'full'
               });
               return _context7.abrupt("return", processedProducts);
-            case 27:
-              _context7.prev = 27;
+            case 29:
+              _context7.prev = 29;
               _context7.t0 = _context7["catch"](4);
               errorMessage = _context7.t0 instanceof Error ? _context7.t0.message : String(_context7.t0);
               console.log("[ProductsModule] \uD83C\uDF10 ERROR", _context7.t0);
@@ -839,13 +852,13 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 schedule_date: schedule_date,
                 error: errorMessage
               });
-            case 32:
+            case 34:
               return _context7.abrupt("return", []);
-            case 33:
+            case 35:
             case "end":
               return _context7.stop();
           }
-        }, _callee7, this, [[4, 27]]);
+        }, _callee7, this, [[4, 29]]);
       }));
       function prepareProductsWithPrice(_x10, _x11, _x12) {
         return _prepareProductsWithPrice.apply(this, arguments);
@@ -858,7 +871,27 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
       var _extraContext$custome;
       var datetime = (extraContext === null || extraContext === void 0 ? void 0 : extraContext.schedule_datetime) || schedule_date;
       var productScope = productIds ? ":products:".concat(productIds.join(',')) : '';
-      return "".concat(datetime, ":customer:").concat((_extraContext$custome = extraContext === null || extraContext === void 0 ? void 0 : extraContext.customer_id) !== null && _extraContext$custome !== void 0 ? _extraContext$custome : '').concat(productScope);
+      var strategyScope = this.stringifyStable((extraContext === null || extraContext === void 0 ? void 0 : extraContext.strategy_context) || {});
+      return "".concat(datetime, ":customer:").concat((_extraContext$custome = extraContext === null || extraContext === void 0 ? void 0 : extraContext.customer_id) !== null && _extraContext$custome !== void 0 ? _extraContext$custome : '', ":strategy:").concat(strategyScope).concat(productScope);
+    }
+
+    /**
+     * 稳定序列化策略上下文，避免对象 key 顺序不同导致缓存 key 抖动。
+     */
+  }, {
+    key: "stringifyStable",
+    value: function stringifyStable(value) {
+      var _this7 = this;
+      if (value == null) return '';
+      if (Array.isArray(value)) return "[".concat(value.map(function (item) {
+        return _this7.stringifyStable(item);
+      }).join(','), "]");
+      if (_typeof(value) === 'object') {
+        return "{".concat(Object.keys(value).sort().map(function (key) {
+          return "".concat(key, ":").concat(_this7.stringifyStable(value[key]));
+        }).join(','), "}");
+      }
+      return String(value);
     }
   }, {
     key: "normalizeProductIds",
@@ -1004,26 +1037,55 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
       return applyFormatters;
     }()
     /**
-     * 注册内置的价格格式化器
-     * 这个格式化器负责将价格数据应用到商品上
+     * 注册内置商品格式化器。
+     *
+     * 智能定价默认替代报价单逻辑；报价单 formatter 仅在 enableLegacyPriceFormatter=true 时启用。
      * @private
      */
     )
   }, {
-    key: "registerBuiltinPriceFormatter",
-    value: function registerBuiltinPriceFormatter() {
-      if (this.isPriceFormatterRegistered) {
-        console.warn('[ProductsModule] 内置价格格式化器已注册，跳过');
+    key: "registerBuiltinProductFormatters",
+    value: function registerBuiltinProductFormatters() {
+      var _this8 = this;
+      if (this.isBuiltinFormatterRegistered) {
+        console.warn('[ProductsModule] 内置商品格式化器已注册，跳过');
         return;
       }
+      this.isLegacyPriceFormatterEnabled = this.shouldEnableLegacyPriceFormatter();
+      var dataVariantFormatter = function dataVariantFormatter(products, context) {
+        var _this8$core, _strategyContext$busi;
+        var evaluator = context.dataVariantEvaluator || ((_this8$core = _this8.core) === null || _this8$core === void 0 || (_this8$core = _this8$core.context) === null || _this8$core === void 0 ? void 0 : _this8$core.dataVariantEvaluator);
+        if (!evaluator || typeof evaluator.resolveProducts !== 'function') {
+          _this8.lastScheduleTimePoints = [];
+          _this8.logWarning('智能定价评估器未注入，跳过 DataVariant 格式化', {
+            productCount: products.length
+          });
+          return products;
+        }
+        var strategyContext = context.strategy_context || {};
+        var businessData = {
+          products: products,
+          scheduleDateTime: context.schedule_datetime || context.schedule_date,
+          scheduleList: context.scheduleList || [],
+          menuList: context.menuList || [],
+          customerId: context.customer_id,
+          channel: strategyContext.channel,
+          orderType: strategyContext.orderType || strategyContext.order_type,
+          businessCode: (_strategyContext$busi = strategyContext.business_code) !== null && _strategyContext$busi !== void 0 ? _strategyContext$busi : strategyContext.businessCode,
+          custom: strategyContext
+        };
+        var result = evaluator.resolveProducts(businessData);
+        _this8.lastScheduleTimePoints = Array.isArray(result === null || result === void 0 ? void 0 : result.scheduleTimePoints) ? _toConsumableArray(result.scheduleTimePoints) : [];
+        return Array.isArray(result === null || result === void 0 ? void 0 : result.products) ? result.products : products;
+      };
 
-      // 创建价格格式化器
-      var priceFormatter = function priceFormatter(products, context) {
+      // 创建 legacy 报价单格式化器
+      var legacyPriceFormatter = function legacyPriceFormatter(products, context) {
         if (!context.priceData || context.priceData.length === 0) {
-          console.log('[ProductsModule] 💰 没有价格数据，跳过价格应用');
+          console.log('[ProductsModule] 💰 没有价格数据，跳过 legacy 报价单价格应用');
           return products;
         }
-        console.log("[ProductsModule] \uD83D\uDCB0 \u5E94\u7528\u4EF7\u683C\u6570\u636E\u5230 ".concat(products.length, " \u4E2A\u5546\u54C1"));
+        console.log("[ProductsModule] \uD83D\uDCB0 \u5E94\u7528 legacy \u62A5\u4EF7\u5355\u4EF7\u683C\u5230 ".concat(products.length, " \u4E2A\u5546\u54C1"));
         return applyPriceDataToProducts(products, context.priceData);
       };
       var i18nFormatter = function i18nFormatter(products, context) {
@@ -1032,18 +1094,41 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
       var detailValueFormatter = function detailValueFormatter(products, context) {
         return applyDetailValueToProducts(products, context);
       };
-
-      // 将价格格式化器注册为第一个格式化器
-      this.formatters.unshift(priceFormatter);
+      if (this.isLegacyPriceFormatterEnabled) {
+        this.formatters.push(legacyPriceFormatter);
+      }
+      this.formatters.push(dataVariantFormatter);
       this.formatters.push(i18nFormatter);
       this.formatters.push(detailValueFormatter);
-      this.isPriceFormatterRegistered = true;
-      console.log('[ProductsModule] ✅ 内置价格格式化器已注册（第 1 个）');
+      this.isBuiltinFormatterRegistered = true;
+      console.log('[ProductsModule] ✅ 内置商品格式化器已注册（智能定价优先）');
+    }
+
+    /**
+     * 是否启用旧报价单价格 formatter。
+     *
+     * 默认关闭，避免报价单逻辑覆盖智能定价结果。
+     */
+  }, {
+    key: "shouldEnableLegacyPriceFormatter",
+    value: function shouldEnableLegacyPriceFormatter() {
+      var _this$otherParams3, _this$core3;
+      return ((_this$otherParams3 = this.otherParams) === null || _this$otherParams3 === void 0 ? void 0 : _this$otherParams3.enableLegacyPriceFormatter) === true || ((_this$core3 = this.core) === null || _this$core3 === void 0 || (_this$core3 = _this$core3.context) === null || _this$core3 === void 0 ? void 0 : _this$core3.enableLegacyPriceFormatter) === true;
+    }
+
+    /**
+     * 返回最近一次 prepareProductsWithPrice / DataVariant 评估提取的变价时间点（HH:mm）。
+     * 供 OS Server 商品 query 订阅定时刷新使用。
+     */
+  }, {
+    key: "getLastScheduleTimePoints",
+    value: function getLastScheduleTimePoints() {
+      return _toConsumableArray(this.lastScheduleTimePoints);
     }
 
     /**
      * 注册商品格式化器
-     * 格式化器会按注册顺序依次执行（内置价格格式化器始终是第一个）
+     * 格式化器会按注册顺序依次执行；legacy 启用时先兜底报价，再由智能定价覆盖。
      * @param formatter 格式化函数
      * @param prepend 是否插入到队列开头（默认 false，追加到末尾）
      * @example
@@ -1061,8 +1146,8 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     value: function registerFormatter(formatter) {
       var prepend = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
       if (prepend) {
-        // 插入到价格格式化器之后（索引 1 的位置）
-        var insertIndex = this.isPriceFormatterRegistered ? 1 : 0;
+        // 插入到内置智能定价格式化器之后；legacy 报价单启用时需跳过它。
+        var insertIndex = this.isBuiltinFormatterRegistered ? this.isLegacyPriceFormatterEnabled ? 2 : 1 : 0;
         this.formatters.splice(insertIndex, 0, formatter);
         console.log("[ProductsModule] \uD83D\uDCCC \u5DF2\u5728\u4F4D\u7F6E ".concat(insertIndex + 1, " \u63D2\u5165\u683C\u5F0F\u5316\u5668\uFF0C\u5F53\u524D\u5171 ").concat(this.formatters.length, " \u4E2A"));
       } else {
@@ -1073,20 +1158,21 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     }
 
     /**
-     * 清空所有格式化器（包括内置价格格式化器）
-     * @param keepBuiltin 是否保留内置价格格式化器（默认 true）
+     * 清空所有格式化器（包括内置智能定价格式化器）
+     * @param keepBuiltin 是否保留内置智能定价格式化器（默认 true）
      */
   }, {
     key: "clearFormatters",
     value: function clearFormatters() {
       var keepBuiltin = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
-      if (keepBuiltin && this.isPriceFormatterRegistered) {
-        // 只保留第一个格式化器（内置价格格式化器）
-        this.formatters = [this.formatters[0]];
-        console.log('[ProductsModule] 🧹 已清空自定义格式化器，保留内置价格格式化器');
+      if (keepBuiltin && this.isBuiltinFormatterRegistered) {
+        // 保留 legacy 兜底（如果启用）和智能定价格式化器。
+        var builtinCount = this.isLegacyPriceFormatterEnabled ? 2 : 1;
+        this.formatters = this.formatters.slice(0, builtinCount);
+        console.log('[ProductsModule] 🧹 已清空自定义格式化器，保留内置智能定价格式化器');
       } else {
         this.formatters = [];
-        this.isPriceFormatterRegistered = false;
+        this.isBuiltinFormatterRegistered = false;
         console.log('[ProductsModule] 🧹 已清空所有格式化器');
       }
     }
@@ -1197,7 +1283,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     key: "fetchProductsByHttp",
     value: (function () {
       var _fetchProductsByHttp = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(params) {
-        var _ref13, _ref13$category_ids, category_ids, _ref13$product_ids, product_ids, _ref13$collection, collection, customer_id, cacheId, startTime, _this$otherParams3, _productsData$data, productsData, productList, duration, _duration2, errorMessage;
+        var _ref13, _ref13$category_ids, category_ids, _ref13$product_ids, product_ids, _ref13$collection, collection, customer_id, cacheId, startTime, _this$otherParams4, _productsData$data, productsData, productList, duration, _duration2, errorMessage;
         return _regeneratorRuntime().wrap(function _callee10$(_context10) {
           while (1) switch (_context10.prev = _context10.next) {
             case 0:
@@ -1215,7 +1301,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 open_bundle: 1,
                 exclude_extension_type: ['product_party', 'product_event', 'product_series_event', 'product_package_ticket', 'ticket', 'event_item'],
                 force_ignore_cache_flag: 1,
-                with: ['category', 'collection', 'resourceRelation', 'bundleGroup.bundleItem', 'optionGroup.optionItem', 'variantGroup.variantItem'],
+                with: ['category', 'collection', 'resourceRelation', 'bundleGroup.bundleItem', 'optionGroup.optionItem', 'variantGroup.variantItem', 'dataVariants'],
                 open_deposit: 1,
                 is_append_product_description: 1,
                 with_count: ['bundleGroup', 'optionGroup'],
@@ -1227,7 +1313,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 ids: product_ids,
                 collection: collection,
                 front_end_cache_id: cacheId,
-                application_code: (_this$otherParams3 = this.otherParams) === null || _this$otherParams3 === void 0 ? void 0 : _this$otherParams3.channel
+                application_code: (_this$otherParams4 = this.otherParams) === null || _this$otherParams4 === void 0 ? void 0 : _this$otherParams4.channel
               }, {
                 cache: undefined
               });
@@ -1691,7 +1777,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     key: "replaceProductsSnapshotInIndexDB",
     value: (function () {
       var _replaceProductsSnapshotInIndexDB = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee20(products, source) {
-        var _this7 = this;
+        var _this9 = this;
         var errorMessage;
         return _regeneratorRuntime().wrap(function _callee20$(_context20) {
           while (1) switch (_context20.prev = _context20.next) {
@@ -1710,25 +1796,25 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 return _regeneratorRuntime().wrap(function _callee19$(_context19) {
                   while (1) switch (_context19.prev = _context19.next) {
                     case 0:
-                      _this7.logInfo('replaceProductsSnapshotInIndexDB 开始', {
+                      _this9.logInfo('replaceProductsSnapshotInIndexDB 开始', {
                         source: source,
                         productCount: products.length
                       });
                       t0 = performance.now();
                       _context19.next = 4;
-                      return _this7.dbManager.clear(INDEXDB_STORE_NAME);
+                      return _this9.dbManager.clear(INDEXDB_STORE_NAME);
                     case 4:
                       if (!(products.length > 0)) {
                         _context19.next = 7;
                         break;
                       }
                       _context19.next = 7;
-                      return _this7.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+                      return _this9.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
                     case 7:
                       perfMark('replaceProductsSnapshotInIndexDB', performance.now() - t0, {
                         count: products.length
                       });
-                      _this7.logInfo('replaceProductsSnapshotInIndexDB 完成', {
+                      _this9.logInfo('replaceProductsSnapshotInIndexDB 完成', {
                         source: source,
                         productCount: products.length
                       });
@@ -1772,7 +1858,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     key: "patchProductsInIndexDB",
     value: (function () {
       var _patchProductsInIndexDB = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee22(products, source) {
-        var _this8 = this;
+        var _this10 = this;
         var mergeActions,
           validProducts,
           errorMessage,
@@ -1803,22 +1889,22 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 return _regeneratorRuntime().wrap(function _callee21$(_context21) {
                   while (1) switch (_context21.prev = _context21.next) {
                     case 0:
-                      _this8.logInfo('patchProductsInIndexDB 开始', {
+                      _this10.logInfo('patchProductsInIndexDB 开始', {
                         source: source,
                         count: validProducts.length
                       });
                       t0 = performance.now();
-                      if (!(typeof _this8.dbManager.bulkUpdate === 'function')) {
+                      if (!(typeof _this10.dbManager.bulkUpdate === 'function')) {
                         _context21.next = 7;
                         break;
                       }
                       _context21.next = 5;
-                      return _this8.dbManager.bulkUpdate(INDEXDB_STORE_NAME, validProducts);
+                      return _this10.dbManager.bulkUpdate(INDEXDB_STORE_NAME, validProducts);
                     case 5:
                       _context21.next = 25;
                       break;
                     case 7:
-                      if (!(typeof _this8.dbManager.update === 'function')) {
+                      if (!(typeof _this10.dbManager.update === 'function')) {
                         _context21.next = 25;
                         break;
                       }
@@ -1832,7 +1918,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                       }
                       product = _step10.value;
                       _context21.next = 15;
-                      return _this8.dbManager.update(INDEXDB_STORE_NAME, product);
+                      return _this10.dbManager.update(INDEXDB_STORE_NAME, product);
                     case 15:
                       _context21.next = 11;
                       break;
@@ -1851,7 +1937,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                       perfMark('patchProductsInIndexDB', performance.now() - t0, {
                         count: validProducts.length
                       });
-                      _this8.logInfo('patchProductsInIndexDB 完成', {
+                      _this10.logInfo('patchProductsInIndexDB 完成', {
                         source: source,
                         count: validProducts.length
                       });
@@ -2049,7 +2135,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "setupProductSync",
     value: function setupProductSync() {
-      var _this9 = this;
+      var _this11 = this;
       if (!this.productDataSource) {
         this.logWarning('setupProductSync: ProductDataSource 不可用，跳过同步初始化');
         return;
@@ -2059,20 +2145,20 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
           var data = (message === null || message === void 0 ? void 0 : message.data) || message;
           if (!data) return;
           console.log("[ProductsModule] \u6536\u5230\u540C\u6B65\u6D88\u606F [".concat(channelKey, "]:"), data);
-          _this9.logInfo('收到同步消息', {
+          _this11.logInfo('收到同步消息', {
             channelKey: channelKey,
             action: data.action,
             id: data.id,
             action_filed: data.action_filed
           });
-          _this9.pendingSyncMessages.push(_objectSpread(_objectSpread({}, data), {}, {
+          _this11.pendingSyncMessages.push(_objectSpread(_objectSpread({}, data), {}, {
             _channelKey: channelKey
           }));
-          if (_this9.syncTimer) {
-            clearTimeout(_this9.syncTimer);
+          if (_this11.syncTimer) {
+            clearTimeout(_this11.syncTimer);
           }
-          _this9.syncTimer = setTimeout(function () {
-            _this9.processProductSyncMessages();
+          _this11.syncTimer = setTimeout(function () {
+            _this11.processProductSyncMessages();
           }, PRODUCT_SYNC_DEBOUNCE_MS);
         };
       };
@@ -2090,7 +2176,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
           }
         }
       }).catch(function (err) {
-        _this9.logError('setupProductSync: DataSource run 出错', {
+        _this11.logError('setupProductSync: DataSource run 出错', {
           error: err instanceof Error ? err.message : String(err)
         });
       });
@@ -2119,7 +2205,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     key: "processProductSyncMessages",
     value: (function () {
       var _processProductSyncMessages = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee24() {
-        var messages, deleteIds, bodyUpdates, sseRefreshIds, priceRefreshIds, shouldClearPriceCache, _iterator12, _step12, msg, channelKey, _msg$relation_product, _msg$change_types, _msg$ids2, _msg$ids, ids, bodyId, _bodyId, _msg$relation_product2, _msg$relation_product3, uniqueDeleteIds, uniqueSSEIds, uniquePriceIds, patchProductMap, patchMergeActions, storeMutated, bodyResult, _iterator13, _step13, product, freshProducts, mergeResult, _iterator14, _step14, _product, patchProducts, allChangedIds, hasChanges, errorMessage;
+        var messages, deleteIds, bodyUpdates, sseRefreshIds, priceRefreshIds, shouldClearPriceCache, _iterator12, _step12, msg, channelKey, _msg$relation_product, _msg$change_types, _msg$ids2, _msg$ids, ids, bodyId, _bodyId, _msg$relation_product2, _msg$relation_product3, _msg$product_ids, uniqueDeleteIds, uniqueSSEIds, uniquePriceIds, patchProductMap, patchMergeActions, storeMutated, bodyResult, _iterator13, _step13, product, freshProducts, mergeResult, _iterator14, _step14, _product, patchProducts, allChangedIds, hasChanges, errorMessage;
         return _regeneratorRuntime().wrap(function _callee24$(_context24) {
           while (1) switch (_context24.prev = _context24.next) {
             case 0:
@@ -2203,6 +2289,10 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 if ((_msg$relation_product3 = msg.relation_product_ids) !== null && _msg$relation_product3 !== void 0 && _msg$relation_product3.length) {
                   sseRefreshIds.push.apply(sseRefreshIds, _toConsumableArray(msg.relation_product_ids));
                 }
+              } else if (['product_data_variant'].includes(channelKey)) {
+                if ((_msg$product_ids = msg.product_ids) !== null && _msg$product_ids !== void 0 && _msg$product_ids.length) {
+                  sseRefreshIds.push.apply(sseRefreshIds, _toConsumableArray(msg.product_ids));
+                }
               }
             case 34:
               _context24.next = 13;

package/dist/server/modules/products/types.d.ts

@@ -110,6 +110,8 @@ export interface ProductSyncMessage {
     change_types?: string[];
     /** 关联商品 ID（product_collection / product_category / product_quotation 变更时携带） */
     relation_product_ids?: number[];
+    /** 关联商品 ID（product_data_variant 变更时携带） */
+    product_ids?: number[];
     message_uuid?: string;
     timestamp?: string;
     /** 内部标记：来源频道 key */
@@ -124,6 +126,18 @@ export interface ProductFormatterContext {
     customer_id?: number | string;
     priceData?: LoadProductsPriceData[];
     scheduleModule?: any;
+    /** 全量餐牌列表，供智能定价 menu_match 等条件判断使用 */
+    menuList?: any[];
+    /** 全量日程列表，供智能定价 schedule_match 等条件判断使用 */
+    scheduleList?: any[];
+    /** 外部传入的策略上下文，仅承载定价条件，不参与商品集合筛选 */
+    strategy_context?: Record<string, any>;
+    /** 智能定价评估器，由宿主统一注入到 PisellOS context */
+    dataVariantEvaluator?: {
+        resolveProducts: (businessData: any) => {
+            products: ProductData[];
+        };
+    };
     locale?: string;
 }
 /**