@pisell/pisellos 2.3.68 → 2.3.69

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

@@ -43,6 +43,7 @@ import { getOrderPaymentIdentityKeys, isIdentifiedPendingOrderPayment, isPending
 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 = 2000;
 /** pubsub 回声写入去重窗口：业务 API 刚写入后，跳过同单 SQLite patch */
@@ -308,18 +309,23 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "normalizeOrderCollectionsForIngress",
     value: function normalizeOrderCollectionsForIngress(order, source) {
-      var sourceOrder = cloneDeep(order);
-      var sourceOrderRecord = sourceOrder;
+      var sourceOrderRecord = order;
+      var sourceOrder = sourceOrderRecord;
       if (Array.isArray(sourceOrderRecord.payments)) {
-        sourceOrderRecord.payments = sourceOrderRecord.payments.map(function (payment) {
-          if (!isPendingOrderPayment(payment) || getOrderPaymentIdentityKeys(payment).some(function (key) {
-            return key.startsWith('unique_payment_number:');
-          })) {
-            return payment;
-          }
-          return _objectSpread(_objectSpread({}, payment), {}, _defineProperty({}, PENDING_PAYMENT_WITHOUT_UNIQUE_MARKER, true));
+        sourceOrder = _objectSpread(_objectSpread({}, sourceOrderRecord), {}, {
+          payments: sourceOrderRecord.payments.map(function (payment) {
+            if (!isPendingOrderPayment(payment) || getOrderPaymentIdentityKeys(payment).some(function (key) {
+              return key.startsWith('unique_payment_number:');
+            })) {
+              return payment;
+            }
+            return _objectSpread(_objectSpread({}, payment), {}, _defineProperty({}, PENDING_PAYMENT_WITHOUT_UNIQUE_MARKER, true));
+          })
         });
       }
+
+      // normalizeOrderCollections 内部已经 cloneDeep；这里只浅复制被改写的 payments，
+      // 既不修改调用方对象，也避免对整笔订单重复深拷贝。
       var result = normalizeOrderCollections(sourceOrder);
       var normalizedOrderRecord = result.order;
       if (Array.isArray(normalizedOrderRecord.payments)) {
@@ -700,26 +706,96 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "preload",
     value: function () {
       var _preload = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
-        var orders;
+        var preloadStartedAt, cachedOrders, sqliteLoadTimings, memoryPrepareStartedAt, memoryOrders, memoryPrepareMs, syncMapStartedAt, syncMapMs, onOrdersLoadedStartedAt, onOrdersLoadedMs, emitOrdersChangedStartedAt, emitOrdersChangedMs, orders;
         return _regeneratorRuntime().wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
-              _context4.next = 2;
-              return this.loadOrdersByServer();
-            case 2:
+              preloadStartedAt = Date.now();
+              cachedOrders = null;
+              if (!this.dbManager) {
+                _context4.next = 12;
+                break;
+              }
+              _context4.prev = 3;
+              _context4.next = 6;
+              return this.loadOrdersFromSQLite({
+                throwOnError: true,
+                onTiming: function onTiming(timings) {
+                  sqliteLoadTimings = timings;
+                }
+              });
+            case 6:
+              cachedOrders = _context4.sent;
+              _context4.next = 12;
+              break;
+            case 9:
+              _context4.prev = 9;
+              _context4.t0 = _context4["catch"](3);
+              this.logWarning('preload-SQLite读取失败，回退远端全量拉取', {
+                error: _context4.t0 instanceof Error ? _context4.t0.message : String(_context4.t0)
+              });
+            case 12:
+              if (!(cachedOrders !== null && this.hasPulledOrdersToday())) {
+                _context4.next = 30;
+                break;
+              }
+              memoryPrepareStartedAt = performance.now();
+              memoryOrders = this.prepareNormalizedOrdersForMemoryList(cachedOrders);
+              memoryPrepareMs = +(performance.now() - memoryPrepareStartedAt).toFixed(2); // loadOrdersFromSQLite 已返回独立且完成集合规范化的新对象；直接进入 store，
+              // 不再进行第二轮 normalize 和没有隔离收益的最终 cloneDeep。
+              this.store.list = memoryOrders;
+              syncMapStartedAt = performance.now();
+              this.syncOrdersMap();
+              syncMapMs = +(performance.now() - syncMapStartedAt).toFixed(2);
+              onOrdersLoadedStartedAt = performance.now();
+              _context4.next = 23;
+              return this.core.effects.emit(OrderHooks.onOrdersLoaded, this.store.list);
+            case 23:
+              onOrdersLoadedMs = +(performance.now() - onOrdersLoadedStartedAt).toFixed(2);
+              emitOrdersChangedStartedAt = performance.now();
+              _context4.next = 27;
+              return this.emitOrdersChanged([], 'preload.sqlite');
+            case 27:
+              emitOrdersChangedMs = +(performance.now() - emitOrdersChangedStartedAt).toFixed(2);
+              this.logInfo('预加载完成', {
+                trigger: 'preload',
+                source: 'SQLite',
+                orderCount: this.store.list.length,
+                duration: "".concat(Date.now() - preloadStartedAt, "ms"),
+                stages: _objectSpread(_objectSpread({}, sqliteLoadTimings || {}), {}, {
+                  memoryPrepareMs: memoryPrepareMs,
+                  syncMapMs: syncMapMs,
+                  onOrdersLoadedMs: onOrdersLoadedMs,
+                  emitOrdersChangedMs: emitOrdersChangedMs
+                })
+              });
+              return _context4.abrupt("return");
+            case 30:
+              _context4.next = 32;
+              return this.loadOrdersByServer({
+                trigger: 'preload'
+              });
+            case 32:
               orders = _context4.sent;
               this.store.list = cloneDeep(orders);
               this.syncOrdersMap();
-              _context4.next = 7;
+              _context4.next = 37;
               return this.emitOrdersChanged([], 'preload');
-            case 7:
-              _context4.next = 9;
+            case 37:
+              _context4.next = 39;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 9:
+            case 39:
+              this.logInfo('预加载完成', {
+                trigger: 'preload',
+                source: 'Server',
+                orderCount: this.store.list.length,
+                duration: "".concat(Date.now() - preloadStartedAt, "ms")
+              });
+            case 40:
             case "end":
               return _context4.stop();
           }
-        }, _callee4, this);
+        }, _callee4, this, [[3, 9]]);
       }));
       function preload() {
         return _preload.apply(this, arguments);
@@ -1052,18 +1128,32 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8() {
         var _this5 = this,
           _this$store;
-        var orderList, protectedOrdersBeforeRemoteFetch, data, mergedOrders, memoryOrders;
+        var options,
+          orderList,
+          hasFetchedRemoteSnapshot,
+          trigger,
+          protectedOrdersBeforeRemoteFetch,
+          data,
+          _yield$this$replaceOr,
+          mergedOrders,
+          isRemoteSnapshotPersisted,
+          memoryOrders,
+          _args8 = arguments;
         return _regeneratorRuntime().wrap(function _callee8$(_context8) {
           while (1) switch (_context8.prev = _context8.next) {
             case 0:
+              options = _args8.length > 0 && _args8[0] !== undefined ? _args8[0] : {};
               orderList = [];
-              _context8.next = 3;
+              hasFetchedRemoteSnapshot = false;
+              trigger = options.trigger || 'unknown';
+              _context8.next = 6;
               return this.loadOrdersFromSQLite();
-            case 3:
+            case 6:
               protectedOrdersBeforeRemoteFetch = _context8.sent.filter(function (order) {
                 return _this5.shouldProtectLocalOrderFromRemoteSnapshot(order);
               });
               this.logInfo('loadOrdersByServer-开始', {
+                trigger: trigger,
                 hasOrderDataSource: !!this.orderDataSource,
                 query: ((_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.createdAtQuery) || null,
                 protectedLocalOrderCount: protectedOrdersBeforeRemoteFetch.length,
@@ -1072,51 +1162,61 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 }, 0)
               });
               if (!this.orderDataSource) {
-                _context8.next = 20;
+                _context8.next = 23;
                 break;
               }
-              _context8.prev = 6;
-              _context8.next = 9;
+              _context8.prev = 9;
+              _context8.next = 12;
               return this.orderDataSource.run({
                 sse: {
                   query: this.store.createdAtQuery
                 }
               });
-            case 9:
+            case 12:
               data = _context8.sent;
               orderList = data || [];
               this.logInfo('loadOrdersByServer-SSE拉取成功', {
+                trigger: trigger,
                 count: orderList.length
               });
-              this.markOrderPulledAtNow();
+              hasFetchedRemoteSnapshot = true;
               this.lastServerFullFetchAtMs = Date.now();
-              _context8.next = 20;
+              _context8.next = 23;
               break;
-            case 16:
-              _context8.prev = 16;
-              _context8.t0 = _context8["catch"](6);
+            case 19:
+              _context8.prev = 19;
+              _context8.t0 = _context8["catch"](9);
               this.logInfo('loadOrdersByServer-SSE拉取失败，保持当前内存订单');
               return _context8.abrupt("return", this.store.list);
-            case 20:
-              _context8.next = 22;
+            case 23:
+              if (hasFetchedRemoteSnapshot) {
+                this.clearOrderSnapshotMarker();
+              }
+              _context8.next = 26;
               return this.replaceOrdersSnapshotInSQLite(orderList, 'loadOrdersByServer', protectedOrdersBeforeRemoteFetch);
-            case 22:
-              mergedOrders = _context8.sent;
+            case 26:
+              _yield$this$replaceOr = _context8.sent;
+              mergedOrders = _yield$this$replaceOr.orders;
+              isRemoteSnapshotPersisted = _yield$this$replaceOr.persisted;
+              if (hasFetchedRemoteSnapshot && isRemoteSnapshotPersisted) {
+                this.markOrderPulledAtNow();
+              }
               memoryOrders = this.normalizeOrdersForMemoryList(mergedOrders, 'loadOrdersByServer.memory');
               this.logInfo('loadOrdersByServer-结束', {
+                trigger: trigger,
                 count: memoryOrders.length,
                 persistedCount: mergedOrders.length,
                 sqliteOnlyDraftCount: mergedOrders.length - memoryOrders.length
               });
-              _context8.next = 27;
+              _context8.next = 34;
               return this.core.effects.emit(OrderHooks.onOrdersLoaded, memoryOrders);
-            case 27:
+            case 34:
               return _context8.abrupt("return", memoryOrders);
-            case 28:
+            case 35:
             case "end":
               return _context8.stop();
           }
-        }, _callee8, this, [[6, 16]]);
+        }, _callee8, this, [[9, 19]]);
       }));
       function loadOrdersByServer() {
         return _loadOrdersByServer.apply(this, arguments);
@@ -1132,53 +1232,76 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "silentRefresh",
     value: (function () {
       var _silentRefresh = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
-        var startTime, elapsedSinceFullFetch, orders, errorMessage;
+        var options,
+          startTime,
+          trigger,
+          elapsedSinceFullFetch,
+          orders,
+          errorMessage,
+          _args9 = arguments;
         return _regeneratorRuntime().wrap(function _callee9$(_context9) {
           while (1) switch (_context9.prev = _context9.next) {
             case 0:
+              options = _args9.length > 0 && _args9[0] !== undefined ? _args9[0] : {};
               startTime = Date.now();
+              trigger = options.trigger || 'background';
               elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
               if (!(this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS)) {
-                _context9.next = 4;
+                _context9.next = 7;
                 break;
               }
+              this.logInfo('silentRefresh 跳过全量 SSE', {
+                trigger: trigger,
+                reason: 'within_min_interval',
+                minIntervalMs: ORDER_SILENT_REFRESH_MIN_INTERVAL_MS,
+                elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+                orderCount: this.store.list.length
+              });
               return _context9.abrupt("return", this.store.list);
-            case 4:
-              this.logInfo('silentRefresh 开始');
-              _context9.prev = 5;
+            case 7:
+              this.logInfo('silentRefresh 开始', {
+                trigger: trigger,
+                elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+                orderCount: this.store.list.length
+              });
+              _context9.prev = 8;
               // 刷新前，需要更新当前营业日边界（store.createdAtQuery）
               this.updateCreateStore();
-              _context9.next = 9;
-              return this.loadOrdersByServer();
-            case 9:
+              _context9.next = 12;
+              return this.loadOrdersByServer({
+                trigger: trigger
+              });
+            case 12:
               orders = _context9.sent;
               this.store.list = cloneDeep(orders);
               this.syncOrdersMap();
-              _context9.next = 14;
+              _context9.next = 17;
               return this.emitOrdersChanged([], 'silentRefresh');
-            case 14:
-              _context9.next = 16;
+            case 17:
+              _context9.next = 19;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 16:
+            case 19:
               this.logInfo('silentRefresh 完成', {
+                trigger: trigger,
                 orderCount: orders.length,
                 duration: "".concat(Date.now() - startTime, "ms")
               });
               return _context9.abrupt("return", this.store.list);
-            case 20:
-              _context9.prev = 20;
-              _context9.t0 = _context9["catch"](5);
+            case 23:
+              _context9.prev = 23;
+              _context9.t0 = _context9["catch"](8);
               errorMessage = _context9.t0 instanceof Error ? _context9.t0.message : String(_context9.t0);
               this.logError('silentRefresh 失败', {
+                trigger: trigger,
                 duration: "".concat(Date.now() - startTime, "ms"),
                 error: errorMessage
               });
               return _context9.abrupt("return", this.store.list);
-            case 25:
+            case 28:
             case "end":
               return _context9.stop();
           }
-        }, _callee9, this, [[5, 20]]);
+        }, _callee9, this, [[8, 23]]);
       }));
       function silentRefresh() {
         return _silentRefresh.apply(this, arguments);
@@ -1190,6 +1313,15 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function normalizeOrderForMemoryList(order) {
       var source = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'normalizeOrderForMemoryList';
       var normalizedOrder = this.normalizeOrderCollectionsForIngress(order, source);
+      return this.prepareNormalizedOrderForMemoryList(normalizedOrder);
+    }
+
+    /**
+     * 将已经完成集合规范化的订单转换为内存身份，不重复扫描 products/bookings/payments。
+     */
+  }, {
+    key: "prepareNormalizedOrderForMemoryList",
+    value: function prepareNormalizedOrderForMemoryList(normalizedOrder) {
       var externalSaleNumber = normalizedOrder === null || normalizedOrder === void 0 ? void 0 : normalizedOrder.external_sale_number;
       if (this.isDraftOrder(normalizedOrder) && !this.hasRealOrderId(normalizedOrder)) {
         return normalizedOrder;
@@ -1205,15 +1337,25 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       });
     }
   }, {
-    key: "normalizeOrdersForMemoryList",
-    value: function normalizeOrdersForMemoryList(orders, source) {
+    key: "prepareNormalizedOrdersForMemoryList",
+    value: function prepareNormalizedOrdersForMemoryList(orders) {
       var _this6 = this;
       return orders.map(function (order) {
-        return _this6.normalizeOrderForMemoryList(order, source);
+        return _this6.prepareNormalizedOrderForMemoryList(order);
       }).filter(function (order) {
         return _this6.shouldKeepOrderInMemory(order);
       });
     }
+  }, {
+    key: "normalizeOrdersForMemoryList",
+    value: function normalizeOrdersForMemoryList(orders, source) {
+      var _this7 = this;
+      return orders.map(function (order) {
+        return _this7.normalizeOrderForMemoryList(order, source);
+      }).filter(function (order) {
+        return _this7.shouldKeepOrderInMemory(order);
+      });
+    }
   }, {
     key: "hasRealOrderId",
     value: function hasRealOrderId(order) {
@@ -1246,7 +1388,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "overwriteExistingOrder",
     value: (function () {
       var _overwriteExistingOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(fresh) {
-        var _this7 = this;
+        var _this8 = this;
         var orderId, key, normalizedFresh, existingOrder, reconciledFresh;
         return _regeneratorRuntime().wrap(function _callee10$(_context10) {
           while (1) switch (_context10.prev = _context10.next) {
@@ -1283,9 +1425,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               this.store.list = this.store.list.map(function (order) {
                 var id = order === null || order === void 0 ? void 0 : order.order_id;
                 if (id === undefined || id === null) {
-                  return _this7.normalizeOrderForMemoryList(order, 'overwriteExistingOrder.existingMemory');
+                  return _this8.normalizeOrderForMemoryList(order, 'overwriteExistingOrder.existingMemory');
                 }
-                return _this7.getIdKey(id) === key ? reconciledFresh : _this7.normalizeOrderForMemoryList(order, 'overwriteExistingOrder.existingMemory');
+                return _this8.getIdKey(id) === key ? reconciledFresh : _this8.normalizeOrderForMemoryList(order, 'overwriteExistingOrder.existingMemory');
               });
               this.syncOrdersMap();
               _context10.next = 16;
@@ -1357,7 +1499,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "markOrderSyncedByExternalSaleNumber",
     value: function () {
       var _markOrderSyncedByExternalSaleNumber = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee12(params) {
-        var _this8 = this,
+        var _this9 = this,
           _existing$external_sa,
           _nextOrder$order_id;
         var externalSaleNumber, key, targetIndex, existing, nextOrder, storageKey;
@@ -1378,7 +1520,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               targetIndex = this.store.list.findIndex(function (order) {
                 var value = order === null || order === void 0 ? void 0 : order.external_sale_number;
                 if (value === undefined || value === null || value === '') return false;
-                return _this8.getIdKey(value) === key;
+                return _this9.getIdKey(value) === key;
               });
               if (!(targetIndex < 0)) {
                 _context12.next = 9;
@@ -1436,7 +1578,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "upsertPendingSyncOrders",
     value: (function () {
       var _upsertPendingSyncOrders = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee13(pendingOrders) {
-        var _this9 = this;
+        var _this10 = this;
         var options,
           pendingMap,
           memoryPendingMap,
@@ -1532,7 +1674,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               });
               mergeActions = {};
               updatedList = this.store.list.map(function (order) {
-                return _this9.normalizeOrderForMemoryList(order, 'upsertPendingSyncOrders.existingMemory');
+                return _this10.normalizeOrderForMemoryList(order, 'upsertPendingSyncOrders.existingMemory');
               }); // 与 mergeOrdersToStore 一致：基于身份键（field:value）建立索引，把「查找已存在订单」
               // 从 O(n) 线性扫描降为 O(1)，整体复杂度由 O(n^2) 降为 O(n + m)。
               identityKeyToIndex = new Map();
@@ -1642,7 +1784,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "upsertLocalDraftOrders",
     value: (function () {
       var _upsertLocalDraftOrders = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee14(draftOrders) {
-        var _this10 = this;
+        var _this11 = this;
         var draftMap, memoryDraftMap, _iterator9, _step9, order, draftOrder, storageKey, memoryDraftOrder, mergeActions, updatedList, identityKeyToIndex, index, _iterator10, _step10, key, _iterator11, _step11, _step11$value, _storageKey2, _draftOrder, matchIndex, existingOrder, reconciledDraftOrder, mergedOrder, nextOrder, insertIndex, patchedOrders, previousList, removedLegacyMemoryDraft;
         return _regeneratorRuntime().wrap(function _callee14$(_context14) {
           while (1) switch (_context14.prev = _context14.next) {
@@ -1712,7 +1854,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               });
               mergeActions = {};
               updatedList = this.store.list.filter(function (order) {
-                return _this10.shouldKeepOrderInMemory(order);
+                return _this11.shouldKeepOrderInMemory(order);
               });
               identityKeyToIndex = new Map();
               for (index = 0; index < updatedList.length; index += 1) {
@@ -1799,7 +1941,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 storeOrderCountAfter: this.store.list.length
               });
               removedLegacyMemoryDraft = previousList.some(function (order) {
-                return !_this10.shouldKeepOrderInMemory(order);
+                return !_this11.shouldKeepOrderInMemory(order);
               });
               if (!(memoryDraftMap.size > 0 || removedLegacyMemoryDraft)) {
                 _context14.next = 84;
@@ -1807,7 +1949,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               }
               _context14.next = 84;
               return this.emitOrdersChanged(patchedOrders.filter(function (order) {
-                return _this10.shouldKeepOrderInMemory(order);
+                return _this11.shouldKeepOrderInMemory(order);
               }), 'upsertLocalDraftOrders');
             case 84:
             case "end":
@@ -1890,9 +2032,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "syncOrdersMap",
     value: function syncOrdersMap() {
-      var _this11 = this;
+      var _this12 = this;
       this.store.list = this.store.list.filter(function (order) {
-        return _this11.shouldKeepOrderInMemory(order);
+        return _this12.shouldKeepOrderInMemory(order);
       });
       this.store.map.clear();
       var _iterator12 = _createForOfIteratorHelper(this.store.list),
@@ -1948,7 +2090,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getOrderIdentityEntries",
     value: function getOrderIdentityEntries(order) {
-      var _this12 = this;
+      var _this13 = this;
       if (!order) return [];
       var record = order;
       var candidates = [{
@@ -1967,8 +2109,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var entries = [];
       var _loop = function _loop() {
           var candidate = _candidates[_i2];
-          if (_this12.isBlankIdentityValue(candidate.value)) return 0; // continue
-          var key = _this12.getIdKey(candidate.value);
+          if (_this13.isBlankIdentityValue(candidate.value)) return 0; // continue
+          var key = _this13.getIdKey(candidate.value);
           if (entries.some(function (entry) {
             return entry.field === candidate.field && entry.key === key;
           })) return 0; // continue
@@ -2035,7 +2177,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "setupOrderSync",
     value: function setupOrderSync() {
-      var _this13 = this;
+      var _this14 = this;
       if (!this.orderDataSource) return;
       this.orderDataSource.run({
         pubsub: {
@@ -2043,22 +2185,22 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
             var _message$id, _message$order_id, _message$type;
             console.log('orderDataSource', res);
             var pubsubReceivedAt = Date.now();
-            var message = _this13.normalizeOrderSyncMessage(res);
+            var message = _this14.normalizeOrderSyncMessage(res);
             if (!message) return;
             message._pubsubReceivedAt = pubsubReceivedAt;
-            _this13.pendingSyncMessages.push(message);
-            var throttleMs = _this13.getOrderSyncThrottleMs();
-            var routeInfo = _this13.resolveSyncMessageRoute(message);
-            _this13.logInfo('orderSync-收到消息并入队', {
+            _this14.pendingSyncMessages.push(message);
+            var throttleMs = _this14.getOrderSyncThrottleMs();
+            var routeInfo = _this14.resolveSyncMessageRoute(message);
+            _this14.logInfo('orderSync-收到消息并入队', {
               id: (_message$id = message.id) !== null && _message$id !== void 0 ? _message$id : null,
               order_id: (_message$order_id = message.order_id) !== null && _message$order_id !== void 0 ? _message$order_id : null,
               type: (_message$type = message.type) !== null && _message$type !== void 0 ? _message$type : null,
-              pendingCount: _this13.pendingSyncMessages.length,
+              pendingCount: _this14.pendingSyncMessages.length,
               throttleMs: throttleMs,
               pubsubReceivedAt: new Date(pubsubReceivedAt).toISOString(),
               fullMessage: JSON.stringify(message)
             });
-            _this13.scheduleOrderSyncThrottle();
+            _this14.scheduleOrderSyncThrottle();
           }
         }
       }).catch(function () {
@@ -2075,7 +2217,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "scheduleOrderSyncThrottle",
     value: function scheduleOrderSyncThrottle() {
-      var _this14 = this;
+      var _this15 = this;
       if (this.isProcessingSyncBatch) return;
       if (this.isIdlePhase) {
         this.isIdlePhase = false;
@@ -2086,8 +2228,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       if (this.syncTimer) return;
       var throttleMs = this.getOrderSyncThrottleMs();
       this.syncTimer = setTimeout(function () {
-        _this14.syncTimer = undefined;
-        void _this14.flushOrderSyncMessagesByThrottle();
+        _this15.syncTimer = undefined;
+        void _this15.flushOrderSyncMessagesByThrottle();
       }, throttleMs);
     }
 
@@ -2155,7 +2297,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "processOrderSyncMessages",
     value: (function () {
       var _processOrderSyncMessages = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee17() {
-        var _this15 = this;
+        var _this16 = this;
         var messages, batchProcessStartAt, earliestReceivedAt, upsertOrders, refreshIds, uniqueRefreshIds, upsertList, _this$filterRedundant, toFetch, skipped, freshOrders, batchProcessEndAt;
         return _regeneratorRuntime().wrap(function _callee17$(_context17) {
           while (1) switch (_context17.prev = _context17.next) {
@@ -2182,13 +2324,13 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               upsertOrders = new Map();
               refreshIds = [];
               messages.forEach(function (msg, msgIndex) {
-                var routeInfo = _this15.resolveSyncMessageRoute(msg);
+                var routeInfo = _this16.resolveSyncMessageRoute(msg);
                 var hasBatchIds = routeInfo.hasBatchIds;
                 var singleId = routeInfo.singleId;
                 var hasSingleId = routeInfo.hasSingleId;
-                var normalizedBody = _this15.normalizeOrderSyncPayload(msg.body || msg.data);
+                var normalizedBody = _this16.normalizeOrderSyncPayload(msg.body || msg.data);
                 if (routeInfo.route === 'bodyUpsert' && normalizedBody) {
-                  upsertOrders.set(_this15.getIdKey(normalizedBody.order_id), normalizedBody);
+                  upsertOrders.set(_this16.getIdKey(normalizedBody.order_id), normalizedBody);
                   return;
                 }
                 if (hasBatchIds) refreshIds.push.apply(refreshIds, _toConsumableArray(routeInfo.batchIds));else if (routeInfo.route === 'httpRefresh.singleId' && singleId !== null) refreshIds.push(singleId);else if (routeInfo.route === 'httpRefresh.relationIds') refreshIds.push.apply(refreshIds, _toConsumableArray(routeInfo.batchIds));
@@ -2326,7 +2468,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "mergeOrdersToStore",
     value: (function () {
       var _mergeOrdersToStore = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee19(freshOrders, source) {
-        var _this16 = this;
+        var _this17 = this;
         var storeOrderCountBefore, normalizedFreshOrders, incomingProductsHaveStableIdentity, _iterator14, _step14, order, id, rawProducts, _incomingProductsHave, allProductsHaveStableIdentity, orderIdKey, uniqueFreshOrders, uniqueFreshCount, patchedOrders, remoteProductMembershipChanges, forceWriteStorageKeys, storageKeyMigrations, mergeActions, existingProductsHaveStableIdentity, updatedList, identityKeyToIndex, index, identityKeys, _iterator15, _step15, key, _iterator16, _step16, fresh, freshIdentityKeys, matchIndex, storageKey, mergeKey, existingOrder, previousStorageKey, _ref, _existingOrder$order_, _ref2, _external_sale_number2, _existingOrder$paymen, _fresh$payment_status, _existingOrder$need_s, _fresh$need_sync, _ref3, _existingOrder$order_2, _ref4, _external_sale_number3, _existingOrder$is_dra, _fresh$is_draft_order, mergedOrder, freshOrderId, incomingProductsAreStable, membershipChange, mergedProductsHaveStableIdentity, adjustedMatchIndex, duplicateIndexes, _iterator17, _step17, _key2, _duplicateIndex, _iterator18, _step18, duplicateIndex, _index, _iterator19, _step19, _key, nextStorageKey, _ref5, _ref6, _mergedOrder$order_id, mergedStorageKey, insertIndex, insertCount, updateCount;
         return _regeneratorRuntime().wrap(function _callee19$(_context19) {
           while (1) switch (_context19.prev = _context19.next) {
@@ -2387,10 +2529,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               storageKeyMigrations = [];
               mergeActions = {};
               existingProductsHaveStableIdentity = this.store.list.map(function (order) {
-                return _this16.doProductsHaveStableMembershipIdentity(order.products);
+                return _this17.doProductsHaveStableMembershipIdentity(order.products);
               });
               updatedList = this.store.list.map(function (order) {
-                return _this16.normalizeOrderForMemoryList(order, "".concat(source, ".existingMemory"));
+                return _this17.normalizeOrderForMemoryList(order, "".concat(source, ".existingMemory"));
               }); // 基于身份键（field:value）建立索引，把「查找已存在订单」从 O(n) 线性扫描降为 O(1)，
               // 整体合并复杂度由 O(n^2) 降为 O(n + m)。索引语义与 doOrdersShareIdentity 完全一致：
               // 任一身份字段（order_id/external_sale_number/order_number/shop_order_number）同值即同一单。
@@ -2694,7 +2836,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getRemoteProductMembershipChange",
     value: function getRemoteProductMembershipChange(existingOrder, mergedOrder, source) {
-      var _this17 = this,
+      var _this18 = this,
         _mergedOrder$order_id2;
       if (!this.isRemoteProductMembershipChangeSource(source)) return null;
       var previousProducts = Array.isArray(existingOrder.products) ? existingOrder.products : [];
@@ -2709,13 +2851,13 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         var _loop2 = function _loop2() {
           var previousProduct = _step21.value;
           var matchedIndex = currentProducts.findIndex(function (currentProduct, index) {
-            return unmatchedCurrentIndexes.has(index) && _this17.isSameProductMembershipItem(previousProduct, currentProduct);
+            return unmatchedCurrentIndexes.has(index) && _this18.isSameProductMembershipItem(previousProduct, currentProduct);
           });
           if (matchedIndex >= 0) {
             unmatchedCurrentIndexes.delete(matchedIndex);
             return 1; // continue
           }
-          var productKey = _this17.getProductMembershipKey(previousProduct);
+          var productKey = _this18.getProductMembershipKey(previousProduct);
           if (productKey) removedProductKeys.push(productKey);
         };
         for (_iterator21.s(); !(_step21 = _iterator21.n()).done;) {
@@ -2727,7 +2869,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         _iterator21.f();
       }
       var addedProductKeys = _toConsumableArray(unmatchedCurrentIndexes).map(function (index) {
-        return _this17.getProductMembershipKey(currentProducts[index]);
+        return _this18.getProductMembershipKey(currentProducts[index]);
       }).filter(Boolean);
       if (addedProductKeys.length === 0 && removedProductKeys.length === 0) {
         return null;
@@ -2842,12 +2984,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "isOrderLookupMatch",
     value: function isOrderLookupMatch(order, lookupKey) {
-      var _this18 = this;
+      var _this19 = this;
       if (!order || !lookupKey) return false;
       var candidates = [order.order_id, order.external_sale_number, order.order_number, order.shop_order_number, order.shop_full_order_number];
       return candidates.some(function (value) {
         if (value === undefined || value === null || value === '') return false;
-        return _this18.getIdKey(value) === lookupKey;
+        return _this19.getIdKey(value) === lookupKey;
       });
     }
 
@@ -2899,10 +3041,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "findOrderIndexByIdentity",
     value: function findOrderIndexByIdentity(orders, target) {
-      var _this19 = this;
+      var _this20 = this;
       if (this.getOrderIdentityMatchKeys(target).length === 0) return -1;
       return orders.findIndex(function (order) {
-        return _this19.doOrdersShareIdentity(order, target);
+        return _this20.doOrdersShareIdentity(order, target);
       });
     }
   }, {
@@ -3214,25 +3356,32 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     }
 
     /**
-     * 当前订单拉取窗口：
-     * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
-     * - 无法解析时退化为自然日窗口
+     * 当前订单缓存可复用窗口。
+     * start_time 模式使用精确的营业日起止时间；配置缺失或异常时退化为自然日。
      */
   }, {
-    key: "getCurrentPullWindow",
-    value: function getCurrentPullWindow() {
-      var _this$store2;
+    key: "getCurrentOrderCacheWindow",
+    value: function getCurrentOrderCacheWindow() {
       var now = dayjs();
-      var range = (_this$store2 = this.store) === null || _this$store2 === void 0 || (_this$store2 = _this$store2.createdAtQuery) === null || _this$store2 === void 0 ? void 0 : _this$store2.sales_time_between;
-      if (Array.isArray(range) && range.length >= 2) {
-        var _startAt = dayjs(range[0]);
-        var endExclusiveAt = dayjs(range[1]);
-        if (_startAt.isValid() && endExclusiveAt.isValid() && endExclusiveAt.isAfter(_startAt)) {
-          return {
-            startAt: _startAt,
-            endExclusiveAt: endExclusiveAt
-          };
+      try {
+        var _coreData$core;
+        var appPlugin = this.core.getPlugin('app');
+        var app = appPlugin === null || appPlugin === void 0 ? void 0 : appPlugin.getApp();
+        var coreData = app === null || app === void 0 ? void 0 : app.data.store.getStore().getDataByModel('core');
+        var boundary = coreData === null || coreData === void 0 || (_coreData$core = coreData.core) === null || _coreData$core === void 0 ? void 0 : _coreData$core.operating_day_boundary;
+        if ((boundary === null || boundary === void 0 ? void 0 : boundary.type) === 'start_time') {
+          var boundaryTime = String(boundary.time || '').trim();
+          var todayBoundary = dayjs("".concat(now.format('YYYY-MM-DD'), " ").concat(boundaryTime));
+          if (todayBoundary.isValid()) {
+            var _startAt = now.isBefore(todayBoundary) ? todayBoundary.subtract(1, 'day') : todayBoundary;
+            return {
+              startAt: _startAt,
+              endExclusiveAt: _startAt.add(1, 'day')
+            };
+          }
         }
+      } catch (_unused6) {
+        // 读取营业日配置失败时按自然日兜底，不影响启动。
       }
       var startAt = now.startOf('day');
       return {
@@ -3245,20 +3394,47 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function hasPulledOrdersToday() {
       var lastFullFetchAt = this.getStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY);
       if (!lastFullFetchAt) return false;
+      var currentShopId = this.getCurrentShopId();
+      var lastFullFetchShopId = this.getStorageItem(ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY);
+      if (!currentShopId || !lastFullFetchShopId || currentShopId !== lastFullFetchShopId) {
+        return false;
+      }
       var parsed = dayjs(lastFullFetchAt);
       if (!parsed.isValid()) return false;
-
-      // 按当前拉取窗口判断，而不是自然日判断。
-      // 这样在营业日跨日边界（start_time）场景下也能正确判定是否需要重新拉取。
-      var _this$getCurrentPullW = this.getCurrentPullWindow(),
-        startAt = _this$getCurrentPullW.startAt,
-        endExclusiveAt = _this$getCurrentPullW.endExclusiveAt;
+      var _this$getCurrentOrder = this.getCurrentOrderCacheWindow(),
+        startAt = _this$getCurrentOrder.startAt,
+        endExclusiveAt = _this$getCurrentOrder.endExclusiveAt;
       return (parsed.isAfter(startAt) || parsed.isSame(startAt)) && parsed.isBefore(endExclusiveAt);
     }
   }, {
     key: "markOrderPulledAtNow",
     value: function markOrderPulledAtNow() {
+      var currentShopId = this.getCurrentShopId();
+      if (!currentShopId) return;
       this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, dayjs().format('YYYY-MM-DD HH:mm:ss'));
+      this.setStorageItem(ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY, currentShopId);
+    }
+  }, {
+    key: "clearOrderSnapshotMarker",
+    value: function clearOrderSnapshotMarker() {
+      this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, '');
+      this.setStorageItem(ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY, '');
+    }
+  }, {
+    key: "getCurrentShopId",
+    value: function getCurrentShopId() {
+      try {
+        var _coreData$core2;
+        var appPlugin = this.core.getPlugin('app');
+        var app = appPlugin === null || appPlugin === void 0 ? void 0 : appPlugin.getApp();
+        if (!app) return null;
+        var coreData = app.data.store.getStore().getDataByModel('core');
+        var shopId = coreData === null || coreData === void 0 || (_coreData$core2 = coreData.core) === null || _coreData$core2 === void 0 ? void 0 : _coreData$core2.id;
+        if (shopId === undefined || shopId === null || shopId === '') return null;
+        return String(shopId);
+      } catch (_unused7) {
+        return null;
+      }
     }
   }, {
     key: "getStorageItem",
@@ -3269,7 +3445,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         if (typeof globalThis !== 'undefined' && globalThis !== null && globalThis !== void 0 && globalThis.localStorage) {
           return globalThis.localStorage.getItem(key);
         }
-      } catch (_unused6) {
+      } catch (_unused8) {
         // 忽略存储异常，避免影响主流程
       }
       return null;
@@ -3286,7 +3462,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         if (typeof globalThis !== 'undefined' && globalThis !== null && globalThis !== void 0 && globalThis.localStorage) {
           globalThis.localStorage.setItem(key, value);
         }
-      } catch (_unused7) {
+      } catch (_unused9) {
         // 忽略存储异常，避免影响主流程
       }
     }
@@ -3294,34 +3470,61 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "loadOrdersFromSQLite",
     value: function () {
       var _loadOrdersFromSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee20() {
-        var _this20 = this;
-        var orders;
+        var _this21 = this;
+        var options,
+          _options$onTiming,
+          loadStartedAt,
+          rawReadStartedAt,
+          orders,
+          sqliteRawReadMs,
+          normalizeStartedAt,
+          normalizedOrders,
+          sqliteNormalizeMs,
+          _args20 = arguments;
         return _regeneratorRuntime().wrap(function _callee20$(_context20) {
           while (1) switch (_context20.prev = _context20.next) {
             case 0:
+              options = _args20.length > 0 && _args20[0] !== undefined ? _args20[0] : {};
               if (this.dbManager) {
-                _context20.next = 2;
+                _context20.next = 3;
                 break;
               }
               return _context20.abrupt("return", []);
-            case 2:
-              _context20.prev = 2;
-              _context20.next = 5;
+            case 3:
+              _context20.prev = 3;
+              loadStartedAt = performance.now();
+              rawReadStartedAt = performance.now();
+              _context20.next = 8;
               return this.dbManager.getAll(INDEXDB_STORE_NAME);
-            case 5:
+            case 8:
               orders = _context20.sent;
-              return _context20.abrupt("return", (orders || []).map(function (order) {
-                return _this20.normalizeOrderCollectionsForIngress(order, 'loadOrdersFromSQLite');
-              }));
-            case 9:
-              _context20.prev = 9;
-              _context20.t0 = _context20["catch"](2);
+              sqliteRawReadMs = +(performance.now() - rawReadStartedAt).toFixed(2);
+              normalizeStartedAt = performance.now();
+              normalizedOrders = (orders || []).map(function (order) {
+                return _this21.normalizeOrderCollectionsForIngress(order, 'loadOrdersFromSQLite');
+              });
+              sqliteNormalizeMs = +(performance.now() - normalizeStartedAt).toFixed(2);
+              (_options$onTiming = options.onTiming) === null || _options$onTiming === void 0 || _options$onTiming.call(options, {
+                sqliteRawReadMs: sqliteRawReadMs,
+                sqliteNormalizeMs: sqliteNormalizeMs,
+                sqliteLoadTotalMs: +(performance.now() - loadStartedAt).toFixed(2)
+              });
+              return _context20.abrupt("return", normalizedOrders);
+            case 17:
+              _context20.prev = 17;
+              _context20.t0 = _context20["catch"](3);
+              if (!options.throwOnError) {
+                _context20.next = 21;
+                break;
+              }
+              throw _context20.t0;
+            case 21:
               return _context20.abrupt("return", []);
-            case 12:
+            case 22:
             case "end":
               return _context20.stop();
           }
-        }, _callee20, this, [[2, 9]]);
+        }, _callee20, this, [[3, 17]]);
       }));
       function loadOrdersFromSQLite() {
         return _loadOrdersFromSQLite.apply(this, arguments);
@@ -3371,9 +3574,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "mergeRemoteSnapshotWithPendingOrders",
     value: function mergeRemoteSnapshotWithPendingOrders(remoteOrders, existingOrders) {
-      var _this21 = this;
+      var _this22 = this;
       var merged = remoteOrders.map(function (order) {
-        return _this21.normalizeRemoteSyncedOrder(order);
+        return _this22.normalizeRemoteSyncedOrder(order);
       });
       var _iterator31 = _createForOfIteratorHelper(existingOrders),
         _step31;
@@ -3447,7 +3650,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "patchOrdersInSQLite",
     value: (function () {
       var _patchOrdersInSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee23(orders, source) {
-        var _this22 = this;
+        var _this23 = this;
         var mergeActions,
           options,
           forceWriteStorageKeys,
@@ -3491,13 +3694,13 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 return migration.to;
               }));
               ordersSnapshot = cloneDeep(orders).map(function (order) {
-                return _this22.normalizeOrderCollectionsForIngress(order, "".concat(source, ".sqliteIngress"));
+                return _this23.normalizeOrderCollectionsForIngress(order, "".concat(source, ".sqliteIngress"));
               }).map(function (order) {
-                var storageKey = _this22.getOrderStorageKey(order);
+                var storageKey = _this23.getOrderStorageKey(order);
                 if (!storageKey || !migrationTargetStorageKeys.has(storageKey)) return order;
                 return _objectSpread(_objectSpread({}, order), {}, _defineProperty({}, ORDER_STORAGE_KEY_FIELD, storageKey));
               }).filter(function (order) {
-                return _this22.getOrderStorageKey(order);
+                return _this23.getOrderStorageKey(order);
               });
               if (!(ordersSnapshot.length === 0)) {
                 _context23.next = 13;
@@ -3520,7 +3723,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               return _context23.abrupt("return");
             case 19:
               writtenStorageKeys = new Set(compactedToWrite.map(function (order) {
-                return _this22.getOrderStorageKey(order);
+                return _this23.getOrderStorageKey(order);
               }).filter(Boolean));
               storageKeyMigrations = new Map();
               _iterator32 = _createForOfIteratorHelper(options.storageKeyMigrations || []);
@@ -3568,34 +3771,34 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                   while (1) switch (_context22.prev = _context22.next) {
                     case 0:
                       writeMethod = 'none';
-                      _this22.logInfo('patchOrdersInSQLite-开始', {
+                      _this23.logInfo('patchOrdersInSQLite-开始', {
                         source: source,
                         count: compactedToWrite.length,
                         dedupedCount: skipped.length
                       });
-                      if (!(typeof _this22.dbManager.bulkUpdate === 'function')) {
+                      if (!(typeof _this23.dbManager.bulkUpdate === 'function')) {
                         _context22.next = 8;
                         break;
                       }
                       writeMethod = 'bulkUpdate';
                       _context22.next = 6;
-                      return _this22.dbManager.bulkUpdate(INDEXDB_STORE_NAME, compactedToWrite);
+                      return _this23.dbManager.bulkUpdate(INDEXDB_STORE_NAME, compactedToWrite);
                     case 6:
                       _context22.next = 37;
                       break;
                     case 8:
-                      if (!(typeof _this22.dbManager.bulkAdd === 'function')) {
+                      if (!(typeof _this23.dbManager.bulkAdd === 'function')) {
                         _context22.next = 14;
                         break;
                       }
                       writeMethod = 'bulkAdd';
                       _context22.next = 12;
-                      return _this22.dbManager.bulkAdd(INDEXDB_STORE_NAME, compactedToWrite);
+                      return _this23.dbManager.bulkAdd(INDEXDB_STORE_NAME, compactedToWrite);
                     case 12:
                       _context22.next = 37;
                       break;
                     case 14:
-                      if (!(typeof _this22.dbManager.update === 'function')) {
+                      if (!(typeof _this23.dbManager.update === 'function')) {
                         _context22.next = 35;
                         break;
                       }
@@ -3610,7 +3813,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                       }
                       order = _step33.value;
                       _context22.next = 23;
-                      return _this22.dbManager.update(INDEXDB_STORE_NAME, order);
+                      return _this23.dbManager.update(INDEXDB_STORE_NAME, order);
                     case 23:
                       _context22.next = 19;
                       break;
@@ -3635,7 +3838,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                       }
                       throw new Error('订单 SQLite 数据库不支持写入');
                     case 37:
-                      _this22.recordRecentSqliteWrite(source, compactedToWrite);
+                      _this23.recordRecentSqliteWrite(source, compactedToWrite);
                       if (!(writeMethod !== 'none')) {
                         _context22.next = 84;
                         break;
@@ -3651,9 +3854,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                       migration = _step34.value;
                       _context22.prev = 44;
                       _context22.next = 47;
-                      return _this22.dbManager.delete(INDEXDB_STORE_NAME, migration.from);
+                      return _this23.dbManager.delete(INDEXDB_STORE_NAME, migration.from);
                     case 47:
-                      _this22.recentSqliteWriteByStorageKey.delete(migration.from);
+                      _this23.recentSqliteWriteByStorageKey.delete(migration.from);
                       _iterator35 = _createForOfIteratorHelper(orders);
                       _context22.prev = 49;
                       _iterator35.s();
@@ -3663,7 +3866,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                         break;
                       }
                       _order = _step35.value;
-                      if (!(_this22.getOrderStorageKey(_order) !== migration.to)) {
+                      if (!(_this23.getOrderStorageKey(_order) !== migration.to)) {
                         _context22.next = 55;
                         break;
                       }
@@ -3697,7 +3900,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                     case 71:
                       _context22.prev = 71;
                       _context22.t2 = _context22["catch"](44);
-                      _this22.logError('删除订单旧 SQLite storage key 失败', {
+                      _this23.logError('删除订单旧 SQLite storage key 失败', {
                         source: source,
                         order_id: migration.orderId,
                         oldStorageKey: migration.from,
@@ -3719,7 +3922,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                       _iterator34.f();
                       return _context22.finish(81);
                     case 84:
-                      _this22.logInfo('patchOrdersInSQLite-完成', {
+                      _this23.logInfo('patchOrdersInSQLite-完成', {
                         source: source,
                         count: compactedToWrite.length,
                         writeMethod: writeMethod,
@@ -3768,7 +3971,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "updateOrderInSQLite",
     value: (function () {
       var _updateOrderInSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee25(order, source) {
-        var _this23 = this;
+        var _this24 = this;
         var options,
           orderSnapshot,
           _orderSnapshot$order_3,
@@ -3811,40 +4014,40 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                   while (1) switch (_context24.prev = _context24.next) {
                     case 0:
                       writeMethod = 'none';
-                      _this23.logInfo('updateOrderInSQLite-开始', {
+                      _this24.logInfo('updateOrderInSQLite-开始', {
                         source: source,
                         orderId: (_orderSnapshot$order_ = orderSnapshot.order_id) !== null && _orderSnapshot$order_ !== void 0 ? _orderSnapshot$order_ : null,
-                        storageKey: _this23.getOrderStorageKey(orderSnapshot)
+                        storageKey: _this24.getOrderStorageKey(orderSnapshot)
                       });
-                      if (!(typeof _this23.dbManager.update === 'function')) {
+                      if (!(typeof _this24.dbManager.update === 'function')) {
                         _context24.next = 8;
                         break;
                       }
                       writeMethod = 'update';
                       _context24.next = 6;
-                      return _this23.dbManager.update(INDEXDB_STORE_NAME, orderSnapshot);
+                      return _this24.dbManager.update(INDEXDB_STORE_NAME, orderSnapshot);
                     case 6:
                       _context24.next = 22;
                       break;
                     case 8:
-                      if (!(typeof _this23.dbManager.bulkUpdate === 'function')) {
+                      if (!(typeof _this24.dbManager.bulkUpdate === 'function')) {
                         _context24.next = 14;
                         break;
                       }
                       writeMethod = 'bulkUpdate';
                       _context24.next = 12;
-                      return _this23.dbManager.bulkUpdate(INDEXDB_STORE_NAME, [orderSnapshot]);
+                      return _this24.dbManager.bulkUpdate(INDEXDB_STORE_NAME, [orderSnapshot]);
                     case 12:
                       _context24.next = 22;
                       break;
                     case 14:
-                      if (!(typeof _this23.dbManager.bulkAdd === 'function')) {
+                      if (!(typeof _this24.dbManager.bulkAdd === 'function')) {
                         _context24.next = 20;
                         break;
                       }
                       writeMethod = 'bulkAdd';
                       _context24.next = 18;
-                      return _this23.dbManager.bulkAdd(INDEXDB_STORE_NAME, [orderSnapshot]);
+                      return _this24.dbManager.bulkAdd(INDEXDB_STORE_NAME, [orderSnapshot]);
                     case 18:
                       _context24.next = 22;
                       break;
@@ -3855,8 +4058,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                       }
                       throw new Error('订单 SQLite 数据库不支持写入');
                     case 22:
-                      _this23.recordRecentSqliteWrite(source, [orderSnapshot]);
-                      _this23.logInfo('updateOrderInSQLite-完成', {
+                      _this24.recordRecentSqliteWrite(source, [orderSnapshot]);
+                      _this24.logInfo('updateOrderInSQLite-完成', {
                         source: source,
                         orderId: (_orderSnapshot$order_2 = orderSnapshot.order_id) !== null && _orderSnapshot$order_2 !== void 0 ? _orderSnapshot$order_2 : null,
                         writeMethod: writeMethod
@@ -3898,17 +4101,18 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
      * 用于 SSE 全量拉取与营业日窗口裁剪。
      *
      * @example
-     * await this.replaceOrdersSnapshotInSQLite(orderList)
+     * const { orders, persisted } = await this.replaceOrdersSnapshotInSQLite(orderList, 'refresh')
      */
     )
   }, {
     key: "replaceOrdersSnapshotInSQLite",
     value: (function () {
       var _replaceOrdersSnapshotInSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee27(orderList, source) {
-        var _this24 = this;
+        var _this25 = this;
         var protectedOrdersBeforeRemoteFetch,
           remoteSnapshot,
           mergedSnapshot,
+          persisted,
           _args27 = arguments;
         return _regeneratorRuntime().wrap(function _callee27$(_context27) {
           while (1) switch (_context27.prev = _context27.next) {
@@ -3918,29 +4122,33 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 _context27.next = 3;
                 break;
               }
-              return _context27.abrupt("return", this.compactOrderListByIdentity(orderList.map(function (order) {
-                return _this24.normalizeRemoteSyncedOrder(order);
-              }), "".concat(source, ".snapshotNoDb")).list);
+              return _context27.abrupt("return", {
+                orders: this.compactOrderListByIdentity(orderList.map(function (order) {
+                  return _this25.normalizeRemoteSyncedOrder(order);
+                }), "".concat(source, ".snapshotNoDb")).list,
+                persisted: false
+              });
             case 3:
               remoteSnapshot = cloneDeep(orderList).map(function (order) {
-                return _this24.normalizeOrderCollectionsForIngress(order, "".concat(source, ".remoteIngress"));
+                return _this25.normalizeOrderCollectionsForIngress(order, "".concat(source, ".remoteIngress"));
               });
               mergedSnapshot = this.compactOrderListByIdentity(remoteSnapshot.map(function (order) {
-                return _this24.normalizeRemoteSyncedOrder(order);
+                return _this25.normalizeRemoteSyncedOrder(order);
               }), "".concat(source, ".remoteSnapshot")).list;
-              _context27.prev = 5;
-              _context27.next = 8;
+              persisted = false;
+              _context27.prev = 6;
+              _context27.next = 9;
               return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee26() {
                 var existingOrders, protectedLocalOrders, _iterator36, _step36, rawCurrentOrder, currentOrder, protectedIndex, currentNeedsProtection, orderListSnapshot;
                 return _regeneratorRuntime().wrap(function _callee26$(_context26) {
                   while (1) switch (_context26.prev = _context26.next) {
                     case 0:
-                      if (!(typeof _this24.dbManager.getAll === 'function')) {
+                      if (!(typeof _this25.dbManager.getAll === 'function')) {
                         _context26.next = 6;
                         break;
                       }
                       _context26.next = 3;
-                      return _this24.dbManager.getAll(INDEXDB_STORE_NAME);
+                      return _this25.dbManager.getAll(INDEXDB_STORE_NAME);
                     case 3:
                       _context26.t0 = _context26.sent;
                       _context26.next = 7;
@@ -3950,9 +4158,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                     case 7:
                       existingOrders = _context26.t0;
                       protectedLocalOrders = protectedOrdersBeforeRemoteFetch.map(function (order) {
-                        return _this24.normalizeOrderCollectionsForIngress(order, "".concat(source, ".protectedBeforeRemoteFetch"));
+                        return _this25.normalizeOrderCollectionsForIngress(order, "".concat(source, ".protectedBeforeRemoteFetch"));
                       }).filter(function (order) {
-                        return _this24.shouldProtectLocalOrderFromRemoteSnapshot(order);
+                        return _this25.shouldProtectLocalOrderFromRemoteSnapshot(order);
                       });
                       _iterator36 = _createForOfIteratorHelper(existingOrders || []);
                       _context26.prev = 10;
@@ -3963,9 +4171,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                         break;
                       }
                       rawCurrentOrder = _step36.value;
-                      currentOrder = _this24.normalizeOrderCollectionsForIngress(rawCurrentOrder, "".concat(source, ".currentSQLite"));
-                      protectedIndex = _this24.findOrderIndexByIdentity(protectedLocalOrders, currentOrder);
-                      currentNeedsProtection = _this24.shouldProtectLocalOrderFromRemoteSnapshot(currentOrder);
+                      currentOrder = _this25.normalizeOrderCollectionsForIngress(rawCurrentOrder, "".concat(source, ".currentSQLite"));
+                      protectedIndex = _this25.findOrderIndexByIdentity(protectedLocalOrders, currentOrder);
+                      currentNeedsProtection = _this25.shouldProtectLocalOrderFromRemoteSnapshot(currentOrder);
                       if (!(protectedIndex >= 0)) {
                         _context26.next = 20;
                         break;
@@ -3993,9 +4201,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                       _iterator36.f();
                       return _context26.finish(28);
                     case 31:
-                      orderListSnapshot = _this24.mergeRemoteSnapshotWithPendingOrders(remoteSnapshot, protectedLocalOrders);
-                      mergedSnapshot = _this24.compactOrderListByIdentity(orderListSnapshot, "".concat(source, ".sqliteSnapshot")).list;
-                      _this24.logInfo('replaceOrdersSnapshotInSQLite-开始', {
+                      orderListSnapshot = _this25.mergeRemoteSnapshotWithPendingOrders(remoteSnapshot, protectedLocalOrders);
+                      mergedSnapshot = _this25.compactOrderListByIdentity(orderListSnapshot, "".concat(source, ".sqliteSnapshot")).list;
+                      _this25.logInfo('replaceOrdersSnapshotInSQLite-开始', {
                         source: source,
                         count: mergedSnapshot.length,
                         remoteCount: remoteSnapshot.length,
@@ -4003,10 +4211,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                         protectedLocalOrderCount: protectedLocalOrders.length,
                         preservedLocalUnsyncedCount: mergedSnapshot.length - remoteSnapshot.length,
                         protectedPendingPaymentCount: protectedLocalOrders.reduce(function (count, order) {
-                          return count + _this24.getIdentifiedPendingPayments(order).length;
+                          return count + _this25.getIdentifiedPendingPayments(order).length;
                         }, 0),
                         protectedPendingPaymentIdentities: protectedLocalOrders.flatMap(function (order) {
-                          return _this24.getIdentifiedPendingPayments(order).map(function (payment) {
+                          return _this25.getIdentifiedPendingPayments(order).map(function (payment) {
                             var _order$order_id5, _external_sale_number5;
                             return {
                               order_id: (_order$order_id5 = order.order_id) !== null && _order$order_id5 !== void 0 ? _order$order_id5 : null,
@@ -4017,9 +4225,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                         })
                       });
                       _context26.next = 36;
-                      return _this24.dbManager.clear(INDEXDB_STORE_NAME);
+                      return _this25.dbManager.clear(INDEXDB_STORE_NAME);
                     case 36:
-                      _this24.logInfo('replaceOrdersSnapshotInSQLite-clear完成', {
+                      _this25.logInfo('replaceOrdersSnapshotInSQLite-clear完成', {
                         count: mergedSnapshot.length
                       });
                       if (!(mergedSnapshot.length === 0)) {
@@ -4029,10 +4237,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                       return _context26.abrupt("return");
                     case 39:
                       _context26.next = 41;
-                      return _this24.dbManager.bulkAdd(INDEXDB_STORE_NAME, mergedSnapshot);
+                      return _this25.dbManager.bulkAdd(INDEXDB_STORE_NAME, mergedSnapshot);
                     case 41:
-                      _this24.recordRecentSqliteWrite(source, mergedSnapshot);
-                      _this24.logInfo('replaceOrdersSnapshotInSQLite-bulkAdd完成', {
+                      _this25.recordRecentSqliteWrite(source, mergedSnapshot);
+                      _this25.logInfo('replaceOrdersSnapshotInSQLite-bulkAdd完成', {
                         source: source,
                         count: mergedSnapshot.length
                       });
@@ -4042,23 +4250,27 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                   }
                 }, _callee26, null, [[10, 25, 28, 31]]);
               })));
-            case 8:
-              _context27.next = 13;
+            case 9:
+              persisted = true;
+              _context27.next = 15;
               break;
-            case 10:
-              _context27.prev = 10;
-              _context27.t0 = _context27["catch"](5);
+            case 12:
+              _context27.prev = 12;
+              _context27.t0 = _context27["catch"](6);
               this.logError('全量保存订单到 SQLite 失败', {
                 error: _context27.t0 instanceof Error ? _context27.t0.message : String(_context27.t0),
                 orderList: remoteSnapshot.length
               });
-            case 13:
-              return _context27.abrupt("return", mergedSnapshot);
-            case 14:
+            case 15:
+              return _context27.abrupt("return", {
+                orders: mergedSnapshot,
+                persisted: persisted
+              });
+            case 16:
             case "end":
               return _context27.stop();
           }
-        }, _callee27, this, [[5, 10]]);
+        }, _callee27, this, [[6, 12]]);
       }));
       function replaceOrdersSnapshotInSQLite(_x20, _x21) {
         return _replaceOrdersSnapshotInSQLite.apply(this, arguments);
@@ -4076,7 +4288,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "clear",
     value: (function () {
       var _clear = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee29() {
-        var _this25 = this;
+        var _this26 = this;
         return _regeneratorRuntime().wrap(function _callee29$(_context29) {
           while (1) switch (_context29.prev = _context29.next) {
             case 0:
@@ -4092,7 +4304,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                   while (1) switch (_context28.prev = _context28.next) {
                     case 0:
                       _context28.next = 2;
-                      return _this25.dbManager.clear(INDEXDB_STORE_NAME);
+                      return _this26.dbManager.clear(INDEXDB_STORE_NAME);
                     case 2:
                     case "end":
                       return _context28.stop();
@@ -4100,7 +4312,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 }, _callee28);
               })));
             case 5:
-              this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, '');
+              this.clearOrderSnapshotMarker();
               this.emitOrdersChanged([], 'clear');
             case 7:
             case "end":