@pisell/pisellos 2.2.190 → 2.2.191

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

@@ -27,7 +27,11 @@ var import_Quotation = require("../../../modules/Quotation");
 var import_types = require("./types");
 var import_product = require("../../utils/product");
 var INDEXDB_STORE_NAME = "products";
+var PRODUCT_FLOW_LOG_WINDOW_KEY = "__productModuleFlowLogs";
+var PRODUCT_WRITE_STATS_WINDOW_KEY = "__productModuleWriteStats";
+var PRODUCT_FLOW_LOG_MAX_LENGTH = 1e3;
 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);
@@ -46,6 +50,14 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     this.isPriceFormatterRegistered = false;
     this.quotationBridgeLoadedKey = "";
     this.pendingSyncMessages = [];
+    /** IndexDB 写入序号，便于日志关联 */
+    this.productFlowWriteSeq = 0;
+    /** 最近一次 SSE 全量拉取完成时间 */
+    this.lastServerFullFetchAtMs = 0;
+    /** 最近一次 preload 完成时间（含 IndexDB 命中） */
+    this.lastPreloadCompletedAtMs = 0;
+    /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
+    this.productIndexDBSaveQueue = Promise.resolve();
   }
   async initialize(core, options) {
     var _a;
@@ -75,6 +87,12 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     this.registerBuiltinPriceFormatter();
     this.initProductDataSource();
     this.setupProductSync();
+    this.initProductFlowLogs();
+    this.pushProductFlowLog("initialize.complete", {
+      hasDbManager: !!this.dbManager,
+      hasLogger: !!this.logger,
+      initialProductCount: this.store.list.length
+    });
     this.logInfo("模块初始化完成", {
       hasDbManager: !!this.dbManager,
       hasLogger: !!this.logger,
@@ -131,6 +149,138 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       }
     } catch {
     }
+    this.pushProductFlowLog(`error.${title}`, metadata);
+  }
+  /**
+   * 初始化 window 上的商品流程调试日志。
+   *
+   * @example
+   * window.clearProductModuleFlowLogs()
+   * copy(window.exportProductModuleFlowLogs?.() || '[]')
+   */
+  initProductFlowLogs() {
+    try {
+      const win = typeof globalThis !== "undefined" ? globalThis.window : void 0;
+      if (!win)
+        return;
+      win[PRODUCT_FLOW_LOG_WINDOW_KEY] = [];
+      win[PRODUCT_WRITE_STATS_WINDOW_KEY] = {};
+      win.clearProductModuleFlowLogs = () => {
+        win[PRODUCT_FLOW_LOG_WINDOW_KEY] = [];
+        win[PRODUCT_WRITE_STATS_WINDOW_KEY] = {};
+        this.productFlowWriteSeq = 0;
+        this.pushProductFlowLog("debug.clear", {});
+      };
+      win.exportProductModuleFlowLogs = () => {
+        const logs = win[PRODUCT_FLOW_LOG_WINDOW_KEY] || [];
+        return JSON.stringify(logs, null, 2);
+      };
+      win.exportProductModuleWriteStats = () => {
+        const stats = win[PRODUCT_WRITE_STATS_WINDOW_KEY] || {};
+        return JSON.stringify(stats, null, 2);
+      };
+      win.summarizeProductModuleWrites = (topN = 20) => {
+        const stats = win[PRODUCT_WRITE_STATS_WINDOW_KEY] || {};
+        return Object.entries(stats).map(([productId, entries]) => {
+          const list = entries || [];
+          const sources = [...new Set(list.map((item) => item.source))];
+          const last = list[list.length - 1];
+          return {
+            productId: Number(productId),
+            writeCount: list.length,
+            sources,
+            lastWriteAt: (last == null ? void 0 : last.ts) || ""
+          };
+        }).sort((a, b) => b.writeCount - a.writeCount).slice(0, topN);
+      };
+      this.pushProductFlowLog("debug.init", {
+        logKey: PRODUCT_FLOW_LOG_WINDOW_KEY,
+        writeStatsKey: PRODUCT_WRITE_STATS_WINDOW_KEY,
+        indexDbStrategy: "全量 replaceProductsSnapshotInIndexDB + 增量 patchProductsInIndexDB",
+        helpers: [
+          "clearProductModuleFlowLogs",
+          "exportProductModuleFlowLogs",
+          "exportProductModuleWriteStats",
+          "summarizeProductModuleWrites"
+        ]
+      });
+    } catch {
+    }
+  }
+  /**
+   * 写入 window 商品流程调试日志。
+   *
+   * @example
+   * this.pushProductFlowLog('mergeProductsToStore.start', { count: 3 })
+   */
+  pushProductFlowLog(step, metadata) {
+    try {
+      const win = typeof globalThis !== "undefined" ? globalThis.window : void 0;
+      if (!win)
+        return;
+      if (!Array.isArray(win[PRODUCT_FLOW_LOG_WINDOW_KEY])) {
+        win[PRODUCT_FLOW_LOG_WINDOW_KEY] = [];
+      }
+      const entry = {
+        ts: (/* @__PURE__ */ new Date()).toISOString(),
+        step,
+        metadata: metadata || {}
+      };
+      win[PRODUCT_FLOW_LOG_WINDOW_KEY].push(entry);
+      const logs = win[PRODUCT_FLOW_LOG_WINDOW_KEY];
+      if (logs.length > PRODUCT_FLOW_LOG_MAX_LENGTH) {
+        logs.splice(0, logs.length - PRODUCT_FLOW_LOG_MAX_LENGTH);
+      }
+      console.log(`[ProductFlow] ${step}`, metadata || {});
+    } catch {
+    }
+  }
+  /** 当前内存 store 快照，供流程日志使用 */
+  getProductStoreSnapshot() {
+    return {
+      storeListCount: this.store.list.length,
+      storeMapCount: this.store.map.size,
+      pendingSyncCount: this.pendingSyncMessages.length
+    };
+  }
+  /**
+   * 记录 IndexDB 写入统计（按 productId 聚合）。
+   *
+   * @example
+   * this.trackProductWrite('pubsub.mergeProductsToStore', 'clear+bulkUpdate', products, { 1: 'update' })
+   */
+  trackProductWrite(source, writeMethod, products, mergeActions = {}, defaultMergeAction = "update") {
+    this.productFlowWriteSeq += 1;
+    const writeSeq = this.productFlowWriteSeq;
+    try {
+      const win = typeof globalThis !== "undefined" ? globalThis.window : void 0;
+      if (!win)
+        return writeSeq;
+      if (!win[PRODUCT_WRITE_STATS_WINDOW_KEY]) {
+        win[PRODUCT_WRITE_STATS_WINDOW_KEY] = {};
+      }
+      const stats = win[PRODUCT_WRITE_STATS_WINDOW_KEY];
+      for (const product of products) {
+        const productId = product == null ? void 0 : product.id;
+        if (productId === void 0 || productId === null)
+          continue;
+        const mergeAction = mergeActions[productId] || defaultMergeAction;
+        const entry = {
+          ts: (/* @__PURE__ */ new Date()).toISOString(),
+          writeSeq,
+          source,
+          writeMethod,
+          productId,
+          mergeAction
+        };
+        const key = String(productId);
+        if (!stats[key])
+          stats[key] = [];
+        stats[key].push(entry);
+      }
+    } catch {
+    }
+    return writeSeq;
   }
   /**
    * 加载商品价格（原始方法，不带缓存）
@@ -703,6 +853,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("loadProductsByServer: ProductDataSource 不可用");
       return [];
     }
+    this.pushProductFlowLog("loadProductsByServer.start", this.getProductStoreSnapshot());
     this.logInfo("开始通过 DataSource SSE 加载商品列表");
     const t0 = performance.now();
     try {
@@ -710,15 +861,24 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       const productList = await this.productDataSource.run({ sse: {} });
       const list = productList || [];
       (0, import_product.perfMark)("loadProductsByServer.SSE", performance.now() - tSSE, { count: list.length });
+      this.pushProductFlowLog("loadProductsByServer.sseSuccess", { count: list.length });
       this.logInfo("通过 DataSource SSE 加载商品列表成功", {
         productCount: list.length,
         duration: `${Math.round(performance.now() - t0)}ms`
       });
-      await this.saveProductsToIndexDB(list);
+      await this.replaceProductsSnapshotInIndexDB(list, "loadProductsByServer");
+      this.lastServerFullFetchAtMs = Date.now();
       await this.core.effects.emit(import_types.ProductsHooks.onProductsLoaded, list);
+      this.pushProductFlowLog("loadProductsByServer.done", {
+        count: list.length,
+        ...this.getProductStoreSnapshot()
+      });
       (0, import_product.perfMark)("loadProductsByServer", performance.now() - t0, { count: list.length });
       return list;
     } catch (error) {
+      this.pushProductFlowLog("loadProductsByServer.failed", {
+        error: error instanceof Error ? error.message : String(error)
+      });
       const duration = Math.round(performance.now() - t0);
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Products] 加载商品数据失败:", error);
@@ -811,11 +971,20 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * @param params 查询参数
    */
   async loadProductsByServerHttp(params) {
+    this.pushProductFlowLog("loadProductsByServerHttp.start", {
+      params: params || {},
+      ...this.getProductStoreSnapshot()
+    });
     const productList = await this.fetchProductsByHttp(params);
     if (productList.length > 0) {
-      await this.saveProductsToIndexDB(productList);
+      await this.replaceProductsSnapshotInIndexDB(productList, "loadProductsByServerHttp");
+      this.lastServerFullFetchAtMs = Date.now();
       await this.core.effects.emit(import_types.ProductsHooks.onProductsLoaded, productList);
     }
+    this.pushProductFlowLog("loadProductsByServerHttp.done", {
+      count: productList.length,
+      ...this.getProductStoreSnapshot()
+    });
     return productList;
   }
   /**
@@ -860,6 +1029,12 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    */
   async removeProductsByIds(ids) {
     const idSet = new Set(ids);
+    this.pushProductFlowLog("removeProductsByIds.start", {
+      ids,
+      count: ids.length,
+      writeStrategy: "delete-by-id",
+      ...this.getProductStoreSnapshot()
+    });
     this.logInfo("removeProductsByIds", { ids, count: ids.length });
     this.store.list = this.store.list.filter((p) => !idSet.has(p.id));
     for (const id of ids) {
@@ -870,6 +1045,13 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         for (const id of ids) {
           await this.dbManager.delete(INDEXDB_STORE_NAME, id);
         }
+        this.trackProductWrite(
+          "pubsub.removeProductsByIds",
+          "delete",
+          ids.map((id) => ({ id })),
+          Object.fromEntries(ids.map((id) => [id, "delete"])),
+          "delete"
+        );
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         this.logError("removeProductsByIds: IndexDB 删除失败", { ids, error: errorMessage });
@@ -882,6 +1064,10 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       );
     }
     this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+    this.pushProductFlowLog("removeProductsByIds.done", {
+      ids,
+      ...this.getProductStoreSnapshot()
+    });
     this.logInfo("removeProductsByIds 完成", { remaining: this.store.list.length });
   }
   /**
@@ -890,6 +1076,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    */
   async refreshProducts() {
     const tTotal = performance.now();
+    this.pushProductFlowLog("refreshProducts.start", this.getProductStoreSnapshot());
     this.logInfo("refreshProducts 开始");
     const products = await this.loadProductsByServer();
     if (products && products.length > 0) {
@@ -901,6 +1088,11 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("refreshProducts: 服务器未返回数据");
     }
     (0, import_product.perfMark)("refreshProducts", performance.now() - tTotal, { count: this.store.list.length });
+    this.pushProductFlowLog("refreshProducts.done", {
+      count: this.store.list.length,
+      durationMs: Math.round(performance.now() - tTotal),
+      ...this.getProductStoreSnapshot()
+    });
     return this.store.list;
   }
   /**
@@ -952,31 +1144,144 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     }
   }
   /**
-   * 保存商品数据到 IndexDB（平铺存储）
-   * @private
+   * 串行执行商品 IndexDB 写入，避免快照替换与增量 patch 并发交错。
+   *
+   * @example
+   * await this.runInProductIndexDBSaveQueue(async () => {
+   *   await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products)
+   * })
    */
-  async saveProductsToIndexDB(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 replaceProductsSnapshotInIndexDB(products, source) {
     if (!this.dbManager) {
-      this.logWarning("saveProductsToIndexDB: dbManager 不可用");
+      this.pushProductFlowLog("replaceProductsSnapshotInIndexDB.skip", {
+        source,
+        reason: "no_dbManager",
+        inputCount: products.length
+      });
+      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, import_product.perfMark)("saveProductsToIndexDB", performance.now() - t0, { count: products.length });
-      console.log(
-        `[Products] 已将 ${products.length} 个商品平铺保存到 IndexDB`
-      );
-      this.logInfo("商品数据已保存到 IndexDB", { productCount: products.length });
+      await this.runInProductIndexDBSaveQueue(async () => {
+        this.pushProductFlowLog("replaceProductsSnapshotInIndexDB.start", {
+          source,
+          writeStrategy: "clear+bulkUpdate",
+          inputCount: products.length,
+          storeListCount: this.store.list.length
+        });
+        this.logInfo("replaceProductsSnapshotInIndexDB 开始", { source, productCount: products.length });
+        const t0 = performance.now();
+        await this.dbManager.clear(INDEXDB_STORE_NAME);
+        this.pushProductFlowLog("replaceProductsSnapshotInIndexDB.cleared", {
+          source,
+          inputCount: products.length
+        });
+        if (products.length > 0) {
+          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+        }
+        const writeSeq = this.trackProductWrite(
+          source,
+          "clear+bulkUpdate",
+          products,
+          {},
+          "snapshot"
+        );
+        (0, import_product.perfMark)("replaceProductsSnapshotInIndexDB", performance.now() - t0, { count: products.length });
+        this.pushProductFlowLog("replaceProductsSnapshotInIndexDB.done", {
+          source,
+          writeSeq,
+          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.pushProductFlowLog("replaceProductsSnapshotInIndexDB.error", {
+        source,
         productCount: products.length,
         error: errorMessage
       });
+      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) {
+      this.pushProductFlowLog("patchProductsInIndexDB.skip", {
+        source,
+        hasDbManager: !!this.dbManager,
+        inputCount: products.length
+      });
+      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) {
+      this.pushProductFlowLog("patchProductsInIndexDB.skipNoId", { source, inputCount: products.length });
+      return;
+    }
+    try {
+      await this.runInProductIndexDBSaveQueue(async () => {
+        let writeMethod = "none";
+        this.pushProductFlowLog("patchProductsInIndexDB.start", {
+          source,
+          writeStrategy: "bulkUpdate-patch",
+          count: validProducts.length,
+          productIds: validProducts.map((p) => p.id),
+          storeListCount: this.store.list.length
+        });
+        this.logInfo("patchProductsInIndexDB 开始", { source, count: validProducts.length });
+        const t0 = performance.now();
+        if (typeof this.dbManager.bulkUpdate === "function") {
+          writeMethod = "bulkUpdate";
+          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, validProducts);
+        } else if (typeof this.dbManager.update === "function") {
+          writeMethod = "update";
+          for (const product of validProducts) {
+            await this.dbManager.update(INDEXDB_STORE_NAME, product);
+          }
+        }
+        const writeSeq = this.trackProductWrite(source, writeMethod, validProducts, mergeActions);
+        (0, import_product.perfMark)("patchProductsInIndexDB", performance.now() - t0, { count: validProducts.length });
+        this.pushProductFlowLog("patchProductsInIndexDB.done", {
+          source,
+          writeSeq,
+          writeMethod,
+          count: validProducts.length
+        });
+        this.logInfo("patchProductsInIndexDB 完成", { source, count: validProducts.length });
+      });
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.pushProductFlowLog("patchProductsInIndexDB.error", {
+        source,
+        error: errorMessage,
+        productCount: validProducts.length
+      });
+      this.logError("增量保存商品到 IndexDB 失败", {
+        source,
+        error: errorMessage,
+        productCount: validProducts.length
+      });
     }
   }
   /**
@@ -999,6 +1304,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   async preload() {
     console.log("[Products] 开始预加载数据...");
     const tTotal = performance.now();
+    this.pushProductFlowLog("preload.start", this.getProductStoreSnapshot());
     this.logInfo("开始预加载数据");
     try {
       const tIndexDB = performance.now();
@@ -1023,6 +1329,12 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
           duration: `${Math.round(performance.now() - tTotal)}ms`,
           source: "IndexDB"
         });
+        this.pushProductFlowLog("preload.done", {
+          source: "IndexDB",
+          loadedCount: cachedData.length,
+          ...this.getProductStoreSnapshot()
+        });
+        this.lastPreloadCompletedAtMs = Date.now();
         return;
       }
       console.log("[Products] IndexDB 中没有缓存数据，从服务器加载...");
@@ -1050,7 +1362,14 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         duration: `${Math.round(performance.now() - tTotal)}ms`,
         source: "Server"
       });
+      this.pushProductFlowLog("preload.done", {
+        source: "Server",
+        loadedCount: products.length,
+        ...this.getProductStoreSnapshot()
+      });
+      this.lastPreloadCompletedAtMs = Date.now();
     } else {
+      this.pushProductFlowLog("preload.empty", this.getProductStoreSnapshot());
       (0, import_product.perfMark)("preload(empty)", performance.now() - tTotal, { source: "empty" });
       this.logWarning("预加载完成但未获取到数据", {
         duration: `${Math.round(performance.now() - tTotal)}ms`
@@ -1096,6 +1415,17 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         action_filed: data.action_filed
       });
       this.pendingSyncMessages.push({ ...data, _channelKey: channelKey });
+      this.pushProductFlowLog("pubsub.messageEnqueued", {
+        channelKey,
+        action: data.action,
+        operation: data.operation,
+        id: data.id,
+        ids: data.ids,
+        hasBody: !!data.body,
+        changeTypes: data.change_types,
+        pendingSyncCount: this.pendingSyncMessages.length,
+        debounceMs: PRODUCT_SYNC_DEBOUNCE_MS
+      });
       if (this.syncTimer) {
         clearTimeout(this.syncTimer);
       }
@@ -1148,6 +1478,10 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     this.pendingSyncMessages = [];
     if (messages.length === 0)
       return;
+    this.pushProductFlowLog("processProductSyncMessages.start", {
+      messageCount: messages.length,
+      ...this.getProductStoreSnapshot()
+    });
     this.logInfo("processProductSyncMessages: 开始处理", { count: messages.length });
     const deleteIds = [];
     const bodyUpdates = /* @__PURE__ */ new Map();
@@ -1202,22 +1536,64 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     const uniqueDeleteIds = [...new Set(deleteIds)];
     const uniqueSSEIds = [...new Set(sseRefreshIds)];
     const uniquePriceIds = [...new Set(priceRefreshIds)];
+    this.pushProductFlowLog("processProductSyncMessages.parsed", {
+      deleteIds: uniqueDeleteIds,
+      bodyUpdateIds: [...bodyUpdates.keys()],
+      sseRefreshIds: uniqueSSEIds,
+      priceRefreshIds: uniquePriceIds,
+      shouldClearPriceCache
+    });
     if (uniqueDeleteIds.length > 0) {
       await this.removeProductsByIds(uniqueDeleteIds);
     }
+    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;
     }
+    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", {
         requestedCount: uniqueSSEIds.length,
         receivedCount: freshProducts.length
       });
     }
+    const patchProducts = [...patchProductMap.values()];
+    if (patchProducts.length > 0) {
+      await this.patchProductsInIndexDB(
+        patchProducts,
+        "pubsub.processProductSyncMessages",
+        patchMergeActions
+      );
+      this.pushProductFlowLog("processProductSyncMessages.patchDone", {
+        patchCount: patchProducts.length,
+        patchProductIds: patchProducts.map((p) => p.id)
+      });
+    }
+    if (storeMutated) {
+      this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+    }
     const allChangedIds = [.../* @__PURE__ */ new Set([
       ...Array.from(bodyUpdates.keys()),
       ...uniqueSSEIds,
@@ -1233,6 +1609,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     });
     const hasChanges = uniqueDeleteIds.length > 0 || allChangedIds.length > 0 || shouldClearPriceCache;
     if (!hasChanges) {
+      this.pushProductFlowLog("processProductSyncMessages.noChanges", {});
       this.logInfo("processProductSyncMessages: 没有变更，不触发 onProductsSyncCompleted");
       return;
     }
@@ -1248,6 +1625,14 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, {
       changedIds: allChangedIds
     });
+    this.pushProductFlowLog("processProductSyncMessages.done", {
+      deleteCount: uniqueDeleteIds.length,
+      bodyUpdateCount: bodyUpdates.size,
+      sseRefreshCount: uniqueSSEIds.length,
+      allChangedIds,
+      shouldClearPriceCache,
+      ...this.getProductStoreSnapshot()
+    });
   }
   /**
    * 通过 SSE 按 ids 增量拉取商品数据
@@ -1281,19 +1666,32 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   /**
    * 将 body 完整数据直接覆盖到本地 store（不调用报价单接口）
    * 已存在的 → 直接替换；不存在的 → 追加
-   * 同时更新 Map 缓存、IndexDB，触发 onProductsChanged
-   * 价格缓存由 processProductSyncMessages 末尾统一清除
+   *
+   * @example
+   * await this.applyBodyUpdatesToStore(bodyUpdates, { skipIndexDB: true })
    */
-  async applyBodyUpdatesToStore(bodyUpdates) {
+  async applyBodyUpdatesToStore(bodyUpdates, options) {
+    const changedProductIds = [...bodyUpdates.keys()];
+    this.pushProductFlowLog("applyBodyUpdatesToStore.start", {
+      changedProductIds,
+      count: bodyUpdates.size,
+      skipIndexDB: !!(options == null ? void 0 : options.skipIndexDB),
+      ...this.getProductStoreSnapshot()
+    });
     this.logInfo("applyBodyUpdatesToStore: 开始", { count: bodyUpdates.size });
     let updatedCount = 0;
     let newCount = 0;
     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;
     });
@@ -1301,31 +1699,51 @@ var ProductsModule = class extends import_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(import_types.ProductsHooks.onProductsChanged, this.store.list);
+    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.pushProductFlowLog("applyBodyUpdatesToStore.done", {
+      changedProductIds,
+      updatedCount,
+      newCount,
+      totalCount: this.store.list.length,
+      indexDbPatchCount: (options == null ? void 0 : options.skipIndexDB) ? 0 : changedProducts.length
+    });
     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) {
+  async mergeProductsToStore(freshProducts, options) {
     const freshMap = /* @__PURE__ */ new Map();
     for (const p of freshProducts) {
       freshMap.set(p.id, 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;
@@ -1333,17 +1751,38 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     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.pushProductFlowLog("mergeProductsToStore.start", {
+      changedProductIds,
+      incomingCount: freshProducts.length,
+      skipIndexDB: !!(options == null ? void 0 : options.skipIndexDB),
+      ...this.getProductStoreSnapshot()
+    });
     this.store.list = updatedList;
     this.syncProductsMap();
-    await this.saveProductsToIndexDB(this.store.list);
+    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.pushProductFlowLog("mergeProductsToStore.done", {
+      changedProductIds,
+      updatedCount,
+      newCount,
+      totalCount: this.store.list.length,
+      indexDbPatchCount: (options == null ? void 0 : options.skipIndexDB) ? 0 : changedProducts.length
+    });
     this.logInfo("mergeProductsToStore: 合并完成", {
       updatedCount,
       newCount,
       totalCount: this.store.list.length
     });
-    this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
+    return { changedProducts, mergeActions, updatedCount, newCount };
   }
   /**
    * 静默全量刷新：后台重新拉取全量 SSE 数据并更新本地
@@ -1352,6 +1791,22 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    */
   async silentRefresh() {
     const t0 = performance.now();
+    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) {
+      this.pushProductFlowLog("silentRefresh.skipped", {
+        elapsedSincePreloadMs: this.lastPreloadCompletedAtMs > 0 ? elapsedSincePreload : null,
+        elapsedSinceFullFetchMs: this.lastServerFullFetchAtMs > 0 ? elapsedSinceFullFetch : null,
+        minIntervalMs: PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS,
+        ...this.getProductStoreSnapshot()
+      });
+      return this.store.list;
+    }
+    this.pushProductFlowLog("silentRefresh.start", {
+      note: "会调用 loadProductsByServer → replaceProductsSnapshotInIndexDB",
+      ...this.getProductStoreSnapshot()
+    });
     this.logInfo("silentRefresh 开始");
     try {
       const products = await this.loadProductsByServer();
@@ -1361,17 +1816,24 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         this.clearPriceCache();
         this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
         await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, null);
+        this.pushProductFlowLog("silentRefresh.done", {
+          productCount: products.length,
+          durationMs: Math.round(performance.now() - t0),
+          ...this.getProductStoreSnapshot()
+        });
         this.logInfo("silentRefresh 完成", {
           productCount: products.length,
           duration: `${Math.round(performance.now() - t0)}ms`
         });
       } else {
+        this.pushProductFlowLog("silentRefresh.empty", {});
         this.logWarning("silentRefresh: 服务器未返回数据");
       }
       (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.pushProductFlowLog("silentRefresh.failed", { error: errorMessage });
       this.logError("silentRefresh 失败", {
         duration: `${Math.round(performance.now() - t0)}ms`,
         error: errorMessage