@pisell/pisellos 2.3.68 → 2.3.69

package/dist/server/index.js

@@ -103,6 +103,8 @@ var Server = /*#__PURE__*/function () {
     _defineProperty(this, "productQueryScheduleTimers", new Map());
     /** 餐牌筛选为空时才触发的菜单/日程缓存自愈，避免每次商品查询都请求远端。 */
     _defineProperty(this, "menuScheduleRefreshInFlight", null);
+    /** 启动阶段模块预加载任务；预渲染商品查询复用该任务，避免缓存尚未 ready 时误触发远端自愈。 */
+    _defineProperty(this, "startupModulePreloadInFlight", null);
     _defineProperty(this, "lastMenuScheduleRefreshAt", 0);
     _defineProperty(this, "MENU_SCHEDULE_REFRESH_COOLDOWN_MS", 30 * 1000);
     // ---- 订单 / 预约列表查询订阅者 ----
@@ -2266,6 +2268,7 @@ var Server = /*#__PURE__*/function () {
           options,
           startTime,
           registeredModules,
+          preloadTask,
           duration,
           _args29 = arguments;
         return _regeneratorRuntime().wrap(function _callee29$(_context29) {
@@ -2290,22 +2293,31 @@ var Server = /*#__PURE__*/function () {
             case 8:
               registeredModules = _context29.sent;
               if (!autoPreload) {
-                _context29.next = 14;
+                _context29.next = 20;
                 break;
               }
-              _context29.next = 12;
-              return this.preloadModulesData(registeredModules, options);
-            case 12:
+              preloadTask = this.preloadModulesData(registeredModules, options);
+              this.startupModulePreloadInFlight = preloadTask;
+              _context29.prev = 12;
               _context29.next = 15;
+              return preloadTask;
+            case 15:
+              _context29.prev = 15;
+              if (this.startupModulePreloadInFlight === preloadTask) {
+                this.startupModulePreloadInFlight = null;
+              }
+              return _context29.finish(15);
+            case 18:
+              _context29.next = 21;
               break;
-            case 14:
+            case 20:
               this.logInfo('跳过自动预加载', {
                 autoPreload: autoPreload
               });
-            case 15:
-              _context29.next = 17;
+            case 21:
+              _context29.next = 23;
               return this.setupProductsQuotationPriceBridge();
-            case 17:
+            case 23:
               // 监听 ProductsModule 同步完成事件，重新计算并推送查询结果
               this.core.effects.on(ProductsHooks.onProductsSyncCompleted, function (payload) {
                 _this3.recomputeAndNotifyProductQuery({
@@ -2331,11 +2343,11 @@ var Server = /*#__PURE__*/function () {
                 registeredModuleCount: registeredModules.length
               });
               return _context29.abrupt("return", registeredModules);
-            case 23:
+            case 29:
             case "end":
               return _context29.stop();
           }
-        }, _callee29, this);
+        }, _callee29, this, [[12,, 15, 18]]);
       }));
       function initialize(_x32) {
         return _initialize.apply(this, arguments);
@@ -2717,6 +2729,7 @@ var Server = /*#__PURE__*/function () {
     key: "setupProductsQuotationPriceBridge",
     value: (function () {
       var _setupProductsQuotationPriceBridge = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee33() {
+        var _this5 = this;
         var _this$core$context, errorMessage;
         return _regeneratorRuntime().wrap(function _callee33$(_context33) {
           while (1) switch (_context33.prev = _context33.next) {
@@ -2736,31 +2749,42 @@ var Server = /*#__PURE__*/function () {
               return _context33.abrupt("return");
             case 6:
               _context33.prev = 6;
-              _context33.next = 9;
-              return this.schedule.loadAllSchedule();
-            case 9:
               this.products.clearPriceCache();
-              _context33.next = 12;
+              _context33.next = 10;
               return this.products.setupQuotationPriceBridge({
                 scheduleModule: this.schedule,
-                channel: (_this$core$context = this.core.context) === null || _this$core$context === void 0 ? void 0 : _this$core$context.channel
+                channel: (_this$core$context = this.core.context) === null || _this$core$context === void 0 ? void 0 : _this$core$context.channel,
+                onQuotationUpdated: function onQuotationUpdated() {
+                  void _this5.recomputeAndNotifyProductQuery();
+                }
+              });
+            case 10:
+              // Schedule 已在模块 preload 阶段加载完成。价格桥接先使用本地数据，
+              // 远端刷新转为后台校准，避免二次启动重复阻塞请求。
+              void this.schedule.loadAllSchedule().then(function () {
+                var _this5$products;
+                (_this5$products = _this5.products) === null || _this5$products === void 0 || _this5$products.clearPriceCache();
+                void _this5.recomputeAndNotifyProductQuery();
+              }).catch(function (error) {
+                _this5.logWarning('Products 报价单价格桥接后台刷新 Schedule 失败，继续使用本地数据', {
+                  error: error instanceof Error ? error.message : String(error)
+                });
               });
-            case 12:
               this.logInfo('Products 报价单价格桥接初始化完成');
-              _context33.next = 19;
+              _context33.next = 18;
               break;
-            case 15:
-              _context33.prev = 15;
+            case 14:
+              _context33.prev = 14;
               _context33.t0 = _context33["catch"](6);
               errorMessage = _context33.t0 instanceof Error ? _context33.t0.message : String(_context33.t0);
               this.logError('Products 报价单价格桥接初始化失败', {
                 error: errorMessage
               });
-            case 19:
+            case 18:
             case "end":
               return _context33.stop();
           }
-        }, _callee33, this, [[6, 15]]);
+        }, _callee33, this, [[6, 14]]);
       }));
       function setupProductsQuotationPriceBridge() {
         return _setupProductsQuotationPriceBridge.apply(this, arguments);
@@ -2830,44 +2854,58 @@ var Server = /*#__PURE__*/function () {
     key: "refreshProductsInBackground",
     value: (function () {
       var _refreshProductsInBackground = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee34() {
-        var startTime, duration, _duration2, errorMessage;
+        var options,
+          trigger,
+          startTime,
+          duration,
+          _duration2,
+          errorMessage,
+          _args34 = arguments;
         return _regeneratorRuntime().wrap(function _callee34$(_context34) {
           while (1) switch (_context34.prev = _context34.next) {
             case 0:
+              options = _args34.length > 0 && _args34[0] !== undefined ? _args34[0] : {};
               if (this.products) {
-                _context34.next = 3;
+                _context34.next = 4;
                 break;
               }
               this.logWarning('refreshProductsInBackground: Products 模块未注册');
               return _context34.abrupt("return");
-            case 3:
-              this.logInfo('refreshProductsInBackground 开始');
+            case 4:
+              trigger = options.trigger || 'background';
+              this.logInfo('refreshProductsInBackground 开始', {
+                trigger: trigger
+              });
               startTime = Date.now();
-              _context34.prev = 5;
-              _context34.next = 8;
-              return this.products.silentRefresh();
-            case 8:
+              _context34.prev = 7;
+              _context34.next = 10;
+              return this.products.silentRefresh({
+                trigger: trigger
+              });
+            case 10:
               duration = Date.now() - startTime;
               this.logInfo('refreshProductsInBackground 完成', {
+                trigger: trigger,
                 duration: "".concat(duration, "ms")
               });
-              _context34.next = 18;
+              _context34.next = 20;
               break;
-            case 12:
-              _context34.prev = 12;
-              _context34.t0 = _context34["catch"](5);
+            case 14:
+              _context34.prev = 14;
+              _context34.t0 = _context34["catch"](7);
               _duration2 = Date.now() - startTime;
               errorMessage = _context34.t0 instanceof Error ? _context34.t0.message : String(_context34.t0);
               console.error('[Server] refreshProductsInBackground 失败:', _context34.t0);
               this.logError('refreshProductsInBackground 失败', {
+                trigger: trigger,
                 duration: "".concat(_duration2, "ms"),
                 error: errorMessage
               });
-            case 18:
+            case 20:
             case "end":
               return _context34.stop();
           }
-        }, _callee34, this, [[5, 12]]);
+        }, _callee34, this, [[7, 14]]);
       }));
       function refreshProductsInBackground() {
         return _refreshProductsInBackground.apply(this, arguments);
@@ -2884,44 +2922,58 @@ var Server = /*#__PURE__*/function () {
     key: "refreshOrdersInBackground",
     value: (function () {
       var _refreshOrdersInBackground = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee35() {
-        var startTime, duration, _duration3, errorMessage;
+        var options,
+          trigger,
+          startTime,
+          duration,
+          _duration3,
+          errorMessage,
+          _args35 = arguments;
         return _regeneratorRuntime().wrap(function _callee35$(_context35) {
           while (1) switch (_context35.prev = _context35.next) {
             case 0:
+              options = _args35.length > 0 && _args35[0] !== undefined ? _args35[0] : {};
               if (this.order) {
-                _context35.next = 3;
+                _context35.next = 4;
                 break;
               }
               this.logWarning('refreshOrdersInBackground: Order 模块未注册');
               return _context35.abrupt("return");
-            case 3:
-              this.logInfo('refreshOrdersInBackground 开始');
+            case 4:
+              trigger = options.trigger || 'background';
+              this.logInfo('refreshOrdersInBackground 开始', {
+                trigger: trigger
+              });
               startTime = Date.now();
-              _context35.prev = 5;
-              _context35.next = 8;
-              return this.order.silentRefresh();
-            case 8:
+              _context35.prev = 7;
+              _context35.next = 10;
+              return this.order.silentRefresh({
+                trigger: trigger
+              });
+            case 10:
               duration = Date.now() - startTime;
               this.logInfo('refreshOrdersInBackground 完成', {
+                trigger: trigger,
                 duration: "".concat(duration, "ms")
               });
-              _context35.next = 18;
+              _context35.next = 20;
               break;
-            case 12:
-              _context35.prev = 12;
-              _context35.t0 = _context35["catch"](5);
+            case 14:
+              _context35.prev = 14;
+              _context35.t0 = _context35["catch"](7);
               _duration3 = Date.now() - startTime;
               errorMessage = _context35.t0 instanceof Error ? _context35.t0.message : String(_context35.t0);
               console.error('[Server] refreshOrdersInBackground 失败:', _context35.t0);
               this.logError('refreshOrdersInBackground 失败', {
+                trigger: trigger,
                 duration: "".concat(_duration3, "ms"),
                 error: errorMessage
               });
-            case 18:
+            case 20:
             case "end":
               return _context35.stop();
           }
-        }, _callee35, this, [[5, 12]]);
+        }, _callee35, this, [[7, 14]]);
       }));
       function refreshOrdersInBackground() {
         return _refreshOrdersInBackground.apply(this, arguments);
@@ -3235,10 +3287,10 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "getAllRoutes",
     value: function getAllRoutes() {
-      var _this5 = this;
+      var _this6 = this;
       var routes = [];
       ['get', 'post', 'put', 'remove'].forEach(function (method) {
-        Object.keys(_this5.router[method]).forEach(function (path) {
+        Object.keys(_this6.router[method]).forEach(function (path) {
           routes.push({
             method: method,
             path: path
@@ -3368,7 +3420,7 @@ var Server = /*#__PURE__*/function () {
     key: "getPaymentRouteModule",
     value: function () {
       var _getPaymentRouteModule = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee40() {
-        var _this6 = this;
+        var _this7 = this;
         return _regeneratorRuntime().wrap(function _callee40$(_context40) {
           while (1) switch (_context40.prev = _context40.next) {
             case 0:
@@ -3397,13 +3449,13 @@ var Server = /*#__PURE__*/function () {
                     case 0:
                       module = new PaymentServerModule('server_payment_route', '1.0.0');
                       _context39.next = 3;
-                      return module.initialize(_this6.core, {
+                      return module.initialize(_this7.core, {
                         store: {
                           payMethods: []
                         }
                       });
                     case 3:
-                      _this6.paymentRouteModule = module;
+                      _this7.paymentRouteModule = module;
                       return _context39.abrupt("return", module);
                     case 5:
                     case "end":
@@ -3411,7 +3463,7 @@ var Server = /*#__PURE__*/function () {
                   }
                 }, _callee39);
               }))().finally(function () {
-                _this6.paymentRouteModuleInFlight = undefined;
+                _this7.paymentRouteModuleInFlight = undefined;
               });
               return _context40.abrupt("return", this.paymentRouteModuleInFlight);
             case 8:
@@ -3587,7 +3639,7 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "scheduleSubscriberTimePointReloads",
     value: function scheduleSubscriberTimePointReloads(subscriberId, timePoints) {
-      var _this7 = this;
+      var _this8 = this;
       var subscriber = this.productQuerySubscribers.get(subscriberId);
       if (!subscriber || !timePoints.length) return;
       var scheduleDate = subscriber.context.schedule_date || dayjs().format('YYYY-MM-DD');
@@ -3608,7 +3660,7 @@ var Server = /*#__PURE__*/function () {
       setInterval(function () {
         var currentTime = dayjs().format('hh:mm');
         if (timePoints.includes(currentTime)) {
-          _this7.onScheduleTimePointTimerFire(subscriberId);
+          _this8.onScheduleTimePointTimerFire(subscriberId);
         }
       }, 60000);
       if (timerIds.length > 0) {
@@ -3777,7 +3829,7 @@ var Server = /*#__PURE__*/function () {
     key: "refreshMenuScheduleCacheAfterEmptyResult",
     value: (function () {
       var _refreshMenuScheduleCacheAfterEmptyResult = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee44() {
-        var _this8 = this;
+        var _this9 = this;
         var now;
         return _regeneratorRuntime().wrap(function _callee44$(_context44) {
           while (1) switch (_context44.prev = _context44.next) {
@@ -3800,11 +3852,11 @@ var Server = /*#__PURE__*/function () {
                 this.menuScheduleRefreshInFlight = Promise.all([this.menu.loadMenuList(), this.schedule.loadAllSchedule()]).then(function () {
                   return undefined;
                 }).catch(function (error) {
-                  _this8.logWarning('刷新菜单/日程缓存失败，继续使用现有缓存', {
+                  _this9.logWarning('刷新菜单/日程缓存失败，继续使用现有缓存', {
                     error: error instanceof Error ? error.message : String(error)
                   });
                 }).finally(function () {
-                  _this8.menuScheduleRefreshInFlight = null;
+                  _this9.menuScheduleRefreshInFlight = null;
                 });
               }
               _context44.next = 8;
@@ -3990,10 +4042,10 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "stripSalesSearchPageParams",
     value: function stripSalesSearchPageParams(value) {
-      var _this9 = this;
+      var _this10 = this;
       if (Array.isArray(value)) {
         return value.map(function (item) {
-          return _this9.stripSalesSearchPageParams(item);
+          return _this10.stripSalesSearchPageParams(item);
         });
       }
       if (!value || _typeof(value) !== 'object') return value;
@@ -4031,12 +4083,12 @@ var Server = /*#__PURE__*/function () {
     key: "extractSalesSearchOrderIds",
     value: function extractSalesSearchOrderIds(kind, result) {
       var _this$findSalesSearch,
-        _this10 = this;
+        _this11 = this;
       var data = this.extractSalesSearchResponseData(result);
       var list = kind === 'aggregate' ? (_this$findSalesSearch = this.findSalesSearchAggregateGroup(data)) === null || _this$findSalesSearch === void 0 ? void 0 : _this$findSalesSearch.list : data === null || data === void 0 ? void 0 : data.list;
       if (!Array.isArray(list)) return [];
       return list.map(function (item) {
-        return _this10.getSalesSearchOrderId(item);
+        return _this11.getSalesSearchOrderId(item);
       }).filter(function (id) {
         return !!id;
       });
@@ -4203,11 +4255,11 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "stableSerialize",
     value: function stableSerialize(value) {
-      var _this11 = this;
+      var _this12 = this;
       if (value === null || value === undefined) return 'null';
       if (Array.isArray(value)) {
         return "[".concat(value.map(function (item) {
-          return _this11.stableSerialize(item);
+          return _this12.stableSerialize(item);
         }).join(','), "]");
       }
       if (_typeof(value) === 'object') {
@@ -4216,7 +4268,7 @@ var Server = /*#__PURE__*/function () {
           return obj[k] !== undefined;
         }).sort();
         return "{".concat(keys.map(function (k) {
-          return "".concat(JSON.stringify(k), ":").concat(_this11.stableSerialize(obj[k]));
+          return "".concat(JSON.stringify(k), ":").concat(_this12.stableSerialize(obj[k]));
         }).join(','), "}");
       }
       return JSON.stringify(value);
@@ -4756,7 +4808,7 @@ var Server = /*#__PURE__*/function () {
     key: "runLocalPaymentUpdateInQueue",
     value: function () {
       var _runLocalPaymentUpdateInQueue = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee50(key, task, context) {
-        var _this12 = this;
+        var _this13 = this;
         var queuedAt, hasPreviousTask, previous, current, tail, _data, result, released;
         return _regeneratorRuntime().wrap(function _callee50$(_context50) {
           while (1) switch (_context50.prev = _context50.next) {
@@ -4775,7 +4827,7 @@ var Server = /*#__PURE__*/function () {
                 return _regeneratorRuntime().wrap(function _callee49$(_context49) {
                   while (1) switch (_context49.prev = _context49.next) {
                     case 0:
-                      _this12.logInfo('handleUpdateLocalPayment: 串行队列开始执行', _objectSpread(_objectSpread({}, context), {}, {
+                      _this13.logInfo('handleUpdateLocalPayment: 串行队列开始执行', _objectSpread(_objectSpread({}, context), {}, {
                         queue_key: key,
                         queue_wait_ms: Date.now() - queuedAt
                       }));
@@ -6167,7 +6219,7 @@ var Server = /*#__PURE__*/function () {
     key: "handlePendingSyncCheckoutOrder",
     value: function () {
       var _handlePendingSyncCheckoutOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee63(params) {
-        var _this13 = this;
+        var _this14 = this;
         var backendPath, data, title, reason, pendingOrder, _pendingOrder$payment, _pendingOrder$summary, _pendingOrder$summary2, _pendingOrder$summary3, changeGivenAmount, errorMessage;
         return _regeneratorRuntime().wrap(function _callee63$(_context63) {
           while (1) switch (_context63.prev = _context63.next) {
@@ -6220,7 +6272,7 @@ var Server = /*#__PURE__*/function () {
               });
               changeGivenAmount = pendingOrder === null || pendingOrder === void 0 || (_pendingOrder$payment = pendingOrder.payments) === null || _pendingOrder$payment === void 0 ? void 0 : _pendingOrder$payment.reduce(function (sum, payment) {
                 var _payment$metadata;
-                return sum + _this13.toAmountNumber(payment === null || payment === void 0 || (_payment$metadata = payment.metadata) === null || _payment$metadata === void 0 ? void 0 : _payment$metadata.change_given_amount);
+                return sum + _this14.toAmountNumber(payment === null || payment === void 0 || (_payment$metadata = payment.metadata) === null || _payment$metadata === void 0 ? void 0 : _payment$metadata.change_given_amount);
               }, 0);
               return _context63.abrupt("return", {
                 code: 200,
@@ -6360,13 +6412,13 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "sumPaidOrderPayments",
     value: function sumPaidOrderPayments(payments) {
-      var _this14 = this;
+      var _this15 = this;
       if (!Array.isArray(payments)) return 0;
       return payments.reduce(function (sum, payment) {
         var _payment$amount;
         var status = String((payment === null || payment === void 0 ? void 0 : payment.status) || '').toLowerCase();
         if (status !== 'paid') return sum;
-        return sum + _this14.toAmountNumber((_payment$amount = payment === null || payment === void 0 ? void 0 : payment.amount) !== null && _payment$amount !== void 0 ? _payment$amount : payment === null || payment === void 0 ? void 0 : payment.origin_amount);
+        return sum + _this15.toAmountNumber((_payment$amount = payment === null || payment === void 0 ? void 0 : payment.amount) !== null && _payment$amount !== void 0 ? _payment$amount : payment === null || payment === void 0 ? void 0 : payment.origin_amount);
       }, 0);
     }
   }, {
@@ -6382,7 +6434,7 @@ var Server = /*#__PURE__*/function () {
     value: function () {
       var _buildSmallTicketProductMap = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee66(order) {
         var _this$products3,
-          _this15 = this;
+          _this16 = this;
         var products, productIdSet, productIds, entries;
         return _regeneratorRuntime().wrap(function _callee66$(_context66) {
           while (1) switch (_context66.prev = _context66.next) {
@@ -6415,20 +6467,20 @@ var Server = /*#__PURE__*/function () {
               _context66.next = 8;
               return Promise.all(productIds.map( /*#__PURE__*/function () {
                 var _ref68 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee65(id) {
-                  var _this15$products, _this15$products$getP, product;
+                  var _this16$products, _this16$products$getP, product;
                   return _regeneratorRuntime().wrap(function _callee65$(_context65) {
                     while (1) switch (_context65.prev = _context65.next) {
                       case 0:
                         _context65.prev = 0;
                         _context65.next = 3;
-                        return (_this15$products = _this15.products) === null || _this15$products === void 0 || (_this15$products$getP = _this15$products.getProductById) === null || _this15$products$getP === void 0 ? void 0 : _this15$products$getP.call(_this15$products, Number(id));
+                        return (_this16$products = _this16.products) === null || _this16$products === void 0 || (_this16$products$getP = _this16$products.getProductById) === null || _this16$products$getP === void 0 ? void 0 : _this16$products$getP.call(_this16$products, Number(id));
                       case 3:
                         product = _context65.sent;
                         return _context65.abrupt("return", product ? [String(id), product] : null);
                       case 7:
                         _context65.prev = 7;
                         _context65.t0 = _context65["catch"](0);
-                        _this15.logWarning('buildSmallTicketProductMap: 查询本地商品失败', {
+                        _this16.logWarning('buildSmallTicketProductMap: 查询本地商品失败', {
                           product_id: id,
                           error: _context65.t0 instanceof Error ? _context65.t0.message : String(_context65.t0)
                         });
@@ -6579,7 +6631,7 @@ var Server = /*#__PURE__*/function () {
     key: "withSalesDetailProductSnapshots",
     value: function () {
       var _withSalesDetailProductSnapshots = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee68(order) {
-        var _this16 = this;
+        var _this17 = this;
         var products, snapshotMap, hasChanged, enrichedProducts, enrichedOrder;
         return _regeneratorRuntime().wrap(function _callee68$(_context68) {
           while (1) switch (_context68.prev = _context68.next) {
@@ -6603,8 +6655,8 @@ var Server = /*#__PURE__*/function () {
             case 8:
               hasChanged = false;
               enrichedProducts = products.map(function (product) {
-                var productWithBundleSnapshots = _this16.withBundleCatalogSnapshots(product, snapshotMap);
-                var nextProduct = _this16.withProductCatalogSnapshots(productWithBundleSnapshots, snapshotMap);
+                var productWithBundleSnapshots = _this17.withBundleCatalogSnapshots(product, snapshotMap);
+                var nextProduct = _this17.withProductCatalogSnapshots(productWithBundleSnapshots, snapshotMap);
                 if (nextProduct !== product) hasChanged = true;
                 return nextProduct;
               });
@@ -6632,13 +6684,13 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "withPendingSyncProductTitles",
     value: function withPendingSyncProductTitles(order, productMap) {
-      var _this17 = this;
+      var _this18 = this;
       var products = Array.isArray(order.products) ? order.products : null;
       if (!(products !== null && products !== void 0 && products.length)) return order;
       return _objectSpread(_objectSpread({}, order), {}, {
         products: products.map(function (product) {
           return _objectSpread(_objectSpread({}, product), {}, {
-            product_title: _this17.buildProductTitleSnapshot(product, productMap)
+            product_title: _this18.buildProductTitleSnapshot(product, productMap)
           });
         })
       });
@@ -6649,7 +6701,7 @@ var Server = /*#__PURE__*/function () {
       var _product$product_id4,
         _product$product,
         _fallbackProduct$prod,
-        _this18 = this;
+        _this19 = this;
       var productId = (_product$product_id4 = product.product_id) !== null && _product$product_id4 !== void 0 ? _product$product_id4 : product.id;
       var fallbackProduct = productId !== undefined && productId !== null ? productMap[productId] || productMap[String(productId)] : null;
       var ownTitle = product.product_title || product.title || product.name || ((_product$product = product.product) === null || _product$product === void 0 ? void 0 : _product$product.title);
@@ -6657,7 +6709,7 @@ var Server = /*#__PURE__*/function () {
       var currentLocale = this.getProductTitleSnapshotCurrentLocale();
       var autoTitle = this.resolveFirstProductTitleValue(ownTitle) || this.resolveFirstProductTitleValue(fallbackTitle);
       return PRODUCT_TITLE_SNAPSHOT_KEYS.reduce(function (snapshot, key) {
-        snapshot[key] = _this18.resolveProductTitleValue(ownTitle, key, currentLocale) || _this18.resolveProductTitleValue(fallbackTitle, key, currentLocale) || (key === 'auto' || key === 'original' ? autoTitle : null);
+        snapshot[key] = _this19.resolveProductTitleValue(ownTitle, key, currentLocale) || _this19.resolveProductTitleValue(fallbackTitle, key, currentLocale) || (key === 'auto' || key === 'original' ? autoTitle : null);
         return snapshot;
       }, {});
     }
@@ -6756,14 +6808,14 @@ var Server = /*#__PURE__*/function () {
     key: "enrichPaymentNamesByCode",
     value: function () {
       var _enrichPaymentNamesByCode = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee69(order) {
-        var _this19 = this;
+        var _this20 = this;
         var payments, hasMissingName, paymentModule, payMethods, nameByCode, _iterator12, _step12, method, codeKey, name, hasResolvedName, enrichedPayments;
         return _regeneratorRuntime().wrap(function _callee69$(_context69) {
           while (1) switch (_context69.prev = _context69.next) {
             case 0:
               payments = Array.isArray(order === null || order === void 0 ? void 0 : order.payments) ? order.payments : [];
               hasMissingName = payments.some(function (payment) {
-                return _this19.isBlankPaymentName(payment === null || payment === void 0 ? void 0 : payment.name) && _this19.shouldLookupPaymentMethodNameByCode(payment === null || payment === void 0 ? void 0 : payment.code);
+                return _this20.isBlankPaymentName(payment === null || payment === void 0 ? void 0 : payment.name) && _this20.shouldLookupPaymentMethodNameByCode(payment === null || payment === void 0 ? void 0 : payment.code);
               });
               if (hasMissingName) {
                 _context69.next = 4;
@@ -6796,9 +6848,9 @@ var Server = /*#__PURE__*/function () {
               }
               hasResolvedName = false;
               enrichedPayments = payments.map(function (payment) {
-                if (!_this19.isBlankPaymentName(payment === null || payment === void 0 ? void 0 : payment.name)) return payment;
-                if (!_this19.shouldLookupPaymentMethodNameByCode(payment === null || payment === void 0 ? void 0 : payment.code)) return payment;
-                var name = nameByCode.get(_this19.getPaymentCodeKey(payment === null || payment === void 0 ? void 0 : payment.code));
+                if (!_this20.isBlankPaymentName(payment === null || payment === void 0 ? void 0 : payment.name)) return payment;
+                if (!_this20.shouldLookupPaymentMethodNameByCode(payment === null || payment === void 0 ? void 0 : payment.code)) return payment;
+                var name = nameByCode.get(_this20.getPaymentCodeKey(payment === null || payment === void 0 ? void 0 : payment.code));
                 if (!name) return payment;
                 hasResolvedName = true;
                 return _objectSpread(_objectSpread({}, payment), {}, {
@@ -7380,10 +7432,10 @@ var Server = /*#__PURE__*/function () {
     value: function extractBackendErrorResponse(error) {
       var _error$response3,
         _error$response4,
-        _this20 = this;
+        _this21 = this;
       var candidates = [error === null || error === void 0 || (_error$response3 = error.response) === null || _error$response3 === void 0 ? void 0 : _error$response3.data, error === null || error === void 0 ? void 0 : error.data, error === null || error === void 0 || (_error$response4 = error.response) === null || _error$response4 === void 0 ? void 0 : _error$response4.body, error === null || error === void 0 ? void 0 : error.body];
       return candidates.find(function (candidate) {
-        return _this20.isExplicitBackendErrorResponse(candidate);
+        return _this21.isExplicitBackendErrorResponse(candidate);
       }) || null;
     }
   }, {
@@ -7744,8 +7796,8 @@ var Server = /*#__PURE__*/function () {
     value: (function () {
       var _computeProductQueryResult = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee75(context, options) {
         var _menu_list_ids$length3,
-          _this21 = this;
-        var tTotal, menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id, strategy_context, queryIds, formatterContext, uniqueIds, _tPrice, productsWithPrice, _filteredProducts, extensionFilteredProducts, _published$find, pid, _tPrice2, allProductsWithPrice, published, item, _tPrice3, _filteredProducts2, _tStatus, _beforeStatusCount, _tExtensionType, _beforeExtensionTypeCount, _tSort, activeMenuList, tMenu, getActiveMenus, tFilter, productScope, scopedProductIds, tPrice, filteredProducts, tStatus, beforeStatusCount, tExtensionType, beforeExtensionTypeCount, tSort;
+          _this22 = this;
+        var tTotal, menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id, strategy_context, queryIds, startupPreloadTask, formatterContext, uniqueIds, _tPrice, productsWithPrice, _filteredProducts, extensionFilteredProducts, _published$find, pid, _tPrice2, allProductsWithPrice, published, item, _tPrice3, _filteredProducts2, _tStatus, _beforeStatusCount, _tExtensionType, _beforeExtensionTypeCount, _tSort, activeMenuList, tMenu, getActiveMenus, tFilter, productScope, scopedProductIds, tPrice, filteredProducts, tStatus, beforeStatusCount, tExtensionType, beforeExtensionTypeCount, tSort;
         return _regeneratorRuntime().wrap(function _callee75$(_context75) {
           while (1) switch (_context75.prev = _context75.next) {
             case 0:
@@ -7756,12 +7808,6 @@ var Server = /*#__PURE__*/function () {
               }).filter(function (id) {
                 return Number.isFinite(id);
               }) : [];
-              formatterContext = this.buildProductFormatterContext({
-                schedule_date: schedule_date,
-                schedule_datetime: schedule_datetime,
-                customer_id: customer_id,
-                strategy_context: strategy_context
-              });
               this.logInfo('computeProductQueryResult 开始', {
                 menuListIdsCount: (_menu_list_ids$length3 = menu_list_ids === null || menu_list_ids === void 0 ? void 0 : menu_list_ids.length) !== null && _menu_list_ids$length3 !== void 0 ? _menu_list_ids$length3 : 0,
                 ids: queryIds,
@@ -7773,28 +7819,48 @@ var Server = /*#__PURE__*/function () {
                 strategyContextKeys: strategy_context ? Object.keys(strategy_context) : [],
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds
               });
-              if (this.products) {
+
+              // 预渲染可能在 PisellOS 顺序 preload 尚未完成时发起商品查询。此时 Menu/Schedule
+              // 暂时为空不代表缓存失效；等待当前 preload 后再按原逻辑查询，避免并发远端刷新先 clear
+              // SQLite/IndexDB，造成 preload 读到空数据并重复请求。正常运行期该字段为 null，不增加等待。
+              startupPreloadTask = this.startupModulePreloadInFlight;
+              if (!startupPreloadTask) {
                 _context75.next = 8;
                 break;
               }
+              _context75.next = 8;
+              return startupPreloadTask;
+            case 8:
+              // Menu/Schedule preload 会替换 store 中的数组；必须在等待完成后再读取，
+              // 避免 formatterContext 持有预加载前的空数组快照。
+              formatterContext = this.buildProductFormatterContext({
+                schedule_date: schedule_date,
+                schedule_datetime: schedule_datetime,
+                customer_id: customer_id,
+                strategy_context: strategy_context
+              });
+              if (this.products) {
+                _context75.next = 12;
+                break;
+              }
               this.logError('computeProductQueryResult: Products 模块未注册');
               return _context75.abrupt("return", {
                 message: 'Products 模块未注册',
                 data: this.buildProductQueryResultPayload([], 0)
               });
-            case 8:
+            case 12:
               if (!(queryIds.length > 0)) {
-                _context75.next = 20;
+                _context75.next = 24;
                 break;
               }
               uniqueIds = Array.from(new Set(queryIds));
               _tPrice = performance.now();
-              _context75.next = 13;
+              _context75.next = 17;
               return this.products.getProductsWithPrice(schedule_date, formatterContext, {
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds,
                 productIds: uniqueIds
               });
-            case 13:
+            case 17:
               productsWithPrice = _context75.sent;
               perfMark('computeQuery.getProductsWithPrice(ids)', performance.now() - _tPrice, {
                 count: productsWithPrice.length,
@@ -7821,18 +7887,18 @@ var Server = /*#__PURE__*/function () {
                 message: '',
                 status: true
               });
-            case 20:
+            case 24:
               if (!(product_id != null && Number.isFinite(Number(product_id)))) {
-                _context75.next = 32;
+                _context75.next = 36;
                 break;
               }
               pid = Number(product_id);
               _tPrice2 = performance.now();
-              _context75.next = 25;
+              _context75.next = 29;
               return this.products.getProductsWithPrice(schedule_date, formatterContext, {
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds
               });
-            case 25:
+            case 29:
               allProductsWithPrice = _context75.sent;
               perfMark('computeQuery.getProductsWithPrice(single)', performance.now() - _tPrice2, {
                 count: allProductsWithPrice.length,
@@ -7859,17 +7925,17 @@ var Server = /*#__PURE__*/function () {
                 message: item ? '' : '商品不存在或未发布',
                 status: true
               });
-            case 32:
+            case 36:
               if (!this.shouldQueryProductsByExtensionTypes(extension_type)) {
-                _context75.next = 52;
+                _context75.next = 56;
                 break;
               }
               _tPrice3 = performance.now();
-              _context75.next = 36;
+              _context75.next = 40;
               return this.products.getProductsWithPrice(schedule_date, formatterContext, {
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds
               });
-            case 36:
+            case 40:
               _filteredProducts2 = _context75.sent;
               perfMark('computeQuery.getProductsWithPrice(extensionType)', performance.now() - _tPrice3, {
                 count: _filteredProducts2.length,
@@ -7915,9 +7981,9 @@ var Server = /*#__PURE__*/function () {
                 message: '',
                 status: true
               });
-            case 52:
+            case 56:
               if (this.menu) {
-                _context75.next = 55;
+                _context75.next = 59;
                 break;
               }
               this.logError('computeProductQueryResult: Menu 模块未注册');
@@ -7925,9 +7991,9 @@ var Server = /*#__PURE__*/function () {
                 message: 'Menu 模块未注册',
                 data: this.buildProductQueryResultPayload([], 0)
               });
-            case 55:
+            case 59:
               if (this.schedule) {
-                _context75.next = 58;
+                _context75.next = 62;
                 break;
               }
               this.logError('computeProductQueryResult: Schedule 模块未注册');
@@ -7935,41 +8001,41 @@ var Server = /*#__PURE__*/function () {
                 message: 'Schedule 模块未注册',
                 data: this.buildProductQueryResultPayload([], 0)
               });
-            case 58:
+            case 62:
               activeMenuList = [];
               if (!(menu_list_ids && Array.isArray(menu_list_ids) && menu_list_ids.length > 0)) {
-                _context75.next = 71;
+                _context75.next = 75;
                 break;
               }
               tMenu = performance.now();
               getActiveMenus = function getActiveMenus() {
-                return _this21.menu.getMenuByIds(menu_list_ids).filter(function (menu) {
-                  var _this21$schedule;
-                  return ((_this21$schedule = _this21.schedule) === null || _this21$schedule === void 0 ? void 0 : _this21$schedule.getDateIsInSchedule(schedule_datetime, menu.schedule)) || false;
+                return _this22.menu.getMenuByIds(menu_list_ids).filter(function (menu) {
+                  var _this22$schedule;
+                  return ((_this22$schedule = _this22.schedule) === null || _this22$schedule === void 0 ? void 0 : _this22$schedule.getDateIsInSchedule(schedule_datetime, menu.schedule)) || false;
                 });
               };
               activeMenuList = getActiveMenus();
               _context75.t0 = !activeMenuList.length;
               if (!_context75.t0) {
-                _context75.next = 68;
+                _context75.next = 72;
                 break;
               }
-              _context75.next = 67;
+              _context75.next = 71;
               return this.refreshMenuScheduleCacheAfterEmptyResult();
-            case 67:
+            case 71:
               _context75.t0 = _context75.sent;
-            case 68:
+            case 72:
               if (!_context75.t0) {
-                _context75.next = 70;
+                _context75.next = 74;
                 break;
               }
               activeMenuList = getActiveMenus();
-            case 70:
+            case 74:
               perfMark('computeQuery.filterActiveMenu', performance.now() - tMenu, {
                 totalMenu: menu_list_ids.length,
                 activeMenu: activeMenuList.length
               });
-            case 71:
+            case 75:
               tFilter = performance.now();
               productScope = this.getProductScopeByMenuConfig(activeMenuList);
               scopedProductIds = this.products.getProductIdsByScope(productScope);
@@ -7980,21 +8046,21 @@ var Server = /*#__PURE__*/function () {
               });
               tPrice = performance.now();
               if (!(scopedProductIds.length > 0)) {
-                _context75.next = 82;
+                _context75.next = 86;
                 break;
               }
-              _context75.next = 79;
+              _context75.next = 83;
               return this.products.getProductsWithPrice(schedule_date, formatterContext, {
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds,
                 productIds: productScope.isAllProducts ? undefined : scopedProductIds
               });
-            case 79:
+            case 83:
               _context75.t1 = _context75.sent;
-              _context75.next = 83;
+              _context75.next = 87;
               break;
-            case 82:
+            case 86:
               _context75.t1 = [];
-            case 83:
+            case 87:
               filteredProducts = _context75.t1;
               perfMark('computeQuery.getProductsWithPrice', performance.now() - tPrice, {
                 count: filteredProducts.length,
@@ -8042,7 +8108,7 @@ var Server = /*#__PURE__*/function () {
                 message: '',
                 status: true
               });
-            case 99:
+            case 103:
             case "end":
               return _context75.stop();
           }
@@ -8254,7 +8320,7 @@ var Server = /*#__PURE__*/function () {
   }, {
     key: "notifySalesSearchSubscribers",
     value: function notifySalesSearchSubscribers(payload) {
-      var _this22 = this;
+      var _this23 = this;
       if (this.salesSearchSubscribers.size === 0) return;
       var changedOrders = this.extractChangedOrdersFromPayload(payload);
       if (changedOrders.length === 0) {
@@ -8272,21 +8338,21 @@ var Server = /*#__PURE__*/function () {
             subscriber = _step20$value[1];
           try {
             var changedVisibleOrders = changedOrders.filter(function (order) {
-              var orderId = _this22.getSalesSearchOrderId(order);
+              var orderId = _this23.getSalesSearchOrderId(order);
               return !!orderId && subscriber.visibleOrderIds.has(orderId);
             });
             if (changedVisibleOrders.length === 0) {
               return 1; // continue
             }
-            subscriber.callback(_this22.buildSalesSearchDeltaResponse(subscriber, changedVisibleOrders));
-            _this22.logInfo('notifySalesSearchSubscribers: 已推送 delta', {
+            subscriber.callback(_this23.buildSalesSearchDeltaResponse(subscriber, changedVisibleOrders));
+            _this23.logInfo('notifySalesSearchSubscribers: 已推送 delta', {
               subscriberId: subscriberId,
               kind: subscriber.kind,
               count: changedVisibleOrders.length
             });
           } catch (error) {
             var errorMessage = error instanceof Error ? error.message : String(error);
-            _this22.logError('notifySalesSearchSubscribers: 推送失败', {
+            _this23.logError('notifySalesSearchSubscribers: 推送失败', {
               subscriberId: subscriberId,
               error: errorMessage
             });