@pisell/pisellos 2.2.204 → 2.2.206

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,6 +49,7 @@ 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 Server = class {
   constructor(core) {
@@ -69,6 +71,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 +124,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,6 +156,17 @@ 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
+      };
+    };
     /**
      * 处理商品查询请求
      * 存储订阅者信息，便于数据变更时推送最新结果
@@ -270,6 +294,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 层排除的订单类型：
      * 这些类型不会出现在日历上，拉取它们只会浪费带宽并增加前端过滤成本。
@@ -466,6 +525,54 @@ var Server = class {
         title: "handleOrderCheckout"
       });
     };
+    this.handleLocalPrintOrder = async ({ data }) => {
+      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 checkoutData = await this.ensureCheckoutOrderNumbers(
+          {
+            ...inputOrder,
+            small_ticket_data_flag: 1
+          },
+          "handleLocalPrintOrder"
+        );
+        const printableOrder = {
+          ...checkoutData,
+          need_sync: checkoutData.need_sync ?? 1
+        };
+        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);
@@ -912,6 +1019,7 @@ var Server = class {
       moduleConfigs
     });
     this.registerServerRoutes();
+    this.registerDeviceTaskActions();
     const registeredModules = await this.registerModules(moduleConfigs);
     if (autoPreload) {
       await this.preloadModulesData(registeredModules, options);
@@ -927,10 +1035,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 初始化完成", {
@@ -939,6 +1048,114 @@ 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 response = await this.app.request.post("/shop/order/sales/checkout", data, {
+        isShopApi: true,
+        customToast: () => {
+        }
+      });
+      if (this.isCheckoutResponseRejected(response)) {
+        const message = (response == null ? void 0 : response.message) || "后端明确拒绝 checkout";
+        this.logError(`${title}: sync_sales 后端明确失败`, {
+          backendPath,
+          response
+        });
+        return this.taskFail("BACKEND_REJECTED", message, response);
+      }
+      const fresh = this.extractOrderDataFromCheckoutResponse(response);
+      if (!fresh) {
+        this.logWarning(`${title}: sync_sales 返回未包含可同步订单`, {
+          backendPath,
+          response
+        });
+        return this.taskTimeout("checkout 返回未包含可同步订单");
+      }
+      const syncedOrder = { ...fresh, need_sync: 0 };
+      if (this.order) {
+        await this.order.upsertOrdersFromRemote([syncedOrder]);
+        this.logInfo(`${title}: sync_sales 订单已同步到本地`, {
+          order_id: fresh.order_id,
+          external_sale_number: fresh.external_sale_number,
+          order_number: fresh.order_number
+        });
+      } else {
+        this.logWarning(`${title}: sync_sales Order 模块未注册`, {
+          backendPath,
+          order_id: fresh.order_id
+        });
+      }
+      if (this.shouldPrintSyncedOrder({ checkoutData: data, syncedOrder })) {
+        await this.dispatchPrintOtherReceiptTask({
+          checkoutData: data,
+          syncedOrder,
+          response,
+          deviceId: (_c = ctx.task) == null ? void 0 : _c.device_id
+        });
+      }
+      return this.taskOk({
+        order: syncedOrder,
+        response: this.normalizeCheckoutResponse(response)
+      });
+    } 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 = error instanceof Error ? error.message : String(error);
+      this.logError(`${title}: sync_sales 请求未明确成功`, {
+        backendPath,
+        error: errorMessage
+      });
+      return this.taskTimeout(errorMessage);
+    }
+  }
   /**
    * 将普通层 QuotationModule 的报价单计算能力桥接到 Server Products 模块。
    */
@@ -1242,6 +1459,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",
@@ -1262,6 +1499,11 @@ var Server = class {
         path: "/update/localOrder",
         handler: this.handleUpdateLocalOrder.bind(this)
       },
+      {
+        method: "get",
+        path: "/shop/pay/custom-payment/all",
+        handler: this.handlePaymentMethods.bind(this)
+      },
       {
         method: "post",
         path: "/shop/order/sales/checkout",
@@ -1269,8 +1511,13 @@ var Server = class {
       },
       {
         method: "post",
-        path: "/shop/order/checkout",
+        path: "/order/checkout",
         handler: this.handleOrderCheckout.bind(this)
+      },
+      {
+        method: "post",
+        path: "/local/print-order",
+        handler: this.handleLocalPrintOrder.bind(this)
       }
     ]);
     this.registerPrefixRoutes([
@@ -1286,6 +1533,25 @@ 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;
+  }
   /**
    * 根据 subscriberId 移除商品查询订阅者
    */
@@ -1298,6 +1564,162 @@ var Server = class {
       });
     }
   }
+  /**
+   * 执行 sales 搜索并登记可见订单号。
+   * 搜索参数完全透传后端，OS 不做过滤、筛选、排序。
+   *
+   * @example
+   * const result = await this.handleSalesSearchRequest('single', '/shop/es/search/sales', { keyword: '1001' }, {})
+   */
+  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
+      });
+    }
+    return result;
+  }
+  /**
+   * 透传调用后端 sales 搜索接口。
+   *
+   * @example
+   * const res = await this.fetchSalesSearchFromAPI('/shop/es/search/sales', { keyword: '1001' })
+   */
+  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
+      };
+    }
+  }
+  /**
+   * 构建搜索订阅签名；页码变化不重置，可继续累计 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 日期串。
    *
@@ -1738,8 +2160,203 @@ var Server = class {
       };
     }
   }
-  async handleOrderCheckoutSubmit(params) {
+  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.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 }
+    };
+  }
+  resolveCheckoutTaskDeviceId(_data) {
+    return this.getAppData("device_id") || 0;
+  }
+  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}`;
+  }
+  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;
+    this.registerDeviceTaskActions();
+    const deviceTask = this.getDeviceTaskPlugin();
+    const debugDeviceId = this.resolveCheckoutTaskDeviceId(params.data);
+    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,
+          title: params.title
+        },
+        retry_limit: 5,
+        idempotency_key: debugIdempotencyKey,
+        name: "同步订单",
+        source: "server",
+        source_type: "order",
+        source_id: ((_a = params.data) == null ? void 0 : _a.order_id) || ((_b = params.data) == null ? void 0 : _b.external_sale_number) || ((_c = params.data) == null ? void 0 : _c.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 {
+      const printIdentity = this.getPrintOrderIdentity(params.syncedOrder);
+      await deviceTask.dispatch({
+        action: "print_all",
+        device_id: params.deviceId ?? this.resolveCheckoutTaskDeviceId(params.checkoutData),
+        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}`;
+  }
+  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 };
+    }
+    await this.dispatchPrintOtherReceiptTask({
+      checkoutData: params.checkoutData,
+      syncedOrder: printableOrder,
+      response: params.response,
+      receiptOnly: true
+    });
+    return { printed: true, order: printableOrder };
+  }
+  async handleOrderCheckoutSubmit(params) {
     const { backendPath, data, title } = params;
     this.logInfo(`${title}: 开始处理`, {
       backendPath,
@@ -1747,54 +2364,34 @@ var Server = class {
       external_sale_number: data == null ? void 0 : data.external_sale_number,
       order_number: data == null ? void 0 : data.order_number
     });
-    if (!((_a = this.app) == null ? void 0 : _a.request)) {
-      this.logError(`${title}: app.request 不可用`);
-      return this.handlePendingSyncCheckoutOrder({
-        backendPath,
-        data,
-        title,
-        reason: "app.request 不可用"
-      });
-    }
-    try {
-      const response = await this.app.request.post(backendPath, data, {
-        isShopApi: true,
-        customToast: () => {
-        }
-      });
-      const fresh = this.extractOrderDataFromCheckoutResponse(response);
-      if (fresh && this.order) {
-        const syncedOrder = { ...fresh, need_sync: 0 };
-        await this.order.upsertOrdersFromRemote([syncedOrder]);
-        this.logInfo(`${title}: 订单已同步到本地`, {
-          order_id: fresh.order_id,
-          external_sale_number: fresh.external_sale_number,
-          order_number: fresh.order_number
-        });
-      } else {
-        this.logWarning(`${title}: checkout 返回未包含可同步订单`, {
-          hasOrderModule: !!this.order,
-          backendPath
+    const checkoutData = await this.ensureCheckoutOrderNumbers(data, 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)) {
+        await this.dispatchLocalReceiptPrint({
+          checkoutData,
+          order: pendingOrder,
+          response: pendingResult,
+          requireFullyPaid: true
         });
       }
-      return this.normalizeCheckoutResponse(response);
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      this.logError(`${title}: 请求失败`, { backendPath, error: errorMessage });
-      const backendError = this.extractBackendErrorResponse(error);
-      if (backendError)
-        return backendError;
-      return this.handlePendingSyncCheckoutOrder({
+      await this.dispatchCheckoutSyncTask({
         backendPath,
-        data,
-        title,
-        reason: errorMessage
+        data: checkoutData,
+        title
       });
     }
+    return pendingResult;
   }
   async handlePendingSyncCheckoutOrder(params) {
     const { backendPath, data, title, reason } = params;
-    const pendingOrder = this.buildPendingSyncCheckoutOrder(data);
+    const pendingOrder = await this.buildPendingSyncCheckoutOrder(data);
     if (!pendingOrder) {
       this.logError(`${title}: checkout 失败且订单缺少本地存储标识`, {
         backendPath,
@@ -1821,7 +2418,7 @@ var Server = class {
     }
     try {
       await this.order.upsertPendingSyncOrders([pendingOrder]);
-      this.logWarning(`${title}: 后端未明确报错，订单已写入本地待同步`, {
+      this.logWarning(`${title}: 订单已写入本地待同步`, {
         backendPath,
         reason,
         order_id: pendingOrder.order_id,
@@ -1844,16 +2441,135 @@ var Server = class {
       return { code: 500, status: false, message: errorMessage, data: null };
     }
   }
-  buildPendingSyncCheckoutOrder(data) {
+  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;
-    return {
-      ...data,
-      need_sync: 1
-    };
+    return this.withLocalSmallTicketData(
+      {
+        ...data,
+        need_sync: 1
+      },
+      { requireFullyPaid: true }
+    );
+  }
+  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 productIds = Array.from(
+      new Set(
+        products.map((product) => (product == null ? void 0 : product.product_id) ?? (product == null ? void 0 : product.id)).filter((id) => id !== void 0 && id !== null && id !== "")
+      )
+    );
+    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;
+    }, {});
+  }
+  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 = 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) / 数组两种形态。
@@ -2058,6 +2774,13 @@ var Server = class {
       data: response
     };
   }
+  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;
+  }
   extractBackendErrorResponse(error) {
     var _a, _b;
     const candidates = [
@@ -2469,6 +3192,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 推送
    */