@pisell/pisellos 2.3.28 → 2.3.30

package/lib/server/index.js

@@ -34,6 +34,7 @@ __export(server_exports, {
 });
 module.exports = __toCommonJS(server_exports);
 var import_dayjs = __toESM(require("dayjs"));
+var import_decimal = __toESM(require("decimal.js"));
 var import_products = require("./modules/products");
 var import_menu = require("./modules/menu");
 var import_quotation = require("./modules/quotation");
@@ -50,6 +51,7 @@ 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");
 __reExport(server_exports, require("./modules"), module.exports);
 var PRODUCT_TITLE_SNAPSHOT_KEYS = [
   "en",
@@ -85,6 +87,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 = {
@@ -560,6 +563,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",
@@ -1424,13 +1549,15 @@ var Server = class {
         ...checkoutData,
         ...fresh,
         external_sale_number: fresh.external_sale_number ?? externalSaleNumber,
-        need_sync: 0
+        need_sync: 0,
+        is_draft_order: 0
       } : {
         ...fresh,
         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,
@@ -1448,7 +1575,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,
@@ -1828,6 +1956,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",
@@ -1838,6 +1971,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",
@@ -2528,6 +2671,403 @@ 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.loadSalesDetail({
+        externalSaleNumber: String(params.saleId),
+        preloadedSalesDetail: order
+      });
+      this.logInfo("processSuccessfulLocalPayment: 本地订单 hydrate 完成", 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 };
+    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;
@@ -3048,6 +3588,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;
@@ -3123,7 +3716,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(
@@ -3176,7 +3770,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);
@@ -3743,9 +4337,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) {