@pisell/pisellos 2.2.244 → 2.2.246

package/lib/server/index.js

@@ -41,6 +41,7 @@ var import_schedule = require("./modules/schedule");
 var import_resource = require("./modules/resource");
 var import_floor_plan = require("./modules/floor-plan");
 var import_types = require("./modules/floor-plan/types");
+var import_payment = require("./modules/payment");
 var import_schedule2 = require("./utils/schedule");
 var import_types2 = require("./modules/products/types");
 var import_product = require("./utils/product");
@@ -48,9 +49,22 @@ var import_order = require("./modules/order");
 var import_types3 = require("./modules/order/types");
 var import_filterOrders = require("./modules/order/utils/filterOrders");
 var import_filterBookings = require("./modules/order/utils/filterBookings");
+var import_small_ticket = require("./utils/small-ticket");
 __reExport(server_exports, require("./modules"), module.exports);
+var PRODUCT_TITLE_SNAPSHOT_KEYS = [
+  "en",
+  "ja",
+  "pt",
+  "auto",
+  "zh-CN",
+  "zh-HK",
+  "kitchen",
+  "original"
+];
 var Server = class {
   constructor(core) {
+    this.quotationAvailableCache = /* @__PURE__ */ new Map();
+    this.quotationAvailableInFlight = /* @__PURE__ */ new Map();
     /** GET 前缀路由（最长前缀优先匹配） */
     this.prefixRouterGet = [];
     // 路由注册表
@@ -69,6 +83,8 @@ var Server = class {
     this.bookingRemoteCache = /* @__PURE__ */ new Map();
     this.BOOKING_REMOTE_CACHE_TTL_MS = 5 * 60 * 1e3;
     this.BOOKING_REMOTE_CACHE_MAX_ENTRIES = 80;
+    this.salesSearchSubscribers = /* @__PURE__ */ new Map();
+    this.deviceTaskActionsRegistered = false;
     this.floorPlanQuerySubscribers = /* @__PURE__ */ new Map();
     // 模块注册表 - 定义所有可用的模块配置
     this.moduleRegistry = {
@@ -120,6 +136,15 @@ var Server = class {
           list: []
         }
       },
+      payment: {
+        name: "payment",
+        moduleClass: import_payment.PaymentServerModule,
+        moduleName: "server_payment",
+        version: "1.0.0",
+        defaultStore: {
+          payMethods: []
+        }
+      },
       resource: {
         name: "resource",
         moduleClass: import_resource.ResourceModule,
@@ -143,31 +168,67 @@ var Server = class {
         }
       }
     };
+    this.handlePaymentMethods = async ({ data, config }) => {
+      const payment = await this.getPaymentRouteModule();
+      const payMethods = await payment.getPayMethodListAsync({
+        shouldFilter: (data == null ? void 0 : data.filterPaymentMethods) === true || (config == null ? void 0 : config.filterPaymentMethods) === true
+      });
+      return {
+        code: 200,
+        status: true,
+        data: payMethods
+      };
+    };
+    this.handleQuotationAvailable = async ({ data }) => {
+      const queryPayload = data && typeof data === "object" ? { ...data } : {};
+      const cacheKey = this.stableSerialize(queryPayload);
+      if (this.quotationAvailableCache.has(cacheKey)) {
+        this.logInfo("handleQuotationAvailable: 命中运行时缓存", { cacheKey });
+        return this.quotationAvailableCache.get(cacheKey);
+      }
+      const inFlight = this.quotationAvailableInFlight.get(cacheKey);
+      if (inFlight) {
+        this.logInfo("handleQuotationAvailable: 复用进行中的请求", { cacheKey });
+        return inFlight;
+      }
+      const requestPromise = this.fetchQuotationAvailableFromAPI(queryPayload).then((response) => {
+        if (this.isSuccessfulRemoteResponse(response)) {
+          this.quotationAvailableCache.set(cacheKey, response);
+        }
+        return response;
+      }).finally(() => {
+        this.quotationAvailableInFlight.delete(cacheKey);
+      });
+      this.quotationAvailableInFlight.set(cacheKey, requestPromise);
+      return requestPromise;
+    };
     /**
      * 处理商品查询请求
      * 存储订阅者信息，便于数据变更时推送最新结果
      */
     this.handleProductQuery = async ({ url, method, data, config }) => {
       console.log("[Server] handleProductQuery:", url, method, data, config);
-      const { menu_list_ids, schedule_datetime, schedule_date, customer_id } = data;
+      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, extension_type } = data;
       const { callback, subscriberId } = config || {};
       this.logInfo("handleProductQuery: 开始处理商品查询请求", {
         menu_list_ids,
+        ids,
         schedule_datetime,
         schedule_date,
-        customer_id
+        customer_id,
+        extension_type
       });
       if (subscriberId && typeof callback === "function") {
         this.productQuerySubscribers.set(subscriberId, {
           callback,
-          context: { menu_list_ids, schedule_date, schedule_datetime, customer_id }
+          context: { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type }
         });
         this.logInfo("handleProductQuery: 已注册订阅者", {
           subscriberId,
           totalSubscribers: this.productQuerySubscribers.size
         });
       }
-      return this.computeProductQueryResult({ menu_list_ids, schedule_date, schedule_datetime, customer_id });
+      return this.computeProductQueryResult({ menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type });
     };
     /**
      * 按商品 id 查询单条（GET /shop/product/query/:productId）
@@ -269,6 +330,41 @@ var Server = class {
       }
       return { code: 200, message: "ok", status: true };
     };
+    /**
+     * 处理 sales 单模块搜索：请求透传后端，仅在 OS 层维护已返回订单号集合。
+     *
+     * @example
+     * await this.handleSalesSearchModule({ url: '/shop/es/search/sales', method: 'post', data: { keyword: 'A' } })
+     */
+    this.handleSalesSearchModule = async ({ data, config }) => {
+      return this.handleSalesSearchRequest("single", "/shop/es/search/sales", data, config);
+    };
+    /**
+     * 处理 sales 聚合搜索：请求透传后端，仅订阅 sales 分组的已返回订单号。
+     *
+     * @example
+     * await this.handleSalesSearchAggregate({ url: '/shop/es/search', method: 'post', data: { modules: [] } })
+     */
+    this.handleSalesSearchAggregate = async ({ data, config }) => {
+      return this.handleSalesSearchRequest("aggregate", "/shop/es/search", data, config);
+    };
+    /**
+     * 取消 sales 搜索订阅。
+     *
+     * @example
+     * await this.handleUnsubscribeSalesSearch({ data: { subscriberId: 'global-search-order' } } as any)
+     */
+    this.handleUnsubscribeSalesSearch = async ({ data }) => {
+      const { subscriberId } = data || {};
+      if (subscriberId) {
+        this.salesSearchSubscribers.delete(subscriberId);
+        this.logInfo("handleUnsubscribeSalesSearch: 已移除订阅者", {
+          subscriberId,
+          remaining: this.salesSearchSubscribers.size
+        });
+      }
+      return { code: 200, message: "ok", status: true };
+    };
     /**
      * 日历（compact_fields）场景下要直接在 SSE 层排除的订单类型：
      * 这些类型不会出现在日历上，拉取它们只会浪费带宽并增加前端过滤成本。
@@ -372,7 +468,13 @@ var Server = class {
      * @example 批量：GET /update/localOrder?order_ids=96971,96972,96973
      */
     this.handleUpdateLocalOrder = async ({ url, data }) => {
-      var _a;
+      var _a, _b;
+      if (typeof (data == null ? void 0 : data.order_id) === "string" && ((_a = data == null ? void 0 : data.order_id) == null ? void 0 : _a.startsWith("LOCAL_"))) {
+        return {
+          code: 200,
+          status: true
+        };
+      }
       const batchIds = this.parseOrderIdsParam(url, data);
       if (batchIds.length > 0) {
         return this.handleUpdateLocalOrdersBatch(batchIds);
@@ -388,7 +490,7 @@ var Server = class {
         this.logError("handleUpdateLocalOrder: Order 模块未注册");
         return { code: 500, status: false, message: "Order 模块未注册", data: null };
       }
-      if (!((_a = this.app) == null ? void 0 : _a.request)) {
+      if (!((_b = this.app) == null ? void 0 : _b.request)) {
         this.logError("handleUpdateLocalOrder: app.request 不可用");
         return { code: 500, status: false, message: "app.request 不可用", data: null };
       }
@@ -451,34 +553,149 @@ var Server = class {
         };
       }
     };
+    this.handleOrderSalesCheckout = async ({ data }) => {
+      return this.handleOrderCheckoutSubmit({
+        backendPath: "/shop/order/sales/checkout",
+        data,
+        title: "handleOrderSalesCheckout"
+      });
+    };
+    this.handleOrderCheckout = async ({ data }) => {
+      return this.handleOrderCheckoutSubmit({
+        backendPath: "/order/checkout",
+        data,
+        title: "handleOrderCheckout"
+      });
+    };
+    this.handleLocalPrintOrder = async ({ data }) => {
+      var _a;
+      try {
+        const inputOrder = (data == null ? void 0 : data.order) && typeof data.order === "object" ? data.order : data;
+        if (!inputOrder || typeof inputOrder !== "object") {
+          return {
+            code: 400,
+            status: false,
+            message: "订单数据不能为空",
+            data: { printed: false, order: null }
+          };
+        }
+        const shouldLookup = this.shouldLookupLocalPrintOrder(inputOrder) || this.shouldLookupLocalPrintOrder(data);
+        this.logInfo("handleLocalPrintOrder: 是否需要查找本地订单", {
+          shouldLookup,
+          inputOrder,
+          data
+        });
+        const lookup = shouldLookup ? this.getLocalPrintOrderLookup(inputOrder) ?? this.getLocalPrintOrderLookup(data) : void 0;
+        let sourceOrder = inputOrder;
+        if (shouldLookup) {
+          if (lookup === void 0) {
+            return {
+              code: 400,
+              status: false,
+              message: "订单 lookup 缺失",
+              data: { printed: false, order: null }
+            };
+          }
+          if (!((_a = this.order) == null ? void 0 : _a.getLocalOrderByLookup)) {
+            return {
+              code: 500,
+              status: false,
+              message: "Order 模块未注册",
+              data: { printed: false, order: null }
+            };
+          }
+          const localOrder = await this.order.getLocalOrderByLookup(lookup);
+          if (!localOrder) {
+            return {
+              code: 404,
+              status: false,
+              message: "订单不存在",
+              data: { printed: false, order: null }
+            };
+          }
+          sourceOrder = {
+            ...localOrder,
+            ...inputOrder,
+            order_id: localOrder.order_id ?? inputOrder.order_id ?? inputOrder.orderId,
+            external_sale_number: localOrder.external_sale_number ?? inputOrder.external_sale_number ?? inputOrder.externalSaleNumber
+          };
+        }
+        const checkoutData = await this.ensureCheckoutOrderNumbers(
+          {
+            ...sourceOrder,
+            small_ticket_data_flag: 1
+          },
+          "handleLocalPrintOrder"
+        );
+        const printableOrder = {
+          ...checkoutData,
+          need_sync: checkoutData.need_sync ?? 1
+        };
+        this.logInfo("handleLocalPrintOrder: 本地打印小票，构建触发任务前", {
+          checkoutData,
+          printableOrder
+        });
+        const printResult = await this.dispatchLocalReceiptPrint({
+          checkoutData,
+          order: printableOrder,
+          response: null,
+          requireFullyPaid: false
+        });
+        return {
+          code: 200,
+          status: true,
+          message: "",
+          data: {
+            printed: printResult.printed,
+            order: printResult.order
+          }
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        this.logError("handleLocalPrintOrder: 本地打印小票失败", { error: message });
+        return {
+          code: 500,
+          status: false,
+          message,
+          data: { printed: false, order: null }
+        };
+      }
+    };
     this.handleOrderSalesDetail = async ({ url, data, path }) => {
       var _a;
       const requestPath = this.parseRequestPath(url, path);
-      const orderId = this.extractOrderSalesDetailId(requestPath);
-      this.logInfo("handleOrderSalesDetail: 开始处理", { url, path: requestPath, orderId });
-      if (!orderId) {
-        this.logWarning("handleOrderSalesDetail: order_id 缺失", { url, path: requestPath });
-        return { code: 400, status: false, message: "order_id 缺失", data: null };
+      const lookup = this.extractOrderSalesDetailLookup(requestPath);
+      this.logInfo("handleOrderSalesDetail: 开始处理", { url, path: requestPath, lookup });
+      if (!lookup) {
+        this.logWarning("handleOrderSalesDetail: lookup 缺失", { url, path: requestPath });
+        return { code: 400, status: false, message: "订单 lookup 缺失", data: null };
       }
       if (!this.order) {
         this.logError("handleOrderSalesDetail: Order 模块未注册");
         return { code: 500, status: false, message: "Order 模块未注册", data: null };
       }
-      const localOrder = await this.order.getLocalOrderByOrderId(orderId);
-      if (localOrder) {
-        this.logInfo("handleOrderSalesDetail: 命中本地订单", { orderId });
-        return {
-          code: 200,
-          status: true,
-          message: "",
-          data: localOrder
-        };
+      if (!this.shouldForceRemoteSalesDetail(data)) {
+        const localOrder = await this.order.getLocalOrderByLookup(lookup);
+        if (localOrder) {
+          this.logInfo("handleOrderSalesDetail: 命中本地订单", { lookup });
+          return {
+            code: 200,
+            status: true,
+            message: "",
+            data: localOrder
+          };
+        }
       }
       if (!((_a = this.app) == null ? void 0 : _a.request)) {
         this.logError("handleOrderSalesDetail: app.request 不可用");
-        return { code: 500, status: false, message: "app.request 不可用", data: null };
+        return {
+          code: 500,
+          status: false,
+          message: "app.request 不可用",
+          data: null
+        };
       }
-      const backendPath = this.buildOrderSalesDetailBackendPath(orderId, data);
+      const backendPath = this.buildOrderSalesDetailBackendPath(lookup, data);
       try {
         const response = await this.app.request.get(backendPath, {
           lookup_mode: "multi"
@@ -489,8 +706,8 @@ var Server = class {
         });
         const fresh = (response == null ? void 0 : response.data) ?? response;
         if (!fresh || typeof fresh !== "object" || fresh.order_id == null) {
-          this.logError("handleOrderSalesDetail: 后端返回订单为空", {
-            orderId,
+          this.logInfo("handleOrderSalesDetail: 后端返回订单为空", {
+            lookup,
             backendPath
           });
           return {
@@ -501,9 +718,9 @@ var Server = class {
           };
         }
         await this.order.upsertOrdersFromRemote([fresh]);
-        const savedOrder = await this.order.getLocalOrderByOrderId(orderId);
+        const savedOrder = await this.order.getLocalOrderByLookup(lookup);
         if (!savedOrder) {
-          this.logError("handleOrderSalesDetail: 订单写入后回读失败", { orderId });
+          this.logError("handleOrderSalesDetail: 订单写入后回读失败", { lookup });
           return {
             code: 500,
             status: false,
@@ -511,7 +728,7 @@ var Server = class {
             data: null
           };
         }
-        this.logInfo("handleOrderSalesDetail: 远端订单已同步到本地", { orderId });
+        this.logInfo("handleOrderSalesDetail: 远端订单已同步到本地", { lookup });
         return {
           code: 200,
           status: true,
@@ -521,7 +738,7 @@ var Server = class {
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         this.logError("handleOrderSalesDetail: 请求失败", {
-          orderId,
+          lookup,
           backendPath,
           error: errorMessage
         });
@@ -890,6 +1107,7 @@ var Server = class {
       moduleConfigs
     });
     this.registerServerRoutes();
+    this.registerDeviceTaskActions();
     const registeredModules = await this.registerModules(moduleConfigs);
     if (autoPreload) {
       await this.preloadModulesData(registeredModules, options);
@@ -905,10 +1123,11 @@ var Server = class {
     this.core.effects.on(import_types.FloorPlanHooks.onFloorPlansChanged, () => {
       void this.recomputeAndNotifyFloorPlanQuery();
     });
-    this.core.effects.on(import_types3.OrderHooks.onOrdersChanged, () => {
+    this.core.effects.on(import_types3.OrderHooks.onOrdersChanged, (payload) => {
       this.recomputeAndNotifyOrderQuery();
       this.recomputeAndNotifyBookingQuery();
       this.syncBookingRemoteCacheFromOrderChanges();
+      this.notifySalesSearchSubscribers(payload);
     });
     const duration = Date.now() - startTime;
     this.logInfo("Server 初始化完成", {
@@ -917,20 +1136,236 @@ var Server = class {
     });
     return registeredModules;
   }
+  registerDeviceTaskActions() {
+    if (this.deviceTaskActionsRegistered)
+      return;
+    const deviceTask = this.getDeviceTaskPlugin();
+    if (!(deviceTask == null ? void 0 : deviceTask.registerAction)) {
+      this.logWarning("registerDeviceTaskActions: deviceTask 插件不可用");
+      return;
+    }
+    const registeredActions = new Set(
+      typeof deviceTask.getActions === "function" ? (deviceTask.getActions() || []).map((action) => action == null ? void 0 : action.action).filter(Boolean) : []
+    );
+    const register = (definition) => {
+      var _a;
+      if (registeredActions.has(definition.action))
+        return;
+      (_a = deviceTask.registerAction) == null ? void 0 : _a.call(deviceTask, definition);
+      registeredActions.add(definition.action);
+    };
+    register({
+      action: "sync_sales",
+      name: "同步订单",
+      validate: (payload) => (payload == null ? void 0 : payload.backendPath) && (payload == null ? void 0 : payload.data) ? null : "缺少 backendPath 或 data",
+      handler: (ctx) => this.handleSyncSalesTask(ctx)
+    });
+    this.deviceTaskActionsRegistered = true;
+    this.logInfo("DeviceTask actions 已注册", {
+      actions: ["sync_sales"]
+    });
+  }
+  async handleSyncSalesTask(ctx) {
+    var _a, _b, _c;
+    const payload = ((_a = ctx.task) == null ? void 0 : _a.payload) || {};
+    const backendPath = payload.backendPath;
+    const data = payload.data;
+    const title = payload.title || "sync_sales";
+    if (!backendPath || !data) {
+      return this.taskFail("INVALID_PAYLOAD", "缺少 backendPath 或 data");
+    }
+    if (!((_b = this.app) == null ? void 0 : _b.request)) {
+      this.logError(`${title}: sync_sales app.request 不可用`);
+      return this.taskTimeout("app.request 不可用");
+    }
+    try {
+      const syncResult = await this.runCheckoutSync({
+        backendPath,
+        data,
+        title,
+        externalSaleNumber: payload.external_sale_number,
+        deviceId: (_c = ctx.task) == null ? void 0 : _c.device_id,
+        persistCheckoutDataWithResponse: false
+      });
+      if (syncResult.rejected) {
+        this.logError(`${title}: sync_sales 后端明确失败`, {
+          backendPath,
+          response: syncResult.errorResponse
+        });
+        return this.taskFail(
+          "BACKEND_REJECTED",
+          syncResult.message || "后端明确拒绝 checkout",
+          syncResult.errorResponse
+        );
+      }
+      return this.taskOk({
+        order: syncResult.syncedOrder ?? null,
+        response: syncResult.normalizedResponse
+      });
+    } catch (error) {
+      const backendError = this.extractBackendErrorResponse(error);
+      if (backendError) {
+        const message = (backendError == null ? void 0 : backendError.message) || "后端明确拒绝 checkout";
+        this.logError(`${title}: sync_sales 后端明确失败`, {
+          backendPath,
+          backendError
+        });
+        return this.taskFail("BACKEND_REJECTED", message, backendError);
+      }
+      const errorMessage = this.getUnknownErrorMessage(error);
+      this.logError(`${title}: sync_sales 请求未明确成功`, {
+        backendPath,
+        error: errorMessage,
+        error_detail: this.normalizeUnknownError(error)
+      });
+      return this.taskTimeout(errorMessage);
+    }
+  }
+  async runCheckoutSync(params) {
+    var _a, _b;
+    const { backendPath, title } = params;
+    const normalizedData = await this.normalizeCheckoutSubmitData(params.data, title);
+    const checkoutData = await this.ensureCheckoutOrderNumbers(normalizedData, title);
+    const remoteCheckoutData = this.omitCheckoutSyncMode(checkoutData);
+    if (!((_b = (_a = this.app) == null ? void 0 : _a.request) == null ? void 0 : _b.post)) {
+      throw new Error("app.request 不可用");
+    }
+    const response = await this.app.request.post(backendPath, remoteCheckoutData, {
+      isShopApi: true,
+      customToast: () => {
+      }
+    });
+    if (this.isCheckoutResponseRejected(response)) {
+      return {
+        rejected: true,
+        message: (response == null ? void 0 : response.message) || "后端明确拒绝 checkout",
+        errorResponse: response,
+        response,
+        normalizedResponse: this.normalizeCheckoutResponse(response),
+        checkoutData: remoteCheckoutData
+      };
+    }
+    const fresh = this.extractOrderDataFromCheckoutResponse(response);
+    const externalSaleNumber = this.getCheckoutExternalSaleNumber(
+      remoteCheckoutData,
+      {
+        external_sale_number: params.externalSaleNumber,
+        data: remoteCheckoutData
+      }
+    );
+    const syncedOrder = await this.persistSyncedCheckoutOrder({
+      backendPath,
+      checkoutData: remoteCheckoutData,
+      externalSaleNumber,
+      fresh,
+      title,
+      persistCheckoutDataWithResponse: params.persistCheckoutDataWithResponse === true
+    });
+    const printableSyncedOrder = syncedOrder ? this.buildSyncedOrderForPrint({
+      syncedOrder,
+      checkoutResponseOrder: fresh
+    }) : void 0;
+    if (printableSyncedOrder && this.shouldPrintSyncedOrder({
+      checkoutData: remoteCheckoutData,
+      syncedOrder: printableSyncedOrder
+    })) {
+      await this.dispatchPrintOtherReceiptTask({
+        checkoutData: remoteCheckoutData,
+        syncedOrder: printableSyncedOrder,
+        response,
+        deviceId: params.deviceId
+      });
+    }
+    return {
+      rejected: false,
+      response,
+      normalizedResponse: this.normalizeCheckoutResponse(response),
+      checkoutData: remoteCheckoutData,
+      syncedOrder,
+      fresh
+    };
+  }
+  omitCheckoutSyncMode(data) {
+    if (!data || typeof data !== "object")
+      return data;
+    const next = { ...data };
+    delete next.sync_mode;
+    delete next.syncMode;
+    return next;
+  }
+  async persistSyncedCheckoutOrder(params) {
+    const {
+      backendPath,
+      checkoutData,
+      externalSaleNumber,
+      fresh,
+      title,
+      persistCheckoutDataWithResponse
+    } = params;
+    const shouldMergeRemoteOrder = fresh ? this.isMergeableCheckoutOrder(fresh, externalSaleNumber) : false;
+    let syncedOrder;
+    if (this.order && fresh && (shouldMergeRemoteOrder || persistCheckoutDataWithResponse)) {
+      syncedOrder = persistCheckoutDataWithResponse ? {
+        ...checkoutData,
+        ...fresh,
+        external_sale_number: fresh.external_sale_number ?? externalSaleNumber,
+        need_sync: 0
+      } : {
+        ...fresh,
+        external_sale_number: fresh.external_sale_number ?? externalSaleNumber,
+        need_sync: 0
+      };
+      await this.order.upsertOrdersFromRemote([syncedOrder]);
+      this.logInfo(`${title}: sync_sales 完整订单已同步到本地`, {
+        order_id: fresh.order_id,
+        external_sale_number: syncedOrder.external_sale_number,
+        order_number: fresh.order_number,
+        mergedRemoteOrder: shouldMergeRemoteOrder,
+        persistedCheckoutDataWithResponse: persistCheckoutDataWithResponse
+      });
+    } else if (this.order && externalSaleNumber && typeof this.order.markOrderSyncedByExternalSaleNumber === "function") {
+      const patch = this.buildCheckoutSyncSuccessPatch(fresh);
+      const result = await this.order.markOrderSyncedByExternalSaleNumber({
+        externalSaleNumber,
+        patch
+      });
+      syncedOrder = (result == null ? void 0 : result.order) || {
+        ...checkoutData,
+        ...patch,
+        external_sale_number: externalSaleNumber,
+        need_sync: 0
+      };
+      this.logInfo(`${title}: sync_sales 已按 external_sale_number 标记本地订单`, {
+        order_id: (syncedOrder == null ? void 0 : syncedOrder.order_id) ?? null,
+        external_sale_number: externalSaleNumber,
+        hasRemoteOrder: !!fresh,
+        mergedRemoteOrder: false
+      });
+    } else {
+      this.logWarning(`${title}: sync_sales Order 模块未注册`, {
+        backendPath,
+        external_sale_number: externalSaleNumber,
+        order_id: fresh == null ? void 0 : fresh.order_id
+      });
+    }
+    return syncedOrder;
+  }
   /**
    * 将普通层 QuotationModule 的报价单计算能力桥接到 Server Products 模块。
    */
   async setupProductsQuotationPriceBridge() {
     var _a;
     if (!this.products) {
-      this.logWarning("setupProductsQuotationPriceBridge: Products 模块未注册");
+      this.logInfo("setupProductsQuotationPriceBridge: Products 模块未注册");
       return;
     }
     if (!this.schedule) {
-      this.logWarning("setupProductsQuotationPriceBridge: Schedule 模块未注册");
+      this.logInfo("setupProductsQuotationPriceBridge: Schedule 模块未注册");
       return;
     }
     try {
+      await this.schedule.loadAllSchedule();
+      this.products.clearPriceCache();
       await this.products.setupQuotationPriceBridge({
         scheduleModule: this.schedule,
         channel: (_a = this.core.context) == null ? void 0 : _a.channel
@@ -1218,6 +1653,26 @@ var Server = class {
         path: "/shop/order/v2/list/unsubscribe",
         handler: this.handleUnsubscribeOrderQuery.bind(this)
       },
+      {
+        method: "post",
+        path: "/shop/es/search/sales",
+        handler: this.handleSalesSearchModule.bind(this)
+      },
+      {
+        method: "post",
+        path: "/shop/es/search/sales/unsubscribe",
+        handler: this.handleUnsubscribeSalesSearch.bind(this)
+      },
+      {
+        method: "post",
+        path: "/shop/es/search",
+        handler: this.handleSalesSearchAggregate.bind(this)
+      },
+      {
+        method: "post",
+        path: "/shop/es/search/unsubscribe",
+        handler: this.handleUnsubscribeSalesSearch.bind(this)
+      },
       {
         method: "get",
         path: "/shop/schedule/booking",
@@ -1237,6 +1692,36 @@ var Server = class {
         method: "get",
         path: "/update/localOrder",
         handler: this.handleUpdateLocalOrder.bind(this)
+      },
+      {
+        method: "get",
+        path: "/shop/pay/custom-payment/all",
+        handler: this.handlePaymentMethods.bind(this)
+      },
+      {
+        method: "get",
+        path: "/shop/quotation/available",
+        handler: this.handleQuotationAvailable.bind(this)
+      },
+      {
+        method: "get",
+        path: "/quotation/available",
+        handler: this.handleQuotationAvailable.bind(this)
+      },
+      {
+        method: "post",
+        path: "/shop/order/sales/checkout",
+        handler: this.handleOrderSalesCheckout.bind(this)
+      },
+      {
+        method: "post",
+        path: "/order/checkout",
+        handler: this.handleOrderCheckout.bind(this)
+      },
+      {
+        method: "post",
+        path: "/shop/local/print-order",
+        handler: this.handleLocalPrintOrder.bind(this)
       }
     ]);
     this.registerPrefixRoutes([
@@ -1252,6 +1737,50 @@ var Server = class {
       }
     ]);
   }
+  async getPaymentRouteModule() {
+    if (this.payment)
+      return this.payment;
+    if (this.paymentRouteModule)
+      return this.paymentRouteModule;
+    if (this.paymentRouteModuleInFlight)
+      return this.paymentRouteModuleInFlight;
+    this.paymentRouteModuleInFlight = (async () => {
+      const module2 = new import_payment.PaymentServerModule("server_payment_route", "1.0.0");
+      await module2.initialize(this.core, {
+        store: { payMethods: [] }
+      });
+      this.paymentRouteModule = module2;
+      return module2;
+    })().finally(() => {
+      this.paymentRouteModuleInFlight = void 0;
+    });
+    return this.paymentRouteModuleInFlight;
+  }
+  async fetchQuotationAvailableFromAPI(data) {
+    var _a;
+    const requester = ((_a = this.app) == null ? void 0 : _a.request) || this.core.getPlugin("request");
+    if (!(requester == null ? void 0 : requester.get)) {
+      this.logError("fetchQuotationAvailableFromAPI: request 不可用");
+      return {
+        code: 500,
+        message: "request 不可用",
+        data: { list: [] },
+        status: false
+      };
+    }
+    return requester.get("/shop/quotation/available", data);
+  }
+  isSuccessfulRemoteResponse(response) {
+    if (!response)
+      return false;
+    if (response.status === false)
+      return false;
+    if (typeof response.status === "number" && response.status >= 400)
+      return false;
+    if (response.code !== void 0 && response.code !== 200 && response.code !== "200")
+      return false;
+    return true;
+  }
   /**
    * 根据 subscriberId 移除商品查询订阅者
    */
@@ -1265,40 +1794,196 @@ var Server = class {
     }
   }
   /**
-   * 从查询值中提取 YYYY-MM-DD 日期串。
+   * 执行 sales 搜索并登记可见订单号。
+   * 搜索参数完全透传后端，OS 不做过滤、筛选、排序。
    *
    * @example
-   * this.extractQueryDate('2026-04-15 09:58:00') // => '2026-04-15'
+   * const result = await this.handleSalesSearchRequest('single', '/shop/es/search/sales', { keyword: '1001' }, {})
    */
-  extractQueryDate(raw) {
-    if (raw == null)
-      return null;
-    const date = (0, import_dayjs.default)(raw);
-    if (date.isValid()) {
-      return date.format("YYYY-MM-DD");
+  async handleSalesSearchRequest(kind, backendPath, data, config) {
+    const queryPayload = data && typeof data === "object" ? { ...data } : {};
+    const result = await this.fetchSalesSearchFromAPI(backendPath, queryPayload);
+    const { callback, subscriberId, resetVisibleOrderIds } = config || {};
+    if (subscriberId && typeof callback === "function") {
+      const contextSignature = this.buildSalesSearchSignature(kind, queryPayload);
+      const existing = this.salesSearchSubscribers.get(subscriberId);
+      const shouldReset = resetVisibleOrderIds === true || !existing || existing.kind !== kind || existing.contextSignature !== contextSignature;
+      const visibleOrderIds = shouldReset ? /* @__PURE__ */ new Set() : new Set(existing.visibleOrderIds);
+      for (const orderId of this.extractSalesSearchOrderIds(kind, result)) {
+        visibleOrderIds.add(orderId);
+      }
+      this.salesSearchSubscribers.set(subscriberId, {
+        callback,
+        kind,
+        contextSignature,
+        visibleOrderIds,
+        lastResponseData: this.extractSalesSearchResponseData(result)
+      });
+      this.logInfo("handleSalesSearchRequest: 已注册/更新订阅者", {
+        subscriberId,
+        kind,
+        shouldReset,
+        visibleCount: visibleOrderIds.size
+      });
     }
-    const text = String(raw).trim();
-    if (!text)
-      return null;
-    return text.split("T")[0].split(" ")[0] || null;
+    return result;
   }
   /**
-   * 判断时间范围是否「开始和结束都不是今天」。
+   * 透传调用后端 sales 搜索接口。
    *
    * @example
-   * this.isRangeBothNotToday('2026-04-13', '2026-04-14') // => true
+   * const res = await this.fetchSalesSearchFromAPI('/shop/es/search/sales', { keyword: '1001' })
    */
-  isRangeBothNotToday(startRaw, endRaw) {
-    const startDate = this.extractQueryDate(startRaw);
-    const endDate = this.extractQueryDate(endRaw);
-    if (!startDate || !endDate)
-      return false;
-    const today = (0, import_dayjs.default)().format("YYYY-MM-DD");
-    return startDate !== today && endDate !== today;
+  async fetchSalesSearchFromAPI(backendPath, data) {
+    var _a;
+    if (!((_a = this.app) == null ? void 0 : _a.request)) {
+      this.logError("fetchSalesSearchFromAPI: app.request 不可用", { backendPath });
+      return {
+        code: 500,
+        message: "app.request 不可用",
+        data: backendPath === "/shop/es/search" ? { results: [] } : { list: [], count: 0 },
+        status: false
+      };
+    }
+    try {
+      const response = await this.app.request.post(backendPath, data, {
+        isShopApi: true
+      });
+      const payload = (response == null ? void 0 : response.data) ?? response;
+      return {
+        code: (response == null ? void 0 : response.code) ?? 200,
+        status: (response == null ? void 0 : response.status) ?? true,
+        message: (response == null ? void 0 : response.message) ?? "",
+        data: payload
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logError("fetchSalesSearchFromAPI: 请求失败", {
+        backendPath,
+        error: errorMessage
+      });
+      return {
+        code: 500,
+        message: errorMessage,
+        data: backendPath === "/shop/es/search" ? { results: [] } : { list: [], count: 0 },
+        status: false
+      };
+    }
   }
   /**
-   * 订单查询是否走本地：
-   * - 当 start_time 与 end_time 都不是今天时，走远端；
+   * 构建搜索订阅签名；页码变化不重置，可继续累计 visibleOrderIds。
+   *
+   * @example
+   * const signature = this.buildSalesSearchSignature('single', { keyword: 'A', page: 2 })
+   */
+  buildSalesSearchSignature(kind, payload) {
+    return this.stableSerialize({
+      kind,
+      payload: this.stripSalesSearchPageParams(payload)
+    });
+  }
+  /**
+   * 移除页码参数，保留 page size、keyword、filters、sort 等查询语义参数。
+   *
+   * @example
+   * this.stripSalesSearchPageParams({ page: 2, per_page: 20, keyword: 'A' })
+   */
+  stripSalesSearchPageParams(value) {
+    if (Array.isArray(value)) {
+      return value.map((item) => this.stripSalesSearchPageParams(item));
+    }
+    if (!value || typeof value !== "object")
+      return value;
+    const next = {};
+    for (const [key, item] of Object.entries(value)) {
+      if (key === "page" || key === "skip")
+        continue;
+      next[key] = this.stripSalesSearchPageParams(item);
+    }
+    return next;
+  }
+  /**
+   * 提取响应 data，兼容 OS 包装结构与后端直接响应结构。
+   *
+   * @example
+   * const data = this.extractSalesSearchResponseData(result)
+   */
+  extractSalesSearchResponseData(result) {
+    return (result == null ? void 0 : result.data) ?? result;
+  }
+  /**
+   * 从搜索响应中提取 sales 命中的订单号。
+   *
+   * @example
+   * const ids = this.extractSalesSearchOrderIds('single', result)
+   */
+  extractSalesSearchOrderIds(kind, result) {
+    var _a;
+    const data = this.extractSalesSearchResponseData(result);
+    const list = kind === "aggregate" ? (_a = this.findSalesSearchAggregateGroup(data)) == null ? void 0 : _a.list : data == null ? void 0 : data.list;
+    if (!Array.isArray(list))
+      return [];
+    return list.map((item) => this.getSalesSearchOrderId(item)).filter((id) => !!id);
+  }
+  /**
+   * 查找聚合搜索响应中的 sales 分组。
+   *
+   * @example
+   * const group = this.findSalesSearchAggregateGroup({ results: [{ module: 'sales' }] })
+   */
+  findSalesSearchAggregateGroup(data) {
+    const results = Array.isArray(data == null ? void 0 : data.results) ? data.results : [];
+    return results.find((item) => (item == null ? void 0 : item.module) === "sales") || null;
+  }
+  /**
+   * 从订单或搜索命中项中取订单号。
+   *
+   * @example
+   * const id = this.getSalesSearchOrderId({ order_id: 1001 })
+   */
+  getSalesSearchOrderId(order) {
+    if (!order || typeof order !== "object")
+      return null;
+    const raw = order.order_id ?? order.id;
+    if (raw === void 0 || raw === null || raw === "")
+      return null;
+    return String(raw);
+  }
+  /**
+   * 从查询值中提取 YYYY-MM-DD 日期串。
+   *
+   * @example
+   * this.extractQueryDate('2026-04-15 09:58:00') // => '2026-04-15'
+   */
+  extractQueryDate(raw) {
+    if (raw == null)
+      return null;
+    const date = (0, import_dayjs.default)(raw);
+    if (date.isValid()) {
+      return date.format("YYYY-MM-DD");
+    }
+    const text = String(raw).trim();
+    if (!text)
+      return null;
+    return text.split("T")[0].split(" ")[0] || null;
+  }
+  /**
+   * 判断时间范围是否「开始和结束都不是今天」。
+   *
+   * @example
+   * this.isRangeBothNotToday('2026-04-13', '2026-04-14') // => true
+   */
+  isRangeBothNotToday(startRaw, endRaw) {
+    const startDate = this.extractQueryDate(startRaw);
+    const endDate = this.extractQueryDate(endRaw);
+    if (!startDate || !endDate)
+      return false;
+    const today = (0, import_dayjs.default)().format("YYYY-MM-DD");
+    return startDate !== today && endDate !== today;
+  }
+  /**
+   * 订单查询是否走本地：
+   * - 当 start_time 与 end_time 都不是今天时，走远端；
    * - 其余情况走本地。
    */
   shouldUseLocalOrderQuery(data) {
@@ -1704,6 +2389,734 @@ var Server = class {
       };
     }
   }
+  getDeviceTaskPlugin() {
+    var _a, _b;
+    return ((_b = (_a = this.app) == null ? void 0 : _a.getPlugin) == null ? void 0 : _b.call(_a, "deviceTask")) || null;
+  }
+  getIdGeneratorPlugin() {
+    var _a, _b;
+    return ((_b = (_a = this.app) == null ? void 0 : _a.getPlugin) == null ? void 0 : _b.call(_a, "idGenerator")) || null;
+  }
+  getAppData(key) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v;
+    const getData = (_b = (_a = this.core.getPlugin("app")) == null ? void 0 : _a.getData) == null ? void 0 : _b.call(_a);
+    if (typeof getData === "function")
+      return getData(key);
+    const directValue = (_d = (_c = this.app) == null ? void 0 : _c.getData) == null ? void 0 : _d.call(_c, key);
+    if (directValue !== void 0)
+      return directValue;
+    const coreData = ((_i = (_g = (_f = (_e = this.app) == null ? void 0 : _e.models) == null ? void 0 : _f.getStore) == null ? void 0 : (_h = _g.call(_f)).getDataByModel) == null ? void 0 : _i.call(_h, "core", "core")) || ((_o = (_m = (_l = (_k = (_j = this.app) == null ? void 0 : _j.data) == null ? void 0 : _k.store) == null ? void 0 : _l.getStore) == null ? void 0 : (_n = _m.call(_l)).getDataByModel) == null ? void 0 : _o.call(_n, "core", "core")) || ((_v = (_u = (_s = (_r = (_q = (_p = this.app) == null ? void 0 : _p.data) == null ? void 0 : _q.store) == null ? void 0 : _r.getStore) == null ? void 0 : (_t = _s.call(_r)).getDataByModel) == null ? void 0 : _u.call(_t, "core")) == null ? void 0 : _v.core);
+    return coreData == null ? void 0 : coreData[key];
+  }
+  getSmallTicketShopInfo() {
+    const shopInfo = this.getAppData("shop_info") || {};
+    return {
+      ...shopInfo,
+      currency_symbol: shopInfo.currency_symbol || this.getAppData("shop_symbol") || this.getAppData("currency_symbol"),
+      currency_code: shopInfo.currency_code || this.getAppData("shop_currency_code") || this.getAppData("currency_code"),
+      tax_title: shopInfo.tax_title || this.getAppData("tax_title"),
+      tax_country_code: shopInfo.tax_country_code || this.getAppData("tax_country_code"),
+      is_price_include_tax: shopInfo.is_price_include_tax ?? this.getAppData("is_price_include_tax")
+    };
+  }
+  taskOk(result) {
+    return { status: "success", result };
+  }
+  taskFail(code, message, result) {
+    return {
+      status: "failed",
+      error: { code, message },
+      ...result !== void 0 ? { result } : {}
+    };
+  }
+  taskTimeout(message) {
+    return {
+      status: "timeout",
+      error: { code: "TIMEOUT", message }
+    };
+  }
+  async getShortNumberOrDeviceId() {
+    const getAsyncIotDeviceInfo = this.getAppData("async_iot_device_info");
+    if (getAsyncIotDeviceInfo) {
+      const res = await (getAsyncIotDeviceInfo == null ? void 0 : getAsyncIotDeviceInfo());
+      if (res == null ? void 0 : res.short_number) {
+        return res == null ? void 0 : res.short_number;
+      }
+    }
+    return String(this.getAppData("device_id") || 0).slice(-2);
+  }
+  buildCheckoutTaskIdempotencyKey(data) {
+    const identity = (data == null ? void 0 : data.request_unique_idempotency_token) || (data == null ? void 0 : data.external_sale_number) || (data == null ? void 0 : data.order_id) || (data == null ? void 0 : data.shop_order_number) || (data == null ? void 0 : data.shop_full_order_number);
+    if (identity === void 0 || identity === null || identity === "")
+      return void 0;
+    return `sync_sales:${identity}`;
+  }
+  isBlankCheckoutValue(value) {
+    return value === void 0 || value === null || value === "";
+  }
+  isLocalCheckoutOrderId(orderId) {
+    return typeof orderId === "string" && orderId.startsWith("LOCAL_");
+  }
+  async normalizeCheckoutSubmitData(data, title) {
+    if (!data || typeof data !== "object")
+      return data;
+    const next = { ...data };
+    const externalSaleNumber = next.external_sale_number;
+    const shouldClearLocalOrderId = this.isLocalCheckoutOrderId(next.order_id);
+    if (shouldClearLocalOrderId)
+      next.order_id = null;
+    const hasCheckoutOrderNumbers = !this.isBlankCheckoutValue(next.shop_order_number) && !this.isBlankCheckoutValue(next.shop_full_order_number);
+    if (hasCheckoutOrderNumbers) {
+      this.logInfo(`${title}: checkout 已携带订单号，跳过查重`, {
+        original_order_id: data.order_id,
+        order_id: next.order_id,
+        external_sale_number: externalSaleNumber,
+        shop_order_number: next.shop_order_number,
+        shop_full_order_number: next.shop_full_order_number
+      });
+      return next;
+    }
+    if (this.isBlankCheckoutValue(externalSaleNumber)) {
+      if (shouldClearLocalOrderId) {
+        this.logInfo(`${title}: checkout 本地订单号已清理`, {
+          original_order_id: data.order_id,
+          order_id: next.order_id
+        });
+      }
+      return next;
+    }
+    if (!this.order || typeof this.order.getLocalOrderFromMemoryByLookup !== "function") {
+      if (shouldClearLocalOrderId) {
+        this.logInfo(`${title}: checkout 本地订单号已清理`, {
+          original_order_id: data.order_id,
+          external_sale_number: externalSaleNumber
+        });
+      }
+      return next;
+    }
+    try {
+      const localOrder = this.order.getLocalOrderFromMemoryByLookup(externalSaleNumber);
+      if (!localOrder) {
+        if (shouldClearLocalOrderId) {
+          this.logInfo(`${title}: checkout 本地订单号已清理`, {
+            original_order_id: data.order_id,
+            external_sale_number: externalSaleNumber,
+            localOrderFound: false
+          });
+        }
+        return next;
+      }
+      if (this.isBlankCheckoutValue(next.shop_order_number)) {
+        next.shop_order_number = localOrder.shop_order_number;
+      }
+      if (this.isBlankCheckoutValue(next.shop_full_order_number)) {
+        next.shop_full_order_number = localOrder.shop_full_order_number;
+      }
+      this.logInfo(`${title}: checkout 已复用本地订单号`, {
+        original_order_id: data.order_id,
+        order_id: next.order_id,
+        external_sale_number: externalSaleNumber,
+        local_order_id: localOrder.order_id,
+        shop_order_number: next.shop_order_number,
+        shop_full_order_number: next.shop_full_order_number
+      });
+      delete next.vouchers;
+      return next;
+    } catch (error) {
+      this.logWarning(`${title}: checkout 查找本地订单失败`, {
+        external_sale_number: externalSaleNumber,
+        error: this.getUnknownErrorMessage(error),
+        error_detail: this.normalizeUnknownError(error)
+      });
+      return next;
+    }
+  }
+  async ensureCheckoutOrderNumbers(data, title) {
+    if (!data || typeof data !== "object")
+      return data;
+    const next = { ...data };
+    const needsShopOrderNumber = next.shop_order_number === void 0 || next.shop_order_number === null || next.shop_order_number === "";
+    const needsShopFullOrderNumber = next.shop_full_order_number === void 0 || next.shop_full_order_number === null || next.shop_full_order_number === "";
+    if (!needsShopOrderNumber && !needsShopFullOrderNumber)
+      return next;
+    const idGenerator = this.getIdGeneratorPlugin();
+    if (!idGenerator) {
+      this.logWarning(`${title}: idGenerator 插件不可用，无法生成订单号`, {
+        needsShopOrderNumber,
+        needsShopFullOrderNumber
+      });
+      return next;
+    }
+    try {
+      if (needsShopOrderNumber && idGenerator.generateShopOrderNumber) {
+        next.shop_order_number = await idGenerator.generateShopOrderNumber({
+          biz: next.business_code || "ticket"
+        });
+      }
+      if (needsShopFullOrderNumber && idGenerator.generateReceiptId) {
+        next.shop_full_order_number = await idGenerator.generateReceiptId({
+          biz: next.business_code || "ticket"
+        });
+      }
+      this.logInfo(`${title}: checkout 订单号已准备`, {
+        shop_order_number: next.shop_order_number,
+        shop_full_order_number: next.shop_full_order_number
+      });
+    } catch (error) {
+      this.logError(`${title}: 生成 checkout 订单号失败`, {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+    return next;
+  }
+  async dispatchCheckoutSyncTask(params) {
+    var _a, _b, _c, _d;
+    this.registerDeviceTaskActions();
+    const deviceTask = this.getDeviceTaskPlugin();
+    const debugDeviceId = await this.getShortNumberOrDeviceId();
+    const debugIdempotencyKey = this.buildCheckoutTaskIdempotencyKey(params.data);
+    if (!(deviceTask == null ? void 0 : deviceTask.dispatch)) {
+      this.logError(`${params.title}: deviceTask.dispatch 不可用`);
+      return;
+    }
+    try {
+      const result = await deviceTask.dispatch({
+        action: "sync_sales",
+        device_id: debugDeviceId,
+        payload: {
+          backendPath: params.backendPath,
+          data: params.data,
+          external_sale_number: (_a = params.data) == null ? void 0 : _a.external_sale_number,
+          title: params.title
+        },
+        retry_limit: 5,
+        idempotency_key: debugIdempotencyKey,
+        name: "同步订单",
+        source: "server",
+        source_type: "order",
+        source_id: ((_b = params.data) == null ? void 0 : _b.order_id) || ((_c = params.data) == null ? void 0 : _c.external_sale_number) || ((_d = params.data) == null ? void 0 : _d.shop_order_number)
+      });
+      this.logInfo(`${params.title}: sync_sales 任务已派发`, {
+        uuid: result == null ? void 0 : result.uuid,
+        status: result == null ? void 0 : result.status,
+        reused: result == null ? void 0 : result.reused
+      });
+    } catch (error) {
+      this.logError(`${params.title}: 派发 sync_sales 任务失败`, {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  async dispatchPrintOtherReceiptTask(params) {
+    var _a, _b, _c, _d, _e;
+    const deviceTask = this.getDeviceTaskPlugin();
+    if (!(deviceTask == null ? void 0 : deviceTask.dispatch)) {
+      this.logWarning("dispatchPrintOtherReceiptTask: deviceTask.dispatch 不可用");
+      return;
+    }
+    try {
+      let printIdentity = this.getPrintOrderIdentity(params.syncedOrder);
+      const deviceId = await this.getShortNumberOrDeviceId();
+      await deviceTask.dispatch({
+        action: "print_all",
+        device_id: params.deviceId ?? deviceId,
+        payload: {
+          type: params.receiptOnly ? "0" : "99",
+          data: params.receiptOnly ? {
+            order_id: printIdentity,
+            small_ticket_data: (_b = (_a = params.syncedOrder) == null ? void 0 : _a.payment_info) == null ? void 0 : _b.small_ticket_data
+          } : {
+            order_id: printIdentity,
+            machine_code_print_info: (_d = (_c = params.syncedOrder) == null ? void 0 : _c.payment_info) == null ? void 0 : _d.machine_code_print_info,
+            machine_code_print_info_v2: (_e = params.syncedOrder) == null ? void 0 : _e.machine_code_print_info_v2,
+            skip_receipt: true
+          }
+        },
+        idempotency_key: this.buildPrintOtherReceiptIdempotencyKey(params.syncedOrder, {
+          receiptOnly: params.receiptOnly
+        }),
+        name: "打印转发",
+        source: "server",
+        source_type: "order",
+        source_id: printIdentity
+      });
+    } catch (error) {
+      this.logError("dispatchPrintOtherReceiptTask: 派发失败", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  buildPrintOtherReceiptIdempotencyKey(order, options) {
+    const identity = (order == null ? void 0 : order.external_sale_number) || (order == null ? void 0 : order.shop_order_number) || (order == null ? void 0 : order.shop_full_order_number) || (order == null ? void 0 : order.order_id);
+    if (identity === void 0 || identity === null || identity === "")
+      return void 0;
+    return `${(options == null ? void 0 : options.receiptOnly) ? "print_receipt" : "print_voucher"}:${identity}:${Date.now()}`;
+  }
+  getPrintOrderIdentity(order) {
+    return (order == null ? void 0 : order.order_id) || (order == null ? void 0 : order.external_sale_number) || (order == null ? void 0 : order.shop_order_number) || (order == null ? void 0 : order.shop_full_order_number);
+  }
+  async dispatchLocalReceiptPrint(params) {
+    var _a;
+    if (params.requireFullyPaid && !this.isSalesOrderFullyPaid(params.order)) {
+      return { printed: false, order: params.order };
+    }
+    const printableOrder = await this.withLocalSmallTicketData(params.order, {
+      requireFullyPaid: params.requireFullyPaid
+    });
+    if (!(0, import_small_ticket.hasSmallTicketData)((_a = printableOrder.payment_info) == null ? void 0 : _a.small_ticket_data)) {
+      return { printed: false, order: printableOrder };
+    }
+    this.logInfo("dispatchLocalReceiptPrint: 构建触发任务前", {
+      checkoutData: params.checkoutData,
+      printableOrder,
+      response: params.response
+    });
+    await this.dispatchPrintOtherReceiptTask({
+      checkoutData: params.checkoutData,
+      syncedOrder: printableOrder,
+      response: params.response,
+      receiptOnly: true
+    });
+    return { printed: true, order: printableOrder };
+  }
+  shouldLookupLocalPrintOrder(input) {
+    const flag = (input == null ? void 0 : input.lookup_order_from_db) ?? (input == null ? void 0 : input.lookupOrderFromDb);
+    return flag === true || flag === 1 || flag === "1";
+  }
+  getLocalPrintOrderLookup(input) {
+    const orderId = (input == null ? void 0 : input.order_id) ?? (input == null ? void 0 : input.orderId);
+    if (orderId !== void 0 && orderId !== null && orderId !== "")
+      return orderId;
+    const externalSaleNumber = (input == null ? void 0 : input.external_sale_number) ?? (input == null ? void 0 : input.externalSaleNumber);
+    if (externalSaleNumber !== void 0 && externalSaleNumber !== null && externalSaleNumber !== "") {
+      return externalSaleNumber;
+    }
+    return void 0;
+  }
+  async handleOrderCheckoutSubmit(params) {
+    const { backendPath, data, title } = params;
+    this.logInfo(`${title}: 开始处理`, {
+      backendPath,
+      order_id: data == null ? void 0 : data.order_id,
+      external_sale_number: data == null ? void 0 : data.external_sale_number,
+      order_number: data == null ? void 0 : data.order_number
+    });
+    if ((data == null ? void 0 : data.sync_mode) || (data == null ? void 0 : data.syncMode)) {
+      return this.handleSyncCheckoutSubmit({
+        backendPath,
+        data,
+        title
+      });
+    }
+    const normalizedData = await this.normalizeCheckoutSubmitData(data, title);
+    const checkoutData = await this.ensureCheckoutOrderNumbers(normalizedData, title);
+    const pendingResult = await this.handlePendingSyncCheckoutOrder({
+      backendPath,
+      data: checkoutData,
+      title,
+      reason: "checkout 已转入设备任务同步"
+    });
+    if ((pendingResult == null ? void 0 : pendingResult.status) === true) {
+      const pendingOrder = pendingResult.data;
+      if (pendingOrder && this.shouldBuildSmallTicketData(checkoutData) && this.isSalesOrderFullyPaid(pendingOrder) && // TODO 这里先加个兼容，只有 type 为 virtual 才走打印
+      // 后期需要迁移到 picoding ，根据工作流配置
+      checkoutData.type === "virtual") {
+        await this.dispatchLocalReceiptPrint({
+          checkoutData,
+          order: pendingOrder,
+          response: pendingResult,
+          requireFullyPaid: true
+        });
+      }
+      await this.dispatchCheckoutSyncTask({
+        backendPath,
+        data: checkoutData,
+        title
+      });
+    }
+    if (!pendingResult.data.order_id) {
+      return {
+        ...pendingResult,
+        data: {
+          ...pendingResult.data,
+          order_id: pendingResult.data.external_sale_number
+        }
+      };
+    }
+    return pendingResult;
+  }
+  async handleSyncCheckoutSubmit(params) {
+    var _a, _b;
+    const { backendPath, data, title } = params;
+    if (!((_b = (_a = this.app) == null ? void 0 : _a.request) == null ? void 0 : _b.post)) {
+      this.logError(`${title}: sync checkout app.request 不可用`);
+      return {
+        code: 500,
+        status: false,
+        message: "app.request 不可用",
+        data: null
+      };
+    }
+    try {
+      const syncResult = await this.runCheckoutSync({
+        backendPath,
+        data,
+        title,
+        persistCheckoutDataWithResponse: true
+      });
+      if (syncResult.rejected) {
+        const normalized = this.normalizeCheckoutResponse(syncResult.errorResponse);
+        return {
+          ...normalized,
+          status: false,
+          message: syncResult.message || (normalized == null ? void 0 : normalized.message) || "后端明确拒绝 checkout",
+          data: (normalized == null ? void 0 : normalized.data) ?? null
+        };
+      }
+      return this.withSyncedOrderIdInCheckoutResponse(
+        syncResult.normalizedResponse,
+        syncResult.syncedOrder
+      );
+    } catch (error) {
+      const backendError = this.extractBackendErrorResponse(error);
+      if (backendError) {
+        const normalized = this.normalizeCheckoutResponse(backendError);
+        return {
+          ...normalized,
+          status: false,
+          message: (backendError == null ? void 0 : backendError.message) || (normalized == null ? void 0 : normalized.message) || "后端明确拒绝 checkout",
+          data: (normalized == null ? void 0 : normalized.data) ?? null
+        };
+      }
+      const message = this.getUnknownErrorMessage(error);
+      this.logError(`${title}: sync checkout 请求未明确成功`, {
+        backendPath,
+        error: message,
+        error_detail: this.normalizeUnknownError(error)
+      });
+      return {
+        code: 500,
+        status: false,
+        message,
+        data: null
+      };
+    }
+  }
+  async handlePendingSyncCheckoutOrder(params) {
+    var _a, _b, _c, _d;
+    const { backendPath, data, title, reason } = params;
+    const pendingOrder = await this.buildPendingSyncCheckoutOrder(data);
+    if (!pendingOrder) {
+      this.logError(`${title}: checkout 失败且订单缺少本地存储标识`, {
+        backendPath,
+        reason
+      });
+      return {
+        code: 500,
+        status: false,
+        message: "订单缺少本地存储标识，无法写入待同步队列",
+        data: null
+      };
+    }
+    if (!this.order || typeof this.order.upsertPendingSyncOrders !== "function") {
+      this.logError(`${title}: Order 模块不支持本地待同步写入`, {
+        backendPath,
+        reason
+      });
+      return {
+        code: 500,
+        status: false,
+        message: "Order 模块不支持本地待同步写入",
+        data: null
+      };
+    }
+    try {
+      await this.order.upsertPendingSyncOrders([pendingOrder]);
+      this.logInfo(`${title}: 订单已写入本地待同步`, {
+        backendPath,
+        reason,
+        order_id: pendingOrder.order_id,
+        external_sale_number: pendingOrder.external_sale_number,
+        order_number: pendingOrder.order_number
+      });
+      const changeGivenAmount = (_a = pendingOrder == null ? void 0 : pendingOrder.payments) == null ? void 0 : _a.reduce((sum, payment) => {
+        var _a2;
+        return sum + this.toAmountNumber((_a2 = payment == null ? void 0 : payment.metadata) == null ? void 0 : _a2.change_given_amount);
+      }, 0);
+      return {
+        code: 200,
+        status: true,
+        message: "",
+        data: {
+          ...pendingOrder,
+          amount_gap: (_b = pendingOrder == null ? void 0 : pendingOrder.summary) == null ? void 0 : _b.amount_gap,
+          expect_amount: (_c = pendingOrder == null ? void 0 : pendingOrder.summary) == null ? void 0 : _c.expect_amount,
+          total_amount: (_d = pendingOrder == null ? void 0 : pendingOrder.summary) == null ? void 0 : _d.total_amount,
+          payment_status: pendingOrder == null ? void 0 : pendingOrder.payment_status,
+          payment_info: {
+            ...(pendingOrder == null ? void 0 : pendingOrder.payment_info) || {},
+            current_change_given_amount: changeGivenAmount
+          }
+        }
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logError(`${title}: 写入本地待同步订单失败`, {
+        backendPath,
+        reason,
+        error: errorMessage
+      });
+      return { code: 500, status: false, message: errorMessage, data: null };
+    }
+  }
+  async buildPendingSyncCheckoutOrder(data) {
+    if (!data || typeof data !== "object")
+      return null;
+    const hasStorageKey = data.external_sale_number !== void 0 && data.external_sale_number !== null && data.external_sale_number !== "" ? true : data.order_id !== void 0 && data.order_id !== null && data.order_id !== "";
+    if (!hasStorageKey)
+      return null;
+    const pendingOrder = {
+      ...data,
+      need_sync: 1
+    };
+    const productMap = await this.buildSmallTicketProductMap(pendingOrder);
+    const orderWithProductTitles = this.withPendingSyncProductTitles(
+      pendingOrder,
+      productMap
+    );
+    return this.withLocalSmallTicketData(
+      orderWithProductTitles,
+      { requireFullyPaid: true, productMap }
+    );
+  }
+  shouldBuildSmallTicketData(order) {
+    var _a;
+    if (!order || typeof order !== "object")
+      return false;
+    if ((0, import_small_ticket.hasSmallTicketData)((_a = order.payment_info) == null ? void 0 : _a.small_ticket_data))
+      return false;
+    return Number(order.small_ticket_data_flag ?? order.smallTicketDataFlag ?? 0) === 1;
+  }
+  shouldPrintSyncedOrder(params) {
+    if (this.hasPaymentStatus(params.syncedOrder)) {
+      return this.isSalesOrderFullyPaid(params.syncedOrder);
+    }
+    return this.isSalesOrderFullyPaid(params.checkoutData);
+  }
+  hasPaymentStatus(order) {
+    return (order == null ? void 0 : order.payment_status) !== void 0 && (order == null ? void 0 : order.payment_status) !== null && (order == null ? void 0 : order.payment_status) !== "";
+  }
+  isSalesOrderFullyPaid(order) {
+    var _a, _b, _c;
+    if (!order || typeof order !== "object")
+      return false;
+    const paymentStatus = String(order.payment_status || "").toLowerCase();
+    if (paymentStatus === "paid" || paymentStatus === "finished")
+      return true;
+    if (paymentStatus === "partially_paid" || paymentStatus === "payment_processing" || paymentStatus === "pending" || paymentStatus === "unpaid") {
+      return false;
+    }
+    const amountGap = ((_a = order.summary) == null ? void 0 : _a.amount_gap) ?? order.amount_gap;
+    if (amountGap !== void 0 && amountGap !== null && amountGap !== "") {
+      return this.toAmountNumber(amountGap) <= 0;
+    }
+    const paidAmount = this.sumPaidOrderPayments(order.payments);
+    const targetAmount = this.toAmountNumber(
+      ((_b = order.summary) == null ? void 0 : _b.expect_amount) ?? ((_c = order.summary) == null ? void 0 : _c.total_amount) ?? order.expect_amount ?? order.total_amount
+    );
+    if (targetAmount <= 0)
+      return paidAmount > 0;
+    return paidAmount >= targetAmount;
+  }
+  sumPaidOrderPayments(payments) {
+    if (!Array.isArray(payments))
+      return 0;
+    return payments.reduce((sum, payment) => {
+      const status = String((payment == null ? void 0 : payment.status) || "").toLowerCase();
+      if (status === "voided" || status === "failed" || status === "cancelled")
+        return sum;
+      return sum + this.toAmountNumber((payment == null ? void 0 : payment.amount) ?? (payment == null ? void 0 : payment.origin_amount));
+    }, 0);
+  }
+  toAmountNumber(value) {
+    if (typeof value === "number")
+      return Number.isFinite(value) ? value : 0;
+    if (typeof value !== "string")
+      return 0;
+    const parsed = Number(value.replace(/[^\d.-]/g, ""));
+    return Number.isFinite(parsed) ? parsed : 0;
+  }
+  async buildSmallTicketProductMap(order) {
+    var _a;
+    const products = Array.isArray(order == null ? void 0 : order.products) ? order.products : [];
+    const productIdSet = /* @__PURE__ */ new Set();
+    products.forEach((product) => {
+      const productId = (product == null ? void 0 : product.product_id) ?? (product == null ? void 0 : product.id);
+      if (productId !== void 0 && productId !== null && productId !== "") {
+        productIdSet.add(productId);
+      }
+      if (Array.isArray(product == null ? void 0 : product.product_bundle)) {
+        product.product_bundle.forEach((bundle) => {
+          const bundleProductId = (bundle == null ? void 0 : bundle.bundle_product_id) ?? (bundle == null ? void 0 : bundle._bundle_product_id) ?? (bundle == null ? void 0 : bundle.product_id);
+          if (bundleProductId !== void 0 && bundleProductId !== null && bundleProductId !== "") {
+            productIdSet.add(bundleProductId);
+          }
+        });
+      }
+    });
+    const productIds = Array.from(productIdSet);
+    if (!productIds.length || typeof ((_a = this.products) == null ? void 0 : _a.getProductById) !== "function")
+      return {};
+    const entries = await Promise.all(
+      productIds.map(async (id) => {
+        var _a2, _b;
+        try {
+          const product = await ((_b = (_a2 = this.products) == null ? void 0 : _a2.getProductById) == null ? void 0 : _b.call(_a2, Number(id)));
+          return product ? [String(id), product] : null;
+        } catch (error) {
+          this.logWarning("buildSmallTicketProductMap: 查询本地商品失败", {
+            product_id: id,
+            error: error instanceof Error ? error.message : String(error)
+          });
+          return null;
+        }
+      })
+    );
+    return entries.reduce((map, entry) => {
+      if (!entry)
+        return map;
+      const [id, product] = entry;
+      map[id] = product;
+      return map;
+    }, {});
+  }
+  withPendingSyncProductTitles(order, productMap) {
+    const products = Array.isArray(order.products) ? order.products : null;
+    if (!(products == null ? void 0 : products.length))
+      return order;
+    return {
+      ...order,
+      products: products.map((product) => ({
+        ...product,
+        product_title: this.buildProductTitleSnapshot(product, productMap)
+      }))
+    };
+  }
+  buildProductTitleSnapshot(product, productMap) {
+    var _a, _b;
+    const productId = product.product_id ?? product.id;
+    const fallbackProduct = productId !== void 0 && productId !== null ? productMap[productId] || productMap[String(productId)] : null;
+    const ownTitle = product.product_title || product.title || product.name || ((_a = product.product) == null ? void 0 : _a.title);
+    const fallbackTitle = (fallbackProduct == null ? void 0 : fallbackProduct.product_title) || (fallbackProduct == null ? void 0 : fallbackProduct.title) || (fallbackProduct == null ? void 0 : fallbackProduct.name) || (fallbackProduct == null ? void 0 : fallbackProduct.format_title) || ((_b = fallbackProduct == null ? void 0 : fallbackProduct.product) == null ? void 0 : _b.title);
+    const currentLocale = this.getProductTitleSnapshotCurrentLocale();
+    const autoTitle = this.resolveFirstProductTitleValue(ownTitle) || this.resolveFirstProductTitleValue(fallbackTitle);
+    return PRODUCT_TITLE_SNAPSHOT_KEYS.reduce((snapshot, key) => {
+      snapshot[key] = this.resolveProductTitleValue(ownTitle, key, currentLocale) || this.resolveProductTitleValue(fallbackTitle, key, currentLocale) || (key === "auto" || key === "original" ? autoTitle : null);
+      return snapshot;
+    }, {});
+  }
+  getProductTitleSnapshotCurrentLocale() {
+    var _a, _b;
+    const shopInfo = this.getSmallTicketShopInfo();
+    const rawLocale = shopInfo.primary_locale || this.getAppData("locale") || this.getAppData("language") || ((_a = this.core.context) == null ? void 0 : _a.locale) || ((_b = this.core.context) == null ? void 0 : _b.language);
+    return this.normalizeProductTitleSnapshotLocale(rawLocale);
+  }
+  normalizeProductTitleSnapshotLocale(value) {
+    if (typeof value !== "string" || !value)
+      return null;
+    const normalized = value.replace("_", "-");
+    const matchedKey = PRODUCT_TITLE_SNAPSHOT_KEYS.find((key) => key === normalized);
+    return matchedKey ?? null;
+  }
+  resolveProductTitleValue(value, key, currentLocale) {
+    if (value === void 0 || value === null || value === "")
+      return null;
+    if (typeof value !== "object") {
+      const title = String(value);
+      if (key === "auto" || key === "original")
+        return title;
+      if (key === currentLocale && this.canAssignStringProductTitleToLocale(title, currentLocale))
+        return title;
+      return null;
+    }
+    const normalizedKey = key.replace("-", "_");
+    const dashedKey = key.replace("_", "-");
+    const rawValue = value[key] ?? value[normalizedKey] ?? value[dashedKey] ?? (key === "auto" ? value.default : void 0);
+    if (rawValue === void 0 || rawValue === null || rawValue === "")
+      return null;
+    if (typeof rawValue === "object")
+      return this.resolveFirstProductTitleValue(rawValue);
+    return String(rawValue);
+  }
+  canAssignStringProductTitleToLocale(title, locale) {
+    if (!locale)
+      return false;
+    if (locale === "zh-CN" || locale === "zh-HK" || locale === "kitchen") {
+      return this.hasCjkText(title);
+    }
+    if (locale === "ja")
+      return /[\u3040-\u30ff]/.test(title) || this.hasCjkText(title);
+    if (locale === "en" || locale === "pt")
+      return !this.hasCjkText(title);
+    return false;
+  }
+  hasCjkText(value) {
+    return /[\u3400-\u9fff]/.test(value);
+  }
+  resolveFirstProductTitleValue(value) {
+    if (value === void 0 || value === null || value === "")
+      return null;
+    if (typeof value !== "object")
+      return String(value);
+    const preferredKeys = [
+      "auto",
+      "en",
+      "original",
+      "zh-CN",
+      "zh_CN",
+      "zh-HK",
+      "zh_HK",
+      "kitchen",
+      "ja",
+      "pt",
+      "default"
+    ];
+    for (const key of preferredKeys) {
+      const rawValue = value[key];
+      if (rawValue !== void 0 && rawValue !== null && rawValue !== "")
+        return String(rawValue);
+    }
+    const firstValue = Object.values(value).find(
+      (item) => item !== void 0 && item !== null && item !== ""
+    );
+    return firstValue === void 0 ? null : String(firstValue);
+  }
+  async withLocalSmallTicketData(order, options) {
+    if (!this.shouldBuildSmallTicketData(order))
+      return order;
+    if ((options == null ? void 0 : options.requireFullyPaid) && !this.isSalesOrderFullyPaid(order))
+      return order;
+    try {
+      const productMap = (options == null ? void 0 : options.productMap) ?? await this.buildSmallTicketProductMap(order);
+      const smallTicketData = (0, import_small_ticket.buildSmallTicketData)({
+        order,
+        shopInfo: this.getSmallTicketShopInfo(),
+        productMap
+      });
+      return {
+        ...order,
+        payment_info: {
+          ...order.payment_info || {},
+          small_ticket_data: smallTicketData
+        }
+      };
+    } catch (error) {
+      this.logError("withLocalSmallTicketData: 生成本地小票数据失败", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return order;
+    }
+  }
   /**
    * 解析 order_ids 入参，兼容 url query / data 字段、字符串(csv) / 数组两种形态。
    * 自动 trim、去空、按字符串去重，输出归一化后的字符串数组。
@@ -1856,12 +3269,15 @@ var Server = class {
       return null;
     }
   }
-  extractOrderSalesDetailId(url) {
+  extractOrderSalesDetailLookup(url) {
     const path = this.parseRequestPath(url);
     const match = path.match(/^\/shop\/order\/sales\/([^/?#]+)$/);
     return (match == null ? void 0 : match[1]) ? decodeURIComponent(match[1]) : null;
   }
-  buildOrderSalesDetailBackendPath(orderId, data) {
+  shouldForceRemoteSalesDetail(data) {
+    return (data == null ? void 0 : data.forceRemote) === true || (data == null ? void 0 : data.force_remote) === true;
+  }
+  buildOrderSalesDetailBackendPath(lookup, data) {
     const rawWith = data && typeof data === "object" ? data.with : void 0;
     const withFields = Array.isArray(rawWith) && rawWith.length > 0 ? rawWith : ["products", "scheduleEvents"];
     const searchParams = new URLSearchParams();
@@ -1872,7 +3288,198 @@ var Server = class {
     });
     searchParams.append("lookup_mode", "multi");
     const query = searchParams.toString();
-    return `/shop/order/sales/${encodeURIComponent(orderId)}${query ? `?${query}` : ""}`;
+    return `/shop/order/sales/${encodeURIComponent(lookup)}${query ? `?${query}` : ""}`;
+  }
+  extractOrderDataFromCheckoutResponse(response) {
+    var _a, _b;
+    const candidates = [
+      (_a = response == null ? void 0 : response.data) == null ? void 0 : _a.order,
+      (_b = response == null ? void 0 : response.data) == null ? void 0 : _b.sales,
+      response == null ? void 0 : response.data,
+      response == null ? void 0 : response.order,
+      response == null ? void 0 : response.sales,
+      response
+    ];
+    for (const candidate of candidates) {
+      if (!candidate || typeof candidate !== "object")
+        continue;
+      if (candidate.order_id !== void 0 && candidate.order_id !== null) {
+        return candidate;
+      }
+    }
+    return null;
+  }
+  getCheckoutExternalSaleNumber(data, payload) {
+    var _a;
+    const candidates = [
+      payload == null ? void 0 : payload.external_sale_number,
+      data == null ? void 0 : data.external_sale_number,
+      (_a = payload == null ? void 0 : payload.data) == null ? void 0 : _a.external_sale_number
+    ];
+    const value = candidates.find((candidate) => candidate !== void 0 && candidate !== null && candidate !== "");
+    return value === void 0 ? void 0 : String(value);
+  }
+  buildCheckoutSyncSuccessPatch(fresh) {
+    if (!fresh)
+      return {};
+    const patch = {};
+    if (fresh.order_id !== void 0 && fresh.order_id !== null)
+      patch.order_id = fresh.order_id;
+    if (fresh.order_number !== void 0 && fresh.order_number !== null) {
+      patch.order_number = fresh.order_number;
+    }
+    return patch;
+  }
+  buildSyncedOrderForPrint(params) {
+    const { syncedOrder, checkoutResponseOrder } = params;
+    if (!checkoutResponseOrder || typeof checkoutResponseOrder !== "object")
+      return syncedOrder;
+    const printableOrder = { ...syncedOrder };
+    const responseOrder = checkoutResponseOrder;
+    if (responseOrder.order_id !== void 0 && responseOrder.order_id !== null) {
+      printableOrder.order_id = responseOrder.order_id;
+    }
+    if (responseOrder.payment_status !== void 0 && responseOrder.payment_status !== null) {
+      printableOrder.payment_status = responseOrder.payment_status;
+    }
+    if (responseOrder.expect_amount !== void 0 && responseOrder.expect_amount !== null) {
+      printableOrder.expect_amount = responseOrder.expect_amount;
+    }
+    if (responseOrder.machine_code_print_info_v2 !== void 0) {
+      printableOrder.machine_code_print_info_v2 = responseOrder.machine_code_print_info_v2;
+    }
+    if (responseOrder.payment_info && typeof responseOrder.payment_info === "object") {
+      printableOrder.payment_info = {
+        ...syncedOrder.payment_info || {},
+        ...responseOrder.payment_info
+      };
+    }
+    return printableOrder;
+  }
+  isMergeableCheckoutOrder(order, externalSaleNumber) {
+    if (!order || typeof order !== "object")
+      return false;
+    const orderExternalSaleNumber = order.external_sale_number;
+    if (externalSaleNumber && orderExternalSaleNumber !== void 0 && orderExternalSaleNumber !== null && String(orderExternalSaleNumber) !== externalSaleNumber) {
+      return false;
+    }
+    if (externalSaleNumber && (orderExternalSaleNumber === void 0 || orderExternalSaleNumber === null || orderExternalSaleNumber === "")) {
+      return false;
+    }
+    return Array.isArray(order.products) || Array.isArray(order.bookings) || Array.isArray(order.payments) || !!order.summary || order.order_number !== void 0 || order.payment_status !== void 0 || order.status !== void 0;
+  }
+  normalizeCheckoutResponse(response) {
+    if (response && typeof response === "object" && (response.code !== void 0 || response.status !== void 0)) {
+      return response;
+    }
+    return {
+      code: 200,
+      status: true,
+      message: "",
+      data: response
+    };
+  }
+  withSyncedOrderIdInCheckoutResponse(response, syncedOrder) {
+    const normalized = this.normalizeCheckoutResponse(response);
+    const orderId = syncedOrder == null ? void 0 : syncedOrder.order_id;
+    if (orderId === void 0 || orderId === null)
+      return normalized;
+    if (!(normalized == null ? void 0 : normalized.data) || typeof normalized.data !== "object")
+      return normalized;
+    return {
+      ...normalized,
+      data: {
+        ...normalized.data,
+        order_id: normalized.data.order_id ?? orderId
+      }
+    };
+  }
+  isCheckoutResponseRejected(response) {
+    const normalized = this.normalizeCheckoutResponse(response);
+    const isErrorCode = (normalized == null ? void 0 : normalized.code) !== void 0 && normalized.code !== 200 && normalized.code !== "200";
+    const isErrorStatus = (normalized == null ? void 0 : normalized.status) === false || typeof (normalized == null ? void 0 : normalized.status) === "number" && normalized.status >= 400;
+    const isErrorSuccess = (normalized == null ? void 0 : normalized.success) === false;
+    return isErrorCode || isErrorStatus || isErrorSuccess;
+  }
+  getUnknownErrorMessage(error) {
+    var _a, _b, _c, _d, _e, _f;
+    if (error instanceof Error && error.message)
+      return error.message;
+    if (typeof error === "string")
+      return error;
+    const candidates = [
+      error == null ? void 0 : error.message,
+      (_b = (_a = error == null ? void 0 : error.response) == null ? void 0 : _a.data) == null ? void 0 : _b.message,
+      (_c = error == null ? void 0 : error.data) == null ? void 0 : _c.message,
+      (_e = (_d = error == null ? void 0 : error.response) == null ? void 0 : _d.body) == null ? void 0 : _e.message,
+      (_f = error == null ? void 0 : error.body) == null ? void 0 : _f.message
+    ];
+    const message = candidates.find((candidate) => typeof candidate === "string" && candidate !== "");
+    if (message)
+      return message;
+    const normalized = this.normalizeUnknownError(error);
+    if (typeof normalized === "string")
+      return normalized;
+    try {
+      return JSON.stringify(normalized);
+    } catch {
+      return String(error);
+    }
+  }
+  normalizeUnknownError(error) {
+    var _a, _b;
+    if (error instanceof Error) {
+      const normalized = {
+        name: error.name,
+        message: error.message,
+        stack: error.stack
+      };
+      const record = error;
+      if (((_a = record.response) == null ? void 0 : _a.data) !== void 0)
+        normalized.responseData = record.response.data;
+      if (record.data !== void 0)
+        normalized.data = record.data;
+      if (((_b = record.response) == null ? void 0 : _b.body) !== void 0)
+        normalized.responseBody = record.response.body;
+      if (record.body !== void 0)
+        normalized.body = record.body;
+      return this.safeJsonClone(normalized);
+    }
+    if (!error || typeof error !== "object")
+      return String(error);
+    return this.safeJsonClone(error);
+  }
+  safeJsonClone(value) {
+    const seen = /* @__PURE__ */ new WeakSet();
+    try {
+      return JSON.parse(JSON.stringify(value, (_key, current) => {
+        if (!current || typeof current !== "object")
+          return current;
+        if (seen.has(current))
+          return "[Circular]";
+        seen.add(current);
+        return current;
+      }));
+    } catch {
+      return String(value);
+    }
+  }
+  extractBackendErrorResponse(error) {
+    var _a, _b;
+    const candidates = [
+      (_a = error == null ? void 0 : error.response) == null ? void 0 : _a.data,
+      error == null ? void 0 : error.data,
+      (_b = error == null ? void 0 : error.response) == null ? void 0 : _b.body,
+      error == null ? void 0 : error.body
+    ];
+    return candidates.find(
+      (candidate) => this.isExplicitBackendErrorResponse(candidate)
+    ) || null;
+  }
+  isExplicitBackendErrorResponse(candidate) {
+    if (!candidate || typeof candidate !== "object")
+      return false;
+    return candidate.code !== void 0 || candidate.status !== void 0 || typeof candidate.message === "string";
   }
   /**
    * 从 url 或路由 path 解析 pathname（不含 query，去掉末尾 /）
@@ -2040,6 +3647,38 @@ var Server = class {
       status: true
     };
   }
+  /**
+   * 规范商品扩展类型过滤参数。
+   *
+   * @example
+   * const types = this.normalizeProductExtensionTypes(['product_add_time']);
+   */
+  normalizeProductExtensionTypes(extension_type) {
+    if (!Array.isArray(extension_type))
+      return [];
+    return extension_type.map((item) => String(item || "").trim()).filter(Boolean);
+  }
+  /**
+   * 请求包含 product_add_time 时，按传入 extension_type 数组配置过滤商品。
+   *
+   * @example
+   * const list = this.filterProductsByExtensionTypes(products, ['product_add_time']);
+   */
+  filterProductsByExtensionTypes(products, extension_type) {
+    const extensionTypes = this.normalizeProductExtensionTypes(extension_type);
+    if (!extensionTypes.includes("product_add_time"))
+      return products;
+    return products.filter((product) => extensionTypes.includes(String((product == null ? void 0 : product.extension_type) || "")));
+  }
+  /**
+   * 判断本次查询是否需要跳过餐牌过滤，直接按扩展类型拉商品。
+   *
+   * @example
+   * const skipMenu = this.shouldQueryProductsByExtensionTypes(['product_add_time']);
+   */
+  shouldQueryProductsByExtensionTypes(extension_type) {
+    return this.normalizeProductExtensionTypes(extension_type).includes("product_add_time");
+  }
   /**
    * 商品查询的核心计算逻辑（编排 Products、Menu、Schedule 模块）
    * 供 handleProductQuery 首次返回及 pubsub 变更推送复用
@@ -2049,12 +3688,15 @@ var Server = class {
    */
   async computeProductQueryResult(context, options) {
     const tTotal = performance.now();
-    const { menu_list_ids, schedule_date, schedule_datetime, customer_id, product_id } = context;
+    const { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id } = context;
+    const queryIds = Array.isArray(ids) ? ids.map((id) => Number(id)).filter((id) => Number.isFinite(id)) : [];
     this.logInfo("computeProductQueryResult 开始", {
       menuListIdsCount: (menu_list_ids == null ? void 0 : menu_list_ids.length) ?? 0,
+      ids: queryIds,
       schedule_datetime,
       schedule_date,
       customer_id,
+      extension_type,
       product_id,
       changedIds: options == null ? void 0 : options.changedIds
     });
@@ -2062,6 +3704,39 @@ var Server = class {
       this.logError("computeProductQueryResult: Products 模块未注册");
       return { message: "Products 模块未注册", data: { list: [], count: 0 } };
     }
+    if (queryIds.length > 0) {
+      const uniqueIds = Array.from(new Set(queryIds));
+      const tPrice2 = performance.now();
+      const productsWithPrice = await this.products.getProductsWithPrice(schedule_date, {
+        scheduleModule: this.getSchedule(),
+        schedule_datetime,
+        customer_id
+      }, {
+        changedIds: options == null ? void 0 : options.changedIds,
+        productIds: uniqueIds
+      });
+      (0, import_product.perfMark)("computeQuery.getProductsWithPrice(ids)", performance.now() - tPrice2, {
+        count: productsWithPrice.length,
+        ids: uniqueIds
+      });
+      const filteredProducts2 = productsWithPrice.filter((p) => uniqueIds.includes(Number(p == null ? void 0 : p.id))).filter((p) => ((p == null ? void 0 : p.status) || "published") === "published");
+      const extensionFilteredProducts = this.filterProductsByExtensionTypes(filteredProducts2, extension_type);
+      (0, import_product.perfMark)("computeProductQueryResult", performance.now() - tTotal, {
+        mode: "ids",
+        ids: uniqueIds,
+        count: extensionFilteredProducts.length
+      });
+      this.logInfo("computeProductQueryResult 完成（ids）", {
+        ids: uniqueIds,
+        count: extensionFilteredProducts.length
+      });
+      return {
+        code: 200,
+        data: { list: extensionFilteredProducts, count: extensionFilteredProducts.length },
+        message: "",
+        status: true
+      };
+    }
     if (product_id != null && Number.isFinite(Number(product_id))) {
       const pid = Number(product_id);
       const tPrice2 = performance.now();
@@ -2074,7 +3749,10 @@ var Server = class {
         count: allProductsWithPrice.length,
         productId: pid
       });
-      const published = allProductsWithPrice.filter((p) => ((p == null ? void 0 : p.status) || "published") === "published");
+      const published = this.filterProductsByExtensionTypes(
+        allProductsWithPrice.filter((p) => ((p == null ? void 0 : p.status) || "published") === "published"),
+        extension_type
+      );
       const item = published.find((p) => Number(p.id) === pid) ?? null;
       (0, import_product.perfMark)("computeProductQueryResult", performance.now() - tTotal, {
         mode: "single",
@@ -2092,6 +3770,57 @@ var Server = class {
         status: true
       };
     }
+    if (this.shouldQueryProductsByExtensionTypes(extension_type)) {
+      const tPrice2 = performance.now();
+      let filteredProducts2 = await this.products.getProductsWithPrice(schedule_date, {
+        scheduleModule: this.getSchedule(),
+        schedule_datetime,
+        customer_id
+      }, {
+        changedIds: options == null ? void 0 : options.changedIds
+      });
+      (0, import_product.perfMark)("computeQuery.getProductsWithPrice(extensionType)", performance.now() - tPrice2, {
+        count: filteredProducts2.length,
+        extension_type
+      });
+      const tStatus2 = performance.now();
+      const beforeStatusCount2 = filteredProducts2.length;
+      filteredProducts2 = filteredProducts2.filter((p) => ((p == null ? void 0 : p.status) || "published") === "published");
+      (0, import_product.perfMark)("computeQuery.filterByStatus(extensionType)", performance.now() - tStatus2, {
+        before: beforeStatusCount2,
+        after: filteredProducts2.length
+      });
+      const tExtensionType2 = performance.now();
+      const beforeExtensionTypeCount2 = filteredProducts2.length;
+      filteredProducts2 = this.filterProductsByExtensionTypes(filteredProducts2, extension_type);
+      (0, import_product.perfMark)("computeQuery.filterByExtensionType(extensionType)", performance.now() - tExtensionType2, {
+        before: beforeExtensionTypeCount2,
+        after: filteredProducts2.length,
+        extension_type
+      });
+      const tSort2 = performance.now();
+      filteredProducts2 = filteredProducts2.sort((a, b) => {
+        const sortDiff = Number(b.sort) - Number(a.sort);
+        if (sortDiff !== 0)
+          return sortDiff;
+        return (a.title || "").localeCompare(b.title || "");
+      });
+      (0, import_product.perfMark)("computeQuery.sort(extensionType)", performance.now() - tSort2, { count: filteredProducts2.length });
+      (0, import_product.perfMark)("computeProductQueryResult", performance.now() - tTotal, {
+        mode: "extensionType",
+        filteredCount: filteredProducts2.length
+      });
+      this.logInfo("computeProductQueryResult 完成（extension_type）", {
+        filteredCount: filteredProducts2.length,
+        extension_type
+      });
+      return {
+        code: 200,
+        data: { list: filteredProducts2, count: filteredProducts2.length },
+        message: "",
+        status: true
+      };
+    }
     if (!this.menu) {
       this.logError("computeProductQueryResult: Menu 模块未注册");
       return { message: "Menu 模块未注册", data: { list: [], count: 0 } };
@@ -2141,6 +3870,14 @@ var Server = class {
       before: beforeStatusCount,
       after: filteredProducts.length
     });
+    const tExtensionType = performance.now();
+    const beforeExtensionTypeCount = filteredProducts.length;
+    filteredProducts = this.filterProductsByExtensionTypes(filteredProducts, extension_type);
+    (0, import_product.perfMark)("computeQuery.filterByExtensionType", performance.now() - tExtensionType, {
+      before: beforeExtensionTypeCount,
+      after: filteredProducts.length,
+      extension_type
+    });
     const tSort = performance.now();
     filteredProducts = filteredProducts.sort((a, b) => {
       const sortDiff = Number(b.sort) - Number(a.sort);
@@ -2234,6 +3971,101 @@ var Server = class {
       totalNotifyDurationMs: notifyEndAt - notifyStartAt
     });
   }
+  /**
+   * 订单变更后通知 sales 搜索订阅者。
+   * 仅回传当前查询已返回订单号集合中的变更订单。
+   *
+   * @example
+   * this.notifySalesSearchSubscribers({ list: [], changedOrders: [order], source: 'pubsub.bodyUpsert' })
+   */
+  notifySalesSearchSubscribers(payload) {
+    if (this.salesSearchSubscribers.size === 0)
+      return;
+    const changedOrders = this.extractChangedOrdersFromPayload(payload);
+    if (changedOrders.length === 0) {
+      return;
+    }
+    for (const [subscriberId, subscriber] of this.salesSearchSubscribers.entries()) {
+      try {
+        const changedVisibleOrders = changedOrders.filter((order) => {
+          const orderId = this.getSalesSearchOrderId(order);
+          return !!orderId && subscriber.visibleOrderIds.has(orderId);
+        });
+        if (changedVisibleOrders.length === 0) {
+          continue;
+        }
+        subscriber.callback(
+          this.buildSalesSearchDeltaResponse(subscriber, changedVisibleOrders)
+        );
+        this.logInfo("notifySalesSearchSubscribers: 已推送 delta", {
+          subscriberId,
+          kind: subscriber.kind,
+          count: changedVisibleOrders.length
+        });
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        this.logError("notifySalesSearchSubscribers: 推送失败", {
+          subscriberId,
+          error: errorMessage
+        });
+      }
+    }
+  }
+  /**
+   * 从订单变更事件中提取明确 delta。
+   *
+   * @example
+   * const list = this.extractChangedOrdersFromPayload(payload)
+   */
+  extractChangedOrdersFromPayload(payload) {
+    if (!payload || Array.isArray(payload))
+      return [];
+    return Array.isArray(payload.changedOrders) ? payload.changedOrders : [];
+  }
+  /**
+   * 构建与当前搜索接口一致的 delta 响应。
+   *
+   * @example
+   * const response = this.buildSalesSearchDeltaResponse(subscriber, [order])
+   */
+  buildSalesSearchDeltaResponse(subscriber, changedOrders) {
+    if (subscriber.kind === "aggregate") {
+      return this.buildAggregateSalesSearchDeltaResponse(subscriber, changedOrders);
+    }
+    const data = subscriber.lastResponseData || {};
+    return {
+      code: 200,
+      status: true,
+      message: "",
+      data: {
+        ...data,
+        list: changedOrders
+      }
+    };
+  }
+  /**
+   * 构建聚合搜索接口的 sales 分组 delta 响应。
+   *
+   * @example
+   * const response = this.buildAggregateSalesSearchDeltaResponse(subscriber, [order])
+   */
+  buildAggregateSalesSearchDeltaResponse(subscriber, changedOrders) {
+    const data = subscriber.lastResponseData || {};
+    const results = Array.isArray(data == null ? void 0 : data.results) ? data.results : [];
+    const hasSalesGroup = results.some((item) => (item == null ? void 0 : item.module) === "sales");
+    const nextResults = hasSalesGroup ? results.map(
+      (item) => (item == null ? void 0 : item.module) === "sales" ? { ...item, list: changedOrders } : item
+    ) : [{ module: "sales", list: changedOrders, count: changedOrders.length }];
+    return {
+      code: 200,
+      status: true,
+      message: "",
+      data: {
+        ...data,
+        results: nextResults
+      }
+    };
+  }
   /**
    * 预约数据变更后，遍历订阅者重新计算并通过 callback 推送
    */