@pisell/pisellos 2.3.59 → 2.3.60

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

@@ -1226,62 +1226,76 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     key: "loadProductsByServer",
     value: (function () {
       var _loadProductsByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
-        var t0, tSSE, productList, list, duration, errorMessage;
+        var options,
+          trigger,
+          t0,
+          tSSE,
+          productList,
+          list,
+          duration,
+          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] : {};
               if (this.productDataSource) {
-                _context9.next = 3;
+                _context9.next = 4;
                 break;
               }
               this.logWarning('loadProductsByServer: ProductDataSource 不可用');
               return _context9.abrupt("return", []);
-            case 3:
-              this.logInfo('开始通过 DataSource SSE 加载商品列表');
+            case 4:
+              trigger = options.trigger || 'unknown';
+              this.logInfo('开始通过 DataSource SSE 加载商品列表', {
+                trigger: trigger
+              });
               t0 = performance.now();
-              _context9.prev = 5;
+              _context9.prev = 7;
               tSSE = performance.now();
-              _context9.next = 9;
+              _context9.next = 11;
               return this.productDataSource.run({
                 sse: {}
               });
-            case 9:
+            case 11:
               productList = _context9.sent;
               list = productList || [];
               perfMark('loadProductsByServer.SSE', performance.now() - tSSE, {
                 count: list.length
               });
               this.logInfo('通过 DataSource SSE 加载商品列表成功', {
+                trigger: trigger,
                 productCount: list.length,
                 duration: "".concat(Math.round(performance.now() - t0), "ms")
               });
-              _context9.next = 15;
+              _context9.next = 17;
               return this.replaceProductsSnapshotInIndexDB(list, 'loadProductsByServer');
-            case 15:
+            case 17:
               this.lastServerFullFetchAtMs = Date.now();
-              _context9.next = 18;
+              _context9.next = 20;
               return this.core.effects.emit(ProductsHooks.onProductsLoaded, list);
-            case 18:
+            case 20:
               perfMark('loadProductsByServer', performance.now() - t0, {
                 count: list.length
               });
               return _context9.abrupt("return", list);
-            case 22:
-              _context9.prev = 22;
-              _context9.t0 = _context9["catch"](5);
+            case 24:
+              _context9.prev = 24;
+              _context9.t0 = _context9["catch"](7);
               duration = Math.round(performance.now() - t0);
               errorMessage = _context9.t0 instanceof Error ? _context9.t0.message : String(_context9.t0);
               console.error('[Products] 加载商品数据失败:', _context9.t0);
               this.logError('通过 DataSource SSE 加载商品列表失败', {
+                trigger: trigger,
                 duration: "".concat(duration, "ms"),
                 error: errorMessage
               });
               return _context9.abrupt("return", []);
-            case 29:
+            case 31:
             case "end":
               return _context9.stop();
           }
-        }, _callee9, this, [[5, 22]]);
+        }, _callee9, this, [[7, 24]]);
       }));
       function loadProductsByServer() {
         return _loadProductsByServer.apply(this, arguments);
@@ -1678,7 +1692,9 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
               tTotal = performance.now();
               this.logInfo('refreshProducts 开始');
               _context16.next = 4;
-              return this.loadProductsByServer();
+              return this.loadProductsByServer({
+                trigger: 'product_sync'
+              });
             case 4:
               products = _context16.sent;
               if (products && products.length > 0) {
@@ -1770,7 +1786,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     key: "loadProductsFromIndexDB",
     value: (function () {
       var _loadProductsFromIndexDB = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee18() {
-        var _products$length, _products$length2, t0, products, errorMessage;
+        var startedAt, _products$length, _products$length2, products, durationMs, errorMessage;
         return _regeneratorRuntime().wrap(function _callee18$(_context18) {
           while (1) switch (_context18.prev = _context18.next) {
             case 0:
@@ -1781,33 +1797,36 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
               this.logWarning('loadProductsFromIndexDB: dbManager 不可用');
               return _context18.abrupt("return", []);
             case 3:
-              _context18.prev = 3;
-              t0 = performance.now();
+              startedAt = performance.now();
+              _context18.prev = 4;
               _context18.next = 7;
               return this.dbManager.getAll(INDEXDB_STORE_NAME);
             case 7:
               products = _context18.sent;
-              perfMark('loadProductsFromIndexDB', performance.now() - t0, {
+              durationMs = +(performance.now() - startedAt).toFixed(2);
+              perfMark('loadProductsFromIndexDB', durationMs, {
                 count: (_products$length = products === null || products === void 0 ? void 0 : products.length) !== null && _products$length !== void 0 ? _products$length : 0
               });
               this.logInfo('从 IndexDB 加载商品数据', {
-                productCount: (_products$length2 = products === null || products === void 0 ? void 0 : products.length) !== null && _products$length2 !== void 0 ? _products$length2 : 0
+                productCount: (_products$length2 = products === null || products === void 0 ? void 0 : products.length) !== null && _products$length2 !== void 0 ? _products$length2 : 0,
+                durationMs: durationMs
               });
               return _context18.abrupt("return", products || []);
-            case 13:
-              _context18.prev = 13;
-              _context18.t0 = _context18["catch"](3);
+            case 14:
+              _context18.prev = 14;
+              _context18.t0 = _context18["catch"](4);
               errorMessage = _context18.t0 instanceof Error ? _context18.t0.message : String(_context18.t0);
               console.error('[Products] 从 IndexDB 读取数据失败:', _context18.t0);
               this.logError('从 IndexDB 读取数据失败', {
+                durationMs: +(performance.now() - startedAt).toFixed(2),
                 error: errorMessage
               });
               return _context18.abrupt("return", []);
-            case 19:
+            case 20:
             case "end":
               return _context18.stop();
           }
-        }, _callee18, this, [[3, 13]]);
+        }, _callee18, this, [[4, 14]]);
       }));
       function loadProductsFromIndexDB() {
         return _loadProductsFromIndexDB.apply(this, arguments);
@@ -1861,7 +1880,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     value: (function () {
       var _replaceProductsSnapshotInIndexDB = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee21(products, source) {
         var _this9 = this;
-        var errorMessage;
+        var enqueuedAt, queueWaitMs, clearDurationMs, writeDurationMs, errorMessage;
         return _regeneratorRuntime().wrap(function _callee21$(_context21) {
           while (1) switch (_context21.prev = _context21.next) {
             case 0:
@@ -1872,58 +1891,86 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
               this.logWarning('replaceProductsSnapshotInIndexDB: dbManager 不可用');
               return _context21.abrupt("return");
             case 3:
-              _context21.prev = 3;
-              _context21.next = 6;
+              enqueuedAt = performance.now();
+              queueWaitMs = 0;
+              clearDurationMs = 0;
+              writeDurationMs = 0;
+              _context21.prev = 7;
+              _context21.next = 10;
               return this.runInProductIndexDBSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee20() {
-                var t0;
+                var operationStartedAt, clearStartedAt, writeStartedAt, executeDurationMs;
                 return _regeneratorRuntime().wrap(function _callee20$(_context20) {
                   while (1) switch (_context20.prev = _context20.next) {
                     case 0:
+                      operationStartedAt = performance.now();
+                      queueWaitMs = +(operationStartedAt - enqueuedAt).toFixed(2);
                       _this9.logInfo('replaceProductsSnapshotInIndexDB 开始', {
                         source: source,
-                        productCount: products.length
+                        productCount: products.length,
+                        queueWaitMs: queueWaitMs
                       });
-                      t0 = performance.now();
-                      _context20.next = 4;
+                      clearStartedAt = performance.now();
+                      _context20.prev = 4;
+                      _context20.next = 7;
                       return _this9.dbManager.clear(INDEXDB_STORE_NAME);
-                    case 4:
+                    case 7:
+                      _context20.prev = 7;
+                      clearDurationMs = +(performance.now() - clearStartedAt).toFixed(2);
+                      return _context20.finish(7);
+                    case 10:
                       if (!(products.length > 0)) {
-                        _context20.next = 7;
+                        _context20.next = 18;
                         break;
                       }
-                      _context20.next = 7;
+                      writeStartedAt = performance.now();
+                      _context20.prev = 12;
+                      _context20.next = 15;
                       return _this9.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
-                    case 7:
-                      perfMark('replaceProductsSnapshotInIndexDB', performance.now() - t0, {
+                    case 15:
+                      _context20.prev = 15;
+                      writeDurationMs = +(performance.now() - writeStartedAt).toFixed(2);
+                      return _context20.finish(15);
+                    case 18:
+                      executeDurationMs = +(performance.now() - operationStartedAt).toFixed(2);
+                      perfMark('replaceProductsSnapshotInIndexDB', executeDurationMs, {
                         count: products.length
                       });
                       _this9.logInfo('replaceProductsSnapshotInIndexDB 完成', {
                         source: source,
-                        productCount: products.length
+                        productCount: products.length,
+                        queueWaitMs: queueWaitMs,
+                        clearDurationMs: clearDurationMs,
+                        writeDurationMs: writeDurationMs,
+                        executeDurationMs: executeDurationMs,
+                        totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2)
                       });
-                    case 9:
+                    case 21:
                     case "end":
                       return _context20.stop();
                   }
-                }, _callee20);
+                }, _callee20, null, [[4,, 7, 10], [12,, 15, 18]]);
               })));
-            case 6:
-              _context21.next = 12;
+            case 10:
+              _context21.next = 16;
               break;
-            case 8:
-              _context21.prev = 8;
-              _context21.t0 = _context21["catch"](3);
+            case 12:
+              _context21.prev = 12;
+              _context21.t0 = _context21["catch"](7);
               errorMessage = _context21.t0 instanceof Error ? _context21.t0.message : String(_context21.t0);
               this.logError('全量保存商品到 IndexDB 失败', {
                 source: source,
                 productCount: products.length,
+                queueWaitMs: queueWaitMs,
+                clearDurationMs: clearDurationMs,
+                writeDurationMs: writeDurationMs,
+                totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2),
                 error: errorMessage
               });
-            case 12:
+            case 16:
             case "end":
               return _context21.stop();
           }
-        }, _callee21, this, [[3, 8]]);
+        }, _callee21, this, [[7, 12]]);
       }));
       function replaceProductsSnapshotInIndexDB(_x21, _x22) {
         return _replaceProductsSnapshotInIndexDB.apply(this, arguments);
@@ -2124,6 +2171,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                 source: 'IndexDB'
               });
               this.logInfo('预加载完成（从 IndexDB）', {
+                trigger: 'preload',
                 productCount: cachedData.length,
                 duration: "".concat(Math.round(performance.now() - tTotal), "ms"),
                 source: 'IndexDB'
@@ -2146,7 +2194,9 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
             case 29:
               tServer = performance.now();
               _context24.next = 32;
-              return this.loadProductsByServer();
+              return this.loadProductsByServer({
+                trigger: 'preload'
+              });
             case 32:
               products = _context24.sent;
               perfMark('preload.loadFromServer', performance.now() - tServer, {
@@ -2166,6 +2216,7 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
                   source: 'Server'
                 });
                 this.logInfo('预加载完成（从服务器）', {
+                  trigger: 'preload',
                   productCount: products.length,
                   duration: "".concat(Math.round(performance.now() - tTotal), "ms"),
                   source: 'Server'
@@ -2790,64 +2841,91 @@ export var ProductsModule = /*#__PURE__*/function (_BaseModule) {
     key: "silentRefresh",
     value: (function () {
       var _silentRefresh = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee29() {
-        var t0, now, elapsedSincePreload, elapsedSinceFullFetch, products, errorMessage;
+        var options,
+          t0,
+          now,
+          trigger,
+          elapsedSincePreloadMs,
+          elapsedSinceFullFetchMs,
+          products,
+          errorMessage,
+          _args29 = arguments;
         return _regeneratorRuntime().wrap(function _callee29$(_context29) {
           while (1) switch (_context29.prev = _context29.next) {
             case 0:
+              options = _args29.length > 0 && _args29[0] !== undefined ? _args29[0] : {};
               t0 = performance.now();
               now = Date.now();
-              elapsedSincePreload = now - this.lastPreloadCompletedAtMs;
-              elapsedSinceFullFetch = now - this.lastServerFullFetchAtMs;
-              if (!(this.lastPreloadCompletedAtMs > 0 && elapsedSincePreload < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS)) {
-                _context29.next = 6;
+              trigger = options.trigger || 'background';
+              elapsedSincePreloadMs = now - this.lastPreloadCompletedAtMs;
+              elapsedSinceFullFetchMs = now - this.lastServerFullFetchAtMs;
+              if (!(this.lastPreloadCompletedAtMs > 0 && elapsedSincePreloadMs < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetchMs < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS)) {
+                _context29.next = 9;
                 break;
               }
+              this.logInfo('silentRefresh 跳过全量 SSE', {
+                trigger: trigger,
+                reason: 'within_min_interval',
+                minIntervalMs: PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS,
+                elapsedSincePreloadMs: elapsedSincePreloadMs,
+                elapsedSinceFullFetchMs: elapsedSinceFullFetchMs,
+                productCount: this.store.list.length
+              });
               return _context29.abrupt("return", this.store.list);
-            case 6:
-              this.logInfo('silentRefresh 开始');
-              _context29.prev = 7;
-              _context29.next = 10;
-              return this.loadProductsByServer();
-            case 10:
+            case 9:
+              this.logInfo('silentRefresh 开始', {
+                trigger: trigger,
+                elapsedSincePreloadMs: elapsedSincePreloadMs,
+                elapsedSinceFullFetchMs: elapsedSinceFullFetchMs,
+                productCount: this.store.list.length
+              });
+              _context29.prev = 10;
+              _context29.next = 13;
+              return this.loadProductsByServer({
+                trigger: trigger
+              });
+            case 13:
               products = _context29.sent;
               if (!(products && products.length > 0)) {
-                _context29.next = 21;
+                _context29.next = 24;
                 break;
               }
               this.store.list = products;
               this.syncProductsMap();
               this.clearPriceCache();
               this.core.effects.emit(ProductsHooks.onProductsChanged, this.store.list);
-              _context29.next = 18;
+              _context29.next = 21;
               return this.core.effects.emit(ProductsHooks.onProductsSyncCompleted, null);
-            case 18:
+            case 21:
               this.logInfo('silentRefresh 完成', {
+                trigger: trigger,
                 productCount: products.length,
                 duration: "".concat(Math.round(performance.now() - t0), "ms")
               });
-              _context29.next = 22;
+              _context29.next = 25;
               break;
-            case 21:
+            case 24:
               this.logWarning('silentRefresh: 服务器未返回数据');
-            case 22:
+            case 25:
               perfMark('silentRefresh', performance.now() - t0, {
                 count: this.store.list.length
               });
               return _context29.abrupt("return", this.store.list);
-            case 26:
-              _context29.prev = 26;
-              _context29.t0 = _context29["catch"](7);
+            case 29:
+              _context29.prev = 29;
+              _context29.t0 = _context29["catch"](10);
               errorMessage = _context29.t0 instanceof Error ? _context29.t0.message : String(_context29.t0);
               this.logError('silentRefresh 失败', {
+                trigger: trigger,
                 duration: "".concat(Math.round(performance.now() - t0), "ms"),
                 error: errorMessage
               });
               return _context29.abrupt("return", this.store.list);
-            case 31:
+            case 34:
             case "end":
               return _context29.stop();
           }
-        }, _callee29, this, [[7, 26]]);
+        }, _callee29, this, [[10, 29]]);
       }));
       function silentRefresh() {
         return _silentRefresh.apply(this, arguments);

package/lib/model/strategy/adapter/promotion/index.js

@@ -0,0 +1,51 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/model/strategy/adapter/promotion/index.ts
+var promotion_exports = {};
+__export(promotion_exports, {
+  BUY_X_GET_Y_FREE_STRATEGY: () => import_examples.BUY_X_GET_Y_FREE_STRATEGY,
+  ITEM_REWARD_STRATEGY: () => import_examples.ITEM_REWARD_STRATEGY,
+  PromotionAdapter: () => import_adapter.PromotionAdapter,
+  PromotionEvaluator: () => import_evaluator.PromotionEvaluator,
+  X_ITEMS_FOR_Y_PRICE_STRATEGY: () => import_examples.X_ITEMS_FOR_Y_PRICE_STRATEGY,
+  default: () => import_adapter2.default
+});
+module.exports = __toCommonJS(promotion_exports);
+var import_evaluator = require("./evaluator");
+var import_adapter = require("./adapter");
+var import_adapter2 = __toESM(require("./adapter"));
+var import_examples = require("./examples");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BUY_X_GET_Y_FREE_STRATEGY,
+  ITEM_REWARD_STRATEGY,
+  PromotionAdapter,
+  PromotionEvaluator,
+  X_ITEMS_FOR_Y_PRICE_STRATEGY
+});

package/lib/server/index.d.ts

@@ -157,13 +157,17 @@ declare class Server {
      * 重新拉取全量 SSE 接口，更新本地数据后触发 onProductsSyncCompleted
      * 不影响当前界面展示，适用于切回前台、定时刷新等场景
      */
-    refreshProductsInBackground(): Promise<void>;
+    refreshProductsInBackground(options?: {
+        trigger?: string;
+    }): Promise<void>;
     /**
      * 后台静默刷新订单数据
      * 重新拉取全量 SSE 接口，更新本地数据后触发 onOrdersSyncCompleted
      * 不影响当前界面展示，适用于切回前台、定时刷新等场景
      */
-    refreshOrdersInBackground(): Promise<void>;
+    refreshOrdersInBackground(options?: {
+        trigger?: string;
+    }): Promise<void>;
     /**
      * 编辑正式订单时强制查询 Server 最新快照并覆盖本地缓存。
      * 商品成员增删由 OrderModule 在 SQLite/Store 更新完成后广播，

package/lib/server/index.js

@@ -1761,22 +1761,27 @@ var Server = class {
    * 重新拉取全量 SSE 接口，更新本地数据后触发 onProductsSyncCompleted
    * 不影响当前界面展示，适用于切回前台、定时刷新等场景
    */
-  async refreshProductsInBackground() {
+  async refreshProductsInBackground(options = {}) {
     if (!this.products) {
       this.logWarning("refreshProductsInBackground: Products 模块未注册");
       return;
     }
-    this.logInfo("refreshProductsInBackground 开始");
+    const trigger = options.trigger || "background";
+    this.logInfo("refreshProductsInBackground 开始", { trigger });
     const startTime = Date.now();
     try {
-      await this.products.silentRefresh();
+      await this.products.silentRefresh({ trigger });
       const duration = Date.now() - startTime;
-      this.logInfo("refreshProductsInBackground 完成", { duration: `${duration}ms` });
+      this.logInfo("refreshProductsInBackground 完成", {
+        trigger,
+        duration: `${duration}ms`
+      });
     } catch (error) {
       const duration = Date.now() - startTime;
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Server] refreshProductsInBackground 失败:", error);
       this.logError("refreshProductsInBackground 失败", {
+        trigger,
         duration: `${duration}ms`,
         error: errorMessage
       });
@@ -1787,22 +1792,27 @@ var Server = class {
    * 重新拉取全量 SSE 接口，更新本地数据后触发 onOrdersSyncCompleted
    * 不影响当前界面展示，适用于切回前台、定时刷新等场景
    */
-  async refreshOrdersInBackground() {
+  async refreshOrdersInBackground(options = {}) {
     if (!this.order) {
       this.logWarning("refreshOrdersInBackground: Order 模块未注册");
       return;
     }
-    this.logInfo("refreshOrdersInBackground 开始");
+    const trigger = options.trigger || "background";
+    this.logInfo("refreshOrdersInBackground 开始", { trigger });
     const startTime = Date.now();
     try {
-      await this.order.silentRefresh();
+      await this.order.silentRefresh({ trigger });
       const duration = Date.now() - startTime;
-      this.logInfo("refreshOrdersInBackground 完成", { duration: `${duration}ms` });
+      this.logInfo("refreshOrdersInBackground 完成", {
+        trigger,
+        duration: `${duration}ms`
+      });
     } catch (error) {
       const duration = Date.now() - startTime;
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Server] refreshOrdersInBackground 失败:", error);
       this.logError("refreshOrdersInBackground 失败", {
+        trigger,
         duration: `${duration}ms`,
         error: errorMessage
       });

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

@@ -185,16 +185,21 @@ 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
+        menuCount: (menuList == null ? void 0 : menuList.length) ?? 0,
+        durationMs: +(performance.now() - startedAt).toFixed(2)
       });
       return menuList || [];
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Menu] 从 IndexDB 读取数据失败:", error);
-      this.logError("从 IndexDB 读取数据失败", { error: errorMessage });
+      this.logError("从 IndexDB 读取数据失败", {
+        durationMs: +(performance.now() - startedAt).toFixed(2),
+        error: errorMessage
+      });
       return [];
     }
   }
@@ -207,20 +212,41 @@ 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 {
-      await this.dbManager.clear(INDEXDB_STORE_NAME);
+      const clearStartedAt = performance.now();
+      try {
+        await this.dbManager.clear(INDEXDB_STORE_NAME);
+      } finally {
+        clearDurationMs = +(performance.now() - clearStartedAt).toFixed(2);
+      }
+      const writeStartedAt = performance.now();
       const savePromises = menuList.map(
         (menu) => this.dbManager.add(INDEXDB_STORE_NAME, menu)
       );
-      await Promise.all(savePromises);
+      try {
+        await Promise.all(savePromises);
+      } finally {
+        writeDurationMs = +(performance.now() - writeStartedAt).toFixed(2);
+      }
       console.log(`[Menu] 已将 ${menuList.length} 条餐牌数据保存到 IndexDB`);
-      this.logInfo("餐牌数据已保存到 IndexDB", { menuCount: menuList.length });
+      this.logInfo("餐牌数据已保存到 IndexDB", {
+        menuCount: menuList.length,
+        clearDurationMs,
+        writeDurationMs,
+        totalDurationMs: +(performance.now() - startedAt).toFixed(2)
+      });
     } 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,13 +119,17 @@ export declare class OrderModule extends BaseModule implements Module {
         payment: Record<string, any>;
         previousPayment: Record<string, any>;
     } | null>;
-    loadOrdersByServer(): Promise<OrderData[]>;
+    loadOrdersByServer(options?: {
+        trigger?: string;
+    }): Promise<OrderData[]>;
     /**
      * 静默全量刷新：后台重新拉取全量 SSE 订单数据并更新本地
      * 拿到完整数据后一次性替换 store，触发订单变更与同步完成事件
      * @returns 刷新后的订单列表
      */
-    silentRefresh(): Promise<OrderData[]>;
+    silentRefresh(options?: {
+        trigger?: string;
+    }): Promise<OrderData[]>;
     private normalizeOrderForMemoryList;
     private normalizeOrdersForMemoryList;
     private hasRealOrderId;