@pisell/pisellos 0.0.568 → 0.0.570

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

@@ -1,13 +1,26 @@
-import { ProductList, CartModule, AccountListModule, OrderModule } from '../../modules';
+import { ProductList, OrderModule, OpenDataModule } from '../../modules';
+import { BookingContextModule } from '../../modules/BookingContext';
 import { CustomerModule } from '../../modules/Customer';
-export interface BookingTicketState {
-    cart: CartModule;
+import { SalesSummaryModule } from '../../modules/SalesSummary';
+import { ScheduleModule } from '../../modules/Schedule';
+import type { BaseSalesState } from '../BaseSales';
+import type { BaseSalesOrderProduct } from '../BaseSales';
+import type { ISalesBooking } from '../BaseSales/utils/parseSalesResponse';
+import type { ProductData } from '../../modules/Product/types';
+/**
+ * BookingTicket 子模块清单：在 BaseSales 自带的 products/order/salesSummary/schedule 之上
+ * 追加业务向的 customer 模块；不再注册 cart/accountList（无外部消费）。
+ */
+export interface BookingTicketState extends BaseSalesState {
     products: ProductList;
-    accountList: AccountListModule;
-    customer: CustomerModule;
     order: OrderModule;
+    salesSummary: SalesSummaryModule;
+    schedule: ScheduleModule;
+    customer: CustomerModule;
+    bookingContext: BookingContextModule;
+    openData: OpenDataModule;
 }
-export declare function createModule<T extends keyof BookingTicketState>(moduleName: T, solutionName: string, name?: string, version?: string): BookingTicketState[T];
+export declare function createBookingTicketModule<T extends keyof BookingTicketState>(moduleName: T, solutionName: string, name?: string, version?: string): BookingTicketState[T] | null;
 export declare enum BookingTicketHooks {
     onInited = "bookingTicket:onInited",
     onDestroy = "bookingTicket:onDestroy",
@@ -48,6 +61,12 @@ export interface ICustomer {
  * 加载商品列表的参数
  */
 export interface ILoadProductsParams {
+    /** 商品分类ID */
+    category_ids?: number[];
+    /** 商品ID */
+    product_ids?: number[];
+    /** 商品集合ID */
+    collection?: number | string[];
     /** 日期 格式：YYYY-MM-DD */
     schedule_date?: string;
     /** 客户ID */
@@ -56,6 +75,23 @@ export interface ILoadProductsParams {
     menu_list_ids?: number[];
     /** 时间 格式：YYYY-MM-DD HH:mm:ss*/
     schedule_datetime?: string;
+    /** 关联统计字段 */
+    with_count?: string[];
+    /** 是否返回日程信息 */
+    with_schedule?: number;
+    /** 扩展商品类型过滤 */
+    extension_type?: string[];
+    /** 商品发布状态 */
+    status?: string;
+    /** 智能定价条件上下文，仅影响策略命中，不参与商品集合筛选 */
+    strategy_context?: Record<string, any>;
+}
+/**
+ * 加载商品详情的参数
+ */
+export interface ILoadProductDetailParams extends Omit<ILoadProductsParams, 'product_ids'> {
+    /** 商品ID */
+    product_id: number;
 }
 /**
  * 扫描结果
@@ -66,3 +102,152 @@ export interface IScanResult {
     scanCode: string;
     result: any;
 }
+/**
+ * BookingTicket 面向 UI 的购物车商品行视图。
+ *
+ * 直接透传 tempOrder.products 协议行，不做 Solution 层 enrichment。
+ */
+export declare type BookingTicketCartItemView = BaseSalesOrderProduct;
+/**
+ * BookingTicket 面向 UI 的 booking 行视图（平铺，附带关联商品）。
+ */
+export interface BookingTicketCartBookingView extends ISalesBooking {
+    _extend: {
+        product: BookingTicketCartItemView | null;
+        addTimeProduct: BookingTicketCartItemView[];
+        canAddTime: boolean;
+    };
+}
+/**
+ * BookingTicket 面向 UI 的购物车视图。
+ */
+export interface BookingTicketCartView {
+    bookings: BookingTicketCartBookingView[];
+    items: BookingTicketCartItemView[];
+}
+/**
+ * BookingTicket 面向 UI 的客户展示视图。
+ */
+export interface BookingTicketCustomerView {
+    id: number | string;
+    name: string;
+    phone?: string;
+    email?: string;
+    country_calling_code?: string;
+    cover?: string;
+    isWalkIn: boolean;
+}
+/**
+ * BookingTicket 当前已加载的商品池视图。
+ */
+export interface BookingTicketProductCatalogView {
+    products: ProductData[];
+}
+/**
+ * 添加加时商品到已有 booking 的输入。
+ *
+ * @example
+ * await bookingTicket.addAddTimeProductToBooking({
+ *   booking,
+ *   product,
+ *   num: 1,
+ *   price: '10.00',
+ *   product_add_schedule_time: 30,
+ * });
+ */
+export interface AddAddTimeProductToBookingInput {
+    /** 当前购物车中已存在的 booking，必须带 metadata.unique_identification_number。 */
+    booking: Record<string, any>;
+    /** 加时商品原始数据，保留完整商品信息供 OrderModule 缓存原始快照。 */
+    product: ProductData & Record<string, any>;
+    /** 本次添加数量，缺省为 1。 */
+    num?: number;
+    /** 本次加时商品价格，缺省回退 product.price。 */
+    price?: number | string;
+    /** 加时时长，单位分钟；最终写入 product.metadata.product_add_schedule_time。 */
+    product_add_schedule_time?: number;
+    /** 本次加时方案实际覆盖分钟数，用于同步更新 booking 结束时间与 duration。 */
+    coveredMinutes?: number;
+    /** 直接写入 booking 的时间补丁，restart 场景使用。 */
+    bookingPatch?: {
+        start_date?: string;
+        start_time?: string;
+        end_date?: string;
+        end_time?: string;
+        duration?: number;
+    };
+}
+/**
+ * 批量添加加时商品到已有 booking 的单行输入。
+ *
+ * @example
+ * const line: AddAddTimeProductLineInput = { product, product_add_schedule_time: 30 };
+ */
+export declare type AddAddTimeProductLineInput = Omit<AddAddTimeProductToBookingInput, 'booking' | 'coveredMinutes'>;
+/**
+ * 批量添加加时商品到已有 booking 的输入。
+ *
+ * @example
+ * await bookingTicket.addAddTimeProductsToBooking({
+ *   booking,
+ *   products: [{ product, product_add_schedule_time: 30 }],
+ * });
+ */
+export interface AddAddTimeProductsToBookingInput {
+    /** 当前购物车中已存在的 booking，必须带 metadata.unique_identification_number。 */
+    booking: Record<string, any>;
+    /** 需要一次性写入购物车的加时商品行。 */
+    products: AddAddTimeProductLineInput[];
+    /** 本次加时方案实际覆盖分钟数，用于同步更新 booking 结束时间与 duration。 */
+    coveredMinutes?: number;
+    /** 直接写入 booking 的时间补丁，restart 场景使用。 */
+    bookingPatch?: AddAddTimeProductToBookingInput['bookingPatch'];
+}
+/** 扫码宿主桥接：SalesSdk 在 pubsub 订阅回调里注入，OS 需要 UI 时直接调用 */
+export interface GlobalScanHostBridge {
+    openProductDetail?: (payload: Record<string, any>) => Promise<any | null>;
+    openBookingEdit?: (payload: Record<string, any>) => Promise<any | null>;
+    confirmDetail?: (input: {
+        item: any;
+        detailResult: {
+            e: any;
+            extension_type?: any;
+            detail?: any;
+        };
+        options?: Record<string, any>;
+    }) => Promise<any>;
+    confirmBookingEdit?: (input: {
+        cacheItem: any;
+        options?: Record<string, any>;
+    }) => Promise<any>;
+    openOrder?: (data: {
+        order_id: number;
+        business_code?: string;
+    }) => void;
+    /**
+     * walk-in 扫 walletPass：直接核销优惠码（对齐 SaleDetail Voucher.handleApplyCode / cart.scanCode）。
+     */
+    applyPromotionCode?: (code: string, customerId?: number) => Promise<{
+        isAvailable?: boolean;
+        type?: string;
+        unavailableReason?: string;
+    }>;
+    onNotify?: (type: 'success' | 'fail' | 'info', messageKey?: string) => void;
+    refresh?: () => void;
+}
+/** handleGlobalScanCode 结构化返回 */
+export declare type GlobalScanHandleResult = {
+    status: 'success';
+    kind: 'customer' | 'products' | 'promotion';
+    meta?: {
+        count?: number;
+    };
+} | {
+    status: 'pending';
+    kind: 'openOrder' | 'requiresDetail' | 'requiresBookingEdit';
+} | {
+    status: 'cancelled';
+} | {
+    status: 'failed';
+    reason: 'empty_code' | 'not_found' | 'invalid_data' | 'no_bridge';
+};

package/lib/solution/BookingTicket/types.js

@@ -4,23 +4,35 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.BookingTicketHooks = void 0;
-exports.createModule = createModule;
+exports.createBookingTicketModule = createBookingTicketModule;
 var _modules = require("../../modules");
+var _BookingContext = require("../../modules/BookingContext");
 var _Customer = require("../../modules/Customer");
-function createModule(moduleName, solutionName, name, version) {
+var _SalesSummary = require("../../modules/SalesSummary");
+var _Schedule = require("../../modules/Schedule");
+/**
+ * BookingTicket 子模块清单：在 BaseSales 自带的 products/order/salesSummary/schedule 之上
+ * 追加业务向的 customer 模块；不再注册 cart/accountList（无外部消费）。
+ */
+
+function createBookingTicketModule(moduleName, solutionName, name, version) {
   switch (moduleName) {
-    case 'cart':
-      return new _modules.CartModule(`${solutionName}_${name || moduleName}`, version);
     case 'products':
       return new _modules.ProductList(`${solutionName}_${name || moduleName}`, version);
-    case 'accountList':
-      return new _modules.AccountListModule(`${solutionName}_${name || moduleName}`, version);
-    case 'customer':
-      return new _Customer.CustomerModule(`${solutionName}_${name || moduleName}`, version);
     case 'order':
       return new _modules.OrderModule(`${solutionName}_${name || moduleName}`, version);
+    case 'salesSummary':
+      return new _SalesSummary.SalesSummaryModule(`${solutionName}_${name || moduleName}`, version);
+    case 'schedule':
+      return new _Schedule.ScheduleModule(`${solutionName}_${name || moduleName}`, version);
+    case 'customer':
+      return new _Customer.CustomerModule(`${solutionName}_${name || moduleName}`, version);
+    case 'bookingContext':
+      return new _BookingContext.BookingContextModule(`${solutionName}_${name || moduleName}`, version);
+    case 'openData':
+      return new _modules.OpenDataModule(`${solutionName}_${name || moduleName}`, version);
     default:
-      throw new Error(`Unknown module type: ${moduleName}`);
+      return null;
   }
 }
 let BookingTicketHooks = exports.BookingTicketHooks = /*#__PURE__*/function (BookingTicketHooks) {
@@ -41,6 +53,55 @@ let BookingTicketHooks = exports.BookingTicketHooks = /*#__PURE__*/function (Boo
 /**
  * 加载商品列表的参数
  */
+/**
+ * 加载商品详情的参数
+ */
 /**
  * 扫描结果
- */
+ */
+/**
+ * BookingTicket 面向 UI 的购物车商品行视图。
+ *
+ * 直接透传 tempOrder.products 协议行，不做 Solution 层 enrichment。
+ */
+/**
+ * BookingTicket 面向 UI 的 booking 行视图（平铺，附带关联商品）。
+ */
+/**
+ * BookingTicket 面向 UI 的购物车视图。
+ */
+/**
+ * BookingTicket 面向 UI 的客户展示视图。
+ */
+/**
+ * BookingTicket 当前已加载的商品池视图。
+ */
+/**
+ * 添加加时商品到已有 booking 的输入。
+ *
+ * @example
+ * await bookingTicket.addAddTimeProductToBooking({
+ *   booking,
+ *   product,
+ *   num: 1,
+ *   price: '10.00',
+ *   product_add_schedule_time: 30,
+ * });
+ */
+/**
+ * 批量添加加时商品到已有 booking 的单行输入。
+ *
+ * @example
+ * const line: AddAddTimeProductLineInput = { product, product_add_schedule_time: 30 };
+ */
+/**
+ * 批量添加加时商品到已有 booking 的输入。
+ *
+ * @example
+ * await bookingTicket.addAddTimeProductsToBooking({
+ *   booking,
+ *   products: [{ product, product_add_schedule_time: 30 }],
+ * });
+ */
+/** 扫码宿主桥接：SalesSdk 在 pubsub 订阅回调里注入，OS 需要 UI 时直接调用 */
+/** handleGlobalScanCode 结构化返回 */

package/lib/solution/BookingTicket/utils/addProductDecision.d.ts

@@ -0,0 +1,117 @@
+import { BookingCalcContext } from '../../../modules/BookingContext';
+import type { ProductData } from '../../../modules/Product/types';
+import type { OrderProduct, OrderProductIdentity, AddProductBookingInput } from '../../../modules/Order/types';
+/**
+ * cart.addProduct 两阶段决策（与 ticketBooking `handleSelectProduct` 对齐）：
+ *
+ * 1. `requiresDetail`：规格 / SKU / 套餐 / Session / 称重弹窗（门禁：`isOpenDetailModal` / `cartDetailValue` / `open_sold_weight`）
+ * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（门禁：`getIsAutoClose` on prepared cacheItem）
+ * 3. `add`：两关均通过，直接 transform + 加车
+ */
+export declare type AddProductDecision = {
+    action: 'add';
+    cacheItem: any;
+} | {
+    action: 'requiresDetail';
+    payload: AddProductRequiresDetailPayload;
+} | {
+    action: 'requiresBookingEdit';
+    cacheItem: any;
+    payload: AddProductRequiresBookingEditPayload;
+}
+/** session 商品 catalog 日期与 TimeBar 不一致，需 reload products 后由用户重试加购。 */
+ | {
+    action: 'reloadCatalog';
+};
+/** 资源 / 时间编辑抽屉所需的最小 payload。 */
+export interface AddProductRequiresBookingEditPayload {
+    cacheItem: any;
+    customerId?: number | string;
+    date: string | null;
+}
+/**
+ * 加车主决策：对齐 `handleSelectProduct` 两段分支。
+ */
+export declare function decideAddProduct(item: any, ctx?: AddProductDecideContext): AddProductDecision;
+/**
+ * 规格弹窗 callback 后的第二段决策（对齐 `handleBooking4Service` 内 `cacheItem.autoClose` 分支）。
+ */
+export declare function decideAfterDetail(cacheItem: any, ctx?: AddProductDecideContext): AddProductDecision;
+/**
+ * @deprecated 请用 `decideAddProduct`；保留兼容：autoClose=true 仅表示可直接加车（action=add）。
+ */
+export interface AddProductRequiresDetailPayload {
+    item: ProductData | Record<string, any>;
+    /** UI 需展示的子弹窗开关。 */
+    showConfig: {
+        option: boolean;
+        session: boolean;
+        variant: boolean;
+        package: boolean;
+        number: boolean;
+    };
+    /** 仅 session 商品（且无 variant/option/package）→ true，UI 可只渲染 session 选择。 */
+    isOnlySession: boolean;
+    /** 0/1，与 info2 `getIsEject` 等价含义。 */
+    isEject: 0 | 1;
+    /** 当前选中客户 id（透传给 detail 弹窗用）。 */
+    customerId?: number | string;
+    /** 当前选择的日期。 */
+    date: string | null;
+    /** 透传完整商品数据，UI 渲染时直接用。 */
+    productData: ProductData | Record<string, any>;
+}
+export interface AddProductDecideContext extends BookingCalcContext {
+    type?: 'select' | 'detail';
+    quantity?: number;
+    customerId?: number | string;
+}
+/**
+ * 统一补齐预约商品的运行态字段。
+ *
+ * 新链路不再让决策和提交各自重建 cacheItem；这里作为唯一入口补齐
+ * `_extend.resource / capacity / startDate / endDate` 等后续 booking mapper 需要的字段。
+ */
+export declare function prepareBookingCacheItem(cacheItem: any, ctx?: AddProductDecideContext): any;
+export declare function decideAutoClose(item: any, ctx?: AddProductDecideContext): {
+    autoClose: boolean;
+    cacheItem?: any;
+};
+/**
+ * 替代 info2 `getIsEject`：商品是否需要弹窗（含 type='detail' / option_group / bundle_group / variant / session / sold_by_weight）。
+ */
+export declare function getIsEject(item: any, type?: 'select' | 'detail'): 0 | 1;
+/** 仅 session 商品（且没有 variant/option/package）。 */
+export declare function getIsOnlySession(item: any): boolean;
+/**
+ * 拼装 requiresDetail payload；showConfig 与 info2 弹窗内部判断一致。
+ */
+export declare function buildRequiresDetailPayload(item: any, ctx?: AddProductDecideContext): AddProductRequiresDetailPayload;
+/**
+ * 用 item.cartDetailValue 拼装一个 cacheItem 雏形（与 info2 `handleDirectAddService` 等价路径）。
+ * 这里只补 `_extend.start_date / quantity / other` 等运行态字段；后续走 getProductExtend 才会补齐资源 / 时间。
+ */
+export declare function buildCacheItemFromCartDetail(item: any, ctx?: AddProductDecideContext): any;
+/**
+ * 用 Info2 callback 的 (e, extension_type, detail) 拼装 cacheItem。
+ *
+ * 保留 detail._extend 中的 pricing / note（规格弹窗改价、备注等），
+ * 再叠加 session 时间、ctx.quantity 等运行态字段；other 以 callback `e` 为准。
+ */
+export declare function buildCacheItemFromDetail(item: any, detailResult: {
+    e: any;
+    extension_type?: any;
+    detail?: any;
+}, ctx?: AddProductDecideContext): any;
+/**
+ * `transformDetailToProductAndBooking`：把 cacheItem 拆成 OS `addProductToOrder` 所需的 `(product, booking)`。
+ *
+ * - `product` 走 `transformBaseProductToOrderProduct`（沿用 BaseSales 现有 mapper）。
+ * - `booking` 走 `cacheItemToBookingInput`（严格按 TEMP_ORDER_FIELDS_SUMMARY.md 协议）。
+ * - 普通商品（无 duration / 无 schedules）不产 booking，与 info2 一致。
+ */
+export declare function transformDetailToProductAndBooking(cacheItem: any, ctx?: AddProductDecideContext): {
+    product: Partial<OrderProduct> & OrderProductIdentity;
+    booking?: AddProductBookingInput;
+    cacheItem: any;
+};