@pisell/pisellos 2.3.62 → 2.3.64

package/lib/server/modules/floor-plan/index.js

@@ -25,7 +25,6 @@ module.exports = __toCommonJS(floor_plan_exports);
 var import_BaseModule = require("../../../modules/BaseModule");
 var import_types = require("./types");
 var FLOOR_PLAN_SYNC_DEBOUNCE_MS = 3e3;
-var FLOOR_PLAN_STORE_NAME = "floor_plans";
 var FloorPlanModule = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
@@ -51,7 +50,6 @@ var FloorPlanModule = class extends import_BaseModule.BaseModule {
     if (appPlugin) {
       const app = appPlugin.getApp();
       this.logger = app.logger;
-      this.dbManager = app.sqlite || app.dbManager;
     }
     this.initFloorPlanDataSource();
     this.setupFloorPlanSync();
@@ -161,45 +159,6 @@ var FloorPlanModule = class extends import_BaseModule.BaseModule {
       return [];
     }
   }
-  async loadListFromSQLite() {
-    if (!this.dbManager)
-      return [];
-    try {
-      const list = await this.dbManager.getAll(FLOOR_PLAN_STORE_NAME);
-      return Array.isArray(list) ? list : [];
-    } catch (error) {
-      this.logWarning("从 SQLite 读取平面图失败", {
-        error: error instanceof Error ? error.message : String(error)
-      });
-      return [];
-    }
-  }
-  async saveListToSQLite(list) {
-    if (!this.dbManager)
-      return;
-    try {
-      await this.dbManager.clear(FLOOR_PLAN_STORE_NAME);
-      if (list.length > 0) {
-        await this.dbManager.bulkAdd(FLOOR_PLAN_STORE_NAME, list);
-      }
-    } catch (error) {
-      this.logWarning("保存平面图到 SQLite 失败", {
-        count: list.length,
-        error: error instanceof Error ? error.message : String(error)
-      });
-    }
-  }
-  async refreshListFromServer() {
-    const list = await this.loadListFromServer();
-    if (list.length === 0) {
-      this.logWarning("远端平面图刷新完成但列表为空");
-      return;
-    }
-    this.replaceStore(list);
-    await this.saveListToSQLite(list);
-    this.core.effects.emit(import_types.FloorPlanHooks.onFloorPlansChanged, this.getSortedList());
-    this.logInfo("远端平面图刷新完成", { count: list.length });
-  }
   async fetchByIdFromServer(id) {
     try {
       const res = await this.request.get(
@@ -231,19 +190,14 @@ var FloorPlanModule = class extends import_BaseModule.BaseModule {
   }
   async preload() {
     this.logInfo("开始预加载平面图列表");
-    const cachedList = await this.loadListFromSQLite();
-    if (cachedList.length > 0) {
-      this.replaceStore(cachedList);
+    const list = await this.loadListFromServer();
+    if (list.length > 0) {
+      this.replaceStore(list);
       this.core.effects.emit(import_types.FloorPlanHooks.onFloorPlansChanged, this.getSortedList());
-      this.logInfo("预加载完成（SQLite）", { count: cachedList.length });
-      void this.refreshListFromServer().catch((error) => {
-        this.logWarning("后台刷新平面图失败，继续使用本地数据", {
-          error: error instanceof Error ? error.message : String(error)
-        });
-      });
-      return;
+      this.logInfo("预加载完成", { count: list.length });
+    } else {
+      this.logWarning("预加载完成但列表为空");
     }
-    await this.refreshListFromServer();
   }
   initFloorPlanDataSource() {
     var _a, _b;
@@ -345,7 +299,6 @@ var FloorPlanModule = class extends import_BaseModule.BaseModule {
       }
     }
     if (changed) {
-      await this.saveListToSQLite(this.store.list);
       this.core.effects.emit(import_types.FloorPlanHooks.onFloorPlansChanged, this.getSortedList());
       this.core.effects.emit(import_types.FloorPlanHooks.onFloorPlanSyncCompleted, null);
     }
@@ -354,7 +307,6 @@ var FloorPlanModule = class extends import_BaseModule.BaseModule {
     this.store.list = [];
     this.store.map.clear();
     this.store.codeMap.clear();
-    await this.saveListToSQLite([]);
   }
   destroy() {
     var _a;

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

@@ -185,21 +185,16 @@ var MenuModule = class extends import_BaseModule.BaseModule {
       this.logWarning("loadMenuFromIndexDB: dbManager 不可用");
       return [];
     }
-    const startedAt = performance.now();
     try {
       const menuList = await this.dbManager.getAll(INDEXDB_STORE_NAME);
       this.logInfo("从 IndexDB 加载餐牌数据", {
-        menuCount: (menuList == null ? void 0 : menuList.length) ?? 0,
-        durationMs: +(performance.now() - startedAt).toFixed(2)
+        menuCount: (menuList == null ? void 0 : menuList.length) ?? 0
       });
       return menuList || [];
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Menu] 从 IndexDB 读取数据失败:", error);
-      this.logError("从 IndexDB 读取数据失败", {
-        durationMs: +(performance.now() - startedAt).toFixed(2),
-        error: errorMessage
-      });
+      this.logError("从 IndexDB 读取数据失败", { error: errorMessage });
       return [];
     }
   }
@@ -212,41 +207,20 @@ var MenuModule = class extends import_BaseModule.BaseModule {
       this.logWarning("saveMenuToIndexDB: dbManager 不可用");
       return;
     }
-    const startedAt = performance.now();
-    let clearDurationMs = 0;
-    let writeDurationMs = 0;
     this.logInfo("开始保存餐牌数据到 IndexDB", { menuCount: menuList.length });
     try {
-      const clearStartedAt = performance.now();
-      try {
-        await this.dbManager.clear(INDEXDB_STORE_NAME);
-      } finally {
-        clearDurationMs = +(performance.now() - clearStartedAt).toFixed(2);
-      }
-      const writeStartedAt = performance.now();
+      await this.dbManager.clear(INDEXDB_STORE_NAME);
       const savePromises = menuList.map(
         (menu) => this.dbManager.add(INDEXDB_STORE_NAME, menu)
       );
-      try {
-        await Promise.all(savePromises);
-      } finally {
-        writeDurationMs = +(performance.now() - writeStartedAt).toFixed(2);
-      }
+      await Promise.all(savePromises);
       console.log(`[Menu] 已将 ${menuList.length} 条餐牌数据保存到 IndexDB`);
-      this.logInfo("餐牌数据已保存到 IndexDB", {
-        menuCount: menuList.length,
-        clearDurationMs,
-        writeDurationMs,
-        totalDurationMs: +(performance.now() - startedAt).toFixed(2)
-      });
+      this.logInfo("餐牌数据已保存到 IndexDB", { menuCount: menuList.length });
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Menu] 保存数据到 IndexDB 失败:", error);
       this.logError("保存数据到 IndexDB 失败", {
         menuCount: menuList.length,
-        clearDurationMs,
-        writeDurationMs,
-        totalDurationMs: +(performance.now() - startedAt).toFixed(2),
         error: errorMessage
       });
     }

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

@@ -119,17 +119,13 @@ export declare class OrderModule extends BaseModule implements Module {
         payment: Record<string, any>;
         previousPayment: Record<string, any>;
     } | null>;
-    loadOrdersByServer(options?: {
-        trigger?: string;
-    }): Promise<OrderData[]>;
+    loadOrdersByServer(): Promise<OrderData[]>;
     /**
      * 静默全量刷新：后台重新拉取全量 SSE 订单数据并更新本地
      * 拿到完整数据后一次性替换 store，触发订单变更与同步完成事件
      * @returns 刷新后的订单列表
      */
-    silentRefresh(options?: {
-        trigger?: string;
-    }): Promise<OrderData[]>;
+    silentRefresh(): Promise<OrderData[]>;
     private normalizeOrderForMemoryList;
     private normalizeOrdersForMemoryList;
     private hasRealOrderId;
@@ -278,6 +274,7 @@ export declare class OrderModule extends BaseModule implements Module {
      * // => 'S-1001'
      */
     private getOrderStorageKey;
+    private getPersistedOrderStorageKey;
     private getOrderIdentityMatchKeys;
     private doOrdersShareIdentity;
     private findOrderIndexByIdentity;
@@ -294,14 +291,13 @@ export declare class OrderModule extends BaseModule implements Module {
     private logDuplicateOrders;
     private compactOrderListByIdentity;
     /**
-     * 当前订单缓存可复用窗口。
-     * start_time 模式使用精确的营业日起止时间；配置缺失或异常时退化为自然日。
+     * 当前订单拉取窗口：
+     * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
+     * - 无法解析时退化为自然日窗口
      */
-    private getCurrentOrderCacheWindow;
+    private getCurrentPullWindow;
     private hasPulledOrdersToday;
     private markOrderPulledAtNow;
-    private clearOrderSnapshotMarker;
-    private getCurrentShopId;
     private getStorageItem;
     private setStorageItem;
     private loadOrdersFromSQLite;
@@ -339,7 +335,7 @@ export declare class OrderModule extends BaseModule implements Module {
      * 用于 SSE 全量拉取与营业日窗口裁剪。
      *
      * @example
-     * const { orders, persisted } = await this.replaceOrdersSnapshotInSQLite(orderList, 'refresh')
+     * await this.replaceOrdersSnapshotInSQLite(orderList)
      */
     private replaceOrdersSnapshotInSQLite;
     /**

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;
@@ -525,47 +525,11 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return DEFAULT_ORDER_SYNC_THROTTLE_MS;
   }
   async preload() {
-    const preloadStartedAt = Date.now();
-    let cachedOrders = null;
-    if (this.dbManager) {
-      try {
-        cachedOrders = await this.loadOrdersFromSQLite({ throwOnError: true });
-      } catch (error) {
-        this.logWarning("preload-SQLite读取失败，回退远端全量拉取", {
-          error: error instanceof Error ? error.message : String(error)
-        });
-      }
-    }
-    if (cachedOrders !== null && this.hasPulledOrdersToday()) {
-      const memoryOrders = this.normalizeOrdersForMemoryList(
-        cachedOrders,
-        "preload.sqliteMemory"
-      );
-      this.store.list = (0, import_lodash_es.cloneDeep)(memoryOrders);
-      this.syncOrdersMap();
-      await this.core.effects.emit(import_types.OrderHooks.onOrdersLoaded, this.store.list);
-      await this.emitOrdersChanged([], "preload.sqlite");
-      this.logInfo("预加载完成", {
-        trigger: "preload",
-        source: "SQLite",
-        orderCount: this.store.list.length,
-        duration: `${Date.now() - preloadStartedAt}ms`
-      });
-      return;
-    }
-    const orders = await this.loadOrdersByServer({
-      trigger: "preload"
-    });
+    const orders = await this.loadOrdersByServer();
     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;
@@ -786,16 +750,13 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.logInfo("updateLocalPayment-变更事件完成", paymentContext);
     return { order: nextOrder, payment: nextPayment, previousPayment };
   }
-  async loadOrdersByServer(options = {}) {
+  async loadOrdersByServer() {
     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,
@@ -813,36 +774,25 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         });
         orderList = data || [];
         this.logInfo("loadOrdersByServer-SSE拉取成功", {
-          trigger,
           count: orderList.length
         });
-        hasFetchedRemoteSnapshot = true;
+        this.markOrderPulledAtNow();
         this.lastServerFullFetchAtMs = Date.now();
       } catch {
         this.logInfo("loadOrdersByServer-SSE拉取失败，保持当前内存订单");
         return this.store.list;
       }
     }
-    if (hasFetchedRemoteSnapshot) {
-      this.clearOrderSnapshotMarker();
-    }
-    const {
-      orders: mergedOrders,
-      persisted: isRemoteSnapshotPersisted
-    } = await this.replaceOrdersSnapshotInSQLite(
+    const mergedOrders = 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
@@ -855,34 +805,21 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 拿到完整数据后一次性替换 store，触发订单变更与同步完成事件
    * @returns 刷新后的订单列表
    */
-  async silentRefresh(options = {}) {
+  async silentRefresh() {
     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 开始", {
-      trigger,
-      elapsedSinceFullFetchMs: elapsedSinceFullFetch,
-      orderCount: this.store.list.length
-    });
+    this.logInfo("silentRefresh 开始");
     try {
       this.updateCreateStore();
-      const orders = await this.loadOrdersByServer({ trigger });
+      const orders = await this.loadOrdersByServer();
       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`
       });
@@ -890,7 +827,6 @@ 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
       });
@@ -1598,6 +1534,7 @@ 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(
@@ -1622,6 +1559,7 @@ 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,
@@ -1683,6 +1621,14 @@ 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) {
@@ -1720,7 +1666,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       patchedOrders,
       source,
       mergeActions,
-      {},
+      { storageKeyMigrations },
       forceWriteStorageKeys
     );
     this.logInfo("mergeOrdersToStore-结束", {
@@ -1925,6 +1871,13 @@ 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}`);
   }
@@ -2184,29 +2137,20 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return { list, removedCount };
   }
   /**
-   * 当前订单缓存可复用窗口。
-   * start_time 模式使用精确的营业日起止时间；配置缺失或异常时退化为自然日。
+   * 当前订单拉取窗口：
+   * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
+   * - 无法解析时退化为自然日窗口
    */
-  getCurrentOrderCacheWindow() {
-    var _a;
+  getCurrentPullWindow() {
+    var _a, _b;
     const now = (0, import_dayjs.default)();
-    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")
-          };
-        }
+    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 };
       }
-    } catch {
     }
     const startAt = now.startOf("day");
     return { startAt, endExclusiveAt: startAt.add(1, "day") };
@@ -2215,51 +2159,17 @@ 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.getCurrentOrderCacheWindow();
+    const { startAt, endExclusiveAt } = this.getCurrentPullWindow();
     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;
@@ -2286,7 +2196,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     } catch {
     }
   }
-  async loadOrdersFromSQLite(options = {}) {
+  async loadOrdersFromSQLite() {
     if (!this.dbManager)
       return [];
     try {
@@ -2294,9 +2204,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return (orders || []).map(
         (order) => this.normalizeOrderCollectionsForIngress(order, "loadOrdersFromSQLite")
       );
-    } catch (error) {
-      if (options.throwOnError)
-        throw error;
+    } catch {
       return [];
     }
   }
@@ -2400,7 +2308,18 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         throw new Error("订单 SQLite 数据库未初始化");
       return;
     }
-    const ordersSnapshot = (0, import_lodash_es.cloneDeep)(orders).map((order) => this.normalizeOrderCollectionsForIngress(order, `${source}.sqliteIngress`)).filter((order) => this.getOrderStorageKey(order));
+    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));
     if (ordersSnapshot.length === 0) {
       return;
     }
@@ -2417,6 +2336,17 @@ 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";
@@ -2440,6 +2370,30 @@ 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,
@@ -2518,17 +2472,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 用于 SSE 全量拉取与营业日窗口裁剪。
    *
    * @example
-   * const { orders, persisted } = await this.replaceOrdersSnapshotInSQLite(orderList, 'refresh')
+   * await this.replaceOrdersSnapshotInSQLite(orderList)
    */
   async replaceOrdersSnapshotInSQLite(orderList, source, protectedOrdersBeforeRemoteFetch = []) {
     if (!this.dbManager) {
-      return {
-        orders: this.compactOrderListByIdentity(
-          orderList.map((order) => this.normalizeRemoteSyncedOrder(order)),
-          `${source}.snapshotNoDb`
-        ).list,
-        persisted: false
-      };
+      return this.compactOrderListByIdentity(
+        orderList.map((order) => this.normalizeRemoteSyncedOrder(order)),
+        `${source}.snapshotNoDb`
+      ).list;
     }
     const remoteSnapshot = (0, import_lodash_es.cloneDeep)(orderList).map(
       (order) => this.normalizeOrderCollectionsForIngress(order, `${source}.remoteIngress`)
@@ -2537,7 +2488,6 @@ 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) : [];
@@ -2602,14 +2552,13 @@ 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 { orders: mergedSnapshot, persisted };
+    return mergedSnapshot;
   }
   /**
    * 清空订单模块的内存数据和本地 SQLite 订单表。
@@ -2625,7 +2574,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         await this.dbManager.clear(INDEXDB_STORE_NAME);
       });
     }
-    this.clearOrderSnapshotMarker();
+    this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, "");
     this.emitOrdersChanged([], "clear");
   }
 };