@pisell/pisellos 0.0.568 → 0.0.570

package/lib/solution/BookingTicket/index.js

@@ -8,7 +8,7 @@ var _exportNames = {
   BookingTicket: true
 };
 exports.BookingTicketImpl = exports.BookingTicket = void 0;
-var _BaseModule = require("../../modules/BaseModule");
+var _dayjs = _interopRequireDefault(require("dayjs"));
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -21,69 +21,551 @@ Object.keys(_types).forEach(function (key) {
     }
   });
 });
+var _BookingContext = require("../../modules/BookingContext");
+var _BaseSales = require("../BaseSales");
 var _scan = _interopRequireDefault(require("./utils/scan"));
+var _orderCustomer = require("./utils/orderCustomer");
 var _handleScan = require("./utils/scan/handleScan");
 var _scanCache = _interopRequireDefault(require("./utils/scan/scanCache"));
+var _formatGlobalScan = require("./utils/scan/formatGlobalScan");
+var _applyGlobalScan = require("./utils/scan/applyGlobalScan");
+var _cartView = require("./utils/cartView");
+var _addProductDecision = require("./utils/addProductDecision");
+var _buildCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildCacheItemFromOrderLine");
+var _sessionCatalogStale = require("./utils/sessionCatalogStale");
+var _buildNormalProductCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine");
+var _orderLineDisplay = require("../../modules/BookingContext/utils/orderLineDisplay");
+var _bookingStatus = require("./utils/bookingStatus");
+var _resolveBestAddTimePlan = require("./utils/resolveBestAddTimePlan");
+var _utils = require("../../modules/Order/utils");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-class BookingTicketImpl extends _BaseModule.BaseModule {
+const OPEN_DATA_SECTION_CODES = ['sale', 'reservation', 'fulfillment', 'menu', 'workflow'];
+const OPEN_DATA_CACHE_TTL = 5 * 60 * 1000;
+
+/**
+ * 读取已有 booking 的协议唯一值，用于加时商品行绑定原预约。
+ *
+ * @example
+ * const bookingUid = resolveBookingUidForAddTime(booking);
+ */
+function resolveBookingUidForAddTime(booking) {
+  const uid = booking?.metadata?.unique_identification_number;
+  return uid === undefined || uid === null ? '' : String(uid);
+}
+
+/**
+ * 规范化加车数量，避免非法值进入 OrderModule。
+ *
+ * @example
+ * const quantity = normalizeAddTimeQuantity(product.num);
+ */
+function normalizeAddTimeQuantity(value) {
+  const parsed = Math.floor(Number(value));
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 1;
+}
+
+/**
+ * 解析加时时长，优先使用显式入参，其次回退商品字段。
+ *
+ * @example
+ * const minutes = resolveAddTimeScheduleMinutes(input.product_add_schedule_time, product);
+ */
+function resolveAddTimeScheduleMinutes(explicitValue, product) {
+  const raw = explicitValue ?? product?.product_add_schedule_time;
+  if (raw === undefined || raw === null || raw === '') return undefined;
+  const parsed = Number(raw);
+  return Number.isFinite(parsed) ? parsed : undefined;
+}
+
+/**
+ * 计算加时商品行价格字段，保持 `price` 与 `selling_price` 输入口径一致。
+ *
+ * @example
+ * const price = resolveAddTimeProductPrice(input.price, product);
+ */
+function resolveAddTimeProductPrice(explicitValue, product) {
+  return explicitValue ?? product?.price ?? product?.selling_price ?? product?.base_price;
+}
+
+/**
+ * 规范化加时覆盖分钟数。
+ *
+ * @example
+ * const minutes = normalizeCoveredMinutes(input.coveredMinutes);
+ */
+function normalizeCoveredMinutes(value) {
+  const parsed = Math.ceil(Number(value));
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+}
+
+/**
+ * 计算 booking 加时后的结束时间与时长。
+ *
+ * @example
+ * const updates = buildAddTimeBookingTimePatch(booking, 30);
+ */
+function buildAddTimeBookingTimePatch(booking, coveredMinutes) {
+  if (coveredMinutes <= 0) return null;
+  const endDate = booking?.end_date;
+  const endTime = booking?.end_time;
+  if (!endDate || !endTime) {
+    throw new Error('[BookingTicket] addAddTimeProductsToBooking: booking.end_date/end_time 缺失');
+  }
+  const currentEnd = (0, _dayjs.default)(`${endDate} ${endTime}`);
+  if (!currentEnd.isValid()) {
+    throw new Error('[BookingTicket] addAddTimeProductsToBooking: booking.end_date/end_time 无效');
+  }
+  const nextEnd = currentEnd.add(coveredMinutes, 'minute');
+  const currentDuration = Number(booking?.duration);
+  let duration = Number.isFinite(currentDuration) ? currentDuration + coveredMinutes : coveredMinutes;
+  if (booking?.start_date && booking?.start_time) {
+    const start = (0, _dayjs.default)(`${booking.start_date} ${booking.start_time}`);
+    if (start.isValid()) {
+      const diffMinutes = nextEnd.diff(start, 'minute');
+      duration = diffMinutes > 0 ? diffMinutes : duration;
+    }
+  }
+  return {
+    end_date: nextEnd.format('YYYY-MM-DD'),
+    end_time: nextEnd.format('HH:mm'),
+    duration
+  };
+}
+function withProductOptionString(cacheItem) {
+  const productOptionString = (0, _orderLineDisplay.buildProductOptionStringFromOrderLine)(cacheItem);
+  if (!productOptionString) return cacheItem;
+  return {
+    ...cacheItem,
+    product_option_string: cacheItem?.product_option_string || productOptionString,
+    _extend: {
+      ...(cacheItem?._extend || {}),
+      product_option_string: cacheItem?._extend?.product_option_string || productOptionString
+    }
+  };
+}
+class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   defaultName = 'bookingTicket';
   defaultVersion = '1.0.0';
-  isSolution = true;
-  request;
-  window;
-  shopStore;
-  store;
-  otherParams = {};
-  cacheId;
-  platform; // 平台类型，用于判断是 PC / H5
 
+  /**
+   * 子类覆盖 store 类型为 BookingTicket 子模块清单（在父类基础上追加 customer）。
+   * 父类按 `getRegisteredModuleNames` 注入成员到该 store。
+   */
+  store = {};
+  platform;
   scan;
-  async initialize(core, options) {
-    this.core = core;
-    this.store = options.store || {};
-    this.otherParams = options.otherParams || {};
-    // 获取依赖的插件
-    this.request = core.getPlugin('request');
-    this.window = core.getPlugin('window');
-    this.shopStore = core.getPlugin('shopStore');
+  productCatalog = [];
+  addTimeProductsCatalog = [];
+  orderCustomerDiscountRefreshInFlight = null;
+  orderCustomerDiscountRefreshCustomerId = null;
+  loadOpenDataConfigInFlight = null;
+
+  /**
+   * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
+   * bookingContext 是 SalesSdk 加车下沉所需的「预约 UI 上下文」（bookingConfig / resourcesOrigin / date）。
+   */
+  getRegisteredModuleNames() {
+    return [...super.getRegisteredModuleNames(), 'customer', 'bookingContext', 'openData'];
+  }
+  getSubmitOrderSalesChannel() {
+    const channel = this.core?.context?.getChannel?.();
+    return !channel || channel === 'system' ? 'pos' : channel;
+  }
+
+  /**
+   * 业务侧子模块工厂：BookingTicket 自带的 createBookingTicketModule 优先匹配；
+   * 未识别的模块名（如 BookingByStep 公共类型）回退到父类工厂。
+   */
+  createSubModule(moduleName) {
+    const localModule = (0, _types.createBookingTicketModule)(moduleName, this.name);
+    if (localModule) return localModule;
+    return super.createSubModule(moduleName);
+  }
+  async initialize(core, options = {}) {
+    this.scan = new _scan.default(this, `BOOKING_TICKET_SCAN:${this.name}`);
+    await super.initialize(core, options);
     if (!this.request) {
       throw new Error('bookingTicket解决方案需要 request 插件支持');
     }
-    if (!this.shopStore) {
-      throw new Error('bookingTicket解决方案需要 shopStore 插件支持');
+    this.platform = this.otherParams?.platform;
+    await this.configureIdGeneratorFromOpenData();
+  }
+  getBookingTicketBusinessCode() {
+    const businessCode = this.otherParams?.businessCode ?? this.otherParams?.business_code;
+    if (businessCode === undefined || businessCode === null) return null;
+    const normalized = String(businessCode).trim();
+    return normalized || null;
+  }
+  getIdGeneratorPlugin() {
+    const appPlugin = this.core.getPlugin('app');
+    const app = appPlugin?.getApp?.();
+    return app?.getPlugin?.('idGenerator') || null;
+  }
+  async loadOpenDataConfig() {
+    if (!this.store.openData) throw new Error('openData 模块未初始化');
+    const businessCode = this.getBookingTicketBusinessCode();
+    if (!businessCode) {
+      console.warn('[BookingTicket] businessCode 缺失，跳过 OpenData 配置加载，当前 module name: ', this.name);
+      return null;
+    }
+    const lastFetchedAt = this.store.openData.getLastFetchedAt();
+    const cachedData = this.store.openData.getOpenData();
+    if (cachedData && lastFetchedAt && Date.now() - lastFetchedAt < OPEN_DATA_CACHE_TTL) {
+      this.otherParams.openData = cachedData;
+      return cachedData;
+    }
+    if (this.loadOpenDataConfigInFlight) return await this.loadOpenDataConfigInFlight;
+    const channel = this.getSubmitOrderSalesChannel();
+    this.loadOpenDataConfigInFlight = this.store.openData.fetchOpenData({
+      scope: 'board',
+      target: `${businessCode}+${channel}`,
+      // target: `dine_in+pos`,
+      section_code: [...OPEN_DATA_SECTION_CODES]
+    });
+    try {
+      const openDataConfig = await this.loadOpenDataConfigInFlight;
+      this.otherParams.openData = openDataConfig;
+      return openDataConfig;
+    } finally {
+      this.loadOpenDataConfigInFlight = null;
+    }
+  }
+  async getOpenData() {
+    return this.store.openData?.getOpenData();
+  }
+  async getShortNumberOrDeviceId() {
+    const getAsyncIotDeviceInfo = this.getAppData('async_iot_device_info');
+    if (getAsyncIotDeviceInfo) {
+      const res = await getAsyncIotDeviceInfo?.();
+      if (res?.short_number) {
+        return res?.short_number;
+      }
+    }
+    return String(this.getAppData('device_id') || 0).slice(-2);
+  }
+  async configureIdGeneratorFromOpenData() {
+    let openDataConfig = null;
+    try {
+      openDataConfig = await this.loadOpenDataConfig();
+    } catch (error) {
+      console.warn('[BookingTicket] OpenData 配置加载失败，跳过 idGenerator 配置', error);
+      return;
     }
 
-    // 如果有传 cacheid，默认需要收集上面这些模块里用户操作选中的数据
-    let targetCacheData = {};
-    this.cacheId = this.otherParams?.cacheId;
-    this.platform = this.otherParams?.platform;
-    this.scan = new _scan.default(this, 'BOOKING_TICKET_SCAN');
-    if (this.otherParams?.cacheId) {
-      const sessionData = this.window.sessionStorage.getItem(this.name);
-      if (sessionData) {
-        const data = JSON.parse(sessionData);
-        targetCacheData = data[this.otherParams.cacheId];
+    // if (!openDataConfig) return;
+
+    const idGenerator = this.getIdGeneratorPlugin();
+    if (!idGenerator?.configure) {
+      console.warn('[BookingTicket] idGenerator 插件不可用，跳过配置');
+      return;
+    }
+    const receiptSequenceLength = this.normalizePositiveInteger(openDataConfig?.['sale.short_number_digits'], 5);
+    const receiptSequenceStart = this.normalizePositiveInteger(openDataConfig?.['sale.short_number_start_number'], 1);
+    const prefix = this.normalizeIdPrefix(openDataConfig?.['sale.short_number_prefix'], '');
+    const shopOrderPrefix = this.normalizeIdPrefix(openDataConfig?.['sale.sale_number_prefix'], '');
+    const resetReceiptSequenceDaily = typeof openDataConfig?.['sale.short_number_daily_reset'] === 'boolean' ? openDataConfig?.['sale.short_number_daily_reset'] : false;
+    const operatingDayBoundary = this.getAppData('operating_day_boundary');
+    const deviceId = await this.getShortNumberOrDeviceId();
+    const businessCode = this.getBookingTicketBusinessCode();
+    if (!businessCode) {
+      console.warn('[BookingTicket] businessCode 缺失，跳过 idGenerator 配置');
+      return;
+    }
+    try {
+      await idGenerator.configure({
+        biz: businessCode,
+        config: {
+          prefix,
+          deviceCode: deviceId,
+          // TODO 现在 picoding 没这个配置的 key
+          padReceiptSequence: false,
+          receiptSequenceLength,
+          resetReceiptSequenceDaily,
+          receiptSequenceResetTime: operatingDayBoundary.time,
+          receiptSequenceStart,
+          shopOrderPrefix
+        }
+      });
+    } catch (error) {
+      console.warn('[BookingTicket] idGenerator 配置失败', error);
+    }
+  }
+  normalizePositiveInteger(value, fallback) {
+    const numeric = Number(value);
+    if (!Number.isInteger(numeric) || numeric <= 0) return fallback;
+    return numeric;
+  }
+  normalizeIdPrefix(value, fallback) {
+    if (value === undefined || value === null) return fallback;
+    const normalized = String(value).trim().toUpperCase();
+    return normalized || fallback;
+  }
+
+  /**
+   * 加载销售详情，并在父类基础上把 customer 信息装配到 CustomerModule。
+   *
+   * 业务上 ticketBooking 进入「编辑/查看」时需要 active customer 状态，因此从
+   * sales.customer / sales.header / tempOrder 顶层字段中拼装 ICustomer 后调 setSelectedCustomer，
+   * 让现有 setActiveCustomer / getActiveCustomer 调用方零成本拿到详情态客户。
+   */
+  async loadSalesDetail(orderIdOrParams) {
+    const sales = await super.loadSalesDetail(orderIdOrParams);
+    const customerModule = this.store.customer;
+    const detailCustomer = sales?.customer;
+    const orderCustomerSnapshot = this.store.order.getOrderCustomerSnapshot();
+    const protocolCustomerId = sales?.customer_id;
+    const protocolCustomer = protocolCustomerId !== undefined && protocolCustomerId !== null ? {
+      id: protocolCustomerId,
+      name: String(sales?.customer_name || ''),
+      phone: sales?.phone,
+      email: sales?.email,
+      country_calling_code: sales?.country_calling_code
+    } : null;
+    const selectedCustomer = detailCustomer ?? orderCustomerSnapshot ?? protocolCustomer;
+    if (customerModule && selectedCustomer) {
+      const {
+        id: detailCustomerId,
+        ...detailCustomerRest
+      } = selectedCustomer ?? {};
+      const rawId = detailCustomerId ?? '';
+      const customer = {
+        ...detailCustomerRest,
+        id: rawId == null ? '' : rawId,
+        name: selectedCustomer?.name ?? '',
+        phone: selectedCustomer?.phone,
+        email: selectedCustomer?.email,
+        country_calling_code: selectedCustomer?.country_calling_code
+      };
+      customerModule.setSelectedCustomer(customer);
+      this.setOrderCustomer(customer);
+      // await this.store.order.saveDraft();
+    }
+    return sales;
+  }
+  async scanPromotionCode(code, customerId) {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    const raw = await this.store.order.scanCode(code, customerId);
+    const scannedList = raw.scannedDiscountList || [];
+    const extractedCustomerId = this.getDiscountCustomerId(scannedList);
+    const hasOrderCustomer = Boolean(this.store.order.getOrderCustomer());
+
+    // 缺 Holder 等场景 isAvailable=false，但仍需把 Pass 归属客户带入订单，供 Holder 弹窗使用。
+    if (!hasOrderCustomer && extractedCustomerId) {
+      await this.hydrateOrderCustomerFromScanDiscounts(scannedList);
+    }
+    if (raw.isAvailable) {
+      await this.store.order.recalculateSummary({
+        createIfMissing: true
+      });
+      this.store.order.persistTempOrder();
+      const tempOrder = this.store.order.ensureTempOrder();
+      await this.effectsEmit('onDiscountApplied', {
+        productList: tempOrder.products || [],
+        discountList: this.store.order.getDiscountList(),
+        selectedDiscountList: tempOrder.discount_list || [],
+        tempOrder
+      });
+    }
+    return {
+      isAvailable: raw.isAvailable,
+      type: raw.type,
+      unavailableReason: raw.unavailableReason,
+      scannedDiscountList: raw.scannedDiscountList
+    };
+  }
+  async hydrateOrderCustomerFromScanDiscounts(discounts) {
+    const currentOrderCustomer = this.store.order.getOrderCustomer();
+    if (currentOrderCustomer) return;
+    const customerId = this.getDiscountCustomerId(discounts);
+    if (!customerId) return;
+    const customer = await this.resolveCustomerByDiscountCustomerId(customerId);
+    if (!customer) return;
+    this.store.customer.setSelectedCustomer(customer);
+    this.setOrderCustomer(customer);
+  }
+  getDiscountCustomerId(discounts) {
+    for (const item of discounts) {
+      const topLevelId = Number(item.customer_id);
+      if (Number.isFinite(topLevelId) && topLevelId > 0) {
+        return topLevelId;
       }
     }
-    const moduleArr = ['cart', 'products', 'accountList', 'customer', 'order'];
-    moduleArr.forEach(step => {
-      const targetModule = (0, _types.createModule)(step, this.name);
-      if (targetModule) {
-        this.store[step] = targetModule;
-        this.core.registerModule(targetModule, {
-          initialState: targetCacheData?.[targetModule.name],
-          otherParams: {
-            ...this.otherParams,
-            fatherModule: this.name,
-            openCache: this.otherParams?.cacheId ? true : false,
-            cacheId: this.otherParams?.cacheId
-          }
-        });
-      } else {
-        throw new Error(`模块 ${step} 不存在`);
+    return null;
+  }
+  async resolveCustomerByDiscountCustomerId(customerId) {
+    const localCustomers = this.store.customer.getCustomers();
+    const localCustomer = this.findCustomerById(localCustomers, customerId);
+    const normalizedLocalCustomer = localCustomer ? this.normalizeCustomer(localCustomer) : null;
+    if (normalizedLocalCustomer && this.hasUsableCustomerDetails(normalizedLocalCustomer)) {
+      return normalizedLocalCustomer;
+    }
+    const result = await this.store.customer.queryCustomerList({
+      ids: [customerId],
+      skip: 1,
+      num: 1
+    });
+    const remoteCustomer = this.findCustomerById(result?.list || [], customerId) || result?.list?.[0] || null;
+    return remoteCustomer ? this.normalizeCustomer(remoteCustomer) : null;
+  }
+  findCustomerById(customers = [], customerId) {
+    return customers.find(customer => {
+      const rawId = this.getRawCustomerId(customer);
+      return rawId !== null && String(rawId) === String(customerId);
+    }) || null;
+  }
+  normalizeCustomer(customer) {
+    const raw = customer;
+    const rawId = this.getRawCustomerId(customer);
+    const name = customer.name || raw.display_name || raw.nickname || raw.customer_name || [raw.first_name, raw.last_name].filter(Boolean).join(' ') || '';
+    return {
+      ...customer,
+      id: rawId ?? customer.id,
+      name,
+      phone: customer.phone ?? raw.phone ?? raw.mobile ?? '',
+      email: customer.email ?? raw.email ?? '',
+      country_calling_code: customer.country_calling_code ?? raw.country_calling_code ?? ''
+    };
+  }
+  getRawCustomerId(customer) {
+    const raw = customer;
+    return customer.id ?? raw.customer_id ?? raw.customerId ?? null;
+  }
+  hasUsableCustomerDetails(customer) {
+    return !!(customer.name || customer.phone || customer.email || customer.display_name || customer.customer_name);
+  }
+
+  /**
+   * 更新当前预约的 appointment_status。
+   *
+   * 数据源：从 OrderModule.tempOrder 内部读取，调用方无需传 orderId / scheduleId。
+   * schedule id 解析优先级：
+   *   1. `tempOrder.metadata.appointment_booking_parent_schedule_id`
+   *   2. `tempOrder.bookings` 中 `parent_id === 0` 的 `schedule_event_id`
+   *
+   * 流程：先乐观更新本地 bookings 的 appointment_status，再调 PUT 接口，
+   * 接口成功后强制刷新销售详情；任一步失败都回滚本地状态并抛错。
+   *
+   * @param status 目标状态（如 'confirmed'）
+   * @returns 接口返回的 data
+   */
+  async setBookingStatus(status) {
+    const tempOrder = this.store.order?.getTempOrder?.();
+    if (!tempOrder) {
+      throw new Error('setBookingStatus: tempOrder 未加载');
+    }
+    const orderId = tempOrder.order_id;
+    if (orderId === undefined || orderId === null) {
+      throw new Error('setBookingStatus: tempOrder.order_id 缺失');
+    }
+    const scheduleId = (0, _bookingStatus.resolveScheduleId)(tempOrder);
+    if (scheduleId === null) {
+      throw new Error('setBookingStatus: 无法解析 schedule id（metadata 与 root booking 均缺失）');
+    }
+    const bookings = Array.isArray(tempOrder.bookings) ? tempOrder.bookings : [];
+    const previous = (0, _bookingStatus.applyBookingsStatus)(bookings, status);
+    try {
+      const res = await this.request.put(`/schedule/booking/appointment-status/${scheduleId}`, {
+        appointment_status: status
+      });
+      await this.refreshSalesDetail();
+      this.core.effects.emit(`${this.name}:onBookingStatusChange`, {
+        orderId,
+        status
+      });
+      return res?.data ?? res;
+    } catch (error) {
+      (0, _bookingStatus.restoreBookingsStatus)(bookings, previous);
+      throw error;
+    }
+  }
+
+  /**
+   * 子预约状态机转移（POST /schedule/booking-transition/{schedule_event_id}）。
+   *
+   * 与 `setBookingStatus`（父预约 PUT appointment-status）不同，本方法按子预约
+   * `schedule_event_id` 调用状态转移接口，body 为 `{ action }`。
+   *
+   * 流程：能解析出目标状态时先乐观更新对应子预约的 `appointment_status`，
+   * 再调 POST；成功后强制刷新销售详情；失败则回滚该子预约本地状态并抛错。
+   * `reschedule` 暂未启用状态矩阵，跳过乐观更新仅调接口。
+   *
+   * @param params.schedule_event_id 子预约 schedule_event_id
+   * @param params.action 转移动作：confirm | reject | arrive | start | complete | cancel | no_show | reschedule
+   * @returns 接口返回的 data
+   *
+   * @example
+   * await bookingTicket.transitionChildBooking({
+   *   schedule_event_id: 301,
+   *   action: 'confirm',
+   * });
+   */
+  async transitionChildBooking(params) {
+    const {
+      schedule_event_id,
+      action
+    } = params;
+    if (schedule_event_id === undefined || schedule_event_id === null || schedule_event_id === '') {
+      throw new Error('transitionChildBooking: schedule_event_id 不能为空');
+    }
+    if (!action) {
+      throw new Error('transitionChildBooking: action 不能为空');
+    }
+    const tempOrder = this.store.order?.getTempOrder?.();
+    if (!tempOrder) {
+      throw new Error('transitionChildBooking: tempOrder 未加载');
+    }
+    const orderId = tempOrder.order_id;
+    if (orderId === undefined || orderId === null) {
+      throw new Error('transitionChildBooking: tempOrder.order_id 缺失');
+    }
+    const bookings = Array.isArray(tempOrder.bookings) ? tempOrder.bookings : [];
+    const targetStatus = (0, _bookingStatus.resolveStatusAfterTransition)(action);
+    const previous = targetStatus !== null ? (0, _bookingStatus.applyChildBookingStatus)(bookings, schedule_event_id, targetStatus) : undefined;
+    try {
+      const res = await this.request.post(`/schedule/booking-transition/${schedule_event_id}`, {
+        action
+      });
+      await this.refreshSalesDetail();
+      this.core.effects.emit(`${this.name}:onChildBookingStatusChange`, {
+        orderId,
+        schedule_event_id,
+        action,
+        status: targetStatus
+      });
+      return res?.data ?? res;
+    } catch (error) {
+      if (previous !== undefined) {
+        (0, _bookingStatus.restoreChildBookingStatus)(bookings, schedule_event_id, previous);
       }
+      throw error;
+    }
+  }
+
+  /**
+   * 基于当前 tempOrder.order_id 强制从远端重新拉取销售详情。
+   *
+   * 适用场景：在 BookingTicket 内执行了「修改服务端订单状态」的动作（如改预约状态、
+   * 改下单客户、改商品行等）后，统一刷新本地销售详情，保证 UI 与服务端一致。
+   *
+   * 约束：调用前必须已有 tempOrder 且 order_id 存在，否则视为非法调用并抛错。
+   *
+   * @returns loadSalesDetail 的返回值
+   */
+  async refreshSalesDetail(params = {}) {
+    const tempOrder = this.store.order?.getTempOrder?.();
+    if (!tempOrder) {
+      throw new Error('refreshSalesDetail: tempOrder 未加载');
+    }
+    debugger;
+    const orderId = tempOrder.order_id || tempOrder.external_sale_number;
+    if (orderId === undefined || orderId === null) {
+      return {};
+    }
+    return this.loadSalesDetail({
+      orderId: orderId,
+      // merge: true
+      forceRemote: params.forceRemote
     });
-    this.core.effects.emit(`${this.name}:onInited`, {});
   }
 
   /**
@@ -98,6 +580,13 @@ class BookingTicketImpl extends _BaseModule.BaseModule {
       menu_list_ids,
       schedule_datetime
     } = params;
+
+    // 优先写入 schedule_datetime（含时分），供加购 presetStartTime 与 TimeBar 对齐；
+    // requiresDetail 弹窗仍通过 formatBookingDateForUI 只取日历日 YYYY-MM-DD。
+    const bookingDate = schedule_datetime || schedule_date || '';
+    if (bookingDate) {
+      this.setBookingDate(bookingDate);
+    }
     try {
       const result = await this.store.products.loadProducts({
         with_count: ['bundleGroup', 'optionGroup'],
@@ -105,6 +594,7 @@ class BookingTicketImpl extends _BaseModule.BaseModule {
         ...params,
         cacheId: this.cacheId
       }, options);
+      this.productCatalog = Array.isArray(result) ? [...result] : [];
       this.core.effects.emit(`${this.name}:onProductsLoaded`, result);
       return result;
     } catch (error) {
@@ -113,6 +603,72 @@ class BookingTicketImpl extends _BaseModule.BaseModule {
     }
   }
 
+  /**
+   * 获取加时商品列表。
+   *
+   * @example
+   * const products = await bookingTicket.getAddTimeProducts({ schedule_date: '2026-06-16' });
+   */
+  async getAddTimeProducts(params = {}) {
+    const result = await this.store.products.getAddTimeProducts({
+      ...params,
+      cacheId: this.cacheId
+    });
+    this.addTimeProductsCatalog = Array.isArray(result) ? [...result] : [];
+    return result;
+  }
+
+  /**
+   * 只读查询单商品详情：走 ProductList 报价查询，但不写 productCatalog、
+   * 不 emit onProductsLoaded、不修改 BookingDate。
+   *
+   * 供「列表已 loadProducts、仅需补 product_resource / capacity」等场景使用，
+   * 避免 loadProductDetail 覆盖左侧商品列表。
+   *
+   * @example
+   * const detail = await bookingTicket.queryProductDetail({
+   *   product_id: 2,
+   *   schedule_date: '2030-01-15',
+   *   schedule_datetime: '2030-01-15 10:00:00',
+   * });
+   */
+  async queryProductDetail(params, options) {
+    const {
+      product_id,
+      ...queryParams
+    } = params;
+    try {
+      const result = await this.store.products.loadProducts({
+        with_count: ['bundleGroup', 'optionGroup'],
+        with_schedule: 1,
+        ...queryParams,
+        product_ids: [product_id],
+        cacheId: this.cacheId
+      }, options);
+      const list = Array.isArray(result) ? result : [];
+      return list.find(product => Number(product.id) === Number(product_id));
+    } catch (error) {
+      console.error('Failed to query product detail:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * 按预约时间加载单个商品详情。
+   * 价格仍由 server products 的报价单桥接统一计算，避免 solution 实例重复请求报价单。
+   */
+  async loadProductDetail(params, options) {
+    const {
+      product_id,
+      ...queryParams
+    } = params;
+    const products = await this.loadProducts({
+      ...queryParams,
+      product_ids: [product_id]
+    }, options);
+    return products.find(product => Number(product.id) === Number(product_id));
+  }
+
   /**
    * 取消商品查询订阅
    * @param subscriberId 订阅时传入的 subscriberId
@@ -136,6 +692,57 @@ class BookingTicketImpl extends _BaseModule.BaseModule {
     return this.store.products.getProducts();
   }
 
+  /**
+   * 获取当前已加载的商品池 UI 视图。
+   *
+   * ProductList.getProducts 是异步 API；BookingTicket 维护最近一次 loadProducts 结果，
+   * 供 UI 同步 getter 使用。未加载时返回空列表。
+   */
+  getProductCatalog() {
+    return {
+      products: [...this.productCatalog]
+    };
+  }
+
+  /**
+   * 获取购物车 UI 视图。
+   *
+   * tempOrder 仍是 checkout 协议对象；商品行直接透传 products，bookings 附带关联商品。
+   */
+  getCart() {
+    const tempOrder = this.store.order?.getTempOrder() ?? null;
+    const salesDetail = this.getSalesOrder();
+    const bookings = salesDetail?.bookings ?? (tempOrder?.bookings || []);
+    let operatingDayBoundary;
+    try {
+      operatingDayBoundary = this.getAppData('operating_day_boundary');
+    } catch {
+      operatingDayBoundary = undefined;
+    }
+    const shopOpeningHours = operatingDayBoundary?.type === 'start_time' ? '23:59' : operatingDayBoundary?.time;
+    return (0, _cartView.buildCartView)(tempOrder?.products || [], bookings, {
+      addTimeProducts: this.addTimeProductsCatalog,
+      bookingConfig: this.getBookingConfig(),
+      productsByUid: tempOrder?._extend?.productsByUid,
+      shopOpeningHours
+    });
+  }
+
+  /**
+   * 获取当前下单客户（与 OrderModule.tempOrder snapshot 一致）。
+   */
+  getCustomer() {
+    return this.getOrderCustomerSnapshot();
+  }
+
+  /**
+   * 通过 ids 获取商品列表（不加载到模块中）
+   * @returns 商品列表
+   */
+  async getProductByIds(ids) {
+    return this.store.products.getProductByIds(ids);
+  }
+
   /**
    * 获取日程时间段点
    * @param params 参数
@@ -230,6 +837,154 @@ class BookingTicketImpl extends _BaseModule.BaseModule {
     this.store.customer.addCustomerToFirst(customer);
   }
 
+  // ─── 下单客户（基于 OrderModule.tempOrder，单一真源）───
+  // 与老的 setActiveCustomer/getActiveCustomer 解耦：
+  //  - 老路：写入 CustomerModule.selectedCustomer（保留兼容，存量调用方不动）
+  //  - 新路：写入 tempOrder 的 customer 协议字段 + _extend.customerSnapshot
+  // 新业务（如 SalesSdk）应优先使用本组方法。
+
+  /**
+   * 设置当前下单客户。
+   *
+   * @param customer 完整客户对象；null 表示清空
+   *
+   * 内部将 customer 格式化为 tempOrder 协议字段后写入 OrderModule，
+   * 并以 customer 作为 snapshot 保存富字段。
+   *
+   * 同时透传 OrderModule 内部 emit 的 `order:onOrderCustomerChange` 之外，
+   * 在 BookingTicket 命名空间也 emit 一次，方便上层统一从 Solution 订阅。
+   */
+  setOrderCustomer(customer) {
+    if (!customer) {
+      this.clearOrderCustomer();
+      return;
+    }
+    const previousCustomerId = this.store.order.getOrderCustomer()?.customer_id;
+    const snapshotBeforeSet = this.store.order.getOrderCustomerSnapshot();
+    const patch = (0, _orderCustomer.formatOrderCustomerPatch)(customer);
+    const customerUnchanged = Number(previousCustomerId || 0) === Number(patch.customer_id || 0);
+    if (!customerUnchanged) {
+      this.discountConfigCacheKey = null;
+      this.hasManualDiscountSelection = false;
+    }
+    this.store.order.setOrderCustomer(patch, customer);
+    const snapshotAfterOrderSet = this.store.order.getOrderCustomerSnapshot();
+    if (customerUnchanged) {
+      // hydrate 后 customer_id 已存在但 _extend.customerSnapshot 仍为空时，
+      // 须通知 SalesSdk 刷新 selected（否则会一直停在 onSalesOrderLoaded 时的 null）。
+      const snapshotReplenished = !snapshotBeforeSet && Boolean(snapshotAfterOrderSet);
+      if (snapshotReplenished) {
+        const next = this.buildOrderCustomerPayload();
+        this.core.effects.emit(`${this.name}:onOrderCustomerChange`, next);
+      }
+      return;
+    }
+    const next = this.buildOrderCustomerPayload();
+    this.core.effects.emit(`${this.name}:onOrderCustomerChange`, next);
+    this.refreshDiscountConfigAfterOrderCustomerChange(patch.customer_id);
+    // 客户切换可能改变可用促销/赠品；触发一次重算（recursion-safe）。
+    void this.store.order.applyPromotion().catch(error => {
+      console.error('[BookingTicket] applyPromotion after customer change failed', error);
+    });
+  }
+
+  /**
+   * 读取 tempOrder 上的下单客户协议字段；customer_id 缺失时返回 null。
+   */
+  getOrderCustomer() {
+    return this.store.order.getOrderCustomer();
+  }
+
+  /**
+   * 读取 tempOrder._extend.customerSnapshot 中的完整客户对象。
+   */
+  getOrderCustomerSnapshot() {
+    return this.store.order.getOrderCustomerSnapshot();
+  }
+
+  /**
+   * 清空下单客户（协议字段 + snapshot）。
+   */
+  clearOrderCustomer() {
+    this.store.order.clearOrderCustomer();
+    this.discountConfigCacheKey = null;
+    this.hasManualDiscountSelection = false;
+    const orderStore = this.store.order.store || {};
+    const discountModule = orderStore.discount;
+    void discountModule?.setOriginalDiscountList?.([]);
+    void discountModule?.setDiscountList?.([]);
+    this.store.order.applyDiscount();
+    void this.store.order.recalculateSummary({
+      createIfMissing: true
+    }).then(() => {
+      const tempOrder = this.store.order.ensureTempOrder();
+      this.store.order.persistTempOrder();
+      return this.effectsEmit('onDiscountApplied', {
+        productList: tempOrder.products || [],
+        discountList: discountModule?.getDiscountList?.() || [],
+        selectedDiscountList: tempOrder.discount_list || [],
+        tempOrder
+      });
+    }).catch(error => {
+      console.error('Failed to recalculate summary after clearing customer:', error);
+    });
+    this.core.effects.emit(`${this.name}:onOrderCustomerChange`, null);
+  }
+
+  /**
+   * 重置 tempOrder，并同步清空下单客户运行态。
+   *
+   * OrderModule.restoreOrder 会重建空单（customer_id 已为 null），但不会：
+   *  - emit BookingTicket `onOrderCustomerChange`
+   *  - 重置 CustomerModule.selectedCustomer（老路 getActiveCustomer）
+   *
+   * 因此在 super.restoreOrder 之后显式清客户，保证 SalesSdk / ticketBooking 订阅方与 tempOrder 一致。
+   */
+  async restoreOrder() {
+    const tempOrder = await super.restoreOrder();
+    this.clearOrderCustomer();
+    this.store.customer?.setSelectedCustomer(null);
+    return tempOrder;
+  }
+
+  /** 内部：基于 OrderModule 当前状态构造一份 OrderCustomerChangePayload。 */
+  buildOrderCustomerPayload() {
+    const patch = this.store.order.getOrderCustomer();
+    if (!patch) return null;
+    return {
+      patch,
+      snapshot: this.store.order.getOrderCustomerSnapshot()
+    };
+  }
+  refreshDiscountConfigAfterOrderCustomerChange(customerId) {
+    if (!customerId || customerId === 1) return;
+    if (this.orderCustomerDiscountRefreshInFlight && this.orderCustomerDiscountRefreshCustomerId === customerId) {
+      return;
+    }
+    const previousRefresh = this.orderCustomerDiscountRefreshInFlight;
+    const refreshTask = (async () => {
+      if (previousRefresh) {
+        await previousRefresh.catch(() => undefined);
+      }
+      const currentCustomer = this.store.order.getOrderCustomer();
+      if (!currentCustomer || Number(currentCustomer.customer_id) !== customerId) {
+        return;
+      }
+      await this.loadDiscountConfig({
+        customerId
+      });
+    })();
+    this.orderCustomerDiscountRefreshInFlight = refreshTask;
+    this.orderCustomerDiscountRefreshCustomerId = customerId;
+    refreshTask.catch(error => {
+      console.error('Failed to load discount config after customer change:', error);
+    }).finally(() => {
+      if (this.orderCustomerDiscountRefreshInFlight !== refreshTask) return;
+      this.orderCustomerDiscountRefreshInFlight = null;
+      this.orderCustomerDiscountRefreshCustomerId = null;
+    });
+  }
+
   /**
    * 获取客户分页信息
    * @returns 分页信息
@@ -332,7 +1087,7 @@ class BookingTicketImpl extends _BaseModule.BaseModule {
    */
   scanGlobalListener(callback) {
     const localSearch = v => this.store.products.findProductsByCodeOrBarcode(v);
-    const scanCallback = (0, _handleScan.handleGlobalScan)(this.request, localSearch);
+    const scanCallback = (0, _handleScan.handleGlobalScan)(this.request, localSearch, this.getSubmitOrderSalesChannel());
     const safeCallback = d => {
       try {
         callback(d);
@@ -425,45 +1180,564 @@ class BookingTicketImpl extends _BaseModule.BaseModule {
   }
 
   /**
-   * 设置其他参数
-   * @param params 参数
-   * @param options 选项
+   * 获取其他参数
+   * @returns 其他参数
    */
-  async setOtherParams(params, {
-    cover = false
-  } = {}) {
-    if (cover) {
-      this.otherParams = params;
-    } else {
-      this.otherParams = {
-        ...this.otherParams,
-        ...params
+  async getOtherParams() {
+    return this.otherParams;
+  }
+
+  // ─── BookingContext API（透传给 BookingContextModule） ──────────────────────
+  // SalesSdkProvider 挂载时默认调 initBookingContext；也可由 UI 显式 set* 灌入已有数据。
+
+  /** 拉取 board config 并写入 BookingContext。 */
+  loadBookingConfig(params) {
+    return this.store.bookingContext.loadBookingConfig(params);
+  }
+
+  /** 拉取资源全集并写入 BookingContext。 */
+  loadBookingResources(params) {
+    return this.store.bookingContext.loadResources(params);
+  }
+
+  /** 初始化 BookingContext（date + config + resources）。 */
+  initBookingContext(params) {
+    return this.store.bookingContext.initBookingContext(params);
+  }
+
+  /** 当前 store 是否已具备与入参等价的 config / resources（无需再请求接口）。 */
+  isBookingContextReady(params) {
+    return this.store.bookingContext.isBookingContextReady(params);
+  }
+
+  /** 写入 booking config（来源：`/core/board/management/config`）。 */
+  setBookingConfig(config) {
+    this.store.bookingContext.setBookingConfig(config);
+  }
+
+  /** 读取当前 booking config。 */
+  getBookingConfig() {
+    return this.store.bookingContext.getBookingConfig();
+  }
+
+  /** 写入资源全集（来源：`/form/schedule`），同步派生 resourcesOriginMap。 */
+  setResources(resources) {
+    this.store.bookingContext.setResources(resources);
+  }
+
+  /** 读取资源全集（浅克隆）。 */
+  getResourcesOrigin() {
+    return this.store.bookingContext.getResourcesOrigin();
+  }
+
+  /** 读取资源全集 map（id → resource）。 */
+  getResourcesOriginMap() {
+    return this.store.bookingContext.getResourcesOriginMap();
+  }
+
+  /** 写入当前选择的日期；支持 dayjs / Date / string。 */
+  setBookingDate(date) {
+    this.store.bookingContext.setDate(date);
+  }
+
+  /** 读取当前选择的日期（统一 string）。 */
+  getBookingDate() {
+    return this.store.bookingContext.getDate();
+  }
+
+  /** 读取 BookingContext 完整 store（调试 / 测试 / 透传给 SDK 使用）。 */
+  getBookingContextState() {
+    return this.store.bookingContext.getState();
+  }
+
+  /** 清空 BookingContext（切租户 / destroy 场景）。 */
+  clearBookingContext() {
+    this.store.bookingContext.clear();
+  }
+
+  /**
+   * 构造 BookingContext 计算上下文（供 getProductExtend / getResourceByIds 等读 API 复用）。
+   */
+  buildBookingCalcContext(extra) {
+    const state = this.store.bookingContext.getState();
+    const date = extra?.date ?? state.date;
+    return {
+      bookingConfig: state.bookingConfig,
+      resourcesOrigin: state.resourcesOrigin,
+      resourcesOriginMap: state.resourcesOriginMap,
+      date,
+      presetStartTime: extra?.presetStartTime ?? (0, _BookingContext.derivePresetStartTimeFromDate)(date),
+      ...(extra || {})
+    };
+  }
+
+  /**
+   * 取商品当前可选资源列表（透传 OS BookingContext utils#getResourceByIds）。
+   * `extraResources` 用于把拖入未绑定的资源也展示出来。
+   */
+  getResourcesForProduct(product, options) {
+    const ctx = this.buildBookingCalcContext();
+    return (0, _BookingContext.getResourceByIds)(ctx.resourcesOriginMap || {}, product, {
+      resourceTab: ctx.bookingConfig?.config?.resource_tab,
+      resourcesOrigin: ctx.resourcesOrigin,
+      extraResources: options?.extraResources || []
+    });
+  }
+
+  /**
+   * 拼装 cacheItem 的 _extend / _data（资源 / 容量 / timeObj），与 info2 `getProductExtend` 等价。
+   */
+  getProductExtend(cacheItem, extra) {
+    const preparedCacheItem = withProductOptionString(cacheItem);
+    const result = (0, _BookingContext.getProductExtend)({
+      cacheItem: preparedCacheItem,
+      ctx: this.buildBookingCalcContext(extra)
+    });
+    return result;
+  }
+
+  /**
+   * 取资源不可用原因列表（结构化 enum + params，i18n 文案由 UI 渲染）。
+   */
+  getResourceErrors(resource, cacheItem) {
+    return (0, _BookingContext.getResourceErrors)(resource, cacheItem);
+  }
+
+  // ─── addProduct 决策 / 转换 API（SDK 加车下沉所需） ─────────────────────────
+  // 这一组方法是 SalesSdkCartContext.addProduct / confirmDetail 的 OS 后端。
+  // 调用方传入 ProductData，OS 自取 bookingContext / customer / date 等上下文，
+  // 输出 (a) autoClose 决策结果或 (b) `{ product, booking }` 协议入参。
+
+  /**
+   * session 商品 catalog 日期与 TimeBar 不一致时写业务日志。
+   *
+   * @example
+   * this.logSessionCatalogDateMismatch(product, ctx.date);
+   */
+  logSessionCatalogDateMismatch(item, bookingDate) {
+    const logger = this.logger;
+    if (!logger?.addLog) return;
+    const tempOrder = this.getTempOrder?.();
+    const staleInfo = (0, _sessionCatalogStale.buildSessionCatalogStaleInfo)(item, bookingDate);
+    logger.addLog({
+      type: 'warning',
+      title: `[BookingTicket] session catalog date mismatch, reload products`,
+      metadata: {
+        order_id: tempOrder?.order_id ?? null,
+        external_sale_number: tempOrder?.external_sale_number ?? null,
+        ...staleInfo,
+        cartDetailValueSession: item?.cartDetailValue?.session ?? null
+      }
+    });
+  }
+
+  /**
+   * 加车前：session 商品 catalog 日历日与 bookingDate 不一致时中断加购，交由 SDK reload products。
+   */
+  resolveSessionCatalogBeforeAdd(item, ctx) {
+    if (!(0, _sessionCatalogStale.isSessionCatalogDateStale)(item, ctx.date)) {
+      return null;
+    }
+    this.logSessionCatalogDateMismatch(item, ctx.date);
+    return {
+      action: 'reloadCatalog'
+    };
+  }
+
+  /**
+   * 拼装 addProductDecision 通用上下文（从 store 自取）。
+   */
+  buildAddProductCtx(extra) {
+    const bookingContextState = this.store.bookingContext.getState();
+    const date = extra?.date ?? bookingContextState.date;
+    const orderCustomerId = this.getOrderCustomerSnapshot()?.id ?? this.store.order.getTempOrder()?.customer_id ?? undefined;
+    return {
+      bookingConfig: bookingContextState.bookingConfig,
+      resourcesOrigin: bookingContextState.resourcesOrigin,
+      resourcesOriginMap: bookingContextState.resourcesOriginMap,
+      date,
+      presetStartTime: extra?.presetStartTime ?? (0, _BookingContext.derivePresetStartTimeFromDate)(date),
+      customerId: orderCustomerId,
+      ...(extra || {})
+    };
+  }
+
+  /**
+   * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
+   * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
+   */
+  decideAddProduct(item, options) {
+    const ctx = this.buildAddProductCtx(options);
+    const staleDecision = this.resolveSessionCatalogBeforeAdd(item, ctx);
+    if (staleDecision) {
+      return staleDecision;
+    }
+    return (0, _addProductDecision.decideAddProduct)(item, ctx);
+  }
+
+  /** 规格弹窗 callback 后的第二段决策。 */
+  decideAfterDetail(cacheItem, options) {
+    return (0, _addProductDecision.decideAfterDetail)(cacheItem, this.buildAddProductCtx(options));
+  }
+
+  /**
+   * @deprecated 请用 `decideAddProduct`；`autoClose=true` 仅当 action=add。
+   */
+  decideAutoClose(item, options) {
+    return (0, _addProductDecision.decideAutoClose)(item, this.buildAddProductCtx(options));
+  }
+
+  /** 替代 info2 `getIsEject`：商品是否需要弹窗（0/1）。 */
+  getIsEject(item, type = 'select') {
+    return (0, _addProductDecision.getIsEject)(item, type);
+  }
+
+  /** 仅 session 商品（无 variant/option/package）→ true。 */
+  getIsOnlySession(item) {
+    return (0, _addProductDecision.getIsOnlySession)(item);
+  }
+
+  /**
+   * 拼装 requiresDetail payload（给 SDK 直接 return 给 UI 用）。
+   */
+  buildRequiresDetailPayload(item, options) {
+    const ctx = this.buildAddProductCtx(options);
+    return (0, _addProductDecision.buildRequiresDetailPayload)(item, ctx);
+  }
+
+  /**
+   * 把 detail 弹窗回调结果（e, extension_type, detail）转换为 `(product, booking)` 入参。
+   * 内部会先拼 cacheItem，再走 cacheItemToBookingInput 严格协议对齐。
+   */
+  transformDetailToProductAndBooking(input) {
+    const {
+      item,
+      cacheItem: preparedCacheItem,
+      detailResult,
+      options
+    } = input;
+    const ctx = this.buildAddProductCtx(options);
+    const cacheItem = preparedCacheItem || (detailResult ? (0, _addProductDecision.buildCacheItemFromDetail)(item, detailResult, ctx) : (0, _addProductDecision.buildCacheItemFromCartDetail)(item, ctx));
+    return (0, _addProductDecision.transformDetailToProductAndBooking)(cacheItem, ctx);
+  }
+
+  /**
+   * 从已加车的 order line + booking 反查资源编辑抽屉所需的 cacheItem。
+   * 供 SalesSdk「编辑资源」等场景使用；字段语义与 buildCacheItemFromDetail 产出对齐。
+   */
+  buildCacheItemFromOrderLine(input) {
+    return (0, _buildCacheItemFromOrderLine.buildCacheItemFromOrderLine)(input);
+  }
+
+  /**
+   * 从已加车的普通商品 order line 反查 SkuDetailModal edit 所需的 cacheItem。
+   */
+  buildNormalProductCacheItemFromOrderLine(input) {
+    return (0, _buildNormalProductCacheItemFromOrderLine.buildNormalProductCacheItemFromOrderLine)(input);
+  }
+
+  /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
+  async updateProductInOrder(params) {
+    return this.updateOrderProduct(params);
+  }
+
+  /**
+   * 全局扫码 pubsub 入口：解析码值 → 搜索 → 业务分发（客户 / 加车 / 开单）。
+   * UI 层在 pubsub 订阅回调里注入 `bridge`（uiHosts / action / cart.confirm*）。
+   *
+   * @example
+   * ```ts
+   * await bookingTicket.handleGlobalScanCode(payload.data, {
+   *   openProductDetail: uiHosts.openProductDetail,
+   *   confirmDetail: cart.confirmDetail,
+   *   openOrder: ({ order_id }) => action({ type: 'pisell1.handleOpenCachedBigSale', data: { order_id } }),
+   * });
+   * ```
+   */
+  async handleGlobalScanCode(code, bridge) {
+    const trimmed = typeof code === 'string' ? code.trim() : '';
+    if (!trimmed) {
+      bridge?.onNotify?.('fail', 'pisell2.text.scan-global-failed');
+      return {
+        status: 'failed',
+        reason: 'empty_code'
       };
     }
+    try {
+      const localSearch = v => this.store.products.findProductsByCodeOrBarcode(v);
+      const scanCallback = (0, _handleScan.handleGlobalScan)(this.request, localSearch, this.getSubmitOrderSalesChannel());
+      const raw = await scanCallback({
+        type: 'nativeScanner',
+        value: trimmed
+      });
+      const formatted = (0, _formatGlobalScan.formatGlobalScanResult)(raw, trimmed);
+      if (!formatted) {
+        bridge?.onNotify?.('fail', 'pisell2.text.scan-global-failed');
+        return {
+          status: 'failed',
+          reason: 'not_found'
+        };
+      }
+      const result = await (0, _applyGlobalScan.applyGlobalScan)({
+        setOrderCustomer: customer => this.setOrderCustomer(customer),
+        getOrderCustomerSnapshot: () => this.getOrderCustomerSnapshot(),
+        getBusinessCode: () => this.otherParams?.businessCode,
+        buildAddProductCtx: extra => this.buildAddProductCtx(extra),
+        decideAddProduct: (item, options) => this.decideAddProduct(item, options),
+        decideAfterDetail: (cacheItem, options) => this.decideAfterDetail(cacheItem, options),
+        transformDetailToProductAndBooking: input => this.transformDetailToProductAndBooking(input),
+        addProductToOrder: (product, booking) => this.addProductToOrder(product, booking)
+      }, formatted, bridge);
+      bridge?.refresh?.();
+      return result;
+    } catch (error) {
+      console.error('[BookingTicket] handleGlobalScanCode failed', error);
+      bridge?.onNotify?.('fail', 'pisell2.text.scan-global-failed');
+      return {
+        status: 'failed',
+        reason: 'not_found'
+      };
+    }
+  }
+  resolveBestAddTimePlan(addTimeProducts, targetMinutes) {
+    return (0, _resolveBestAddTimePlan.resolveBestAddTimePlan)(addTimeProducts, targetMinutes);
   }
 
   /**
-   * 获取其他参数
-   * @returns 其他参数
+   * 构造一条绑定到已有 booking 的加时商品行。
+   *
+   * @example
+   * const line = this.buildAddTimeOrderLine({ product, product_add_schedule_time: 30 }, 'booking-1');
    */
-  async getOtherParams() {
-    return this.otherParams;
+  buildAddTimeOrderLine(input, bookingUid) {
+    const product = input?.product;
+    if (!product || typeof product !== 'object') {
+      throw new Error('[BookingTicket] addAddTimeProductToBooking: product 不能为空');
+    }
+    const quantity = normalizeAddTimeQuantity(input.num ?? product.num);
+    const price = resolveAddTimeProductPrice(input.price, product);
+    const addScheduleTime = resolveAddTimeScheduleMinutes(input.product_add_schedule_time, product);
+    const payload = {
+      id: product.id ?? product.product_id,
+      product_id: product.product_id ?? product.id,
+      product_variant_id: product.product_variant_id ?? product.variant_id ?? 0,
+      variant_id: product.variant_id ?? product.product_variant_id ?? 0,
+      quantity,
+      num: quantity,
+      price,
+      selling_price: price,
+      original_price: product.original_price ?? price,
+      line_total: price,
+      total: price,
+      product_sku: product.product_sku,
+      option: product.option ?? product.options ?? product.product_sku?.option ?? [],
+      bundle: product.bundle ?? product.bundles ?? product.product_bundle ?? []
+    };
+    const orderLine = this.transformBaseProductToOrderProduct({
+      payload,
+      fallbackProductId: product.id ?? product.product_id,
+      sourceProduct: product,
+      sourceItem: product
+    });
+    if (!orderLine) {
+      throw new Error('[BookingTicket] addAddTimeProductToBooking: product transform failed');
+    }
+    const metadata = {
+      ...(orderLine.metadata || {}),
+      ...(addScheduleTime !== undefined ? {
+        product_add_schedule_time: addScheduleTime
+      } : {}),
+      booking_uid: bookingUid
+    };
+    return {
+      ...orderLine,
+      booking_uid: bookingUid,
+      metadata
+    };
+  }
+
+  /**
+   * 将加时商品作为独立商品行绑定到已有 booking。
+   *
+   * 与预约商品加车不同，本方法不会把当前 booking 作为 `addProductToOrder` 第二参数传入，
+   * 避免 OrderModule 新建 booking 或重写已有 booking.product_uid。
+   *
+   * @example
+   * await bookingTicket.addAddTimeProductToBooking({
+   *   booking,
+   *   product,
+   *   num: 1,
+   *   price: '10.00',
+   *   product_add_schedule_time: 30,
+   * });
+   */
+  async addAddTimeProductToBooking(input) {
+    return this.addAddTimeProductsToBooking({
+      booking: input.booking,
+      products: [input],
+      coveredMinutes: input.coveredMinutes,
+      bookingPatch: input.bookingPatch
+    });
+  }
+
+  /**
+   * 批量将加时商品作为独立商品行绑定到已有 booking，并只触发一次购物车重算。
+   *
+   * @example
+   * await bookingTicket.addAddTimeProductsToBooking({
+   *   booking,
+   *   products: [{ product, product_add_schedule_time: 30 }],
+   * });
+   */
+  async addAddTimeProductsToBooking(input) {
+    const bookingUid = resolveBookingUidForAddTime(input?.booking);
+    if (!bookingUid) {
+      throw new Error('[BookingTicket] addAddTimeProductToBooking: booking.metadata.unique_identification_number 缺失');
+    }
+    const orderLines = (input.products || []).map(line => ({
+      product: this.buildAddTimeOrderLine(line, bookingUid)
+    }));
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    const coveredMinutes = normalizeCoveredMinutes(input.coveredMinutes);
+    const bookingTimePatch = input.bookingPatch ?? buildAddTimeBookingTimePatch(input.booking, coveredMinutes);
+    if (bookingTimePatch) {
+      this.store.order.updateOrderBooking({
+        unique_identification_number: bookingUid,
+        updates: bookingTimePatch
+      });
+    }
+    if (typeof this.store.order.addProductsToOrder === 'function') {
+      return this.store.order.addProductsToOrder(orderLines, {
+        skipEditDiscountConfigRefresh: true,
+        skipDiscountRecalculation: true
+      });
+    }
+    const result = [];
+    for (const line of orderLines) {
+      result.splice(0, result.length, ...(await this.addProductToOrder(line.product)));
+    }
+    return result;
+  }
+  async setOtherParams(params, {
+    cover = false
+  } = {}) {
+    super.setOtherParams(params, {
+      cover
+    });
+    if (params?.businessCode) {
+      await this.configureIdGeneratorFromOpenData();
+    }
+  }
+  getDeviceTaskPlugin() {
+    const app = this.core.getPlugin('app');
+    return app?.getApp()?.getPlugin('deviceTask') || null;
+  }
+
+  // 打印手环，单个或批量都可以
+  async handlePrintWristband(params) {
+    const deviceTask = this.getDeviceTaskPlugin();
+    if (!deviceTask?.dispatch) {
+      this.logger.addLog({
+        type: 'info',
+        title: '[BookingTicket] handlePrintWristband: deviceTask.dispatch 不可用',
+        metadata: {
+          voucher_ids: Array.isArray(params.voucher_ids) ? params.voucher_ids : [params.voucher_ids]
+        }
+      });
+      return;
+    }
+    this.logger.addLog({
+      type: 'info',
+      title: '[BookingTicket] handlePrintWristband',
+      metadata: {
+        voucher_ids: Array.isArray(params.voucher_ids) ? params.voucher_ids : [params.voucher_ids]
+      }
+    });
+    const deviceId = await this.getShortNumberOrDeviceId();
+    const idempotencyKey = (0, _utils.createUuidV4)();
+    deviceTask.dispatch({
+      action: 'print_all',
+      device_id: deviceId,
+      payload: {
+        type: 'WRISTBAND',
+        data: {
+          order_id: this.getOrderIdentity()?.orderId,
+          voucher_ids: Array.isArray(params.voucher_ids) ? params.voucher_ids : [params.voucher_ids]
+        }
+      },
+      idempotency_key: idempotencyKey,
+      name: 'PRINT_WRISTBAND',
+      source: 'bookingTicket',
+      source_type: 'handlePrintWristband',
+      source_id: idempotencyKey
+    });
+  }
+
+  // 触发核销
+  async handleRedeem(params) {
+    const voucherIds = Array.isArray(params.voucher_ids) ? params.voucher_ids : [];
+    const status = params.is_checkin ? 'used' : 'unused';
+    this.logger.addLog({
+      type: 'info',
+      title: '[BookingTicket] handleRedeem',
+      metadata: {
+        voucher_ids: voucherIds,
+        status
+      }
+    });
+    const voucherIdSet = new Set(voucherIds);
+    const tempOrder = this.store.order?.getTempOrder?.();
+    const vouchers = tempOrder?.vouchers || this.store.order?.getVouchers() || [];
+    let hasUpdatedVoucher = false;
+    const nextVouchers = vouchers.map(voucher => {
+      if (!voucherIdSet.has(voucher.voucher_id)) return voucher;
+      hasUpdatedVoucher = true;
+      return {
+        ...voucher,
+        status
+      };
+    });
+    if (tempOrder && hasUpdatedVoucher) {
+      await this.replaceTempOrder({
+        ...tempOrder,
+        vouchers: nextVouchers
+      });
+    }
+    this.core.effects.emit(`${this.name}:onVouchersChange`, {});
+    if (voucherIds.length === 0) {
+      return {
+        code: 200,
+        status: true,
+        message: '',
+        data: []
+      };
+    }
+    const identity = this.getOrderIdentity();
+    const externalSaleNumber = tempOrder?.external_sale_number || identity?.externalSaleNumber || undefined;
+    const orderId = tempOrder?.order_id ?? identity?.orderId ?? undefined;
+    const orderLookup = externalSaleNumber || orderId || identity?.orderNumber || identity?.shopOrderNumber || identity?.shopFullOrderNumber || undefined;
+    return this.request.post('/machinecode/batch', {
+      ids: voucherIds,
+      status,
+      order_lookup: orderLookup,
+      order_id: orderId,
+      external_sale_number: externalSaleNumber
+    }, {
+      osServer: true
+    });
   }
 
   /**
-   * 销毁模块
+   * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
+   * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。
    */
-  destroy() {
-    this.store.cart?.destroy();
-    this.store.products?.destroy();
-    this.store.accountList?.destroy();
-    this.store.customer?.destroy();
-    this.store.order?.destroy();
-    this.core.effects.offByModuleDestroy(this.name);
-    this.core.unregisterModule(this);
-    // 清除所有的监听
-    this.scan.removeAllListeners();
-    // 清除scan数据内存缓存
+  async destroy() {
+    await super.destroy();
+    try {
+      this.scan?.removeAllListeners();
+    } catch (error) {
+      console.warn('[BookingTicket] scan removeAllListeners 失败', error);
+    }
     _scanCache.default.clear();
   }
 }