@pisell/pisellos 2.3.29 → 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",
@@ -76,8 +78,6 @@ var Server = class {
     };
     // ---- 商品查询订阅者 ----
     this.productQuerySubscribers = /* @__PURE__ */ new Map();
-    /** subscriberId → 智能定价变价时间点定时器句柄（与 subscriber 分离存储，便于 clear） */
-    this.productQueryScheduleTimers = /* @__PURE__ */ new Map();
     // ---- 订单 / 预约列表查询订阅者 ----
     this.orderQuerySubscribers = /* @__PURE__ */ new Map();
     this.bookingQuerySubscribers = /* @__PURE__ */ new Map();
@@ -87,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 = {
@@ -210,7 +211,7 @@ var Server = class {
      */
     this.handleProductQuery = async ({ url, method, data, config }) => {
       console.log("[Server] handleProductQuery:", url, method, data, config);
-      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, extension_type, strategy_context } = data;
+      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, extension_type } = data;
       const { callback, subscriberId } = config || {};
       this.logInfo("handleProductQuery: 开始处理商品查询请求", {
         menu_list_ids,
@@ -218,32 +219,19 @@ var Server = class {
         schedule_datetime,
         schedule_date,
         customer_id,
-        extension_type,
-        strategyContextKeys: strategy_context ? Object.keys(strategy_context) : []
+        extension_type
       });
       if (subscriberId && typeof callback === "function") {
         this.productQuerySubscribers.set(subscriberId, {
           callback,
-          context: { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, strategy_context }
+          context: { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type }
         });
         this.logInfo("handleProductQuery: 已注册订阅者", {
           subscriberId,
           totalSubscribers: this.productQuerySubscribers.size
         });
       }
-      const result = await this.computeProductQueryResult({
-        menu_list_ids,
-        ids,
-        schedule_date,
-        schedule_datetime,
-        customer_id,
-        extension_type,
-        strategy_context
-      });
-      if (subscriberId && typeof callback === "function") {
-        this.syncProductQueryScheduleTimers(subscriberId, strategy_context);
-      }
-      return result;
+      return this.computeProductQueryResult({ menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type });
     };
     /**
      * 按商品 id 查询单条（GET /shop/product/query/:productId）
@@ -575,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",
@@ -1439,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,
@@ -1463,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,
@@ -1843,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",
@@ -1853,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",
@@ -1926,7 +2054,6 @@ var Server = class {
    */
   removeProductQuerySubscriber(subscriberId) {
     if (subscriberId) {
-      this.clearSubscriberScheduleTimers(subscriberId);
       this.productQuerySubscribers.delete(subscriberId);
       this.logInfo("removeProductQuerySubscriber: 已移除订阅者", {
         subscriberId,
@@ -1934,156 +2061,6 @@ var Server = class {
       });
     }
   }
-  /**
-   * 构建商品 query 响应 data 段，附带智能定价 schedule_time_points 元数据。
-   */
-  buildProductQueryResultPayload(list, count) {
-    var _a, _b;
-    return {
-      list,
-      count: count ?? list.length,
-      schedule_time_points: ((_b = (_a = this.products) == null ? void 0 : _a.getLastScheduleTimePoints) == null ? void 0 : _b.call(_a)) ?? []
-    };
-  }
-  /**
-   * 是否启用商品 query 订阅的 schedule 时间点定时重算。
-   * strategy_context.enable_schedule_reload === false 时关闭。
-   */
-  shouldScheduleProductQueryReload(strategy_context) {
-    return (strategy_context == null ? void 0 : strategy_context.enable_schedule_reload) !== false;
-  }
-  /**
-   * 清除指定 subscriber 的全部 schedule 定时器，防止重复 query 或 unsubscribe 后泄漏。
-   */
-  clearSubscriberScheduleTimers(subscriberId) {
-    const timers = this.productQueryScheduleTimers.get(subscriberId);
-    if (timers == null ? void 0 : timers.length) {
-      timers.forEach((timerId) => clearTimeout(timerId));
-    }
-    this.productQueryScheduleTimers.delete(subscriberId);
-    const subscriber = this.productQuerySubscribers.get(subscriberId);
-    if (subscriber) {
-      subscriber.scheduleTimerIds = [];
-    }
-  }
-  /**
-   * 从 productQueryScheduleTimers 移除已触发的 timer 引用。
-   */
-  removeScheduleTimerRef(subscriberId, timerId) {
-    const timers = this.productQueryScheduleTimers.get(subscriberId);
-    if (!(timers == null ? void 0 : timers.length))
-      return;
-    const next = timers.filter((id) => id !== timerId);
-    if (next.length === 0) {
-      this.productQueryScheduleTimers.delete(subscriberId);
-    } else {
-      this.productQueryScheduleTimers.set(subscriberId, next);
-    }
-    const subscriber = this.productQuerySubscribers.get(subscriberId);
-    if (subscriber) {
-      subscriber.scheduleTimerIds = next;
-    }
-  }
-  /**
-   * 计算 schedule 变价时间点到当前时刻的延迟（ms）。已过期返回 -1。
-   */
-  computeScheduleTimePointDelayMs(scheduleDate, timePoint) {
-    const parts = timePoint.split(":");
-    if (parts.length < 2)
-      return -1;
-    const hours = parseInt(parts[0], 10);
-    const minutes = parseInt(parts[1], 10);
-    if (!Number.isFinite(hours) || !Number.isFinite(minutes))
-      return -1;
-    const target = (0, import_dayjs.default)(scheduleDate).hour(hours).minute(minutes).second(4).millisecond(0);
-    const delayMs = target.diff((0, import_dayjs.default)());
-    return delayMs >= 0 ? delayMs : -1;
-  }
-  /**
-   * 定时重算前刷新 subscriber schedule 上下文：使用执行瞬间时间，禁止沿用首次 query 的 schedule_datetime。
-   */
-  refreshSubscriberScheduleAtExecution(subscriber) {
-    const executedAt = (0, import_dayjs.default)();
-    const bookingDate = subscriber.context.schedule_date || executedAt.format("YYYY-MM-DD");
-    subscriber.context.schedule_date = bookingDate;
-    subscriber.context.schedule_datetime = `${bookingDate} ${executedAt.format("HH:mm:ss")}`;
-  }
-  /**
-   * 为 subscriber 注册智能定价 scheduleTimePoints 定时重算。
-   * 必须先 clearSubscriberScheduleTimers，再调用本方法。
-   */
-  scheduleSubscriberTimePointReloads(subscriberId, timePoints) {
-    const subscriber = this.productQuerySubscribers.get(subscriberId);
-    if (!subscriber || !timePoints.length)
-      return;
-    const scheduleDate = subscriber.context.schedule_date || (0, import_dayjs.default)().format("YYYY-MM-DD");
-    const timerIds = [];
-    for (const timePoint of timePoints) {
-      const delayMs = this.computeScheduleTimePointDelayMs(scheduleDate, timePoint);
-      if (delayMs < 0)
-        continue;
-      const timerId = setTimeout(() => {
-        void this.onScheduleTimePointTimerFire(subscriberId, timerId);
-      }, delayMs);
-      timerIds.push(timerId);
-    }
-    if (timerIds.length > 0) {
-      this.productQueryScheduleTimers.set(subscriberId, timerIds);
-      subscriber.scheduleTimerIds = timerIds;
-      this.logInfo("scheduleSubscriberTimePointReloads: 已注册定时器", {
-        subscriberId,
-        timerCount: timerIds.length,
-        timePoints
-      });
-    }
-  }
-  /**
-   * schedule 变价时间点定时器触发：刷新 schedule_datetime 后重算并 callback。
-   */
-  async onScheduleTimePointTimerFire(subscriberId, timerId) {
-    this.removeScheduleTimerRef(subscriberId, timerId);
-    if (!this.productQuerySubscribers.has(subscriberId))
-      return;
-    const subscriber = this.productQuerySubscribers.get(subscriberId);
-    this.refreshSubscriberScheduleAtExecution(subscriber);
-    await this.recomputeAndNotifySubscriber(subscriberId);
-  }
-  /**
-   * 对单个商品 query 订阅者重算并推送（定时路径；不新建 schedule timer）。
-   */
-  async recomputeAndNotifySubscriber(subscriberId) {
-    const subscriber = this.productQuerySubscribers.get(subscriberId);
-    if (!subscriber)
-      return;
-    try {
-      const result = await this.computeProductQueryResult(subscriber.context);
-      subscriber.callback(result);
-      this.logInfo("recomputeAndNotifySubscriber: 已推送", {
-        subscriberId,
-        schedule_datetime: subscriber.context.schedule_datetime
-      });
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      this.logError("recomputeAndNotifySubscriber: 推送失败", {
-        subscriberId,
-        error: errorMessage
-      });
-    }
-  }
-  /**
-   * query 完成后为 subscriber 同步 schedule 定时器（先 clear 再 schedule）。
-   */
-  syncProductQueryScheduleTimers(subscriberId, strategy_context) {
-    var _a, _b;
-    this.clearSubscriberScheduleTimers(subscriberId);
-    if (!this.shouldScheduleProductQueryReload(strategy_context)) {
-      return;
-    }
-    const timePoints = ((_b = (_a = this.products) == null ? void 0 : _a.getLastScheduleTimePoints) == null ? void 0 : _b.call(_a)) ?? [];
-    if (timePoints.length > 0) {
-      this.scheduleSubscriberTimePointReloads(subscriberId, timePoints);
-    }
-  }
   /**
    * 执行 sales 搜索并登记可见订单号。
    * 搜索参数完全透传后端，OS 不做过滤、筛选、排序。
@@ -2694,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;
@@ -3214,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;
@@ -3289,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(
@@ -3342,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);
@@ -3909,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) {
@@ -4277,14 +4707,8 @@ var Server = class {
    */
   async computeProductQueryResult(context, options) {
     const tTotal = performance.now();
-    const { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id, strategy_context } = context;
+    const { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id } = context;
     const queryIds = Array.isArray(ids) ? ids.map((id) => Number(id)).filter((id) => Number.isFinite(id)) : [];
-    const formatterContext = this.buildProductFormatterContext({
-      schedule_date,
-      schedule_datetime,
-      customer_id,
-      strategy_context
-    });
     this.logInfo("computeProductQueryResult 开始", {
       menuListIdsCount: (menu_list_ids == null ? void 0 : menu_list_ids.length) ?? 0,
       ids: queryIds,
@@ -4293,17 +4717,20 @@ var Server = class {
       customer_id,
       extension_type,
       product_id,
-      strategyContextKeys: strategy_context ? Object.keys(strategy_context) : [],
       changedIds: options == null ? void 0 : options.changedIds
     });
     if (!this.products) {
       this.logError("computeProductQueryResult: Products 模块未注册");
-      return { message: "Products 模块未注册", data: this.buildProductQueryResultPayload([], 0) };
+      return { message: "Products 模块未注册", data: { list: [], count: 0 } };
     }
     if (queryIds.length > 0) {
       const uniqueIds = Array.from(new Set(queryIds));
       const tPrice2 = performance.now();
-      const productsWithPrice = await this.products.getProductsWithPrice(schedule_date, formatterContext, {
+      const productsWithPrice = await this.products.getProductsWithPrice(schedule_date, {
+        scheduleModule: this.getSchedule(),
+        schedule_datetime,
+        customer_id
+      }, {
         changedIds: options == null ? void 0 : options.changedIds,
         productIds: uniqueIds
       });
@@ -4324,7 +4751,7 @@ var Server = class {
       });
       return {
         code: 200,
-        data: this.buildProductQueryResultPayload(extensionFilteredProducts),
+        data: { list: extensionFilteredProducts, count: extensionFilteredProducts.length },
         message: "",
         status: true
       };
@@ -4332,7 +4759,9 @@ var Server = class {
     if (product_id != null && Number.isFinite(Number(product_id))) {
       const pid = Number(product_id);
       const tPrice2 = performance.now();
-      const allProductsWithPrice = await this.products.getProductsWithPrice(schedule_date, formatterContext, {
+      const allProductsWithPrice = await this.products.getProductsWithPrice(schedule_date, {
+        scheduleModule: this.getSchedule()
+      }, {
         changedIds: options == null ? void 0 : options.changedIds
       });
       (0, import_product.perfMark)("computeQuery.getProductsWithPrice(single)", performance.now() - tPrice2, {
@@ -4362,7 +4791,11 @@ var Server = class {
     }
     if (this.shouldQueryProductsByExtensionTypes(extension_type)) {
       const tPrice2 = performance.now();
-      let filteredProducts2 = await this.products.getProductsWithPrice(schedule_date, formatterContext, {
+      let filteredProducts2 = await this.products.getProductsWithPrice(schedule_date, {
+        scheduleModule: this.getSchedule(),
+        schedule_datetime,
+        customer_id
+      }, {
         changedIds: options == null ? void 0 : options.changedIds
       });
       (0, import_product.perfMark)("computeQuery.getProductsWithPrice(extensionType)", performance.now() - tPrice2, {
@@ -4402,18 +4835,18 @@ var Server = class {
       });
       return {
         code: 200,
-        data: this.buildProductQueryResultPayload(filteredProducts2),
+        data: { list: filteredProducts2, count: filteredProducts2.length },
         message: "",
         status: true
       };
     }
     if (!this.menu) {
       this.logError("computeProductQueryResult: Menu 模块未注册");
-      return { message: "Menu 模块未注册", data: this.buildProductQueryResultPayload([], 0) };
+      return { message: "Menu 模块未注册", data: { list: [], count: 0 } };
     }
     if (!this.schedule) {
       this.logError("computeProductQueryResult: Schedule 模块未注册");
-      return { message: "Schedule 模块未注册", data: this.buildProductQueryResultPayload([], 0) };
+      return { message: "Schedule 模块未注册", data: { list: [], count: 0 } };
     }
     let activeMenuList = [];
     if (menu_list_ids && Array.isArray(menu_list_ids) && menu_list_ids.length > 0) {
@@ -4437,7 +4870,11 @@ var Server = class {
       isAllProducts: !!productScope.isAllProducts
     });
     const tPrice = performance.now();
-    let filteredProducts = scopedProductIds.length > 0 ? await this.products.getProductsWithPrice(schedule_date, formatterContext, {
+    let filteredProducts = scopedProductIds.length > 0 ? await this.products.getProductsWithPrice(schedule_date, {
+      scheduleModule: this.getSchedule(),
+      schedule_datetime,
+      customer_id
+    }, {
       changedIds: options == null ? void 0 : options.changedIds,
       productIds: productScope.isAllProducts ? void 0 : scopedProductIds
     }) : [];
@@ -4480,29 +4917,11 @@ var Server = class {
     });
     return {
       code: 200,
-      data: this.buildProductQueryResultPayload(filteredProducts),
+      data: { list: filteredProducts, count: filteredProducts.length },
       message: "",
       status: true
     };
   }
-  /**
-   * 构建商品格式化上下文。
-   *
-   * 智能定价条件使用全量 menuList/scheduleList；Product Query 顶层参数只保留筛选商品集合所需字段。
-   */
-  buildProductFormatterContext(context) {
-    var _a, _b, _c, _d;
-    const scheduleModule = this.getSchedule();
-    return {
-      scheduleModule,
-      schedule_datetime: context.schedule_datetime,
-      customer_id: context.customer_id,
-      strategy_context: context.strategy_context,
-      menuList: ((_b = (_a = this.menu) == null ? void 0 : _a.getMenuList) == null ? void 0 : _b.call(_a)) || [],
-      scheduleList: ((_c = scheduleModule == null ? void 0 : scheduleModule.getScheduleList) == null ? void 0 : _c.call(scheduleModule)) || [],
-      dataVariantEvaluator: (_d = this.core.context) == null ? void 0 : _d.dataVariantEvaluator
-    };
-  }
   /**
    * 数据变更后，遍历所有订阅者重新计算查询结果并通过 callback 推送
    * 由 ProductsModule 的 onProductsSyncCompleted 事件触发