@pisell/pisellos 2.3.65 → 2.3.67

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

@@ -39,8 +39,8 @@ var import_orderCollectionIdentity = require("../../../modules/Order/utils/order
 var import_types = require("./types");
 var import_payment_utils = require("../../../modules/Order/payment-utils");
 var INDEXDB_STORE_NAME = "orders";
-var ORDER_STORAGE_KEY_FIELD = "__order_storage_key";
 var ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY = "server_order_last_full_fetch_at";
+var ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY = "server_order_last_full_fetch_shop_id";
 var ORDER_SYNC_THROTTLE_MS_STORAGE_KEY = "order_sync_throttle_ms";
 var DEFAULT_ORDER_SYNC_THROTTLE_MS = 2e3;
 var ORDER_SQLITE_DEDUPE_MS = 15e3;
@@ -192,18 +192,21 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 仅记录计数与订单标识，不输出商品、预约、支付或客户明细。
    */
   normalizeOrderCollectionsForIngress(order, source) {
-    const sourceOrder = (0, import_lodash_es.cloneDeep)(order);
-    const sourceOrderRecord = sourceOrder;
+    const sourceOrderRecord = order;
+    let sourceOrder = sourceOrderRecord;
     if (Array.isArray(sourceOrderRecord.payments)) {
-      sourceOrderRecord.payments = sourceOrderRecord.payments.map((payment) => {
-        if (!(0, import_payment_utils.isPendingOrderPayment)(payment) || (0, import_payment_utils.getOrderPaymentIdentityKeys)(payment).some((key) => key.startsWith("unique_payment_number:"))) {
-          return payment;
-        }
-        return {
-          ...payment,
-          [PENDING_PAYMENT_WITHOUT_UNIQUE_MARKER]: true
-        };
-      });
+      sourceOrder = {
+        ...sourceOrderRecord,
+        payments: sourceOrderRecord.payments.map((payment) => {
+          if (!(0, import_payment_utils.isPendingOrderPayment)(payment) || (0, import_payment_utils.getOrderPaymentIdentityKeys)(payment).some((key) => key.startsWith("unique_payment_number:"))) {
+            return payment;
+          }
+          return {
+            ...payment,
+            [PENDING_PAYMENT_WITHOUT_UNIQUE_MARKER]: true
+          };
+        })
+      };
     }
     const result = (0, import_orderCollectionIdentity.normalizeOrderCollections)(sourceOrder);
     const normalizedOrderRecord = result.order;
@@ -525,11 +528,65 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return DEFAULT_ORDER_SYNC_THROTTLE_MS;
   }
   async preload() {
-    const orders = await this.loadOrdersByServer();
+    const preloadStartedAt = Date.now();
+    let cachedOrders = null;
+    let sqliteLoadTimings;
+    if (this.dbManager) {
+      try {
+        cachedOrders = await this.loadOrdersFromSQLite({
+          throwOnError: true,
+          onTiming: (timings) => {
+            sqliteLoadTimings = timings;
+          }
+        });
+      } catch (error) {
+        this.logWarning("preload-SQLite读取失败，回退远端全量拉取", {
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+    if (cachedOrders !== null && this.hasPulledOrdersToday()) {
+      const memoryPrepareStartedAt = performance.now();
+      const memoryOrders = this.prepareNormalizedOrdersForMemoryList(cachedOrders);
+      const memoryPrepareMs = +(performance.now() - memoryPrepareStartedAt).toFixed(2);
+      this.store.list = memoryOrders;
+      const syncMapStartedAt = performance.now();
+      this.syncOrdersMap();
+      const syncMapMs = +(performance.now() - syncMapStartedAt).toFixed(2);
+      const onOrdersLoadedStartedAt = performance.now();
+      await this.core.effects.emit(import_types.OrderHooks.onOrdersLoaded, this.store.list);
+      const onOrdersLoadedMs = +(performance.now() - onOrdersLoadedStartedAt).toFixed(2);
+      const emitOrdersChangedStartedAt = performance.now();
+      await this.emitOrdersChanged([], "preload.sqlite");
+      const emitOrdersChangedMs = +(performance.now() - emitOrdersChangedStartedAt).toFixed(2);
+      this.logInfo("预加载完成", {
+        trigger: "preload",
+        source: "SQLite",
+        orderCount: this.store.list.length,
+        duration: `${Date.now() - preloadStartedAt}ms`,
+        stages: {
+          ...sqliteLoadTimings || {},
+          memoryPrepareMs,
+          syncMapMs,
+          onOrdersLoadedMs,
+          emitOrdersChangedMs
+        }
+      });
+      return;
+    }
+    const orders = await this.loadOrdersByServer({
+      trigger: "preload"
+    });
     this.store.list = (0, import_lodash_es.cloneDeep)(orders);
     this.syncOrdersMap();
     await this.emitOrdersChanged([], "preload");
     await this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
+    this.logInfo("预加载完成", {
+      trigger: "preload",
+      source: "Server",
+      orderCount: this.store.list.length,
+      duration: `${Date.now() - preloadStartedAt}ms`
+    });
   }
   getOrders() {
     return this.store.list;
@@ -750,13 +807,16 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.logInfo("updateLocalPayment-变更事件完成", paymentContext);
     return { order: nextOrder, payment: nextPayment, previousPayment };
   }
-  async loadOrdersByServer() {
+  async loadOrdersByServer(options = {}) {
     var _a;
     let orderList = [];
+    let hasFetchedRemoteSnapshot = false;
+    const trigger = options.trigger || "unknown";
     const protectedOrdersBeforeRemoteFetch = (await this.loadOrdersFromSQLite()).filter(
       (order) => this.shouldProtectLocalOrderFromRemoteSnapshot(order)
     );
     this.logInfo("loadOrdersByServer-开始", {
+      trigger,
       hasOrderDataSource: !!this.orderDataSource,
       query: ((_a = this.store) == null ? void 0 : _a.createdAtQuery) || null,
       protectedLocalOrderCount: protectedOrdersBeforeRemoteFetch.length,
@@ -774,25 +834,36 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         });
         orderList = data || [];
         this.logInfo("loadOrdersByServer-SSE拉取成功", {
+          trigger,
           count: orderList.length
         });
-        this.markOrderPulledAtNow();
+        hasFetchedRemoteSnapshot = true;
         this.lastServerFullFetchAtMs = Date.now();
       } catch {
         this.logInfo("loadOrdersByServer-SSE拉取失败，保持当前内存订单");
         return this.store.list;
       }
     }
-    const mergedOrders = await this.replaceOrdersSnapshotInSQLite(
+    if (hasFetchedRemoteSnapshot) {
+      this.clearOrderSnapshotMarker();
+    }
+    const {
+      orders: mergedOrders,
+      persisted: isRemoteSnapshotPersisted
+    } = await this.replaceOrdersSnapshotInSQLite(
       orderList,
       "loadOrdersByServer",
       protectedOrdersBeforeRemoteFetch
     );
+    if (hasFetchedRemoteSnapshot && isRemoteSnapshotPersisted) {
+      this.markOrderPulledAtNow();
+    }
     const memoryOrders = this.normalizeOrdersForMemoryList(
       mergedOrders,
       "loadOrdersByServer.memory"
     );
     this.logInfo("loadOrdersByServer-结束", {
+      trigger,
       count: memoryOrders.length,
       persistedCount: mergedOrders.length,
       sqliteOnlyDraftCount: mergedOrders.length - memoryOrders.length
@@ -805,21 +876,34 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 拿到完整数据后一次性替换 store，触发订单变更与同步完成事件
    * @returns 刷新后的订单列表
    */
-  async silentRefresh() {
+  async silentRefresh(options = {}) {
     const startTime = Date.now();
+    const trigger = options.trigger || "background";
     const elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
     if (this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS) {
+      this.logInfo("silentRefresh 跳过全量 SSE", {
+        trigger,
+        reason: "within_min_interval",
+        minIntervalMs: ORDER_SILENT_REFRESH_MIN_INTERVAL_MS,
+        elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+        orderCount: this.store.list.length
+      });
       return this.store.list;
     }
-    this.logInfo("silentRefresh 开始");
+    this.logInfo("silentRefresh 开始", {
+      trigger,
+      elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+      orderCount: this.store.list.length
+    });
     try {
       this.updateCreateStore();
-      const orders = await this.loadOrdersByServer();
+      const orders = await this.loadOrdersByServer({ trigger });
       this.store.list = (0, import_lodash_es.cloneDeep)(orders);
       this.syncOrdersMap();
       await this.emitOrdersChanged([], "silentRefresh");
       await this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
       this.logInfo("silentRefresh 完成", {
+        trigger,
         orderCount: orders.length,
         duration: `${Date.now() - startTime}ms`
       });
@@ -827,6 +911,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("silentRefresh 失败", {
+        trigger,
         duration: `${Date.now() - startTime}ms`,
         error: errorMessage
       });
@@ -835,6 +920,12 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   }
   normalizeOrderForMemoryList(order, source = "normalizeOrderForMemoryList") {
     const normalizedOrder = this.normalizeOrderCollectionsForIngress(order, source);
+    return this.prepareNormalizedOrderForMemoryList(normalizedOrder);
+  }
+  /**
+   * 将已经完成集合规范化的订单转换为内存身份，不重复扫描 products/bookings/payments。
+   */
+  prepareNormalizedOrderForMemoryList(normalizedOrder) {
     const externalSaleNumber = normalizedOrder == null ? void 0 : normalizedOrder.external_sale_number;
     if (this.isDraftOrder(normalizedOrder) && !this.hasRealOrderId(normalizedOrder)) {
       return normalizedOrder;
@@ -850,6 +941,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       order_id: externalSaleNumber
     };
   }
+  prepareNormalizedOrdersForMemoryList(orders) {
+    return orders.map((order) => this.prepareNormalizedOrderForMemoryList(order)).filter((order) => this.shouldKeepOrderInMemory(order));
+  }
   normalizeOrdersForMemoryList(orders, source) {
     return orders.map((order) => this.normalizeOrderForMemoryList(order, source)).filter((order) => this.shouldKeepOrderInMemory(order));
   }
@@ -1534,7 +1628,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const patchedOrders = [];
     const remoteProductMembershipChanges = [];
     const forceWriteStorageKeys = /* @__PURE__ */ new Set();
-    const storageKeyMigrations = [];
     const mergeActions = {};
     const existingProductsHaveStableIdentity = this.store.list.map(
       (order) => this.doProductsHaveStableMembershipIdentity(
@@ -1559,7 +1652,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       const mergeKey = storageKey || (fresh.order_id !== void 0 && fresh.order_id !== null ? this.getIdKey(fresh.order_id) : "");
       if (matchIndex >= 0) {
         const existingOrder = updatedList[matchIndex];
-        const previousStorageKey = this.getPersistedOrderStorageKey(existingOrder);
         if (this.isPendingSyncOrder(existingOrder) && this.isRemoteEchoMergeSource(source)) {
           this.logInfo("mergeOrdersToStore-跳过 pending 订单远端覆盖", {
             source,
@@ -1621,14 +1713,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
             }
           }
         }
-        const nextStorageKey = this.getOrderStorageKey(mergedOrder);
-        if (previousStorageKey && nextStorageKey && previousStorageKey !== nextStorageKey) {
-          storageKeyMigrations.push({
-            orderId: mergedOrder.order_id ?? existingOrder.order_id ?? fresh.order_id ?? null,
-            from: previousStorageKey,
-            to: nextStorageKey
-          });
-        }
         updatedList[adjustedMatchIndex] = mergedOrder;
         existingProductsHaveStableIdentity[adjustedMatchIndex] = mergedProductsHaveStableIdentity;
         if (membershipChange) {
@@ -1666,7 +1750,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       patchedOrders,
       source,
       mergeActions,
-      { storageKeyMigrations },
+      {},
       forceWriteStorageKeys
     );
     this.logInfo("mergeOrdersToStore-结束", {
@@ -1871,13 +1955,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     }
     return "";
   }
-  getPersistedOrderStorageKey(order) {
-    const persistedStorageKey = order == null ? void 0 : order[ORDER_STORAGE_KEY_FIELD];
-    if (persistedStorageKey !== void 0 && persistedStorageKey !== null && persistedStorageKey !== "") {
-      return String(persistedStorageKey);
-    }
-    return this.getOrderStorageKey(order);
-  }
   getOrderIdentityMatchKeys(order) {
     return this.getOrderIdentityEntries(order).map((entry) => `${entry.field}:${entry.key}`);
   }
@@ -2137,20 +2214,29 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return { list, removedCount };
   }
   /**
-   * 当前订单拉取窗口：
-   * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
-   * - 无法解析时退化为自然日窗口
+   * 当前订单缓存可复用窗口。
+   * start_time 模式使用精确的营业日起止时间；配置缺失或异常时退化为自然日。
    */
-  getCurrentPullWindow() {
-    var _a, _b;
+  getCurrentOrderCacheWindow() {
+    var _a;
     const now = (0, import_dayjs.default)();
-    const range = (_b = (_a = this.store) == null ? void 0 : _a.createdAtQuery) == null ? void 0 : _b.sales_time_between;
-    if (Array.isArray(range) && range.length >= 2) {
-      const startAt2 = (0, import_dayjs.default)(range[0]);
-      const endExclusiveAt = (0, import_dayjs.default)(range[1]);
-      if (startAt2.isValid() && endExclusiveAt.isValid() && endExclusiveAt.isAfter(startAt2)) {
-        return { startAt: startAt2, endExclusiveAt };
+    try {
+      const appPlugin = this.core.getPlugin("app");
+      const app = appPlugin == null ? void 0 : appPlugin.getApp();
+      const coreData = app == null ? void 0 : app.data.store.getStore().getDataByModel("core");
+      const boundary = (_a = coreData == null ? void 0 : coreData.core) == null ? void 0 : _a.operating_day_boundary;
+      if ((boundary == null ? void 0 : boundary.type) === "start_time") {
+        const boundaryTime = String(boundary.time || "").trim();
+        const todayBoundary = (0, import_dayjs.default)(`${now.format("YYYY-MM-DD")} ${boundaryTime}`);
+        if (todayBoundary.isValid()) {
+          const startAt2 = now.isBefore(todayBoundary) ? todayBoundary.subtract(1, "day") : todayBoundary;
+          return {
+            startAt: startAt2,
+            endExclusiveAt: startAt2.add(1, "day")
+          };
+        }
       }
+    } catch {
     }
     const startAt = now.startOf("day");
     return { startAt, endExclusiveAt: startAt.add(1, "day") };
@@ -2159,17 +2245,51 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const lastFullFetchAt = this.getStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY);
     if (!lastFullFetchAt)
       return false;
+    const currentShopId = this.getCurrentShopId();
+    const lastFullFetchShopId = this.getStorageItem(
+      ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY
+    );
+    if (!currentShopId || !lastFullFetchShopId || currentShopId !== lastFullFetchShopId) {
+      return false;
+    }
     const parsed = (0, import_dayjs.default)(lastFullFetchAt);
     if (!parsed.isValid())
       return false;
-    const { startAt, endExclusiveAt } = this.getCurrentPullWindow();
+    const { startAt, endExclusiveAt } = this.getCurrentOrderCacheWindow();
     return (parsed.isAfter(startAt) || parsed.isSame(startAt)) && parsed.isBefore(endExclusiveAt);
   }
   markOrderPulledAtNow() {
+    const currentShopId = this.getCurrentShopId();
+    if (!currentShopId)
+      return;
     this.setStorageItem(
       ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY,
       (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss")
     );
+    this.setStorageItem(
+      ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY,
+      currentShopId
+    );
+  }
+  clearOrderSnapshotMarker() {
+    this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, "");
+    this.setStorageItem(ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY, "");
+  }
+  getCurrentShopId() {
+    var _a;
+    try {
+      const appPlugin = this.core.getPlugin("app");
+      const app = appPlugin == null ? void 0 : appPlugin.getApp();
+      if (!app)
+        return null;
+      const coreData = app.data.store.getStore().getDataByModel("core");
+      const shopId = (_a = coreData == null ? void 0 : coreData.core) == null ? void 0 : _a.id;
+      if (shopId === void 0 || shopId === null || shopId === "")
+        return null;
+      return String(shopId);
+    } catch {
+      return null;
+    }
   }
   getStorageItem(key) {
     var _a;
@@ -2196,15 +2316,29 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     } catch {
     }
   }
-  async loadOrdersFromSQLite() {
+  async loadOrdersFromSQLite(options = {}) {
+    var _a;
     if (!this.dbManager)
       return [];
     try {
+      const loadStartedAt = performance.now();
+      const rawReadStartedAt = performance.now();
       const orders = await this.dbManager.getAll(INDEXDB_STORE_NAME);
-      return (orders || []).map(
+      const sqliteRawReadMs = +(performance.now() - rawReadStartedAt).toFixed(2);
+      const normalizeStartedAt = performance.now();
+      const normalizedOrders = (orders || []).map(
         (order) => this.normalizeOrderCollectionsForIngress(order, "loadOrdersFromSQLite")
       );
-    } catch {
+      const sqliteNormalizeMs = +(performance.now() - normalizeStartedAt).toFixed(2);
+      (_a = options.onTiming) == null ? void 0 : _a.call(options, {
+        sqliteRawReadMs,
+        sqliteNormalizeMs,
+        sqliteLoadTotalMs: +(performance.now() - loadStartedAt).toFixed(2)
+      });
+      return normalizedOrders;
+    } catch (error) {
+      if (options.throwOnError)
+        throw error;
       return [];
     }
   }
@@ -2308,18 +2442,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         throw new Error("订单 SQLite 数据库未初始化");
       return;
     }
-    const migrationTargetStorageKeys = new Set(
-      (options.storageKeyMigrations || []).map((migration) => migration.to)
-    );
-    const ordersSnapshot = (0, import_lodash_es.cloneDeep)(orders).map((order) => this.normalizeOrderCollectionsForIngress(order, `${source}.sqliteIngress`)).map((order) => {
-      const storageKey = this.getOrderStorageKey(order);
-      if (!storageKey || !migrationTargetStorageKeys.has(storageKey))
-        return order;
-      return {
-        ...order,
-        [ORDER_STORAGE_KEY_FIELD]: storageKey
-      };
-    }).filter((order) => this.getOrderStorageKey(order));
+    const ordersSnapshot = (0, import_lodash_es.cloneDeep)(orders).map((order) => this.normalizeOrderCollectionsForIngress(order, `${source}.sqliteIngress`)).filter((order) => this.getOrderStorageKey(order));
     if (ordersSnapshot.length === 0) {
       return;
     }
@@ -2336,17 +2459,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     if (compactedToWrite.length === 0) {
       return;
     }
-    const writtenStorageKeys = new Set(
-      compactedToWrite.map((order) => this.getOrderStorageKey(order)).filter(Boolean)
-    );
-    const storageKeyMigrations = /* @__PURE__ */ new Map();
-    for (const migration of options.storageKeyMigrations || []) {
-      if (!writtenStorageKeys.has(migration.to))
-        continue;
-      if (writtenStorageKeys.has(migration.from))
-        continue;
-      storageKeyMigrations.set(migration.from, migration);
-    }
     try {
       await this.runInOrderSQLiteSaveQueue(async () => {
         let writeMethod = "none";
@@ -2370,30 +2482,6 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           throw new Error("订单 SQLite 数据库不支持写入");
         }
         this.recordRecentSqliteWrite(source, compactedToWrite);
-        if (writeMethod !== "none") {
-          for (const migration of storageKeyMigrations.values()) {
-            try {
-              await this.dbManager.delete(INDEXDB_STORE_NAME, migration.from);
-              this.recentSqliteWriteByStorageKey.delete(migration.from);
-              for (const order of orders) {
-                if (this.getOrderStorageKey(order) !== migration.to)
-                  continue;
-                const orderRecord = order;
-                if (String(orderRecord[ORDER_STORAGE_KEY_FIELD] ?? "") !== migration.from)
-                  continue;
-                orderRecord[ORDER_STORAGE_KEY_FIELD] = migration.to;
-              }
-            } catch (error) {
-              this.logError("删除订单旧 SQLite storage key 失败", {
-                source,
-                order_id: migration.orderId,
-                oldStorageKey: migration.from,
-                newStorageKey: migration.to,
-                error: error instanceof Error ? error.message : String(error)
-              });
-            }
-          }
-        }
         this.logInfo("patchOrdersInSQLite-完成", {
           source,
           count: compactedToWrite.length,
@@ -2472,14 +2560,17 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 用于 SSE 全量拉取与营业日窗口裁剪。
    *
    * @example
-   * await this.replaceOrdersSnapshotInSQLite(orderList)
+   * const { orders, persisted } = await this.replaceOrdersSnapshotInSQLite(orderList, 'refresh')
    */
   async replaceOrdersSnapshotInSQLite(orderList, source, protectedOrdersBeforeRemoteFetch = []) {
     if (!this.dbManager) {
-      return this.compactOrderListByIdentity(
-        orderList.map((order) => this.normalizeRemoteSyncedOrder(order)),
-        `${source}.snapshotNoDb`
-      ).list;
+      return {
+        orders: this.compactOrderListByIdentity(
+          orderList.map((order) => this.normalizeRemoteSyncedOrder(order)),
+          `${source}.snapshotNoDb`
+        ).list,
+        persisted: false
+      };
     }
     const remoteSnapshot = (0, import_lodash_es.cloneDeep)(orderList).map(
       (order) => this.normalizeOrderCollectionsForIngress(order, `${source}.remoteIngress`)
@@ -2488,6 +2579,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       remoteSnapshot.map((order) => this.normalizeRemoteSyncedOrder(order)),
       `${source}.remoteSnapshot`
     ).list;
+    let persisted = false;
     try {
       await this.runInOrderSQLiteSaveQueue(async () => {
         const existingOrders = typeof this.dbManager.getAll === "function" ? await this.dbManager.getAll(INDEXDB_STORE_NAME) : [];
@@ -2552,13 +2644,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           count: mergedSnapshot.length
         });
       });
+      persisted = true;
     } catch (error) {
       this.logError("全量保存订单到 SQLite 失败", {
         error: error instanceof Error ? error.message : String(error),
         orderList: remoteSnapshot.length
       });
     }
-    return mergedSnapshot;
+    return { orders: mergedSnapshot, persisted };
   }
   /**
    * 清空订单模块的内存数据和本地 SQLite 订单表。
@@ -2574,7 +2667,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         await this.dbManager.clear(INDEXDB_STORE_NAME);
       });
     }
-    this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, "");
+    this.clearOrderSnapshotMarker();
     this.emitOrdersChanged([], "clear");
   }
 };

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

@@ -25,6 +25,7 @@ export declare class ProductsModule extends BaseModule implements Module {
     private quotationBridgeLoadedKey?;
     private quotationBridgeRefreshPromise?;
     private quotationBridgeRefreshKey?;
+    private quotationBridgeUpdatedCallback?;
     private quotationScheduleCache;
     private quotationScheduleCacheSource;
     private quotationScheduleCacheLoaded;
@@ -72,6 +73,7 @@ export declare class ProductsModule extends BaseModule implements Module {
         scheduleModule?: any;
         channel?: string;
         customer_id?: number | string;
+        onQuotationUpdated?: () => void;
     }): Promise<void>;
     /**
      * 刷新桥接器内的报价单列表。
@@ -181,7 +183,9 @@ export declare class ProductsModule extends BaseModule implements Module {
     /**
      * 通过 ProductDataSource SSE 加载完整商品列表
      */
-    loadProductsByServer(): Promise<any>;
+    loadProductsByServer(options?: {
+        trigger?: string;
+    }): Promise<any>;
     /**
      * 纯请求方法：通过 HTTP 接口获取商品列表（无副作用，不触发事件、不写 IndexDB）
      * @param params 查询参数
@@ -331,7 +335,9 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
      * @returns 刷新后的商品列表
      */
-    silentRefresh(): Promise<ProductData[]>;
+    silentRefresh(options?: {
+        trigger?: string;
+    }): Promise<ProductData[]>;
     /**
      * 销毁同步资源（取消 pubsub 订阅、清除定时器）
      */