@pisell/pisellos 2.2.274 → 2.2.275

package/lib/server/index.js

@@ -34,6 +34,8 @@ __export(server_exports, {
 });
 module.exports = __toCommonJS(server_exports);
 var import_dayjs = __toESM(require("dayjs"));
+var import_decimal = __toESM(require("decimal.js"));
+var import_lodash_es = require("lodash-es");
 var import_products = require("./modules/products");
 var import_menu = require("./modules/menu");
 var import_quotation = require("./modules/quotation");
@@ -50,6 +52,8 @@ 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");
+var import_BaseSales = require("../solution/BaseSales");
+var import_payment_utils = require("../modules/Order/payment-utils");
 __reExport(server_exports, require("./modules"), module.exports);
 var PRODUCT_TITLE_SNAPSHOT_KEYS = [
   "en",
@@ -61,6 +65,7 @@ var PRODUCT_TITLE_SNAPSHOT_KEYS = [
   "kitchen",
   "original"
 ];
+var AUTO_PRINT_STORAGE_KEY = "auto_print";
 var Server = class {
   constructor(core) {
     this.quotationAvailableCache = /* @__PURE__ */ new Map();
@@ -87,6 +92,7 @@ var Server = class {
     this.BOOKING_REMOTE_CACHE_MAX_ENTRIES = 80;
     this.salesSearchSubscribers = /* @__PURE__ */ new Map();
     this.deviceTaskActionsRegistered = false;
+    this.localPaymentUpdateQueues = /* @__PURE__ */ new Map();
     this.floorPlanQuerySubscribers = /* @__PURE__ */ new Map();
     // 模块注册表 - 定义所有可用的模块配置
     this.moduleRegistry = {
@@ -575,6 +581,128 @@ var Server = class {
         title: "handleOrderSalesCheckout"
       });
     };
+    this.handleOrderSalesDraft = async ({ data }) => {
+      return this.handleOrderDraftSubmit({
+        data,
+        title: "handleOrderSalesDraft"
+      });
+    };
+    this.handleGetLocalPayment = async ({ data }) => {
+      const saleId = data == null ? void 0 : data.sale_id;
+      const paymentNumber = data == null ? void 0 : data.payment_number;
+      const operationId = this.createLocalPaymentOperationId("get");
+      const requestContext = {
+        operation_id: operationId,
+        sale_id: saleId ?? null,
+        payment_number: paymentNumber ?? null
+      };
+      this.logInfo("handleGetLocalPayment: 请求进入", requestContext);
+      if (saleId === void 0 || saleId === null || saleId === "" || paymentNumber === void 0 || paymentNumber === null || paymentNumber === "") {
+        this.logWarning("handleGetLocalPayment: 参数校验失败", {
+          ...requestContext,
+          missing_fields: [
+            ...saleId === void 0 || saleId === null || saleId === "" ? ["sale_id"] : [],
+            ...paymentNumber === void 0 || paymentNumber === null || paymentNumber === "" ? ["payment_number"] : []
+          ]
+        });
+        return {
+          code: 400,
+          status: false,
+          message: "sale_id 和 payment_number 必填",
+          data: null
+        };
+      }
+      if (!this.order) {
+        this.logError("handleGetLocalPayment: Order 模块未注册", requestContext);
+        return { code: 500, status: false, message: "Order 模块未注册", data: null };
+      }
+      const startedAt = Date.now();
+      try {
+        this.logInfo("handleGetLocalPayment: 开始查询本地支付项", requestContext);
+        const found = await this.order.getLocalPayment({
+          saleId,
+          paymentNumber,
+          operationId
+        });
+        if (!found) {
+          this.logWarning("handleGetLocalPayment: 本地支付项不存在", {
+            ...requestContext,
+            duration_ms: Date.now() - startedAt
+          });
+          return { code: 404, status: false, message: "本地支付项不存在", data: null };
+        }
+        this.logInfo("handleGetLocalPayment: 查询命中", {
+          ...requestContext,
+          duration_ms: Date.now() - startedAt,
+          matched_by: found.matchedBy,
+          payment_index: found.paymentIndex,
+          ...this.buildLocalPaymentOrderLogContext(found.order),
+          payment: found.payment
+        });
+        return { code: 200, status: true, message: "", data: found.payment };
+      } catch (error) {
+        this.logError("handleGetLocalPayment: 查询异常", {
+          ...requestContext,
+          duration_ms: Date.now() - startedAt,
+          error: error instanceof Error ? error.message : String(error),
+          error_detail: this.normalizeUnknownError(error)
+        });
+        throw error;
+      }
+    };
+    this.handleUpdateLocalPayment = async ({ data }) => {
+      const saleId = data == null ? void 0 : data.sale_id;
+      const paymentNumber = data == null ? void 0 : data.payment_number;
+      const number = data == null ? void 0 : data.number;
+      const status = data == null ? void 0 : data.status;
+      const serviceCharge = data == null ? void 0 : data.service_charge;
+      const cardReaderSurcharge = data == null ? void 0 : data.card_reader_surcharge;
+      const hasSurchargeInput = serviceCharge !== void 0 || cardReaderSurcharge !== void 0;
+      const invalidSurchargeFields = this.getInvalidLocalPaymentSurchargeFields(
+        serviceCharge,
+        cardReaderSurcharge
+      );
+      const operationId = this.createLocalPaymentOperationId("update");
+      const requestContext = {
+        operation_id: operationId,
+        sale_id: saleId ?? null,
+        payment_number: paymentNumber ?? null,
+        transaction_number: number ?? null,
+        requested_status: status ?? null,
+        service_charge: serviceCharge ?? null,
+        card_reader_surcharge: cardReaderSurcharge ?? null
+      };
+      this.logInfo("handleUpdateLocalPayment: 请求进入", requestContext);
+      if (saleId === void 0 || saleId === null || saleId === "" || paymentNumber === void 0 || paymentNumber === null || paymentNumber === "" || number === void 0 || number === null || number === "" || status !== "success" && status !== "fail" || invalidSurchargeFields.length > 0) {
+        this.logWarning("handleUpdateLocalPayment: 参数校验失败", {
+          ...requestContext,
+          missing_or_invalid_fields: [
+            ...saleId === void 0 || saleId === null || saleId === "" ? ["sale_id"] : [],
+            ...paymentNumber === void 0 || paymentNumber === null || paymentNumber === "" ? ["payment_number"] : [],
+            ...number === void 0 || number === null || number === "" ? ["number"] : [],
+            ...status !== "success" && status !== "fail" ? ["status"] : [],
+            ...invalidSurchargeFields
+          ]
+        });
+        return {
+          code: 400,
+          status: false,
+          message: invalidSurchargeFields.length > 0 ? `手续费参数非法: ${invalidSurchargeFields.join(", ")}` : "sale_id、payment_number、number 必填，status 仅支持 success/fail",
+          data: null
+        };
+      }
+      const queueKey = `${String(saleId)}:${String(paymentNumber)}`;
+      return this.runLocalPaymentUpdateInQueue(queueKey, () => this.processLocalPaymentUpdate({
+        operationId,
+        saleId,
+        paymentNumber,
+        number: String(number),
+        status,
+        serviceCharge,
+        cardReaderSurcharge,
+        hasSurchargeInput
+      }), requestContext);
+    };
     this.handleOrderCheckout = async ({ data }) => {
       return this.handleOrderCheckoutSubmit({
         backendPath: "/order/checkout",
@@ -1356,7 +1484,7 @@ var Server = class {
     const { backendPath, title } = params;
     const normalizedData = await this.normalizeCheckoutSubmitData(params.data, title);
     const checkoutData = await this.ensureCheckoutOrderNumbers(normalizedData, title);
-    const remoteCheckoutData = this.omitCheckoutSyncMode(checkoutData);
+    const remoteCheckoutData = this.buildRemoteCheckoutData(checkoutData, title);
     if (!((_b = (_a = this.app) == null ? void 0 : _a.request) == null ? void 0 : _b.post)) {
       throw new Error("app.request 不可用");
     }
@@ -1372,20 +1500,20 @@ var Server = class {
         errorResponse: response,
         response,
         normalizedResponse: this.normalizeCheckoutResponse(response),
-        checkoutData: remoteCheckoutData
+        checkoutData
       };
     }
     const fresh = this.extractOrderDataFromCheckoutResponse(response);
     const externalSaleNumber = this.getCheckoutExternalSaleNumber(
-      remoteCheckoutData,
+      checkoutData,
       {
         external_sale_number: params.externalSaleNumber,
-        data: remoteCheckoutData
+        data: checkoutData
       }
     );
     const syncedOrder = await this.persistSyncedCheckoutOrder({
       backendPath,
-      checkoutData: remoteCheckoutData,
+      checkoutData,
       externalSaleNumber,
       fresh,
       title,
@@ -1396,11 +1524,11 @@ var Server = class {
       checkoutResponseOrder: fresh
     }) : void 0;
     if (printableSyncedOrder && this.shouldPrintSyncedOrder({
-      checkoutData: remoteCheckoutData,
+      checkoutData,
       syncedOrder: printableSyncedOrder
     })) {
       await this.dispatchPrintOtherReceiptTask({
-        checkoutData: remoteCheckoutData,
+        checkoutData,
         syncedOrder: printableSyncedOrder,
         response,
         deviceId: params.deviceId
@@ -1410,7 +1538,7 @@ var Server = class {
       rejected: false,
       response,
       normalizedResponse: this.normalizeCheckoutResponse(response),
-      checkoutData: remoteCheckoutData,
+      checkoutData,
       syncedOrder,
       fresh
     };
@@ -1423,6 +1551,54 @@ var Server = class {
     delete next.syncMode;
     return next;
   }
+  buildRemoteCheckoutData(data, title) {
+    const next = (0, import_lodash_es.cloneDeep)(this.omitCheckoutSyncMode(data));
+    if (!next || typeof next !== "object")
+      return next;
+    const record = next;
+    if (!Array.isArray(record.payments))
+      return next;
+    const originalPayments = record.payments;
+    const filteredPayments = originalPayments.filter((payment) => !(0, import_payment_utils.isPendingOrderPayment)(payment));
+    const removedPayments = originalPayments.filter((payment) => (0, import_payment_utils.isPendingOrderPayment)(payment));
+    record.payments = filteredPayments;
+    this.logInfo(`${title}: checkout 云端支付项已过滤`, {
+      external_sale_number: record.external_sale_number,
+      original_payment_count: originalPayments.length,
+      remote_payment_count: filteredPayments.length,
+      filtered_pending_count: removedPayments.length,
+      filtered_payment_identities: removedPayments.map((payment) => (0, import_payment_utils.getOrderPaymentIdentityKeys)(payment))
+    });
+    return next;
+  }
+  mergeCheckoutSyncPayments(checkoutData, fresh, title) {
+    const localPayments = Array.isArray(checkoutData == null ? void 0 : checkoutData.payments) ? checkoutData.payments : [];
+    const freshRecord = fresh;
+    if (!Array.isArray(freshRecord.payments)) {
+      return localPayments.length > 0 ? { ...freshRecord, payments: (0, import_lodash_es.cloneDeep)(localPayments) } : freshRecord;
+    }
+    const freshPayments = freshRecord.payments;
+    const mergedPayments = (0, import_payment_utils.mergeOrderPaymentListsByIdentity)(
+      localPayments,
+      freshPayments,
+      { preserveUnmatchedExistingWhen: import_payment_utils.isIdentifiedPendingOrderPayment }
+    );
+    const remoteIdentityKeys = new Set(
+      freshPayments.flatMap((payment) => (0, import_payment_utils.getOrderPaymentIdentityKeys)(payment))
+    );
+    const preservedPending = localPayments.filter((payment) => (0, import_payment_utils.isIdentifiedPendingOrderPayment)(payment) && !(0, import_payment_utils.getOrderPaymentIdentityKeys)(payment).some((key) => remoteIdentityKeys.has(key)));
+    if (preservedPending.length > 0) {
+      this.logInfo(`${title}: checkout 响应合并保留本地 pending 支付项`, {
+        external_sale_number: checkoutData == null ? void 0 : checkoutData.external_sale_number,
+        preserved_pending_count: preservedPending.length,
+        preserved_payment_identities: preservedPending.map((payment) => (0, import_payment_utils.getOrderPaymentIdentityKeys)(payment))
+      });
+    }
+    return {
+      ...freshRecord,
+      payments: mergedPayments
+    };
+  }
   async persistSyncedCheckoutOrder(params) {
     const {
       backendPath,
@@ -1437,15 +1613,17 @@ var Server = class {
     if (this.order && fresh && (shouldMergeRemoteOrder || persistCheckoutDataWithResponse)) {
       syncedOrder = persistCheckoutDataWithResponse ? {
         ...checkoutData,
-        ...fresh,
+        ...this.mergeCheckoutSyncPayments(checkoutData, fresh, title),
         external_sale_number: fresh.external_sale_number ?? externalSaleNumber,
-        need_sync: 0
+        need_sync: 0,
+        is_draft_order: 0
       } : {
-        ...fresh,
+        ...this.mergeCheckoutSyncPayments(checkoutData, fresh, title),
         external_sale_number: fresh.external_sale_number ?? externalSaleNumber,
-        need_sync: 0
+        need_sync: 0,
+        is_draft_order: 0
       };
-      await this.order.upsertOrdersFromRemote([syncedOrder]);
+      await this.order.upsertOrdersFromRemote([syncedOrder], "checkoutSync");
       this.logInfo(`${title}: sync_sales 完整订单已同步到本地`, {
         order_id: fresh.order_id,
         external_sale_number: syncedOrder.external_sale_number,
@@ -1463,7 +1641,8 @@ var Server = class {
         ...checkoutData,
         ...patch,
         external_sale_number: externalSaleNumber,
-        need_sync: 0
+        need_sync: 0,
+        is_draft_order: 0
       };
       this.logInfo(`${title}: sync_sales 已按 external_sale_number 标记本地订单`, {
         order_id: (syncedOrder == null ? void 0 : syncedOrder.order_id) ?? null,
@@ -1843,6 +2022,11 @@ var Server = class {
         path: "/shop/order/sales/checkout",
         handler: this.handleOrderSalesCheckout.bind(this)
       },
+      {
+        method: "post",
+        path: "/shop/order/sales/draft",
+        handler: this.handleOrderSalesDraft.bind(this)
+      },
       {
         method: "post",
         path: "/order/checkout",
@@ -1853,6 +2037,16 @@ var Server = class {
         path: "/shop/local/print-order",
         handler: this.handleLocalPrintOrder.bind(this)
       },
+      {
+        method: "post",
+        path: "/shop/local/getLocalPayment",
+        handler: this.handleGetLocalPayment.bind(this)
+      },
+      {
+        method: "post",
+        path: "/shop/local/updateLocalPayment",
+        handler: this.handleUpdateLocalPayment.bind(this)
+      },
       {
         method: "post",
         path: "/shop/machinecode/batch",
@@ -2694,6 +2888,405 @@ var Server = class {
       };
     }
   }
+  createLocalPaymentOperationId(action) {
+    return `local_payment_${action}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+  }
+  buildLocalPaymentOrderLogContext(order) {
+    if (!order)
+      return {};
+    return {
+      order_id: order.order_id ?? null,
+      external_sale_number: order.external_sale_number ?? null,
+      order_number: order.order_number ?? null,
+      shop_order_number: order.shop_order_number ?? null,
+      shop_full_order_number: order.shop_full_order_number ?? null,
+      order_status: order.status ?? null,
+      payment_status: order.payment_status ?? null,
+      is_draft_order: Number(order.is_draft_order || 0),
+      need_sync: Number(order.need_sync || 0),
+      platform: order.platform ?? null,
+      business_code: order.business_code ?? null,
+      order_sales_channel: order.order_sales_channel ?? null,
+      sales_channel: order.sales_channel ?? null,
+      order_type: order.type ?? null,
+      payments_count: Array.isArray(order.payments) ? order.payments.length : 0
+    };
+  }
+  isValidLocalPaymentDecimal(value) {
+    if (typeof value !== "string" && typeof value !== "number")
+      return false;
+    if (typeof value === "string" && value.trim() === "")
+      return false;
+    try {
+      return new import_decimal.default(value).isFinite();
+    } catch {
+      return false;
+    }
+  }
+  getInvalidLocalPaymentSurchargeFields(serviceCharge, cardReaderSurcharge) {
+    const invalidFields = [];
+    if (serviceCharge !== void 0) {
+      if (serviceCharge === null || typeof serviceCharge !== "object" || Array.isArray(serviceCharge)) {
+        invalidFields.push("service_charge");
+      } else {
+        const input = serviceCharge;
+        if (input.fixed !== void 0 && !this.isValidLocalPaymentDecimal(input.fixed)) {
+          invalidFields.push("service_charge.fixed");
+        }
+        if (input.percentage !== void 0 && !this.isValidLocalPaymentDecimal(input.percentage)) {
+          invalidFields.push("service_charge.percentage");
+        }
+      }
+    }
+    if (cardReaderSurcharge !== void 0 && !this.isValidLocalPaymentDecimal(cardReaderSurcharge)) {
+      invalidFields.push("card_reader_surcharge");
+    }
+    return invalidFields;
+  }
+  buildLocalPaymentSurchargeUpdate(params) {
+    var _a, _b, _c;
+    const amount = new import_decimal.default(((_a = params.serviceCharge) == null ? void 0 : _a.fixed) || 0).plus(params.cardReaderSurcharge || 0).toFixed(2);
+    const serviceFee = new import_decimal.default(params.paymentAmount || 0).times(((_b = params.serviceCharge) == null ? void 0 : _b.percentage) || 0).plus(amount).toDecimalPlaces(2).toFixed(2);
+    return {
+      service_charge: {
+        amount,
+        ...((_c = params.serviceCharge) == null ? void 0 : _c.percentage) !== void 0 ? { percentage: params.serviceCharge.percentage } : {}
+      },
+      service_fee: serviceFee
+    };
+  }
+  async runLocalPaymentUpdateInQueue(key, task, context) {
+    var _a;
+    const queuedAt = Date.now();
+    const hasPreviousTask = this.localPaymentUpdateQueues.has(key);
+    const previous = this.localPaymentUpdateQueues.get(key) || Promise.resolve();
+    this.logInfo("handleUpdateLocalPayment: 串行队列入队", {
+      ...context,
+      queue_key: key,
+      waiting_for_previous: hasPreviousTask,
+      active_queue_count: this.localPaymentUpdateQueues.size
+    });
+    const current = previous.catch(() => void 0).then(async () => {
+      this.logInfo("handleUpdateLocalPayment: 串行队列开始执行", {
+        ...context,
+        queue_key: key,
+        queue_wait_ms: Date.now() - queuedAt
+      });
+      return task();
+    });
+    const tail = current.then(() => void 0, () => void 0);
+    this.localPaymentUpdateQueues.set(key, tail);
+    try {
+      const result = await current;
+      this.logInfo("handleUpdateLocalPayment: 串行队列执行完成", {
+        ...context,
+        queue_key: key,
+        total_duration_ms: Date.now() - queuedAt,
+        result_code: result == null ? void 0 : result.code,
+        result_status: result == null ? void 0 : result.status,
+        payment: (_a = result == null ? void 0 : result.data) == null ? void 0 : _a.payment
+      });
+      return result;
+    } catch (error) {
+      this.logError("handleUpdateLocalPayment: 串行队列执行失败", {
+        ...context,
+        queue_key: key,
+        total_duration_ms: Date.now() - queuedAt,
+        error: error instanceof Error ? error.message : String(error),
+        error_detail: this.normalizeUnknownError(error)
+      });
+      throw error;
+    } finally {
+      let released = false;
+      if (this.localPaymentUpdateQueues.get(key) === tail) {
+        this.localPaymentUpdateQueues.delete(key);
+        released = true;
+      }
+      this.logInfo("handleUpdateLocalPayment: 串行队列释放", {
+        ...context,
+        queue_key: key,
+        released,
+        active_queue_count: this.localPaymentUpdateQueues.size
+      });
+    }
+  }
+  async processLocalPaymentUpdate(params) {
+    var _a, _b, _c;
+    const requestContext = {
+      operation_id: params.operationId,
+      sale_id: params.saleId,
+      payment_number: params.paymentNumber,
+      transaction_number: params.number,
+      requested_status: params.status,
+      service_charge: params.serviceCharge ?? null,
+      card_reader_surcharge: params.cardReaderSurcharge ?? null
+    };
+    this.logInfo("processLocalPaymentUpdate: 开始处理", requestContext);
+    if (!this.order) {
+      this.logError("processLocalPaymentUpdate: Order 模块未注册", requestContext);
+      return { code: 500, status: false, message: "Order 模块未注册", data: null };
+    }
+    this.logInfo("processLocalPaymentUpdate: 开始查询本地支付项", requestContext);
+    const found = await this.order.getLocalPayment({
+      saleId: params.saleId,
+      paymentNumber: params.paymentNumber,
+      operationId: params.operationId
+    });
+    if (!found) {
+      this.logWarning("processLocalPaymentUpdate: 本地支付项不存在", requestContext);
+      return { code: 404, status: false, message: "本地支付项不存在", data: null };
+    }
+    const surchargeUpdate = params.status === "success" && params.hasSurchargeInput ? this.buildLocalPaymentSurchargeUpdate({
+      paymentAmount: (_a = found.payment) == null ? void 0 : _a.amount,
+      serviceCharge: params.serviceCharge,
+      cardReaderSurcharge: params.cardReaderSurcharge
+    }) : void 0;
+    const incomingPaymentUpdate = params.status === "success" ? {
+      status: "paid",
+      ...surchargeUpdate || {},
+      metadata: {
+        unique_payment_number: params.number,
+        transactions: [{ number: params.number, status: "success" }]
+      }
+    } : {
+      metadata: {
+        transactions: [{ number: params.number, status: "fail" }]
+      }
+    };
+    const transactions = Array.isArray((_c = (_b = found.payment) == null ? void 0 : _b.metadata) == null ? void 0 : _c.transactions) ? found.payment.metadata.transactions : [];
+    const existingTransaction = transactions.find((item) => String((item == null ? void 0 : item.number) || "") === params.number);
+    const hasRecordedSuccess = transactions.some((item) => (item == null ? void 0 : item.status) === "success");
+    const orderIsDraft = Number(found.order.is_draft_order || 0) === 1;
+    const foundContext = {
+      ...requestContext,
+      matched_by: found.matchedBy,
+      payment_index: found.paymentIndex,
+      ...this.buildLocalPaymentOrderLogContext(found.order),
+      payment: found.payment,
+      incoming_payment_update: incomingPaymentUpdate,
+      existing_transaction: existingTransaction || null,
+      has_recorded_success: hasRecordedSuccess
+    };
+    this.logInfo("processLocalPaymentUpdate: 查询命中", foundContext);
+    if (params.status === "fail" && (found.payment.status === "paid" || hasRecordedSuccess)) {
+      this.logInfo("processLocalPaymentUpdate: 幂等返回", {
+        ...foundContext,
+        idempotent_reason: "ignore_failure_after_success"
+      });
+      return {
+        code: 200,
+        status: true,
+        message: "",
+        data: { payment: found.payment, order: found.order, idempotent: true }
+      };
+    }
+    const alreadyRecordedFailure = params.status === "fail" && (existingTransaction == null ? void 0 : existingTransaction.status) === "fail";
+    if (alreadyRecordedFailure) {
+      this.logInfo("processLocalPaymentUpdate: 幂等返回", {
+        ...foundContext,
+        idempotent_reason: "failure_already_recorded"
+      });
+      return {
+        code: 200,
+        status: true,
+        message: "",
+        data: { payment: found.payment, order: found.order, idempotent: true }
+      };
+    }
+    if (params.status === "success" && (existingTransaction == null ? void 0 : existingTransaction.status) === "success" && found.payment.status === "paid" && !orderIsDraft) {
+      this.logInfo("processLocalPaymentUpdate: 幂等返回", {
+        ...foundContext,
+        idempotent_reason: "success_already_committed"
+      });
+      return {
+        code: 200,
+        status: true,
+        message: "",
+        data: { payment: found.payment, order: found.order, idempotent: true }
+      };
+    }
+    if (params.status === "success") {
+      this.logInfo("processLocalPaymentUpdate: 进入 success 恢复分支", {
+        ...foundContext,
+        force_submit_if_paid: found.payment.status === "paid" && orderIsDraft
+      });
+      return this.processSuccessfulLocalPayment({
+        ...params,
+        order: found.order,
+        payment: found.payment,
+        matchBy: found.matchedBy === "payment_number" ? "payment_number" : "compat",
+        forceSubmitIfPaid: found.payment.status === "paid" && orderIsDraft,
+        paymentUpdate: incomingPaymentUpdate
+      });
+    }
+    this.logInfo("processLocalPaymentUpdate: 进入 fail 本地更新分支", {
+      ...foundContext,
+      incoming_payment_update: incomingPaymentUpdate
+    });
+    let updated;
+    try {
+      updated = await this.order.updateLocalPayment({
+        saleId: params.saleId,
+        paymentNumber: params.paymentNumber,
+        operationId: params.operationId,
+        updates: incomingPaymentUpdate
+      });
+    } catch (error) {
+      this.logError("processLocalPaymentUpdate: fail 本地更新失败", {
+        ...foundContext,
+        incoming_payment_update: incomingPaymentUpdate,
+        error: error instanceof Error ? error.message : String(error),
+        error_detail: this.normalizeUnknownError(error)
+      });
+      throw error;
+    }
+    if (!updated) {
+      this.logWarning("processLocalPaymentUpdate: fail 本地更新未命中", foundContext);
+      return { code: 404, status: false, message: "本地支付项不存在", data: null };
+    }
+    this.logInfo("processLocalPaymentUpdate: fail 本地更新完成", {
+      ...requestContext,
+      ...this.buildLocalPaymentOrderLogContext(updated.order),
+      previous_payment: updated.previousPayment,
+      payment: updated.payment
+    });
+    return {
+      code: 200,
+      status: true,
+      message: "",
+      data: {
+        local_only: true,
+        payment: updated.payment,
+        order: updated.order
+      }
+    };
+  }
+  async processSuccessfulLocalPayment(params) {
+    var _a, _b, _c, _d, _e;
+    const moduleName = `local_payment_recovery_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    const baseSales = new import_BaseSales.BaseSalesImpl(moduleName);
+    const startedAt = Date.now();
+    const recoveryContext = {
+      operation_id: params.operationId,
+      sale_id: params.saleId,
+      payment_number: params.paymentNumber,
+      transaction_number: params.number,
+      requested_status: "success",
+      match_by: params.matchBy,
+      force_submit_if_paid: params.forceSubmitIfPaid,
+      incoming_payment_update: params.paymentUpdate,
+      base_sales_module_name: moduleName,
+      ...this.buildLocalPaymentOrderLogContext(params.order),
+      payment: params.payment
+    };
+    this.logInfo("processSuccessfulLocalPayment: 创建临时 BaseSales", recoveryContext);
+    try {
+      const order = this.sanitizeLocalRecoveryOrder(params.order);
+      this.logInfo("processSuccessfulLocalPayment: 本地订单清洗完成", {
+        ...recoveryContext,
+        sanitized_order_id: order.order_id ?? null,
+        removed_synthetic_order_id: params.order.order_id != null && order.order_id == null
+      });
+      await baseSales.initialize(this.core, {
+        otherParams: {
+          platform: order.platform,
+          businessCode: order.business_code,
+          business_code: order.business_code,
+          channel: order.order_sales_channel || order.sales_channel,
+          type: order.type,
+          enableTempOrderPersist: false
+        }
+      });
+      this.logInfo("processSuccessfulLocalPayment: BaseSales 初始化完成", recoveryContext);
+      await baseSales.replaceTempOrder(order);
+      this.logInfo("processSuccessfulLocalPayment: 本地订单 tempOrder 恢复完成", recoveryContext);
+      this.logInfo("processSuccessfulLocalPayment: 开始更新支付项并提交", {
+        ...recoveryContext,
+        incoming_payment_update: params.paymentUpdate
+      });
+      const result = await baseSales.updateOrderPayment(
+        params.paymentNumber,
+        params.paymentUpdate,
+        {
+          submitWhenPaid: true,
+          matchBy: params.matchBy,
+          forceSubmitIfPaid: params.forceSubmitIfPaid,
+          applyUpdatesWhenPaid: params.forceSubmitIfPaid,
+          smallTicketDataFlag: 1
+        }
+      );
+      this.logInfo("processSuccessfulLocalPayment: 支付恢复完成", {
+        ...recoveryContext,
+        duration_ms: Date.now() - startedAt,
+        payment: result.payment,
+        payments_count: ((_a = result.payments) == null ? void 0 : _a.length) || 0,
+        summary: result.summary,
+        sync_result: result.syncResult ? {
+          is_fully_paid: result.syncResult.isFullyPaid,
+          is_order_fully_paid: result.syncResult.isOrderFullyPaid,
+          is_deposit_fully_paid: result.syncResult.isDepositFullyPaid,
+          payment_stage: result.syncResult.paymentStage,
+          deposit_amount: result.syncResult.depositAmount,
+          order_expected_amount: result.syncResult.orderExpectedAmount,
+          submit_result_code: (_b = result.syncResult.submitResult) == null ? void 0 : _b.code,
+          submit_result_status: (_c = result.syncResult.submitResult) == null ? void 0 : _c.status
+        } : null,
+        draft_result: result.draftResult ? {
+          code: (_d = result.draftResult) == null ? void 0 : _d.code,
+          status: (_e = result.draftResult) == null ? void 0 : _e.status
+        } : null,
+        draft_error: result.draftError instanceof Error ? result.draftError.message : result.draftError
+      });
+      return {
+        code: 200,
+        status: true,
+        message: "",
+        data: {
+          payment: result.payment,
+          payments: result.payments,
+          summary: result.summary,
+          sync_result: result.syncResult
+        }
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      this.logError("processSuccessfulLocalPayment: 支付恢复失败", {
+        ...recoveryContext,
+        duration_ms: Date.now() - startedAt,
+        error: message,
+        error_detail: this.normalizeUnknownError(error)
+      });
+      return { code: 500, status: false, message, data: null };
+    } finally {
+      try {
+        await baseSales.destroy();
+        this.logInfo("processSuccessfulLocalPayment: 临时 BaseSales 销毁完成", {
+          ...recoveryContext,
+          duration_ms: Date.now() - startedAt
+        });
+      } catch (error) {
+        this.logError("processSuccessfulLocalPayment: 临时 BaseSales 销毁失败", {
+          ...recoveryContext,
+          duration_ms: Date.now() - startedAt,
+          error: error instanceof Error ? error.message : String(error),
+          error_detail: this.normalizeUnknownError(error)
+        });
+      }
+    }
+  }
+  sanitizeLocalRecoveryOrder(order) {
+    const next = {
+      ...order,
+      country_calling_code: String(order.country_calling_code ?? ""),
+      phone: String(order.phone ?? ""),
+      email: String(order.email ?? "")
+    };
+    const externalSaleNumber = next.external_sale_number;
+    if (Number(next.is_draft_order || 0) === 1 && next.order_id !== void 0 && externalSaleNumber !== void 0 && String(next.order_id) === String(externalSaleNumber)) {
+      delete next.order_id;
+    }
+    return next;
+  }
   getDeviceTaskPlugin() {
     var _a, _b;
     return ((_b = (_a = this.app) == null ? void 0 : _a.getPlugin) == null ? void 0 : _b.call(_a, "deviceTask")) || null;
@@ -3106,7 +3699,6 @@ var Server = class {
     });
   }
   async handleOrderCheckoutSubmit(params) {
-    var _a;
     const { backendPath, data, title } = params;
     this.logInfo(`${title}: 开始处理`, {
       backendPath,
@@ -3131,15 +3723,14 @@ var Server = class {
     });
     if ((pendingResult == null ? void 0 : pendingResult.status) === true) {
       const pendingOrder = pendingResult.data;
-      const platform = (_a = this.core.context) == null ? void 0 : _a.getPlatform();
-      const isAndroid = platform === "android";
-      if (pendingOrder && this.shouldBuildSmallTicketData(checkoutData) && this.isSalesOrderFullyPaid(pendingOrder) && // TODO 这里先加个兼容，如果是安卓，则需要 type=virtual 才走打印，如果是苹果则无限制
-      (isAndroid ? checkoutData.type === "virtual" : true)) {
+      if (pendingOrder && this.shouldBuildSmallTicketData(checkoutData) && this.isSalesOrderFullyPaid(pendingOrder) && this.shouldAutoPrintCheckoutReceipt()) {
         await this.dispatchLocalReceiptPrint({
           checkoutData,
           order: pendingOrder,
           response: pendingResult,
-          requireFullyPaid: true
+          requireFullyPaid: true,
+          // 自动小票固定使用 print_all 的收据类型 0，不随订单 type 改成券/手环类型 99。
+          isManualPrint: true
         });
       }
       await this.dispatchCheckoutSyncTask({
@@ -3216,6 +3807,59 @@ var Server = class {
       };
     }
   }
+  async handleOrderDraftSubmit(params) {
+    var _a, _b, _c;
+    const { data, title } = params;
+    this.logInfo(`${title}: 开始处理`, {
+      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
+    });
+    const normalizedData = await this.normalizeCheckoutSubmitData(data, title);
+    const createdAt = normalizedData.created_at || normalizedData.create_date || (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
+    const draftOrder = {
+      ...normalizedData,
+      external_sale_number: normalizedData.external_sale_number || `LOCAL_DRAFT_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`,
+      created_at: createdAt,
+      schedule_date: normalizedData.schedule_date || createdAt,
+      need_sync: 0,
+      is_draft_order: 1
+    };
+    if (!this.order || typeof this.order.upsertLocalDraftOrders !== "function") {
+      this.logError(`${title}: Order 模块不支持本地草稿写入`);
+      return {
+        code: 500,
+        status: false,
+        message: "Order 模块不支持本地草稿写入",
+        data: null
+      };
+    }
+    try {
+      await this.order.upsertLocalDraftOrders([draftOrder]);
+      this.logInfo(`${title}: 草稿订单已写入本地`, {
+        order_id: draftOrder.order_id,
+        external_sale_number: draftOrder.external_sale_number
+      });
+      return {
+        code: 200,
+        status: true,
+        message: "",
+        data: {
+          ...draftOrder,
+          amount_gap: (_a = draftOrder == null ? void 0 : draftOrder.summary) == null ? void 0 : _a.amount_gap,
+          expect_amount: (_b = draftOrder == null ? void 0 : draftOrder.summary) == null ? void 0 : _b.expect_amount,
+          total_amount: (_c = draftOrder == null ? void 0 : draftOrder.summary) == null ? void 0 : _c.total_amount,
+          payment_status: draftOrder == null ? void 0 : draftOrder.payment_status
+        }
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logError(`${title}: 写入本地草稿订单失败`, {
+        error: errorMessage
+      });
+      return { code: 500, status: false, message: errorMessage, data: null };
+    }
+  }
   async handlePendingSyncCheckoutOrder(params) {
     var _a, _b, _c, _d;
     const { backendPath, data, title, reason } = params;
@@ -3291,7 +3935,8 @@ var Server = class {
       return null;
     const pendingOrder = {
       ...data,
-      need_sync: 1
+      need_sync: 1,
+      is_draft_order: 0
     };
     const productMap = await this.buildSmallTicketProductMap(pendingOrder);
     const orderWithProductTitles = this.withPendingSyncProductTitles(
@@ -3303,6 +3948,15 @@ var Server = class {
       { requireFullyPaid: true, productMap }
     );
   }
+  /**
+   * Android 结账自动小票由当前设备设置控制；其它平台保持原有行为。
+   */
+  shouldAutoPrintCheckoutReceipt() {
+    var _a, _b, _c, _d, _e;
+    if (((_b = (_a = this.core.context) == null ? void 0 : _a.getPlatform) == null ? void 0 : _b.call(_a)) !== "android")
+      return true;
+    return ((_e = (_d = (_c = this.app) == null ? void 0 : _c.storage) == null ? void 0 : _d.getStorage) == null ? void 0 : _e.call(_d, AUTO_PRINT_STORAGE_KEY)) === "true";
+  }
   shouldBuildSmallTicketData(order) {
     if (!order || typeof order !== "object")
       return false;
@@ -3344,7 +3998,7 @@ var Server = class {
       return 0;
     return payments.reduce((sum, payment) => {
       const status = String((payment == null ? void 0 : payment.status) || "").toLowerCase();
-      if (status === "voided" || status === "failed" || status === "cancelled")
+      if (status !== "paid")
         return sum;
       return sum + this.toAmountNumber((payment == null ? void 0 : payment.amount) ?? (payment == null ? void 0 : payment.origin_amount));
     }, 0);
@@ -3911,9 +4565,11 @@ var Server = class {
     return value === void 0 ? void 0 : String(value);
   }
   buildCheckoutSyncSuccessPatch(fresh) {
+    const patch = {
+      is_draft_order: 0
+    };
     if (!fresh)
-      return {};
-    const patch = {};
+      return 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) {
@@ -4194,6 +4850,10 @@ var Server = class {
     const rawList = this.order.getOrders();
     this.logInfo("computeOrderQueryResult: 本地订单数量", { rawCount: rawList.length });
     const result = (0, import_filterOrders.filterOrders)(rawList, data);
+    result.list.forEach((order) => {
+      var _a;
+      order.payments = (_a = order.payments) == null ? void 0 : _a.filter((payment) => !(0, import_payment_utils.isPendingOrderPayment)(payment));
+    });
     this.logInfo("computeOrderQueryResult: 过滤结果", {
       rawCount: rawList.length,
       filteredCount: result.count,