@pisell/pisellos 0.0.568 → 0.10.1

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

@@ -1,94 +1,100 @@
-"use strict";
+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);
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
+// src/server/modules/products/index.ts
+var products_exports = {};
+__export(products_exports, {
+  ProductsModule: () => ProductsModule
 });
-exports.ProductsModule = void 0;
-var _BaseModule = require("../../../modules/BaseModule");
-var _plugins = require("../../../plugins");
-var _types = require("./types");
-var _product = require("../../utils/product");
-/**
- * IndexDB 存储名称
- */
-const INDEXDB_STORE_NAME = 'products';
-
-/** 商品同步防抖时间（毫秒） */
-const PRODUCT_SYNC_DEBOUNCE_MS = 10_000;
-
-/**
- * Products 模块 - 用于获取和管理完整的商品详细数据
- * 相比 ProductList 模块，Products 会获取所有详细信息并缓存
- */
-class ProductsModule extends _BaseModule.BaseModule {
-  defaultName = 'products';
-  defaultVersion = '1.0.0';
-  store;
-  request;
-  dbManager; // IndexDBManager 实例
-  logger; // LoggerManager 实例
-  otherParams = {};
-
-  // 商品价格缓存：Map<日期, 应用了价格的商品列表>
-  productsPriceCache = new Map();
-
-  // 缓存配置
-  CACHE_MAX_DAYS = 7; // 最多缓存7天
-
-  // 商品格式化器列表
-  formatters = [];
-
-  // 是否已注册内置价格格式化器
-  isPriceFormatterRegistered = false;
-
-  // ---- 商品数据同步相关 ----
-  productDataSource;
-  pendingSyncMessages = [];
-  syncTimer;
+module.exports = __toCommonJS(products_exports);
+var import_BaseModule = require("../../../modules/BaseModule");
+var import_Quotation = require("../../../modules/Quotation");
+var import_types = require("./types");
+var import_product = require("../../utils/product");
+var INDEXDB_STORE_NAME = "products";
+var PRODUCT_SYNC_DEBOUNCE_MS = 1e4;
+var PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS = 3e4;
+var ProductsModule = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
+    this.defaultName = "products";
+    this.defaultVersion = "1.0.0";
+    // LoggerManager 实例
+    this.otherParams = {};
+    // 商品价格缓存：Map<日期, 应用了价格的商品列表>
+    this.productsPriceCache = /* @__PURE__ */ new Map();
+    // 缓存配置
+    this.CACHE_MAX_DAYS = 7;
+    // 最多缓存7天
+    // 商品格式化器列表
+    this.formatters = [];
+    // 是否已注册内置商品格式化器
+    this.isBuiltinFormatterRegistered = false;
+    // 旧报价单格式化器默认关闭，仅显式开启时作为兼容兜底注册
+    this.isLegacyPriceFormatterEnabled = false;
+    this.quotationBridgeLoadedKey = "";
+    this.quotationScheduleCache = /* @__PURE__ */ new Map();
+    this.quotationScheduleCacheSource = null;
+    this.quotationScheduleCacheLoaded = false;
+    this.pendingSyncMessages = [];
+    /** 最近一次 SSE 全量拉取完成时间 */
+    this.lastServerFullFetchAtMs = 0;
+    /** 最近一次 preload 完成时间（含 IndexDB 命中） */
+    this.lastPreloadCompletedAtMs = 0;
+    /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
+    this.productIndexDBSaveQueue = Promise.resolve();
+    /** 最近一次智能定价评估提取的 schedule 变价时间点（HH:mm），供 Server 订阅定时刷新使用 */
+    this.lastScheduleTimePoints = [];
   }
   async initialize(core, options) {
+    var _a;
     this.core = core;
     this.store = options.store;
     this.otherParams = options.otherParams || {};
-    if (Array.isArray(options.initialState?.list)) {
+    if (Array.isArray((_a = options.initialState) == null ? void 0 : _a.list)) {
       this.store.list = options.initialState.list;
-      // 同步更新 Map 缓存
       this.syncProductsMap();
-      this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
+      this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
     } else {
       this.store.list = [];
-      this.store.map = new Map();
+      this.store.map = /* @__PURE__ */ new Map();
     }
-    this.request = core.getPlugin('request');
-
-    // 获取并存储 dbManager 和 logger
-    const appPlugin = core.getPlugin('app');
+    this.request = core.getPlugin("request");
+    const appPlugin = core.getPlugin("app");
     if (appPlugin) {
       const app = appPlugin.getApp();
       this.dbManager = app.dbManager;
       this.logger = app.logger;
-      if (this.dbManager) {} else {
-        console.warn('[Products] IndexDB Manager 未找到');
+      if (this.dbManager) {
+        console.log("[Products] IndexDB Manager 已初始化");
+      } else {
+        console.warn("[Products] IndexDB Manager 未找到");
       }
     }
-
-    // 注册内置的价格格式化器（作为第一个格式化器）
-    this.registerBuiltinPriceFormatter();
-
-    // 初始化 ProductDataSource 实例
+    this.registerBuiltinProductFormatters();
     this.initProductDataSource();
-
-    // 初始化商品数据同步（pubsub 订阅）
     this.setupProductSync();
-    this.logInfo('模块初始化完成', {
+    this.logInfo("模块初始化完成", {
       hasDbManager: !!this.dbManager,
       hasLogger: !!this.logger,
       initialProductCount: this.store.list.length
     });
   }
-
   /**
    * 记录信息日志
    * @param title 日志标题
@@ -98,16 +104,14 @@ class ProductsModule extends _BaseModule.BaseModule {
     try {
       if (this.logger) {
         this.logger.addLog({
-          type: 'info',
+          type: "info",
           title: `[ProductsModule] ${title}`,
           metadata: metadata || {}
         });
       }
     } catch {
-      // 日志记录失败不影响主流程
     }
   }
-
   /**
    * 记录警告日志
    * @param title 日志标题
@@ -117,16 +121,14 @@ class ProductsModule extends _BaseModule.BaseModule {
     try {
       if (this.logger) {
         this.logger.addLog({
-          type: 'warning',
+          type: "warning",
           title: `[ProductsModule] ${title}`,
           metadata: metadata || {}
         });
       }
     } catch {
-      // 日志记录失败不影响主流程
     }
   }
-
   /**
    * 记录错误日志
    * @param title 日志标题
@@ -136,53 +138,48 @@ class ProductsModule extends _BaseModule.BaseModule {
     try {
       if (this.logger) {
         this.logger.addLog({
-          type: 'error',
+          type: "error",
           title: `[ProductsModule] ${title}`,
           metadata: metadata || {}
         });
       }
     } catch {
-      // 日志记录失败不影响主流程
     }
   }
-
   /**
    * 加载商品价格（原始方法，不带缓存）
    * @private
    */
   async loadProductsPrice({
     ids = [],
-    customer_id,
-    schedule_date
+    schedule_date,
+    schedule_datetime,
+    customer_id
   }) {
-    this.logInfo('开始加载商品价格', {
+    this.logInfo("开始加载商品价格", {
       productCount: ids.length,
       schedule_date,
+      schedule_datetime,
       customer_id
     });
     const startTime = Date.now();
+    const datetime = schedule_datetime || schedule_date;
     try {
-      const productsData = await this.request.post(`/product/query/price`, {
-        ids,
-        customer_id,
-        schedule_date
-      }, {
-        cache: {
-          mode: _plugins.RequestModeENUM.REMOTE_LOCAL,
-          type: "memory"
-        }
-      });
+      await this.ensureQuotationBridgeReady(customer_id);
+      const idSet = new Set(ids);
+      const products = this.getProductsRef().filter((product) => idSet.has(product.id));
+      const priceData = products.map((product) => this.buildPriceDataFromQuotation(product, datetime, customer_id));
       const duration = Date.now() - startTime;
-      this.logInfo('加载商品价格成功', {
+      this.logInfo("加载商品价格成功", {
         productCount: ids.length,
-        priceDataCount: productsData.data?.length ?? 0,
+        priceDataCount: priceData.length,
         duration: `${duration}ms`
       });
-      return productsData.data;
+      return priceData;
     } catch (error) {
       const duration = Date.now() - startTime;
       const errorMessage = error instanceof Error ? error.message : String(error);
-      this.logError('加载商品价格失败', {
+      this.logError("加载商品价格失败", {
         productCount: ids.length,
         duration: `${duration}ms`,
         error: errorMessage
@@ -190,7 +187,182 @@ class ProductsModule extends _BaseModule.BaseModule {
       return [];
     }
   }
-
+  /**
+   * 设置报价单价格桥接器。
+   * Server 层负责传入完整 schedule 模块，Products 只负责把报价单计算结果转成价格响应形状。
+   */
+  async setupQuotationPriceBridge(params) {
+    var _a;
+    if (!this.core) {
+      this.logWarning("setupQuotationPriceBridge: core 尚未初始化");
+      return;
+    }
+    const channel = params.channel || ((_a = this.otherParams) == null ? void 0 : _a.channel);
+    this.quotationBridgeChannel = channel;
+    if (!this.quotationPriceBridge) {
+      const quotation = new import_Quotation.QuotationModule(`${this.name}_quotation_price_bridge`);
+      await quotation.initialize(this.core, {});
+      this.quotationPriceBridge = quotation;
+    }
+    if (params.scheduleModule) {
+      if (this.quotationScheduleCacheSource !== params.scheduleModule) {
+        this.quotationScheduleCache.clear();
+        this.quotationScheduleCacheLoaded = false;
+        this.quotationScheduleCacheSource = params.scheduleModule;
+      }
+      this.quotationPriceBridge.setScheduleResolver((id) => {
+        var _a2, _b, _c, _d, _e, _f;
+        const scheduleId = String(id);
+        if (this.quotationScheduleCache.has(scheduleId)) {
+          return this.quotationScheduleCache.get(scheduleId);
+        }
+        if (!this.quotationScheduleCacheLoaded) {
+          const scheduleList = ((_b = (_a2 = params.scheduleModule).getScheduleList) == null ? void 0 : _b.call(_a2)) || [];
+          for (const schedule of scheduleList) {
+            this.quotationScheduleCache.set(String(schedule.id), schedule);
+          }
+          this.quotationScheduleCacheLoaded = true;
+        }
+        if (this.quotationScheduleCache.has(scheduleId)) {
+          return this.quotationScheduleCache.get(scheduleId);
+        }
+        const schedules = ((_d = (_c = params.scheduleModule).getScheduleListByIds) == null ? void 0 : _d.call(_c, [id])) || ((_f = (_e = params.scheduleModule).getScheduleByIds) == null ? void 0 : _f.call(_e, [id])) || [];
+        if (schedules[0])
+          this.quotationScheduleCache.set(scheduleId, schedules[0]);
+        return schedules[0];
+      });
+    }
+    await this.refreshQuotationPriceBridge({ customer_id: params.customer_id });
+  }
+  /**
+   * 刷新桥接器内的报价单列表。
+   */
+  async refreshQuotationPriceBridge(params) {
+    if (!this.quotationPriceBridge)
+      return;
+    const refreshKey = this.getQuotationBridgeScopeKey();
+    if (this.quotationBridgeRefreshPromise && this.quotationBridgeRefreshKey === refreshKey) {
+      await this.quotationBridgeRefreshPromise;
+      return;
+    }
+    if (this.quotationBridgeRefreshPromise) {
+      await this.quotationBridgeRefreshPromise;
+    }
+    this.quotationBridgeRefreshKey = refreshKey;
+    this.quotationBridgeRefreshPromise = this.quotationPriceBridge.loadQuotations({
+      channel: this.quotationBridgeChannel
+    }).then(() => {
+      this.quotationBridgeLoadedKey = refreshKey;
+    }).finally(() => {
+      this.quotationBridgeRefreshPromise = void 0;
+      this.quotationBridgeRefreshKey = void 0;
+    });
+    await this.quotationBridgeRefreshPromise;
+  }
+  async ensureQuotationBridgeReady(customerId) {
+    var _a;
+    if (!this.quotationPriceBridge) {
+      await this.setupQuotationPriceBridge({
+        channel: (_a = this.otherParams) == null ? void 0 : _a.channel,
+        customer_id: customerId
+      });
+      return;
+    }
+    if (this.quotationBridgeRefreshPromise) {
+      await this.quotationBridgeRefreshPromise;
+    }
+    if (this.getQuotationBridgeScopeKey() !== this.quotationBridgeLoadedKey) {
+      await this.refreshQuotationPriceBridge({ customer_id: customerId });
+    }
+  }
+  getQuotationBridgeScopeKey() {
+    return this.quotationBridgeChannel || "";
+  }
+  getQuotedPrice(params) {
+    var _a;
+    const quotation = this.quotationPriceBridge;
+    if (!quotation)
+      return null;
+    const query = {
+      productId: params.productId,
+      variantId: params.variantId,
+      datetime: params.datetime,
+      customer_id: params.customerId
+    };
+    if (typeof quotation.getQuotationMatchForProduct === "function") {
+      return ((_a = quotation.getQuotationMatchForProduct(query)) == null ? void 0 : _a.price) ?? null;
+    }
+    if (typeof quotation.getPriceForProduct === "function") {
+      return quotation.getPriceForProduct(query);
+    }
+    return null;
+  }
+  buildPriceDataFromQuotation(product, datetime, customerId) {
+    const quotedPrice = this.getQuotedPrice({
+      productId: product.id,
+      datetime,
+      customerId
+    });
+    const productPrice = quotedPrice ?? product.price;
+    const productBasePrice = quotedPrice ?? product.base_price ?? product.price ?? 0;
+    return {
+      id: product.id,
+      price: String(productPrice ?? 0),
+      base_price: String(productBasePrice),
+      variant: this.buildVariantPriceData(product, datetime, customerId),
+      bundle_group: this.buildBundleGroupPriceData(product, datetime, customerId)
+    };
+  }
+  buildVariantPriceData(product, datetime, customerId) {
+    if (!Array.isArray(product.variant))
+      return [];
+    return product.variant.map((variant) => {
+      const quotedPrice = this.getQuotedPrice({
+        productId: product.id,
+        variantId: Number(variant.id),
+        datetime,
+        customerId
+      });
+      const price = quotedPrice ?? variant.price ?? product.price ?? 0;
+      const basePrice = quotedPrice ?? variant.base_price ?? variant.price ?? product.base_price ?? product.price ?? 0;
+      return {
+        id: Number(variant.id),
+        product_id: Number(variant.product_id ?? product.id),
+        base_price: Number(basePrice),
+        price: Number(price)
+      };
+    });
+  }
+  buildBundleGroupPriceData(product, datetime, customerId) {
+    if (!Array.isArray(product.bundle_group))
+      return [];
+    return product.bundle_group.map((group) => ({
+      id: Number(group.id),
+      bundle_item: (group.bundle_item || []).map((item) => {
+        const bundleProductId = Number(item.bundle_product_id);
+        const bundleVariantId = Number(item.bundle_variant_id || 0);
+        const quotedPrice = this.getQuotedPrice({
+          productId: bundleProductId,
+          variantId: bundleVariantId,
+          datetime,
+          customerId
+        });
+        const price = quotedPrice ?? item.price ?? 0;
+        const basePrice = quotedPrice ?? item.base_price ?? item.price ?? 0;
+        return {
+          id: Number(item.id),
+          product_id: Number(item.product_id ?? product.id),
+          group_id: Number(item.group_id ?? group.id),
+          bundle_product_id: bundleProductId,
+          bundle_variant_id: bundleVariantId,
+          price: Number(price),
+          base_price: basePrice,
+          price_type: item.price_type,
+          price_type_ext: item.price_type_ext
+        };
+      })
+    }));
+  }
   /**
    * 获取应用了价格的商品列表（带缓存）
    * 使用日期作为缓存 key，同一天的商品价格会被缓存
@@ -199,29 +371,32 @@ class ProductsModule extends _BaseModule.BaseModule {
    * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
    * @param options 可选参数
    * @param options.changedIds 变更的商品 IDs，非空时仅对这些商品增量执行 prepare 并更新缓存
+   * @param options.productIds 指定商品 IDs，仅对这些商品执行价格计算；不传则处理全量
    * @returns 应用了价格的商品列表
    */
   async getProductsWithPrice(schedule_date, extraContext, options) {
+    var _a;
     const t0 = performance.now();
-    const cacheKey = schedule_date;
-    const changedIds = options?.changedIds;
+    const scopedProductIds = this.normalizeProductIds(options == null ? void 0 : options.productIds);
+    const cacheKey = this.getProductsPriceCacheKey(schedule_date, extraContext, scopedProductIds);
+    const scopedProductIdSet = scopedProductIds ? new Set(scopedProductIds) : void 0;
+    const changedIds = scopedProductIdSet ? (_a = options == null ? void 0 : options.changedIds) == null ? void 0 : _a.filter((id) => scopedProductIdSet.has(id)) : options == null ? void 0 : options.changedIds;
     if (this.productsPriceCache.has(cacheKey)) {
       const cachedProducts = this.productsPriceCache.get(cacheKey);
-
-      // 有变更的商品 → 增量 prepare 后 merge 回缓存
       if (changedIds && changedIds.length > 0) {
-        this.logInfo('商品价格缓存命中，增量更新变更商品', {
+        this.logInfo("商品价格缓存命中，增量更新变更商品", {
           cacheKey,
           changedIds,
           cachedProductCount: cachedProducts.length
         });
         try {
-          const updatedProducts = await this.prepareProductsWithPrice(schedule_date, extraContext, {
-            productIds: changedIds
-          });
+          const updatedProducts = await this.prepareProductsWithPrice(
+            schedule_date,
+            extraContext,
+            { productIds: changedIds }
+          );
           if (updatedProducts.length > 0) {
-            // merge：用更新结果替换缓存中对应的商品，新增的追加
-            const updatedMap = new Map(updatedProducts.map(p => [p.id, p]));
+            const updatedMap = new Map(updatedProducts.map((p) => [p.id, p]));
             const mergedCache = [];
             for (const p of cachedProducts) {
               if (updatedMap.has(p.id)) {
@@ -231,17 +406,16 @@ class ProductsModule extends _BaseModule.BaseModule {
                 mergedCache.push(p);
               }
             }
-            // 剩余的是新增商品（create 场景）
             for (const p of updatedMap.values()) {
               mergedCache.push(p);
             }
             this.productsPriceCache.set(cacheKey, mergedCache);
-            this.logInfo('增量更新完成', {
+            this.logInfo("增量更新完成", {
               cacheKey,
               changedCount: updatedProducts.length,
               totalCount: mergedCache.length
             });
-            (0, _product.perfMark)('getProductsWithPrice(incrementalUpdate)', performance.now() - t0, {
+            (0, import_product.perfMark)("getProductsWithPrice(incrementalUpdate)", performance.now() - t0, {
               cacheKey,
               changedCount: changedIds.length,
               count: mergedCache.length
@@ -250,46 +424,50 @@ class ProductsModule extends _BaseModule.BaseModule {
           }
         } catch (error) {
           const errorMessage = error instanceof Error ? error.message : String(error);
-          this.logError('增量更新失败，返回现有缓存', {
+          this.logError("增量更新失败，返回现有缓存", {
             cacheKey,
             changedIds,
             error: errorMessage
           });
         }
-        (0, _product.perfMark)('getProductsWithPrice(incrementalUpdate)', performance.now() - t0, {
+        (0, import_product.perfMark)("getProductsWithPrice(incrementalUpdate)", performance.now() - t0, {
           cacheKey,
           changedCount: changedIds.length,
           count: cachedProducts.length
         });
         return cachedProducts;
       }
-      (0, _product.perfMark)('getProductsWithPrice(cacheHit)', performance.now() - t0, {
+      (0, import_product.perfMark)("getProductsWithPrice(cacheHit)", performance.now() - t0, {
         cacheKey,
         count: cachedProducts.length
       });
-      this.logInfo('商品价格缓存命中', {
+      this.logInfo("商品价格缓存命中", {
         cacheKey,
         productCount: cachedProducts.length
       });
       return cachedProducts;
     }
-    this.logInfo('商品价格缓存未命中，准备获取', {
-      cacheKey
+    this.logInfo("商品价格缓存未命中，准备获取", {
+      cacheKey,
+      scopedProductCount: scopedProductIds == null ? void 0 : scopedProductIds.length
     });
-    const result = await this.prepareProductsWithPrice(schedule_date, extraContext);
+    const result = await this.prepareProductsWithPrice(
+      schedule_date,
+      extraContext,
+      scopedProductIds ? { productIds: scopedProductIds } : void 0
+    );
     this.productsPriceCache.set(cacheKey, result);
-    this.logInfo('商品价格已缓存', {
+    this.logInfo("商品价格已缓存", {
       cacheKey,
       productCount: result.length
     });
     this.cleanExpiredPriceCache();
-    (0, _product.perfMark)('getProductsWithPrice(cacheMiss)', performance.now() - t0, {
+    (0, import_product.perfMark)("getProductsWithPrice(cacheMiss)", performance.now() - t0, {
       cacheKey,
       count: result.length
     });
     return result;
   }
-
   /**
    * 准备带价格的商品数据（通过格式化器流程处理）
    * @param schedule_date 日期
@@ -300,22 +478,21 @@ class ProductsModule extends _BaseModule.BaseModule {
    * @private
    */
   async prepareProductsWithPrice(schedule_date, extraContext, options) {
+    var _a, _b, _c, _d;
     const tTotal = performance.now();
-    const targetIds = options?.productIds;
-    const isIncremental = targetIds && targetIds.length > 0;
-    this.logInfo('prepareProductsWithPrice 开始处理', {
+    const targetIds = options == null ? void 0 : options.productIds;
+    const isIncremental = Array.isArray(targetIds);
+    this.logInfo("prepareProductsWithPrice 开始处理", {
       schedule_date,
-      mode: isIncremental ? 'incremental' : 'full',
-      targetIdsCount: targetIds?.length
+      mode: isIncremental ? "incremental" : "full",
+      targetIdsCount: targetIds == null ? void 0 : targetIds.length
     });
     try {
-      // 1. 获取商品列表：指定 IDs 时从 store 取子集，否则取全量
       let products;
       let ids;
       if (isIncremental) {
-        const idSet = new Set(targetIds);
-        products = this.getProductsRef().filter(p => idSet.has(p.id));
-        ids = products.map(p => p.id);
+        products = this.getProductsRefByIds(targetIds);
+        ids = products.map((p) => p.id);
       } else {
         products = this.getProductsRef();
         const tIds = performance.now();
@@ -323,65 +500,123 @@ class ProductsModule extends _BaseModule.BaseModule {
         for (let i = 0; i < products.length; i++) {
           ids[i] = products[i].id;
         }
-        (0, _product.perfMark)('prepareProducts.extractIds', performance.now() - tIds, {
-          count: ids.length
+        (0, import_product.perfMark)("prepareProducts.extractIds", performance.now() - tIds, { count: ids.length });
+      }
+      this.logInfo("获取到商品列表", { productCount: products.length });
+      let priceData = [];
+      if (this.isLegacyPriceFormatterEnabled) {
+        const tPrice = performance.now();
+        priceData = await this.loadProductsPrice({
+          ids,
+          schedule_date,
+          schedule_datetime: extraContext == null ? void 0 : extraContext.schedule_datetime,
+          customer_id: extraContext == null ? void 0 : extraContext.customer_id
         });
+        (0, import_product.perfMark)("prepareProducts.loadPrice", performance.now() - tPrice, { count: ids.length });
+        this.logInfo("获取商品报价单价格成功", { priceDataCount: (priceData == null ? void 0 : priceData.length) ?? 0 });
       }
-      this.logInfo('获取到商品列表', {
-        productCount: products.length
-      });
-
-      // 2. 获取价格数据（网络请求）
-      const tPrice = performance.now();
-      const priceData = await this.loadProductsPrice({
-        ids,
-        schedule_date
-      });
-      (0, _product.perfMark)('prepareProducts.loadPrice', performance.now() - tPrice, {
-        count: ids.length
-      });
-      this.logInfo('获取商品报价单价格成功', {
-        priceDataCount: priceData?.length ?? 0
-      });
       const context = {
         schedule_date,
+        schedule_datetime: extraContext == null ? void 0 : extraContext.schedule_datetime,
+        customer_id: extraContext == null ? void 0 : extraContext.customer_id,
         priceData,
-        locale: this.core?.context?.locale,
+        locale: (_b = (_a = this.core) == null ? void 0 : _a.context) == null ? void 0 : _b.locale,
+        dataVariantEvaluator: (extraContext == null ? void 0 : extraContext.dataVariantEvaluator) || ((_d = (_c = this.core) == null ? void 0 : _c.context) == null ? void 0 : _d.dataVariantEvaluator),
+        menuList: (extraContext == null ? void 0 : extraContext.menuList) || [],
+        scheduleList: (extraContext == null ? void 0 : extraContext.scheduleList) || [],
+        strategy_context: extraContext == null ? void 0 : extraContext.strategy_context,
         ...extraContext
       };
-
-      // 3. 通过格式化器流程处理商品
       const tFormat = performance.now();
       const processedProducts = await this.applyFormatters(products, context);
-      (0, _product.perfMark)('prepareProducts.applyFormatters', performance.now() - tFormat, {
+      (0, import_product.perfMark)("prepareProducts.applyFormatters", performance.now() - tFormat, {
         count: products.length,
         formatterCount: this.formatters.length
       });
-      this.logInfo('prepareProductsWithPrice 处理完成', {
-        mode: isIncremental ? 'incremental' : 'full',
+      this.logInfo("prepareProductsWithPrice 处理完成", {
+        mode: isIncremental ? "incremental" : "full",
         originalProductCount: products.length,
         processedProductCount: processedProducts.length,
         formatterCount: this.formatters.length
       });
       if (!isIncremental) {
-        await this.core.effects.emit(_types.ProductsHooks.onProductsPriceApplied, processedProducts);
+        await this.core.effects.emit(
+          import_types.ProductsHooks.onProductsPriceApplied,
+          processedProducts
+        );
       }
-      (0, _product.perfMark)('prepareProductsWithPrice', performance.now() - tTotal, {
+      (0, import_product.perfMark)("prepareProductsWithPrice", performance.now() - tTotal, {
         productCount: products.length,
         formatterCount: this.formatters.length,
-        mode: isIncremental ? 'incremental' : 'full'
+        mode: isIncremental ? "incremental" : "full"
       });
       return processedProducts;
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
-      this.logError('prepareProductsWithPrice 处理失败', {
+      console.log(`[ProductsModule] 🌐 ERROR`, err);
+      this.logError("prepareProductsWithPrice 处理失败", {
         schedule_date,
         error: errorMessage
       });
     }
     return [];
   }
-
+  getProductsPriceCacheKey(schedule_date, extraContext, productIds) {
+    const datetime = (extraContext == null ? void 0 : extraContext.schedule_datetime) || schedule_date;
+    const productScope = productIds ? `:products:${productIds.join(",")}` : "";
+    const strategyScope = this.stringifyStable((extraContext == null ? void 0 : extraContext.strategy_context) || {});
+    return `${datetime}:customer:${(extraContext == null ? void 0 : extraContext.customer_id) ?? ""}:strategy:${strategyScope}${productScope}`;
+  }
+  /**
+   * 稳定序列化策略上下文，避免对象 key 顺序不同导致缓存 key 抖动。
+   */
+  stringifyStable(value) {
+    if (value == null)
+      return "";
+    if (Array.isArray(value))
+      return `[${value.map((item) => this.stringifyStable(item)).join(",")}]`;
+    if (typeof value === "object") {
+      return `{${Object.keys(value).sort().map((key) => `${key}:${this.stringifyStable(value[key])}`).join(",")}}`;
+    }
+    return String(value);
+  }
+  normalizeProductIds(productIds) {
+    if (!Array.isArray(productIds))
+      return void 0;
+    return Array.from(new Set(
+      productIds.map((id) => Number(id)).filter((id) => Number.isFinite(id))
+    )).sort((a, b) => a - b);
+  }
+  /**
+   * 按轻量范围返回商品 ID，不做 structuredClone。
+   */
+  getProductIdsByScope(scope) {
+    const productIds = this.normalizeProductIds(scope.productIds) || [];
+    const collectionIds = this.normalizeProductIds(scope.collectionIds) || [];
+    if (scope.isAllProducts) {
+      return this.getProductsRef().map((product) => product.id);
+    }
+    if (productIds.length === 0 && collectionIds.length === 0)
+      return [];
+    const result = /* @__PURE__ */ new Set();
+    for (const id of productIds) {
+      if (this.store.map.has(id))
+        result.add(id);
+    }
+    if (collectionIds.length === 0)
+      return Array.from(result);
+    const collectionIdSet = new Set(collectionIds);
+    for (const product of this.getProductsRef()) {
+      if (result.has(product.id))
+        continue;
+      if (!Array.isArray(product.collection))
+        continue;
+      const isInCollection = product.collection.some((collection) => collectionIdSet.has(collection.id));
+      if (isInCollection)
+        result.add(product.id);
+    }
+    return Array.from(result);
+  }
   /**
    * 应用所有已注册的格式化器
    * @param products 商品列表
@@ -392,13 +627,11 @@ class ProductsModule extends _BaseModule.BaseModule {
   async applyFormatters(products, context) {
     let result = products;
     if (this.formatters.length === 0) {
-      console.warn('[ProductsModule] ⚠️ 没有注册任何格式化器');
-      this.logWarning('没有注册任何格式化器', {
-        productCount: products.length
-      });
+      console.warn("[ProductsModule] ⚠️ 没有注册任何格式化器");
+      this.logWarning("没有注册任何格式化器", { productCount: products.length });
       return result;
     }
-    this.logInfo('开始应用格式化器', {
+    this.logInfo("开始应用格式化器", {
       productCount: products.length,
       formatterCount: this.formatters.length
     });
@@ -407,7 +640,7 @@ class ProductsModule extends _BaseModule.BaseModule {
       try {
         const tF = performance.now();
         result = await formatter(result, context);
-        (0, _product.perfMark)(`applyFormatters[${i}]`, performance.now() - tF, {
+        (0, import_product.perfMark)(`applyFormatters[${i}]`, performance.now() - tF, {
           index: i,
           total: this.formatters.length,
           productCount: result.length
@@ -422,48 +655,93 @@ class ProductsModule extends _BaseModule.BaseModule {
         });
       }
     }
-    this.logInfo('所有格式化器已应用', {
+    this.logInfo("所有格式化器已应用", {
       formatterCount: this.formatters.length,
       resultProductCount: result.length
     });
     return result;
   }
-
   /**
-   * 注册内置的价格格式化器
-   * 这个格式化器负责将价格数据应用到商品上
+   * 注册内置商品格式化器。
+   *
+   * 智能定价默认替代报价单逻辑；报价单 formatter 仅在 enableLegacyPriceFormatter=true 时启用。
    * @private
    */
-  registerBuiltinPriceFormatter() {
-    if (this.isPriceFormatterRegistered) {
-      console.warn('[ProductsModule] 内置价格格式化器已注册，跳过');
+  registerBuiltinProductFormatters() {
+    if (this.isBuiltinFormatterRegistered) {
+      console.warn("[ProductsModule] 内置商品格式化器已注册，跳过");
       return;
     }
-
-    // 创建价格格式化器
-    const priceFormatter = (products, context) => {
+    this.isLegacyPriceFormatterEnabled = this.shouldEnableLegacyPriceFormatter();
+    const dataVariantFormatter = (products, context) => {
+      var _a, _b;
+      const evaluator = context.dataVariantEvaluator || ((_b = (_a = this.core) == null ? void 0 : _a.context) == null ? void 0 : _b.dataVariantEvaluator);
+      if (!evaluator || typeof evaluator.resolveProducts !== "function") {
+        this.lastScheduleTimePoints = [];
+        this.logWarning("智能定价评估器未注入，跳过 DataVariant 格式化", {
+          productCount: products.length
+        });
+        return products;
+      }
+      const strategyContext = context.strategy_context || {};
+      const businessData = {
+        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.business_code ?? strategyContext.businessCode,
+        availableWalletIds: strategyContext.available_wallet_ids,
+        custom: strategyContext
+      };
+      const result = evaluator.resolveProducts(businessData);
+      this.lastScheduleTimePoints = Array.isArray(result == null ? void 0 : result.scheduleTimePoints) ? [...result.scheduleTimePoints] : [];
+      return Array.isArray(result == null ? void 0 : result.products) ? result.products : products;
+    };
+    const legacyPriceFormatter = (products, context) => {
       if (!context.priceData || context.priceData.length === 0) {
+        console.log("[ProductsModule] 💰 没有价格数据，跳过 legacy 报价单价格应用");
         return products;
       }
-      return (0, _product.applyPriceDataToProducts)(products, context.priceData);
+      console.log(`[ProductsModule] 💰 应用 legacy 报价单价格到 ${products.length} 个商品`);
+      return (0, import_product.applyPriceDataToProducts)(products, context.priceData);
     };
     const i18nFormatter = (products, context) => {
-      return (0, _product.applyI18nToProducts)(products, context.locale);
+      return (0, import_product.applyI18nToProducts)(products, context.locale);
     };
     const detailValueFormatter = (products, context) => {
-      return (0, _product.applyDetailValueToProducts)(products, context);
+      return (0, import_product.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;
+    this.isBuiltinFormatterRegistered = true;
+    console.log("[ProductsModule] ✅ 内置商品格式化器已注册（智能定价优先）");
+  }
+  /**
+   * 是否启用旧报价单价格 formatter。
+   *
+   * 默认关闭，避免报价单逻辑覆盖智能定价结果。
+   */
+  shouldEnableLegacyPriceFormatter() {
+    var _a, _b, _c;
+    return ((_a = this.otherParams) == null ? void 0 : _a.enableLegacyPriceFormatter) === true || ((_c = (_b = this.core) == null ? void 0 : _b.context) == null ? void 0 : _c.enableLegacyPriceFormatter) === true;
+  }
+  /**
+   * 返回最近一次 prepareProductsWithPrice / DataVariant 评估提取的变价时间点（HH:mm）。
+   * 供 OS Server 商品 query 订阅定时刷新使用。
+   */
+  getLastScheduleTimePoints() {
+    return [...this.lastScheduleTimePoints];
   }
-
   /**
    * 注册商品格式化器
-   * 格式化器会按注册顺序依次执行（内置价格格式化器始终是第一个）
+   * 格式化器会按注册顺序依次执行；legacy 启用时先兜底报价，再由智能定价覆盖。
    * @param formatter 格式化函数
    * @param prepend 是否插入到队列开头（默认 false，追加到末尾）
    * @example
@@ -478,29 +756,29 @@ class ProductsModule extends _BaseModule.BaseModule {
    */
   registerFormatter(formatter, prepend = false) {
     if (prepend) {
-      // 插入到价格格式化器之后（索引 1 的位置）
-      const insertIndex = this.isPriceFormatterRegistered ? 1 : 0;
+      const insertIndex = this.isBuiltinFormatterRegistered ? this.isLegacyPriceFormatterEnabled ? 2 : 1 : 0;
       this.formatters.splice(insertIndex, 0, formatter);
+      console.log(`[ProductsModule] 📌 已在位置 ${insertIndex + 1} 插入格式化器，当前共 ${this.formatters.length} 个`);
     } else {
-      // 追加到末尾
       this.formatters.push(formatter);
+      console.log(`[ProductsModule] 📌 已注册格式化器，当前共 ${this.formatters.length} 个`);
     }
   }
-
   /**
-   * 清空所有格式化器（包括内置价格格式化器）
-   * @param keepBuiltin 是否保留内置价格格式化器（默认 true）
+   * 清空所有格式化器（包括内置智能定价格式化器）
+   * @param keepBuiltin 是否保留内置智能定价格式化器（默认 true）
    */
   clearFormatters(keepBuiltin = true) {
-    if (keepBuiltin && this.isPriceFormatterRegistered) {
-      // 只保留第一个格式化器（内置价格格式化器）
-      this.formatters = [this.formatters[0]];
+    if (keepBuiltin && this.isBuiltinFormatterRegistered) {
+      const 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] 🧹 已清空所有格式化器");
     }
   }
-
   /**
    * 清理过期的价格缓存
    * 当缓存数量超过限制时，删除最老的缓存
@@ -511,64 +789,59 @@ class ProductsModule extends _BaseModule.BaseModule {
       const keys = Array.from(this.productsPriceCache.keys());
       const oldestKey = keys[0];
       this.productsPriceCache.delete(oldestKey);
+      console.log(`[ProductsModule] 🧹 清理过期商品价格缓存: ${oldestKey}`);
     }
   }
-
   /**
    * 清空商品价格缓存
    * 可用于手动刷新价格数据
    */
   clearPriceCache() {
     this.productsPriceCache.clear();
+    console.log("[ProductsModule] 🗑️ 商品价格缓存已清空");
   }
-
   /**
    * 通过 ProductDataSource SSE 加载完整商品列表
    */
   async loadProductsByServer() {
     if (!this.productDataSource) {
-      this.logWarning('loadProductsByServer: ProductDataSource 不可用');
+      this.logWarning("loadProductsByServer: ProductDataSource 不可用");
       return [];
     }
-    this.logInfo('开始通过 DataSource SSE 加载商品列表');
+    this.logInfo("开始通过 DataSource SSE 加载商品列表");
     const t0 = performance.now();
     try {
       const tSSE = performance.now();
-      const productList = await this.productDataSource.run({
-        sse: {}
-      });
+      const productList = await this.productDataSource.run({ sse: {} });
       const list = productList || [];
-      (0, _product.perfMark)('loadProductsByServer.SSE', performance.now() - tSSE, {
-        count: list.length
-      });
-      this.logInfo('通过 DataSource SSE 加载商品列表成功', {
+      (0, import_product.perfMark)("loadProductsByServer.SSE", performance.now() - tSSE, { count: list.length });
+      this.logInfo("通过 DataSource SSE 加载商品列表成功", {
         productCount: list.length,
         duration: `${Math.round(performance.now() - t0)}ms`
       });
-      await this.saveProductsToIndexDB(list);
-      await this.core.effects.emit(_types.ProductsHooks.onProductsLoaded, list);
-      (0, _product.perfMark)('loadProductsByServer', performance.now() - t0, {
-        count: list.length
-      });
+      await this.replaceProductsSnapshotInIndexDB(list, "loadProductsByServer");
+      this.lastServerFullFetchAtMs = Date.now();
+      await this.core.effects.emit(import_types.ProductsHooks.onProductsLoaded, list);
+      (0, import_product.perfMark)("loadProductsByServer", performance.now() - t0, { count: list.length });
       return list;
     } catch (error) {
       const duration = Math.round(performance.now() - t0);
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.error('[Products] 加载商品数据失败:', error);
-      this.logError('通过 DataSource SSE 加载商品列表失败', {
+      console.error("[Products] 加载商品数据失败:", error);
+      this.logError("通过 DataSource SSE 加载商品列表失败", {
         duration: `${duration}ms`,
         error: errorMessage
       });
       return [];
     }
   }
-
   /**
    * 纯请求方法：通过 HTTP 接口获取商品列表（无副作用，不触发事件、不写 IndexDB）
    * @param params 查询参数
    * @returns 商品列表
    */
   async fetchProductsByHttp(params) {
+    var _a, _b;
     const {
       category_ids = [],
       product_ids = [],
@@ -576,7 +849,7 @@ class ProductsModule extends _BaseModule.BaseModule {
       customer_id,
       cacheId
     } = params || {};
-    this.logInfo('fetchProductsByHttp: 开始请求', {
+    this.logInfo("fetchProductsByHttp: 开始请求", {
       categoryIdsCount: category_ids.length,
       productIdsCount: product_ids.length,
       collectionCount: Array.isArray(collection) ? collection.length : collection ? 1 : 0,
@@ -584,29 +857,46 @@ class ProductsModule extends _BaseModule.BaseModule {
     });
     const startTime = Date.now();
     try {
-      const productsData = await this.request.post(`/product/query`, {
-        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'],
-        open_deposit: 1,
-        is_append_product_description: 1,
-        with_count: ['bundleGroup', 'optionGroup'],
-        with_category_tree: 1,
-        status: 'published',
-        num: 500,
-        skip: 1,
-        category_ids,
-        ids: product_ids,
-        collection,
-        front_end_cache_id: cacheId,
-        application_code: this.otherParams?.channel
-      }, {
-        cache: undefined
-      });
-      const productList = productsData?.data?.list || [];
+      const productsData = await this.request.post(
+        `/product/query`,
+        {
+          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",
+            "dataVariants"
+          ],
+          open_deposit: 1,
+          is_append_product_description: 1,
+          with_count: ["bundleGroup", "optionGroup"],
+          with_category_tree: 1,
+          status: "published",
+          num: 500,
+          skip: 1,
+          category_ids,
+          ids: product_ids,
+          collection,
+          front_end_cache_id: cacheId,
+          application_code: (_a = this.otherParams) == null ? void 0 : _a.channel
+        },
+        { cache: void 0 }
+      );
+      const productList = ((_b = productsData == null ? void 0 : productsData.data) == null ? void 0 : _b.list) || [];
       const duration = Date.now() - startTime;
-      this.logInfo('fetchProductsByHttp: 请求成功', {
+      this.logInfo("fetchProductsByHttp: 请求成功", {
         productCount: productList.length,
         duration: `${duration}ms`
       });
@@ -614,15 +904,14 @@ class ProductsModule extends _BaseModule.BaseModule {
     } catch (error) {
       const duration = Date.now() - startTime;
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.error('[Products] fetchProductsByHttp 失败:', error);
-      this.logError('fetchProductsByHttp: 请求失败', {
+      console.error("[Products] fetchProductsByHttp 失败:", error);
+      this.logError("fetchProductsByHttp: 请求失败", {
         duration: `${duration}ms`,
         error: errorMessage
       });
       return [];
     }
   }
-
   /**
    * 加载完整商品列表通过接口（包含所有详细数据）
    * 包含副作用：保存到 IndexDB + 触发 onProductsLoaded 事件
@@ -631,24 +920,41 @@ class ProductsModule extends _BaseModule.BaseModule {
   async loadProductsByServerHttp(params) {
     const productList = await this.fetchProductsByHttp(params);
     if (productList.length > 0) {
-      await this.saveProductsToIndexDB(productList);
-      await this.core.effects.emit(_types.ProductsHooks.onProductsLoaded, productList);
+      await this.replaceProductsSnapshotInIndexDB(productList, "loadProductsByServerHttp");
+      this.lastServerFullFetchAtMs = Date.now();
+      await this.core.effects.emit(import_types.ProductsHooks.onProductsLoaded, productList);
     }
     return productList;
   }
-
   /**
    * 获取商品列表（深拷贝，供外部安全使用）
    */
   async getProducts() {
     const t0 = performance.now();
     const result = structuredClone(this.store.list);
-    (0, _product.perfMark)('ProductsModule.getProducts(structuredClone)', performance.now() - t0, {
-      count: result.length
-    });
+    (0, import_product.perfMark)("ProductsModule.getProducts(structuredClone)", performance.now() - t0, { count: result.length });
     return result;
   }
-
+  /**
+   * 批量获取商品轻量快照，供订单详情等响应补齐展示协议字段。
+   */
+  async getProductSnapshotsByIds(ids) {
+    const snapshots = {};
+    const seen = /* @__PURE__ */ new Set();
+    for (const id of ids) {
+      if (!Number.isFinite(id) || seen.has(id))
+        continue;
+      seen.add(id);
+      const product = this.store.map.get(id);
+      if (!product)
+        continue;
+      snapshots[String(id)] = {
+        cover: product.cover,
+        holder_config: product.holder_config
+      };
+    }
+    return snapshots;
+  }
   /**
    * 内部获取商品列表的直接引用（无拷贝）
    * 仅供内部 formatter 流程使用，因为 formatter 会创建新对象
@@ -656,27 +962,34 @@ class ProductsModule extends _BaseModule.BaseModule {
   getProductsRef() {
     return this.store.list;
   }
-
+  /**
+   * 按 ID 从 Map 取商品引用，供内部 formatter 流程使用。
+   */
+  getProductsRefByIds(ids) {
+    const products = [];
+    for (const id of ids) {
+      const product = this.store.map.get(id);
+      if (product)
+        products.push(product);
+    }
+    return products;
+  }
   /**
    * 根据ID获取单个商品（从内存缓存）
    * 使用 Map 快速查询，时间复杂度 O(1)
    */
   async getProductById(id) {
     const product = this.store.map.get(id);
-    return product ? structuredClone(product) : undefined;
+    return product ? structuredClone(product) : void 0;
   }
-
   /**
    * 根据 ID 列表删除商品（用于 pubsub 同步删除场景）
    * 同时更新 store.list、store.map、IndexDB 和价格缓存
    */
   async removeProductsByIds(ids) {
     const idSet = new Set(ids);
-    this.logInfo('removeProductsByIds', {
-      ids,
-      count: ids.length
-    });
-    this.store.list = this.store.list.filter(p => !idSet.has(p.id));
+    this.logInfo("removeProductsByIds", { ids, count: ids.length });
+    this.store.list = this.store.list.filter((p) => !idSet.has(p.id));
     for (const id of ids) {
       this.store.map.delete(id);
     }
@@ -687,134 +1000,166 @@ class ProductsModule extends _BaseModule.BaseModule {
         }
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        this.logError('removeProductsByIds: IndexDB 删除失败', {
-          ids,
-          error: errorMessage
-        });
+        this.logError("removeProductsByIds: IndexDB 删除失败", { ids, error: errorMessage });
       }
     }
     for (const [dateKey, cachedProducts] of this.productsPriceCache.entries()) {
-      this.productsPriceCache.set(dateKey, cachedProducts.filter(p => !idSet.has(p.id)));
+      this.productsPriceCache.set(
+        dateKey,
+        cachedProducts.filter((p) => !idSet.has(p.id))
+      );
     }
-    this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
-    this.logInfo('removeProductsByIds 完成', {
-      remaining: this.store.list.length
-    });
+    this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+    this.logInfo("removeProductsByIds 完成", { remaining: this.store.list.length });
   }
-
   /**
    * 重新从服务器加载全量商品列表并更新本地 store
    * 用于 pubsub 同步 create / update / batch_update 场景
    */
   async refreshProducts() {
     const tTotal = performance.now();
-    this.logInfo('refreshProducts 开始');
+    this.logInfo("refreshProducts 开始");
     const products = await this.loadProductsByServer();
     if (products && products.length > 0) {
-      // 服务器返回的数据已经是全新的，无需 cloneDeep
       this.store.list = products;
       this.syncProductsMap();
-      this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
-      this.logInfo('refreshProducts 完成', {
-        productCount: products.length
-      });
+      this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+      this.logInfo("refreshProducts 完成", { productCount: products.length });
     } else {
-      this.logWarning('refreshProducts: 服务器未返回数据');
+      this.logWarning("refreshProducts: 服务器未返回数据");
     }
-    (0, _product.perfMark)('refreshProducts', performance.now() - tTotal, {
-      count: this.store.list.length
-    });
+    (0, import_product.perfMark)("refreshProducts", performance.now() - tTotal, { count: this.store.list.length });
     return this.store.list;
   }
-
   /**
    * 清空缓存
    */
   async clear() {
-    this.logInfo('开始清空缓存', {
+    this.logInfo("开始清空缓存", {
       currentProductCount: this.store.list.length,
       priceCacheCount: this.productsPriceCache.size
     });
     this.store.list = [];
     this.store.map.clear();
-
-    // 同时清空 IndexDB 中的所有数据（包括商品和元数据）
     if (this.dbManager) {
       try {
         await this.dbManager.clear(INDEXDB_STORE_NAME);
-        this.logInfo('IndexDB 缓存已清空');
+        console.log("[Products] IndexDB 缓存已清空");
+        this.logInfo("IndexDB 缓存已清空");
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        console.error('[Products] 清空 IndexDB 缓存失败:', error);
-        this.logError('清空 IndexDB 缓存失败', {
-          error: errorMessage
-        });
+        console.error("[Products] 清空 IndexDB 缓存失败:", error);
+        this.logError("清空 IndexDB 缓存失败", { error: errorMessage });
       }
     }
-    this.logInfo('缓存清空完成');
+    console.log("[Products] 缓存已清空");
+    this.logInfo("缓存清空完成");
   }
-
   /**
    * 从 IndexDB 加载商品数据
    * @private
    */
   async loadProductsFromIndexDB() {
     if (!this.dbManager) {
-      this.logWarning('loadProductsFromIndexDB: dbManager 不可用');
+      this.logWarning("loadProductsFromIndexDB: dbManager 不可用");
       return [];
     }
     try {
       const t0 = performance.now();
       const products = await this.dbManager.getAll(INDEXDB_STORE_NAME);
-      (0, _product.perfMark)('loadProductsFromIndexDB', performance.now() - t0, {
-        count: products?.length ?? 0
-      });
-      this.logInfo('从 IndexDB 加载商品数据', {
-        productCount: products?.length ?? 0
+      (0, import_product.perfMark)("loadProductsFromIndexDB", performance.now() - t0, { count: (products == null ? void 0 : products.length) ?? 0 });
+      this.logInfo("从 IndexDB 加载商品数据", {
+        productCount: (products == null ? void 0 : products.length) ?? 0
       });
       return products || [];
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.error('[Products] 从 IndexDB 读取数据失败:', error);
-      this.logError('从 IndexDB 读取数据失败', {
-        error: errorMessage
-      });
+      console.error("[Products] 从 IndexDB 读取数据失败:", error);
+      this.logError("从 IndexDB 读取数据失败", { error: errorMessage });
       return [];
     }
   }
-
   /**
-   * 保存商品数据到 IndexDB（平铺存储）
-   * @private
+   * 串行执行商品 IndexDB 写入，避免快照替换与增量 patch 并发交错。
+   *
+   * @example
+   * await this.runInProductIndexDBSaveQueue(async () => {
+   *   await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products)
+   * })
+   */
+  async runInProductIndexDBSaveQueue(task) {
+    const queuedTask = this.productIndexDBSaveQueue.then(task, task);
+    this.productIndexDBSaveQueue = queuedTask.then(() => void 0, () => void 0);
+    return queuedTask;
+  }
+  /**
+   * 全量快照写入 IndexDB：clear + bulkUpdate，仅用于 SSE/HTTP 全量拉取。
+   *
+   * @example
+   * await this.replaceProductsSnapshotInIndexDB(list, 'loadProductsByServer')
    */
-  async saveProductsToIndexDB(products) {
+  async replaceProductsSnapshotInIndexDB(products, source) {
     if (!this.dbManager) {
-      this.logWarning('saveProductsToIndexDB: dbManager 不可用');
+      this.logWarning("replaceProductsSnapshotInIndexDB: dbManager 不可用");
       return;
     }
-    this.logInfo('开始保存商品数据到 IndexDB', {
-      productCount: products.length
-    });
     try {
-      const t0 = performance.now();
-      await this.dbManager.clear(INDEXDB_STORE_NAME);
-      await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
-      (0, _product.perfMark)('saveProductsToIndexDB', performance.now() - t0, {
-        count: products.length
-      });
-      this.logInfo('商品数据已保存到 IndexDB', {
-        productCount: products.length
+      await this.runInProductIndexDBSaveQueue(async () => {
+        this.logInfo("replaceProductsSnapshotInIndexDB 开始", { source, productCount: products.length });
+        const t0 = performance.now();
+        await this.dbManager.clear(INDEXDB_STORE_NAME);
+        if (products.length > 0) {
+          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+        }
+        (0, import_product.perfMark)("replaceProductsSnapshotInIndexDB", performance.now() - t0, { count: products.length });
+        this.logInfo("replaceProductsSnapshotInIndexDB 完成", { source, productCount: products.length });
       });
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.error('[Products] 保存数据到 IndexDB 失败:', error);
-      this.logError('保存数据到 IndexDB 失败', {
+      this.logError("全量保存商品到 IndexDB 失败", {
+        source,
         productCount: products.length,
         error: errorMessage
       });
     }
   }
-
+  /**
+   * 增量 upsert 商品到 IndexDB，不清空表；用于 pubsub 批次合并后的变更商品。
+   *
+   * @example
+   * await this.patchProductsInIndexDB(changedProducts, 'pubsub.processProductSyncMessages', mergeActions)
+   */
+  async patchProductsInIndexDB(products, source, mergeActions = {}) {
+    if (!this.dbManager || products.length === 0) {
+      return;
+    }
+    const validProducts = products.filter((p) => (p == null ? void 0 : p.id) !== void 0 && (p == null ? void 0 : p.id) !== null);
+    if (validProducts.length === 0) {
+      return;
+    }
+    try {
+      await this.runInProductIndexDBSaveQueue(async () => {
+        this.logInfo("patchProductsInIndexDB 开始", { source, count: validProducts.length });
+        const t0 = performance.now();
+        if (typeof this.dbManager.bulkUpdate === "function") {
+          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, validProducts);
+        } else if (typeof this.dbManager.update === "function") {
+          for (const product of validProducts) {
+            await this.dbManager.update(INDEXDB_STORE_NAME, product);
+          }
+        }
+        (0, import_product.perfMark)("patchProductsInIndexDB", performance.now() - t0, { count: validProducts.length });
+        this.logInfo("patchProductsInIndexDB 完成", { source, count: validProducts.length });
+      });
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logError("增量保存商品到 IndexDB 失败", {
+        source,
+        error: errorMessage,
+        productCount: validProducts.length
+      });
+    }
+  }
   /**
    * 同步更新商品 Map 缓存
    * 将 list 中的商品同步到 map，以 id 为 key
@@ -826,103 +1171,92 @@ class ProductsModule extends _BaseModule.BaseModule {
     for (const product of this.store.list) {
       this.store.map.set(product.id, product);
     }
-    (0, _product.perfMark)('syncProductsMap', performance.now() - t0, {
-      count: this.store.map.size
-    });
+    (0, import_product.perfMark)("syncProductsMap", performance.now() - t0, { count: this.store.map.size });
   }
-
   /**
    * 预加载模块数据（统一接口）
    * 在模块注册后自动调用
    */
   async preload() {
+    console.log("[Products] 开始预加载数据...");
     const tTotal = performance.now();
-    this.logInfo('开始预加载数据');
+    this.logInfo("开始预加载数据");
     try {
       const tIndexDB = performance.now();
       const cachedData = await this.loadProductsFromIndexDB();
-      (0, _product.perfMark)('preload.loadFromIndexDB', performance.now() - tIndexDB, {
-        count: cachedData?.length ?? 0
-      });
+      (0, import_product.perfMark)("preload.loadFromIndexDB", performance.now() - tIndexDB, { count: (cachedData == null ? void 0 : cachedData.length) ?? 0 });
       if (cachedData && cachedData.length > 0) {
-        // IndexDB 反序列化的数据已经是全新的，无需 cloneDeep
+        console.log(`[Products] 从 IndexDB 加载了 ${cachedData.length} 个商品`);
         this.store.list = cachedData;
         const tSync = performance.now();
         this.syncProductsMap();
-        (0, _product.perfMark)('preload.syncProductsMap', performance.now() - tSync, {
-          count: cachedData.length
-        });
-        this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
-        (0, _product.perfMark)('preload(IndexDB)', performance.now() - tTotal, {
+        (0, import_product.perfMark)("preload.syncProductsMap", performance.now() - tSync, { count: cachedData.length });
+        this.core.effects.emit(
+          import_types.ProductsHooks.onProductsChanged,
+          this.store.list
+        );
+        (0, import_product.perfMark)("preload(IndexDB)", performance.now() - tTotal, {
           count: cachedData.length,
-          source: 'IndexDB'
+          source: "IndexDB"
         });
-        this.logInfo('预加载完成（从 IndexDB）', {
+        this.logInfo("预加载完成（从 IndexDB）", {
           productCount: cachedData.length,
           duration: `${Math.round(performance.now() - tTotal)}ms`,
-          source: 'IndexDB'
+          source: "IndexDB"
         });
+        this.lastPreloadCompletedAtMs = Date.now();
         return;
       }
-      this.logInfo('IndexDB 中没有缓存数据，准备从服务器加载');
+      console.log("[Products] IndexDB 中没有缓存数据，从服务器加载...");
+      this.logInfo("IndexDB 中没有缓存数据，准备从服务器加载");
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.warn('[Products] 从 IndexDB 加载数据失败:', error);
-      this.logWarning('从 IndexDB 加载数据失败，准备从服务器加载', {
-        error: errorMessage
-      });
+      console.warn("[Products] 从 IndexDB 加载数据失败:", error);
+      this.logWarning("从 IndexDB 加载数据失败，准备从服务器加载", { error: errorMessage });
     }
     const tServer = performance.now();
     const products = await this.loadProductsByServer();
-    (0, _product.perfMark)('preload.loadFromServer', performance.now() - tServer, {
-      count: products?.length ?? 0
-    });
+    (0, import_product.perfMark)("preload.loadFromServer", performance.now() - tServer, { count: (products == null ? void 0 : products.length) ?? 0 });
     if (products && products.length > 0) {
-      // 服务器返回的数据已经是全新的，无需 cloneDeep
       this.store.list = products;
       const tSync = performance.now();
       this.syncProductsMap();
-      (0, _product.perfMark)('preload.syncProductsMap', performance.now() - tSync, {
-        count: products.length
-      });
-      this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
-      (0, _product.perfMark)('preload(Server)', performance.now() - tTotal, {
+      (0, import_product.perfMark)("preload.syncProductsMap", performance.now() - tSync, { count: products.length });
+      this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+      (0, import_product.perfMark)("preload(Server)", performance.now() - tTotal, {
         count: products.length,
-        source: 'Server'
+        source: "Server"
       });
-      this.logInfo('预加载完成（从服务器）', {
+      this.logInfo("预加载完成（从服务器）", {
         productCount: products.length,
         duration: `${Math.round(performance.now() - tTotal)}ms`,
-        source: 'Server'
+        source: "Server"
       });
+      this.lastPreloadCompletedAtMs = Date.now();
     } else {
-      (0, _product.perfMark)('preload(empty)', performance.now() - tTotal, {
-        source: 'empty'
-      });
-      this.logWarning('预加载完成但未获取到数据', {
+      (0, import_product.perfMark)("preload(empty)", performance.now() - tTotal, { source: "empty" });
+      this.logWarning("预加载完成但未获取到数据", {
         duration: `${Math.round(performance.now() - tTotal)}ms`
       });
     }
   }
-
   // =============================================
   // 商品数据同步（pubsub）
   // =============================================
-
   /**
    * 初始化 ProductDataSource 实例
    * 与 pubsub 订阅和数据获取分开，仅负责创建实例
    */
   initProductDataSource() {
-    const ProductDataSourceClass = this.core.serverOptions?.All_DATA_SOURCES?.ProductDataSource;
+    var _a, _b;
+    const ProductDataSourceClass = (_b = (_a = this.core.serverOptions) == null ? void 0 : _a.All_DATA_SOURCES) == null ? void 0 : _b.ProductDataSource;
     if (!ProductDataSourceClass) {
-      this.logWarning('initProductDataSource: ProductDataSource 不可用');
+      this.logWarning("initProductDataSource: ProductDataSource 不可用");
       return;
     }
     this.productDataSource = new ProductDataSourceClass();
-    this.logInfo('ProductDataSource 实例已创建');
+    this.logInfo("ProductDataSource 实例已创建");
   }
-
   /**
    * 初始化 pubsub 订阅，监听管理后台商品变更
    * 仅负责订阅 product / product_quotation 频道，消息通过防抖合并后批量处理
@@ -930,22 +1264,21 @@ class ProductsModule extends _BaseModule.BaseModule {
    */
   setupProductSync() {
     if (!this.productDataSource) {
-      this.logWarning('setupProductSync: ProductDataSource 不可用，跳过同步初始化');
+      this.logWarning("setupProductSync: ProductDataSource 不可用，跳过同步初始化");
       return;
     }
-    const createHandler = channelKey => message => {
-      const data = message?.data || message;
-      if (!data) return;
-      this.logInfo('收到同步消息', {
+    const createHandler = (channelKey) => (message) => {
+      const data = (message == null ? void 0 : message.data) || message;
+      if (!data)
+        return;
+      console.log(`[ProductsModule] 收到同步消息 [${channelKey}]:`, data);
+      this.logInfo("收到同步消息", {
         channelKey,
         action: data.action,
         id: data.id,
         action_filed: data.action_filed
       });
-      this.pendingSyncMessages.push({
-        ...data,
-        _channelKey: channelKey
-      });
+      this.pendingSyncMessages.push({ ...data, _channelKey: channelKey });
       if (this.syncTimer) {
         clearTimeout(this.syncTimer);
       }
@@ -955,24 +1288,21 @@ class ProductsModule extends _BaseModule.BaseModule {
     };
     this.productDataSource.run({
       pubsub: {
-        callback: res => {
-          this.logInfo('sse_products_callback: 收到同步消息', {
-            data: res?.data
-          });
-          if (!res?.data) return;
+        callback: (res) => {
+          if (!(res == null ? void 0 : res.data))
+            return;
           const data = res.data;
-          const channelKey = data.module || 'product';
+          const channelKey = data.module || "product";
           createHandler(channelKey)(data);
         }
       }
-    }).catch(err => {
-      this.logError('setupProductSync: DataSource run 出错', {
+    }).catch((err) => {
+      this.logError("setupProductSync: DataSource run 出错", {
         error: err instanceof Error ? err.message : String(err)
       });
     });
-    this.logInfo('setupProductSync: pubsub 订阅已建立');
+    this.logInfo("setupProductSync: pubsub 订阅已建立");
   }
-
   /**
    * 处理防抖后的同步消息批次
    *
@@ -992,94 +1322,122 @@ class ProductsModule extends _BaseModule.BaseModule {
    * Server 层监听该事件后对变更商品增量执行 prepareProductsWithPrice 并更新缓存
    */
   async processProductSyncMessages() {
+    var _a, _b, _c, _d, _e, _f, _g;
     const messages = [...this.pendingSyncMessages];
     this.pendingSyncMessages = [];
-    if (messages.length === 0) return;
-    this.logInfo('processProductSyncMessages: 开始处理', {
-      count: messages.length
-    });
+    if (messages.length === 0)
+      return;
+    this.logInfo("processProductSyncMessages: 开始处理", { count: messages.length });
     const deleteIds = [];
-    const bodyUpdates = new Map();
+    const bodyUpdates = /* @__PURE__ */ new Map();
     const sseRefreshIds = [];
     const priceRefreshIds = [];
     let shouldClearPriceCache = false;
     for (const msg of messages) {
-      const channelKey = msg._channelKey || msg.module || 'product';
-      if (channelKey === 'product') {
-        if (msg.relation_product_ids?.length) {
+      const channelKey = msg._channelKey || msg.module || "product";
+      if (channelKey === "product") {
+        if ((_a = msg.relation_product_ids) == null ? void 0 : _a.length) {
           sseRefreshIds.push(...msg.relation_product_ids);
         }
-        // 1. 删除场景：operation === 'delete' 或 action === 'delete'
-        if (msg.operation === 'delete' || msg.action === 'delete') {
-          if (msg.ids?.length) deleteIds.push(...msg.ids);else if (msg.id) deleteIds.push(msg.id);
+        if (msg.operation === "delete" || msg.action === "delete") {
+          if ((_b = msg.ids) == null ? void 0 : _b.length)
+            deleteIds.push(...msg.ids);
+          else if (msg.id)
+            deleteIds.push(msg.id);
           continue;
         }
-
-        // 2. change_types 包含 price → 仅收集需要刷新价格的 IDs（不走 SSE 拉取）
-        if (msg.change_types?.includes('price')) {
+        if ((_c = msg.change_types) == null ? void 0 : _c.includes("price")) {
           const ids = msg.ids || (msg.id ? [msg.id] : []);
           priceRefreshIds.push(...ids);
           if (msg.body) {
             const bodyId = msg.body.id;
-            if (bodyId) bodyUpdates.set(bodyId, msg.body);
+            if (bodyId)
+              bodyUpdates.set(bodyId, msg.body);
           }
           continue;
         }
-
-        // 3. 有 body → 完整数据直接覆盖本地
         if (msg.body) {
           const bodyId = msg.body.id || msg.id;
-          if (bodyId) bodyUpdates.set(bodyId, msg.body);
+          if (bodyId)
+            bodyUpdates.set(bodyId, msg.body);
           continue;
         }
-
-        // 4. 其他情况（有 ids 无 body 无 change_types）→ SSE 拉取
-        if (msg.ids?.length) {
+        if ((_d = msg.ids) == null ? void 0 : _d.length) {
           sseRefreshIds.push(...msg.ids);
         } else if (msg.id) {
           sseRefreshIds.push(msg.id);
         }
-      } else if (channelKey === 'product_quotation') {
-        // 报价单变更影响范围大，标记清除全量价格缓存
+      } else if (channelKey === "product_quotation") {
         shouldClearPriceCache = true;
-        if (msg.relation_product_ids?.length) {
+        if ((_e = msg.relation_product_ids) == null ? void 0 : _e.length) {
           sseRefreshIds.push(...msg.relation_product_ids);
         }
-      } else if (['product_collection', 'product_category'].includes(channelKey)) {
-        if (msg.relation_product_ids?.length) {
+      } else if (["product_collection", "product_category"].includes(channelKey)) {
+        if ((_f = msg.relation_product_ids) == null ? void 0 : _f.length) {
           sseRefreshIds.push(...msg.relation_product_ids);
         }
+      } else if (["product_data_variant"].includes(channelKey)) {
+        if ((_g = msg.product_ids) == null ? void 0 : _g.length) {
+          sseRefreshIds.push(...msg.product_ids);
+        }
       }
     }
     const uniqueDeleteIds = [...new Set(deleteIds)];
     const uniqueSSEIds = [...new Set(sseRefreshIds)];
     const uniquePriceIds = [...new Set(priceRefreshIds)];
-
-    // 1. 处理删除
     if (uniqueDeleteIds.length > 0) {
       await this.removeProductsByIds(uniqueDeleteIds);
     }
-
-    // 2. 处理 body 直接覆盖（store.list 更新，价格缓存不清除）
+    const patchProductMap = /* @__PURE__ */ new Map();
+    const patchMergeActions = {};
+    let storeMutated = uniqueDeleteIds.length > 0;
     if (bodyUpdates.size > 0) {
-      await this.applyBodyUpdatesToStore(bodyUpdates);
+      const bodyResult = await this.applyBodyUpdatesToStore(bodyUpdates, {
+        skipIndexDB: true,
+        skipEmit: true
+      });
+      for (const product of bodyResult.changedProducts) {
+        patchProductMap.set(product.id, product);
+        patchMergeActions[product.id] = bodyResult.mergeActions[product.id];
+      }
+      storeMutated = true;
     }
-
-    // 3. 处理 SSE 增量拉取（store.list 更新，价格缓存不清除）
+    let freshProducts = [];
     if (uniqueSSEIds.length > 0) {
-      const freshProducts = await this.fetchProductsBySSE(uniqueSSEIds);
+      freshProducts = await this.fetchProductsBySSE(uniqueSSEIds);
       if (freshProducts.length > 0) {
-        await this.mergeProductsToStore(freshProducts);
+        const mergeResult = await this.mergeProductsToStore(freshProducts, {
+          skipIndexDB: true,
+          skipEmit: true
+        });
+        for (const product of mergeResult.changedProducts) {
+          patchProductMap.set(product.id, product);
+          patchMergeActions[product.id] = mergeResult.mergeActions[product.id];
+        }
+        storeMutated = true;
       }
-      this.logInfo('processProductSyncMessages: SSE 增量更新完成123', {
+      this.logInfo("processProductSyncMessages: SSE 增量更新完成123", {
         requestedCount: uniqueSSEIds.length,
         receivedCount: freshProducts.length
       });
     }
-
-    // 收集所有非 delete 的变更 IDs（body + SSE + price），用于增量更新价格缓存
-    const allChangedIds = [...new Set([...Array.from(bodyUpdates.keys()), ...uniqueSSEIds, ...uniquePriceIds])];
-    this.logInfo('processProductSyncMessages: 处理完成123', {
+    const patchProducts = [...patchProductMap.values()];
+    if (patchProducts.length > 0) {
+      await this.patchProductsInIndexDB(
+        patchProducts,
+        "pubsub.processProductSyncMessages",
+        patchMergeActions
+      );
+    }
+    if (storeMutated) {
+      this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+    }
+    const allChangedIds = [.../* @__PURE__ */ new Set([
+      ...Array.from(bodyUpdates.keys()),
+      ...uniqueSSEIds,
+      ...uniquePriceIds
+    ])];
+    this.logInfo("processProductSyncMessages: 处理完成123", {
       deleteCount: uniqueDeleteIds.length,
       bodyUpdateCount: bodyUpdates.size,
       sseRefreshCount: uniqueSSEIds.length,
@@ -1089,47 +1447,40 @@ class ProductsModule extends _BaseModule.BaseModule {
     });
     const hasChanges = uniqueDeleteIds.length > 0 || allChangedIds.length > 0 || shouldClearPriceCache;
     if (!hasChanges) {
-      this.logInfo('processProductSyncMessages: 没有变更，不触发 onProductsSyncCompleted');
+      this.logInfo("processProductSyncMessages: 没有变更，不触发 onProductsSyncCompleted");
       return;
     }
-
-    // 报价单变更 → 清除全量价格缓存，后续走全量重建
     if (shouldClearPriceCache) {
+      try {
+        await this.refreshQuotationPriceBridge();
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        this.logError("报价单桥接刷新失败，将继续清理价格缓存", { error: errorMessage });
+      }
       this.clearPriceCache();
     }
-    await this.core.effects.emit(_types.ProductsHooks.onProductsSyncCompleted, {
+    await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, {
       changedIds: allChangedIds
     });
   }
-
   /**
    * 通过 SSE 按 ids 增量拉取商品数据
    * 请求 GET /shop/core/stream?type=product&ids={ids}
    */
   async fetchProductsBySSE(ids) {
     if (!this.productDataSource) {
-      this.logWarning('fetchProductsBySSE: ProductDataSource 不可用');
+      this.logWarning("fetchProductsBySSE: ProductDataSource 不可用");
       return [];
     }
-    this.logInfo('fetchProductsBySSE: 开始', {
-      ids,
-      count: ids.length
-    });
+    this.logInfo("fetchProductsBySSE: 开始", { ids, count: ids.length });
     const t0 = performance.now();
     try {
       const productList = await this.productDataSource.run({
-        sse: {
-          query: {
-            type: 'product',
-            ids
-          }
-        }
+        sse: { query: { type: "product", ids } }
       });
       const list = productList || [];
-      (0, _product.perfMark)('fetchProductsBySSE', performance.now() - t0, {
-        count: list.length
-      });
-      this.logInfo('fetchProductsBySSE: 成功', {
+      (0, import_product.perfMark)("fetchProductsBySSE", performance.now() - t0, { count: list.length });
+      this.logInfo("fetchProductsBySSE: 成功", {
         requestedCount: ids.length,
         receivedCount: list.length,
         duration: `${Math.round(performance.now() - t0)}ms`
@@ -1137,32 +1488,33 @@ class ProductsModule extends _BaseModule.BaseModule {
       return list;
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      this.logError('fetchProductsBySSE: 失败', {
-        ids,
-        error: errorMessage
-      });
+      this.logError("fetchProductsBySSE: 失败", { ids, error: errorMessage });
       return [];
     }
   }
-
   /**
    * 将 body 完整数据直接覆盖到本地 store（不调用报价单接口）
    * 已存在的 → 直接替换；不存在的 → 追加
-   * 同时更新 Map 缓存、IndexDB，触发 onProductsChanged
-   * 价格缓存由 processProductSyncMessages 末尾统一清除
+   *
+   * @example
+   * await this.applyBodyUpdatesToStore(bodyUpdates, { skipIndexDB: true })
    */
-  async applyBodyUpdatesToStore(bodyUpdates) {
-    this.logInfo('applyBodyUpdatesToStore: 开始', {
-      count: bodyUpdates.size
-    });
+  async applyBodyUpdatesToStore(bodyUpdates, options) {
+    const changedProductIds = [...bodyUpdates.keys()];
+    this.logInfo("applyBodyUpdatesToStore: 开始", { count: bodyUpdates.size });
     let updatedCount = 0;
     let newCount = 0;
-    const appliedIds = new Set();
-    this.store.list = this.store.list.map(p => {
+    const appliedIds = /* @__PURE__ */ new Set();
+    const mergeActions = {};
+    const changedProducts = [];
+    this.store.list = this.store.list.map((p) => {
       if (bodyUpdates.has(p.id)) {
         updatedCount++;
         appliedIds.add(p.id);
-        return bodyUpdates.get(p.id);
+        mergeActions[p.id] = "update";
+        const next = bodyUpdates.get(p.id);
+        changedProducts.push(next);
+        return next;
       }
       return p;
     });
@@ -1170,54 +1522,71 @@ class ProductsModule extends _BaseModule.BaseModule {
       if (!appliedIds.has(id)) {
         this.store.list.push(body);
         newCount++;
+        mergeActions[id] = "insert";
+        changedProducts.push(body);
       }
     }
     this.syncProductsMap();
-    await this.saveProductsToIndexDB(this.store.list);
-    this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
-    this.logInfo('applyBodyUpdatesToStore: 完成', {
+    if (!(options == null ? void 0 : options.skipIndexDB)) {
+      await this.patchProductsInIndexDB(changedProducts, "pubsub.bodyUpdate", mergeActions);
+    }
+    if (!(options == null ? void 0 : options.skipEmit)) {
+      this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+    }
+    this.logInfo("applyBodyUpdatesToStore: 完成", {
       updatedCount,
       newCount,
       totalCount: this.store.list.length
     });
+    return { changedProducts, mergeActions, updatedCount, newCount };
   }
-
   /**
    * 将增量拉取的商品合并到 store
    * 已存在的 → 替换；新的 → 追加
-   * 同时更新 store.map、IndexDB，触发 onProductsChanged
+   *
+   * @example
+   * await this.mergeProductsToStore(freshProducts, { skipIndexDB: true })
    */
-  async mergeProductsToStore(freshProducts) {
-    const freshMap = new Map();
+  async mergeProductsToStore(freshProducts, options) {
+    const freshMap = /* @__PURE__ */ new Map();
     for (const p of freshProducts) {
       freshMap.set(p.id, p);
     }
-    const updatedList = this.store.list.map(p => {
+    const mergeActions = {};
+    const changedProducts = [];
+    const updatedList = this.store.list.map((p) => {
       if (freshMap.has(p.id)) {
         const fresh = freshMap.get(p.id);
         freshMap.delete(p.id);
+        mergeActions[p.id] = "update";
+        changedProducts.push(fresh);
         return fresh;
       }
       return p;
     });
-
-    // freshMap 中剩余的是新商品（create 场景）
     const newCount = freshMap.size;
     for (const p of freshMap.values()) {
       updatedList.push(p);
+      mergeActions[p.id] = "insert";
+      changedProducts.push(p);
     }
     const updatedCount = freshProducts.length - newCount;
+    const changedProductIds = freshProducts.map((p) => p.id);
     this.store.list = updatedList;
     this.syncProductsMap();
-    await this.saveProductsToIndexDB(this.store.list);
-    this.logInfo('mergeProductsToStore: 合并完成', {
+    if (!(options == null ? void 0 : options.skipIndexDB)) {
+      await this.patchProductsInIndexDB(changedProducts, "pubsub.mergeProductsToStore", mergeActions);
+    }
+    if (!(options == null ? void 0 : options.skipEmit)) {
+      this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+    }
+    this.logInfo("mergeProductsToStore: 合并完成", {
       updatedCount,
       newCount,
       totalCount: this.store.list.length
     });
-    this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
+    return { changedProducts, mergeActions, updatedCount, newCount };
   }
-
   /**
    * 静默全量刷新：后台重新拉取全量 SSE 数据并更新本地
    * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
@@ -1225,51 +1594,54 @@ class ProductsModule extends _BaseModule.BaseModule {
    */
   async silentRefresh() {
     const t0 = performance.now();
-    this.logInfo('silentRefresh 开始');
+    const now = Date.now();
+    const elapsedSincePreload = now - this.lastPreloadCompletedAtMs;
+    const elapsedSinceFullFetch = now - this.lastServerFullFetchAtMs;
+    if (this.lastPreloadCompletedAtMs > 0 && elapsedSincePreload < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS) {
+      return this.store.list;
+    }
+    this.logInfo("silentRefresh 开始");
     try {
       const products = await this.loadProductsByServer();
       if (products && products.length > 0) {
         this.store.list = products;
         this.syncProductsMap();
         this.clearPriceCache();
-        this.core.effects.emit(_types.ProductsHooks.onProductsChanged, this.store.list);
-        await this.core.effects.emit(_types.ProductsHooks.onProductsSyncCompleted, null);
-        this.logInfo('silentRefresh 完成', {
+        this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+        await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, null);
+        this.logInfo("silentRefresh 完成", {
           productCount: products.length,
           duration: `${Math.round(performance.now() - t0)}ms`
         });
       } else {
-        this.logWarning('silentRefresh: 服务器未返回数据');
+        this.logWarning("silentRefresh: 服务器未返回数据");
       }
-      (0, _product.perfMark)('silentRefresh', performance.now() - t0, {
-        count: this.store.list.length
-      });
+      (0, import_product.perfMark)("silentRefresh", performance.now() - t0, { count: this.store.list.length });
       return this.store.list;
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      this.logError('silentRefresh 失败', {
+      this.logError("silentRefresh 失败", {
         duration: `${Math.round(performance.now() - t0)}ms`,
         error: errorMessage
       });
       return this.store.list;
     }
   }
-
   /**
    * 销毁同步资源（取消 pubsub 订阅、清除定时器）
    */
   destroyProductSync() {
+    var _a;
     if (this.syncTimer) {
       clearTimeout(this.syncTimer);
-      this.syncTimer = undefined;
+      this.syncTimer = void 0;
     }
-    if (this.productDataSource?.destroy) {
+    if ((_a = this.productDataSource) == null ? void 0 : _a.destroy) {
       this.productDataSource.destroy();
     }
     this.pendingSyncMessages = [];
-    this.logInfo('destroyProductSync: 同步资源已销毁');
+    this.logInfo("destroyProductSync: 同步资源已销毁");
   }
-
   /**
    * 获取模块的路由定义
    * Products 模块暂不提供路由，由 Server 层统一处理
@@ -1277,5 +1649,8 @@ class ProductsModule extends _BaseModule.BaseModule {
   getRoutes() {
     return [];
   }
-}
-exports.ProductsModule = ProductsModule;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ProductsModule
+});