@pisell/pisellos 2.2.171 → 2.2.172

package/lib/solution/BookingTicket/index.d.ts

@@ -1,10 +1,16 @@
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BookingTicketCartView, BookingTicketProductCatalogView, BookingTicketState, IGetCustomerListParams, ICustomer, ILoadProductsParams, ILoadProductDetailParams, IScanResult } from './types';
 import type { ProductData } from '../../modules';
+import { type BookingContextConfig, type BookingContextDateInput, type BookingContextResource, type BookingContextResourceMap, type BookingContextState, type InitBookingContextParams, type LoadBookingConfigParams, type LoadBookingResourcesParams, type ResourceError, type BookingCalcContext } from '../../modules/BookingContext';
 import type { OrderCustomerView } from '../../modules/Order/types';
 import { BaseSalesImpl } from '../BaseSales';
+import type { BaseSalesScanCodeResult } from '../BaseSales/types';
 import type { ISalesDetail } from '../BaseSales/utils/parseSalesResponse';
 import type { LoadSalesDetailParams } from '../../modules/Order/types';
+import { AddProductDecideContext, AddProductRequiresDetailPayload } from './utils/addProductDecision';
+import { type BuildCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildCacheItemFromOrderLine';
+import { type BuildNormalProductCacheItemFromOrderLineInput } from '../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine';
+import type { AddProductBookingInput, OrderProduct, OrderProductIdentity, UpdateOrderProductParams } from '../../modules/Order/types';
 export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -16,10 +22,14 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     private platform;
     private scan;
     private productCatalog;
+    private orderCustomerDiscountRefreshInFlight;
+    private orderCustomerDiscountRefreshCustomerId;
     /**
-     * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer。
+     * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
+     * bookingContext 是 SalesSdk 加车下沉所需的「预约 UI 上下文」（bookingConfig / resourcesOrigin / date）。
      */
     protected getRegisteredModuleNames(): readonly string[];
+    protected getSubmitOrderSalesChannel(): string;
     /**
      * 业务侧子模块工厂：BookingTicket 自带的 createBookingTicketModule 优先匹配；
      * 未识别的模块名（如 BookingByStep 公共类型）回退到父类工厂。
@@ -34,6 +44,14 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 让现有 setActiveCustomer / getActiveCustomer 调用方零成本拿到详情态客户。
      */
     loadSalesDetail(orderIdOrParams: number | string | LoadSalesDetailParams): Promise<ISalesDetail>;
+    scanPromotionCode(code: string, customerId?: number): Promise<BaseSalesScanCodeResult>;
+    private hydrateOrderCustomerFromScanDiscounts;
+    private getDiscountCustomerId;
+    private resolveCustomerByDiscountCustomerId;
+    private findCustomerById;
+    private normalizeCustomer;
+    private getRawCustomerId;
+    private hasUsableCustomerDetails;
     /**
      * 更新当前预约的 appointment_status。
      *
@@ -186,8 +204,19 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 清空下单客户（协议字段 + snapshot）。
      */
     clearOrderCustomer(): void;
+    /**
+     * 重置 tempOrder，并同步清空下单客户运行态。
+     *
+     * OrderModule.restoreOrder 会重建空单（customer_id 已为 null），但不会：
+     *  - emit BookingTicket `onOrderCustomerChange`
+     *  - 重置 CustomerModule.selectedCustomer（老路 getActiveCustomer）
+     *
+     * 因此在 super.restoreOrder 之后显式清客户，保证 SalesSdk / ticketBooking 订阅方与 tempOrder 一致。
+     */
+    restoreOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
     /** 内部：基于 OrderModule 当前状态构造一份 OrderCustomerChangePayload。 */
     private buildOrderCustomerPayload;
+    private refreshDiscountConfigAfterOrderCustomerChange;
     /**
      * 获取客户分页信息
      * @returns 分页信息
@@ -231,7 +260,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态
@@ -291,6 +320,109 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * @returns 其他参数
      */
     getOtherParams(): Promise<Record<string, any>>;
+    /** 拉取 board config 并写入 BookingContext。 */
+    loadBookingConfig(params?: LoadBookingConfigParams): Promise<BookingContextConfig | null>;
+    /** 拉取资源全集并写入 BookingContext。 */
+    loadBookingResources(params?: LoadBookingResourcesParams): Promise<BookingContextResource[]>;
+    /** 初始化 BookingContext（date + config + resources）。 */
+    initBookingContext(params?: InitBookingContextParams): Promise<BookingContextState>;
+    /** 当前 store 是否已具备与入参等价的 config / resources（无需再请求接口）。 */
+    isBookingContextReady(params?: InitBookingContextParams): boolean;
+    /** 写入 booking config（来源：`/core/board/management/config`）。 */
+    setBookingConfig(config: BookingContextConfig | null): void;
+    /** 读取当前 booking config。 */
+    getBookingConfig(): BookingContextConfig | null;
+    /** 写入资源全集（来源：`/form/schedule`），同步派生 resourcesOriginMap。 */
+    setResources(resources: BookingContextResource[] | null | undefined): void;
+    /** 读取资源全集（浅克隆）。 */
+    getResourcesOrigin(): BookingContextResource[];
+    /** 读取资源全集 map（id → resource）。 */
+    getResourcesOriginMap(): BookingContextResourceMap;
+    /** 写入当前选择的日期；支持 dayjs / Date / string。 */
+    setBookingDate(date: BookingContextDateInput): void;
+    /** 读取当前选择的日期（统一 string）。 */
+    getBookingDate(): string | null;
+    /** 读取 BookingContext 完整 store（调试 / 测试 / 透传给 SDK 使用）。 */
+    getBookingContextState(): BookingContextState;
+    /** 清空 BookingContext（切租户 / destroy 场景）。 */
+    clearBookingContext(): void;
+    /**
+     * 构造 BookingContext 计算上下文（供 getProductExtend / getResourceByIds 等读 API 复用）。
+     */
+    private buildBookingCalcContext;
+    /**
+     * 取商品当前可选资源列表（透传 OS BookingContext utils#getResourceByIds）。
+     * `extraResources` 用于把拖入未绑定的资源也展示出来。
+     */
+    getResourcesForProduct(product: any, options?: {
+        extraResources?: Array<{
+            form_id: number | string;
+            id: number;
+        }>;
+    }): any[];
+    /**
+     * 拼装 cacheItem 的 _extend / _data（资源 / 容量 / timeObj），与 info2 `getProductExtend` 等价。
+     */
+    getProductExtend(cacheItem: any, extra?: Partial<BookingCalcContext>): any;
+    /**
+     * 取资源不可用原因列表（结构化 enum + params，i18n 文案由 UI 渲染）。
+     */
+    getResourceErrors(resource: any, cacheItem: any): ResourceError[];
+    /**
+     * 拼装 addProductDecision 通用上下文（从 store 自取）。
+     */
+    private buildAddProductCtx;
+    /**
+     * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
+     * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
+     */
+    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
+    /** 规格弹窗 callback 后的第二段决策。 */
+    decideAfterDetail(cacheItem: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
+    /**
+     * @deprecated 请用 `decideAddProduct`；`autoClose=true` 仅当 action=add。
+     */
+    decideAutoClose(item: any, options?: Partial<AddProductDecideContext>): {
+        autoClose: boolean;
+        cacheItem?: any;
+    };
+    /** 替代 info2 `getIsEject`：商品是否需要弹窗（0/1）。 */
+    getIsEject(item: any, type?: 'select' | 'detail'): 0 | 1;
+    /** 仅 session 商品（无 variant/option/package）→ true。 */
+    getIsOnlySession(item: any): boolean;
+    /**
+     * 拼装 requiresDetail payload（给 SDK 直接 return 给 UI 用）。
+     */
+    buildRequiresDetailPayload(item: any, options?: Partial<AddProductDecideContext>): AddProductRequiresDetailPayload;
+    /**
+     * 把 detail 弹窗回调结果（e, extension_type, detail）转换为 `(product, booking)` 入参。
+     * 内部会先拼 cacheItem，再走 cacheItemToBookingInput 严格协议对齐。
+     */
+    transformDetailToProductAndBooking(input: {
+        item: any;
+        cacheItem?: any;
+        detailResult?: {
+            e: any;
+            extension_type?: any;
+            detail?: any;
+        };
+        options?: Partial<AddProductDecideContext>;
+    }): {
+        product: Partial<OrderProduct> & OrderProductIdentity;
+        booking?: AddProductBookingInput;
+        cacheItem: any;
+    };
+    /**
+     * 从已加车的 order line + booking 反查资源编辑抽屉所需的 cacheItem。
+     * 供 SalesSdk「编辑资源」等场景使用；字段语义与 buildCacheItemFromDetail 产出对齐。
+     */
+    buildCacheItemFromOrderLine(input: BuildCacheItemFromOrderLineInput): Record<string, any>;
+    /**
+     * 从已加车的普通商品 order line 反查 SkuDetailModal edit 所需的 cacheItem。
+     */
+    buildNormalProductCacheItemFromOrderLine(input: BuildNormalProductCacheItemFromOrderLineInput): Record<string, any>;
+    /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
+    updateProductInOrder(params: UpdateOrderProductParams): Promise<OrderProduct[]>;
     /**
      * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
      * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。

package/lib/solution/BookingTicket/index.js

@@ -35,12 +35,16 @@ __export(BookingTicket_exports, {
 });
 module.exports = __toCommonJS(BookingTicket_exports);
 var import_types = require("./types");
+var import_BookingContext = require("../../modules/BookingContext");
 var import_BaseSales = require("../BaseSales");
 var import_scan = __toESM(require("./utils/scan"));
 var import_orderCustomer = require("./utils/orderCustomer");
 var import_handleScan = require("./utils/scan/handleScan");
 var import_scanCache = __toESM(require("./utils/scan/scanCache"));
 var import_cartView = require("./utils/cartView");
+var import_addProductDecision = require("./utils/addProductDecision");
+var import_buildCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildCacheItemFromOrderLine");
+var import_buildNormalProductCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildNormalProductCacheItemFromOrderLine");
 var import_bookingStatus = require("./utils/bookingStatus");
 __reExport(BookingTicket_exports, require("./types"), module.exports);
 var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
@@ -54,12 +58,18 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
      */
     this.store = {};
     this.productCatalog = [];
+    this.orderCustomerDiscountRefreshInFlight = null;
+    this.orderCustomerDiscountRefreshCustomerId = null;
   }
   /**
-   * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer。
+   * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
+   * bookingContext 是 SalesSdk 加车下沉所需的「预约 UI 上下文」（bookingConfig / resourcesOrigin / date）。
    */
   getRegisteredModuleNames() {
-    return [...super.getRegisteredModuleNames(), "customer"];
+    return [...super.getRegisteredModuleNames(), "customer", "bookingContext"];
+  }
+  getSubmitOrderSalesChannel() {
+    return "pos";
   }
   /**
    * 业务侧子模块工厂：BookingTicket 自带的 createBookingTicketModule 优先匹配；
@@ -96,22 +106,110 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
     console.log(sales, "1234sales");
     const customerModule = this.store.customer;
     const detailCustomer = sales == null ? void 0 : sales.customer;
-    if (customerModule && detailCustomer) {
-      const { id: detailCustomerId, ...detailCustomerRest } = detailCustomer ?? {};
+    const orderCustomerSnapshot = this.store.order.getOrderCustomerSnapshot();
+    const protocolCustomerId = sales == null ? void 0 : sales.customer_id;
+    const protocolCustomer = protocolCustomerId !== void 0 && protocolCustomerId !== null ? {
+      id: protocolCustomerId,
+      name: String((sales == null ? void 0 : sales.customer_name) || ""),
+      phone: sales == null ? void 0 : sales.phone,
+      email: sales == null ? void 0 : sales.email,
+      country_calling_code: sales == null ? void 0 : 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: (detailCustomer == null ? void 0 : detailCustomer.name) ?? "",
-        phone: detailCustomer == null ? void 0 : detailCustomer.phone,
-        email: detailCustomer == null ? void 0 : detailCustomer.email,
-        country_calling_code: detailCustomer == null ? void 0 : detailCustomer.country_calling_code
+        name: (selectedCustomer == null ? void 0 : selectedCustomer.name) ?? "",
+        phone: selectedCustomer == null ? void 0 : selectedCustomer.phone,
+        email: selectedCustomer == null ? void 0 : selectedCustomer.email,
+        country_calling_code: selectedCustomer == null ? void 0 : 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);
+    if (raw.isAvailable) {
+      await this.hydrateOrderCustomerFromScanDiscounts(raw.scannedDiscountList);
+      await this.store.order.recalculateSummary({ createIfMissing: true });
+      this.store.order.persistTempOrder();
+    }
+    return {
+      isAvailable: raw.isAvailable,
+      type: raw.type,
+      unavailableReason: raw.unavailableReason
+    };
+  }
+  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) {
+    const discount = discounts.find((item) => item.customer_id != null);
+    const customerId = Number(discount == null ? void 0 : discount.customer_id);
+    if (!Number.isFinite(customerId) || customerId <= 0)
+      return null;
+    return customerId;
+  }
+  async resolveCustomerByDiscountCustomerId(customerId) {
+    var _a;
+    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 == null ? void 0 : result.list) || [], customerId) || ((_a = result == null ? void 0 : result.list) == null ? void 0 : _a[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。
    *
@@ -192,6 +290,10 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    */
   async loadProducts(params = {}, options) {
     const { schedule_date, customer_id, menu_list_ids, schedule_datetime } = params;
+    const bookingDate = schedule_datetime || schedule_date || "";
+    if (bookingDate) {
+      this.setBookingDate(bookingDate);
+    }
     try {
       const result = await this.store.products.loadProducts({
         with_count: ["bundleGroup", "optionGroup"],
@@ -388,6 +490,7 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
     this.store.order.setOrderCustomer(patch, customer);
     const next = this.buildOrderCustomerPayload();
     this.core.effects.emit(`${this.name}:onOrderCustomerChange`, next);
+    this.refreshDiscountConfigAfterOrderCustomerChange(patch.customer_id);
   }
   /**
    * 读取 tempOrder 上的下单客户协议字段；customer_id 缺失时返回 null。
@@ -405,9 +508,34 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
    * 清空下单客户（协议字段 + snapshot）。
    */
   clearOrderCustomer() {
+    var _a, _b;
     this.store.order.clearOrderCustomer();
+    const orderStore = this.store.order.store || {};
+    const discountModule = orderStore.discount;
+    void ((_a = discountModule == null ? void 0 : discountModule.setOriginalDiscountList) == null ? void 0 : _a.call(discountModule, []));
+    void ((_b = discountModule == null ? void 0 : discountModule.setDiscountList) == null ? void 0 : _b.call(discountModule, []));
+    this.store.order.applyDiscount();
+    void this.store.order.recalculateSummary({ createIfMissing: true }).then(() => this.store.order.persistTempOrder()).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() {
+    var _a;
+    const tempOrder = await super.restoreOrder();
+    this.clearOrderCustomer();
+    (_a = this.store.customer) == null ? void 0 : _a.setSelectedCustomer(null);
+    return tempOrder;
+  }
   /** 内部：基于 OrderModule 当前状态构造一份 OrderCustomerChangePayload。 */
   buildOrderCustomerPayload() {
     const patch = this.store.order.getOrderCustomer();
@@ -418,6 +546,34 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
       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(() => void 0);
+      }
+      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 分页信息
@@ -613,6 +769,183 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
   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 == null ? void 0 : extra.date) ?? state.date;
+    return {
+      bookingConfig: state.bookingConfig,
+      resourcesOrigin: state.resourcesOrigin,
+      resourcesOriginMap: state.resourcesOriginMap,
+      date,
+      presetStartTime: (extra == null ? void 0 : extra.presetStartTime) ?? (0, import_BookingContext.derivePresetStartTimeFromDate)(date),
+      ...extra || {}
+    };
+  }
+  /**
+   * 取商品当前可选资源列表（透传 OS BookingContext utils#getResourceByIds）。
+   * `extraResources` 用于把拖入未绑定的资源也展示出来。
+   */
+  getResourcesForProduct(product, options) {
+    var _a, _b;
+    const ctx = this.buildBookingCalcContext();
+    return (0, import_BookingContext.getResourceByIds)(ctx.resourcesOriginMap || {}, product, {
+      resourceTab: (_b = (_a = ctx.bookingConfig) == null ? void 0 : _a.config) == null ? void 0 : _b.resource_tab,
+      resourcesOrigin: ctx.resourcesOrigin,
+      extraResources: (options == null ? void 0 : options.extraResources) || []
+    });
+  }
+  /**
+   * 拼装 cacheItem 的 _extend / _data（资源 / 容量 / timeObj），与 info2 `getProductExtend` 等价。
+   */
+  getProductExtend(cacheItem, extra) {
+    return (0, import_BookingContext.getProductExtend)({
+      cacheItem,
+      ctx: this.buildBookingCalcContext(extra)
+    });
+  }
+  /**
+   * 取资源不可用原因列表（结构化 enum + params，i18n 文案由 UI 渲染）。
+   */
+  getResourceErrors(resource, cacheItem) {
+    return (0, import_BookingContext.getResourceErrors)(resource, cacheItem);
+  }
+  // ─── addProduct 决策 / 转换 API（SDK 加车下沉所需） ─────────────────────────
+  // 这一组方法是 SalesSdkCartContext.addProduct / confirmDetail 的 OS 后端。
+  // 调用方传入 ProductData，OS 自取 bookingContext / customer / date 等上下文，
+  // 输出 (a) autoClose 决策结果或 (b) `{ product, booking }` 协议入参。
+  /**
+   * 拼装 addProductDecision 通用上下文（从 store 自取）。
+   */
+  buildAddProductCtx(extra) {
+    var _a, _b;
+    const bookingContextState = this.store.bookingContext.getState();
+    const date = (extra == null ? void 0 : extra.date) ?? bookingContextState.date;
+    const orderCustomerId = ((_a = this.getOrderCustomerSnapshot()) == null ? void 0 : _a.id) ?? ((_b = this.store.order.getTempOrder()) == null ? void 0 : _b.customer_id) ?? void 0;
+    return {
+      bookingConfig: bookingContextState.bookingConfig,
+      resourcesOrigin: bookingContextState.resourcesOrigin,
+      resourcesOriginMap: bookingContextState.resourcesOriginMap,
+      date,
+      presetStartTime: (extra == null ? void 0 : extra.presetStartTime) ?? (0, import_BookingContext.derivePresetStartTimeFromDate)(date),
+      customerId: orderCustomerId,
+      ...extra || {}
+    };
+  }
+  /**
+   * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
+   * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
+   */
+  decideAddProduct(item, options) {
+    return (0, import_addProductDecision.decideAddProduct)(item, this.buildAddProductCtx(options));
+  }
+  /** 规格弹窗 callback 后的第二段决策。 */
+  decideAfterDetail(cacheItem, options) {
+    return (0, import_addProductDecision.decideAfterDetail)(cacheItem, this.buildAddProductCtx(options));
+  }
+  /**
+   * @deprecated 请用 `decideAddProduct`；`autoClose=true` 仅当 action=add。
+   */
+  decideAutoClose(item, options) {
+    return (0, import_addProductDecision.decideAutoClose)(item, this.buildAddProductCtx(options));
+  }
+  /** 替代 info2 `getIsEject`：商品是否需要弹窗（0/1）。 */
+  getIsEject(item, type = "select") {
+    return (0, import_addProductDecision.getIsEject)(item, type);
+  }
+  /** 仅 session 商品（无 variant/option/package）→ true。 */
+  getIsOnlySession(item) {
+    return (0, import_addProductDecision.getIsOnlySession)(item);
+  }
+  /**
+   * 拼装 requiresDetail payload（给 SDK 直接 return 给 UI 用）。
+   */
+  buildRequiresDetailPayload(item, options) {
+    return (0, import_addProductDecision.buildRequiresDetailPayload)(item, this.buildAddProductCtx(options));
+  }
+  /**
+   * 把 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, import_addProductDecision.buildCacheItemFromDetail)(item, detailResult, ctx) : (0, import_addProductDecision.buildCacheItemFromCartDetail)(item, ctx));
+    return (0, import_addProductDecision.transformDetailToProductAndBooking)(cacheItem, ctx);
+  }
+  /**
+   * 从已加车的 order line + booking 反查资源编辑抽屉所需的 cacheItem。
+   * 供 SalesSdk「编辑资源」等场景使用；字段语义与 buildCacheItemFromDetail 产出对齐。
+   */
+  buildCacheItemFromOrderLine(input) {
+    return (0, import_buildCacheItemFromOrderLine.buildCacheItemFromOrderLine)(input);
+  }
+  /**
+   * 从已加车的普通商品 order line 反查 SkuDetailModal edit 所需的 cacheItem。
+   */
+  buildNormalProductCacheItemFromOrderLine(input) {
+    return (0, import_buildNormalProductCacheItemFromOrderLine.buildNormalProductCacheItemFromOrderLine)(input);
+  }
+  /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
+  async updateProductInOrder(params) {
+    return this.updateOrderProduct(params);
+  }
   /**
    * 销毁模块：先调用父类（销毁所有 store 内子模块 + emit destroy + super.destroy()），
    * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。

package/lib/solution/BookingTicket/types.d.ts

@@ -1,4 +1,5 @@
 import { ProductList, OrderModule } from '../../modules';
+import { BookingContextModule } from '../../modules/BookingContext';
 import { CustomerModule } from '../../modules/Customer';
 import { SalesSummaryModule } from '../../modules/SalesSummary';
 import { ScheduleModule } from '../../modules/Schedule';
@@ -16,6 +17,7 @@ export interface BookingTicketState extends BaseSalesState {
     salesSummary: SalesSummaryModule;
     schedule: ScheduleModule;
     customer: CustomerModule;
+    bookingContext: BookingContextModule;
 }
 export declare function createBookingTicketModule<T extends keyof BookingTicketState>(moduleName: T, solutionName: string, name?: string, version?: string): BookingTicketState[T] | null;
 export declare enum BookingTicketHooks {

package/lib/solution/BookingTicket/types.js

@@ -24,6 +24,7 @@ __export(types_exports, {
 });
 module.exports = __toCommonJS(types_exports);
 var import_modules = require("../../modules");
+var import_BookingContext = require("../../modules/BookingContext");
 var import_Customer = require("../../modules/Customer");
 var import_SalesSummary = require("../../modules/SalesSummary");
 var import_Schedule = require("../../modules/Schedule");
@@ -54,6 +55,11 @@ function createBookingTicketModule(moduleName, solutionName, name, version) {
         `${solutionName}_${name || moduleName}`,
         version
       );
+    case "bookingContext":
+      return new import_BookingContext.BookingContextModule(
+        `${solutionName}_${name || moduleName}`,
+        version
+      );
     default:
       return null;
   }