@pisell/pisellos 2.2.147 → 2.2.149

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

@@ -1,13 +1,23 @@
-import { ProductList, CartModule, AccountListModule, OrderModule } from '../../modules';
+import { ProductList, OrderModule } from '../../modules';
 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;
 }
-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 +58,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 +72,17 @@ export interface ILoadProductsParams {
     menu_list_ids?: number[];
     /** 时间 格式：YYYY-MM-DD HH:mm:ss*/
     schedule_datetime?: string;
+    /** 关联统计字段 */
+    with_count?: string[];
+    /** 是否返回日程信息 */
+    with_schedule?: number;
+}
+/**
+ * 加载商品详情的参数
+ */
+export interface ILoadProductDetailParams extends Omit<ILoadProductsParams, 'product_ids'> {
+    /** 商品ID */
+    product_id: number;
 }
 /**
  * 扫描结果
@@ -66,3 +93,39 @@ export interface IScanResult {
     scanCode: string;
     result: any;
 }
+/**
+ * BookingTicket 面向 UI 的购物车行视图。
+ *
+ * tempOrder.products 仍保持 Sales checkout 协议结构；展示字段在 Solution 层合并后输出，
+ * 避免 UI 直接读取 booking/detail/catalog 等原始来源。
+ */
+export interface BookingTicketCartItemView extends BaseSalesOrderProduct {
+    /** UI 运行态扩展，不进入 tempOrder 提交协议。 */
+    _extend: {
+        booking: ISalesBooking | null;
+    };
+}
+/**
+ * BookingTicket 面向 UI 的购物车视图。
+ */
+export interface BookingTicketCartView {
+    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[];
+}

package/lib/solution/BookingTicket/types.js

@@ -20,40 +20,42 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var types_exports = {};
 __export(types_exports, {
   BookingTicketHooks: () => BookingTicketHooks,
-  createModule: () => createModule
+  createBookingTicketModule: () => createBookingTicketModule
 });
 module.exports = __toCommonJS(types_exports);
 var import_modules = require("../../modules");
 var import_Customer = require("../../modules/Customer");
-function createModule(moduleName, solutionName, name, version) {
+var import_SalesSummary = require("../../modules/SalesSummary");
+var import_Schedule = require("../../modules/Schedule");
+function createBookingTicketModule(moduleName, solutionName, name, version) {
   switch (moduleName) {
-    case "cart":
-      return new import_modules.CartModule(
+    case "products":
+      return new import_modules.ProductList(
         `${solutionName}_${name || moduleName}`,
         version
       );
-    case "products":
-      return new import_modules.ProductList(
+    case "order":
+      return new import_modules.OrderModule(
         `${solutionName}_${name || moduleName}`,
         version
       );
-    case "accountList":
-      return new import_modules.AccountListModule(
+    case "salesSummary":
+      return new import_SalesSummary.SalesSummaryModule(
         `${solutionName}_${name || moduleName}`,
         version
       );
-    case "customer":
-      return new import_Customer.CustomerModule(
+    case "schedule":
+      return new import_Schedule.ScheduleModule(
         `${solutionName}_${name || moduleName}`,
         version
       );
-    case "order":
-      return new import_modules.OrderModule(
+    case "customer":
+      return new import_Customer.CustomerModule(
         `${solutionName}_${name || moduleName}`,
         version
       );
     default:
-      throw new Error(`Unknown module type: ${moduleName}`);
+      return null;
   }
 }
 var BookingTicketHooks = /* @__PURE__ */ ((BookingTicketHooks2) => {
@@ -68,5 +70,5 @@ var BookingTicketHooks = /* @__PURE__ */ ((BookingTicketHooks2) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BookingTicketHooks,
-  createModule
+  createBookingTicketModule
 });

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

@@ -0,0 +1,37 @@
+/**
+ * BookingTicket - 预约状态相关纯函数。
+ *
+ * 该文件不持有任何运行时引用（无 request / store / effects），
+ * 只做字段解析与本地数组的原地写入/回滚，便于独立单测与未来其他
+ * booking 写操作（editBooking / cancelBooking 等）复用。
+ *
+ * 设计依据：参考 .cursor/rules/data-field-semantics.mdc，
+ * 字段含义严格对齐既有协议（OrderTempOrder / parseSalesResponse），
+ * 不发明等价关系。
+ */
+/**
+ * 从 tempOrder 解析用于调用 appointment-status 接口的 schedule id。
+ *
+ * 优先级：
+ *   1. `tempOrder.metadata.appointment_booking_parent_schedule_id`
+ *   2. `tempOrder.bookings` 中 `parent_id === 0` 的 `schedule_event_id`
+ *
+ * 都缺失时返回 null，由调用方决定如何抛错。
+ */
+export declare function resolveScheduleId(tempOrder: {
+    bookings?: any[];
+    metadata?: Record<string, any> | null;
+} | null | undefined): number | string | null;
+/**
+ * 原地把所有 bookings 的 `appointment_status` 覆盖为新值，
+ * 返回原 status 数组用于回滚（顺序与 bookings 一一对应）。
+ *
+ * - 元素为 null/undefined 时跳过写入（但占位仍保留以保证回滚下标对齐）
+ * - 不会克隆 booking 对象，保持与 OrderModule.tempOrder 引用一致
+ */
+export declare function applyBookingsStatus(bookings: any[] | null | undefined, status: string): Array<string | undefined>;
+/**
+ * 把 applyBookingsStatus 的返回值原地写回，撤销乐观更新。
+ * 长度不一致时按较短一方对齐（防御式编程，正常路径不会发生）。
+ */
+export declare function restoreBookingsStatus(bookings: any[] | null | undefined, previous: Array<string | undefined>): void;

package/lib/solution/BookingTicket/utils/bookingStatus.js

@@ -0,0 +1,65 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/solution/BookingTicket/utils/bookingStatus.ts
+var bookingStatus_exports = {};
+__export(bookingStatus_exports, {
+  applyBookingsStatus: () => applyBookingsStatus,
+  resolveScheduleId: () => resolveScheduleId,
+  restoreBookingsStatus: () => restoreBookingsStatus
+});
+module.exports = __toCommonJS(bookingStatus_exports);
+function resolveScheduleId(tempOrder) {
+  var _a;
+  if (!tempOrder)
+    return null;
+  const metaScheduleId = (_a = tempOrder.metadata) == null ? void 0 : _a.appointment_booking_parent_schedule_id;
+  if (metaScheduleId !== void 0 && metaScheduleId !== null) {
+    return metaScheduleId;
+  }
+  const bookings = Array.isArray(tempOrder.bookings) ? tempOrder.bookings : [];
+  const rootBooking = bookings.find((b) => (b == null ? void 0 : b.parent_id) === 0);
+  const fallback = rootBooking == null ? void 0 : rootBooking.schedule_event_id;
+  return fallback !== void 0 && fallback !== null ? fallback : null;
+}
+function applyBookingsStatus(bookings, status) {
+  if (!Array.isArray(bookings))
+    return [];
+  const previous = bookings.map((b) => b == null ? void 0 : b.appointment_status);
+  bookings.forEach((b) => {
+    if (b)
+      b.appointment_status = status;
+  });
+  return previous;
+}
+function restoreBookingsStatus(bookings, previous) {
+  if (!Array.isArray(bookings))
+    return;
+  const len = Math.min(bookings.length, previous.length);
+  for (let i = 0; i < len; i += 1) {
+    const b = bookings[i];
+    if (b)
+      b.appointment_status = previous[i];
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyBookingsStatus,
+  resolveScheduleId,
+  restoreBookingsStatus
+});

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

@@ -0,0 +1,26 @@
+import type { BaseSalesOrderProduct } from '../../BaseSales';
+import type { ISalesBooking } from '../../BaseSales/utils/parseSalesResponse';
+import type { ProductData } from '../../../modules/Product/types';
+import type { BookingTicketCartItemView, BookingTicketCustomerView, ICustomer } from '../types';
+import type { ScanOrderTempOrder } from '../../ScanOrder/types';
+/**
+ * 仅按 booking.product_uid 建索引，避免发明 booking 与商品行之间的其它等价关系。
+ */
+export declare function indexBookingsByProductUid(bookings: ISalesBooking[] | undefined | null): Record<string, ISalesBooking[]>;
+/**
+ * 合并购物车行展示字段。协议字段仍来自 tempOrder.products，
+ * 展示字段按 booking detail/product 优先，商品池 catalog 兜底。
+ */
+export declare function buildCartItemView(line: BaseSalesOrderProduct, ctx: {
+    bookingDetailMap?: Record<string, ISalesBooking[]>;
+    productsCatalog: ProductData[];
+}): BookingTicketCartItemView;
+export declare function buildCartItemViews(lines: BaseSalesOrderProduct[] | undefined | null, ctx: {
+    bookingDetailMap?: Record<string, ISalesBooking[]>;
+    productsCatalog: ProductData[];
+}): BookingTicketCartItemView[];
+export declare function isWalkInCustomer(customer: Pick<ICustomer, 'id'> | null | undefined): boolean;
+/**
+ * selected 优先，缺失时回退 tempOrder.customer_*，统一输出 UI 客户视图。
+ */
+export declare function buildCustomerView(selected: ICustomer | null | undefined, tempOrder: ScanOrderTempOrder | null | undefined): BookingTicketCustomerView | null;

package/lib/solution/BookingTicket/utils/cartView.js

@@ -0,0 +1,103 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/solution/BookingTicket/utils/cartView.ts
+var cartView_exports = {};
+__export(cartView_exports, {
+  buildCartItemView: () => buildCartItemView,
+  buildCartItemViews: () => buildCartItemViews,
+  buildCustomerView: () => buildCustomerView,
+  indexBookingsByProductUid: () => indexBookingsByProductUid,
+  isWalkInCustomer: () => isWalkInCustomer
+});
+module.exports = __toCommonJS(cartView_exports);
+function indexBookingsByProductUid(bookings) {
+  if (!Array.isArray(bookings) || bookings.length === 0)
+    return {};
+  return bookings.reduce((acc, booking) => {
+    const uid = booking == null ? void 0 : booking.product_uid;
+    if (uid === void 0 || uid === null || uid === "")
+      return acc;
+    const key = String(uid);
+    if (!acc[key])
+      acc[key] = [];
+    acc[key].push(booking);
+    return acc;
+  }, {});
+}
+function buildCartItemView(line, ctx) {
+  var _a, _b, _c;
+  const productUid = (_a = line.metadata) == null ? void 0 : _a.unique_identification_number;
+  const matched = productUid ? (_c = (_b = ctx.bookingDetailMap) == null ? void 0 : _b[String(productUid)]) == null ? void 0 : _c[0] : void 0;
+  return {
+    ...line,
+    _extend: {
+      booking: matched ?? null
+    }
+  };
+}
+function buildCartItemViews(lines, ctx) {
+  if (!Array.isArray(lines) || lines.length === 0)
+    return [];
+  return lines.map((line) => buildCartItemView(line, ctx));
+}
+function isWalkInCustomer(customer) {
+  if (!customer)
+    return true;
+  const id = customer.id;
+  if (id === void 0 || id === null)
+    return true;
+  if (typeof id === "string") {
+    return ["", "0", "1"].includes(id);
+  }
+  return [0, 1].includes(id);
+}
+function buildCustomerView(selected, tempOrder) {
+  if (selected && selected.id !== void 0 && selected.id !== null && selected.id !== "" && selected.id !== 0) {
+    return {
+      id: selected.id,
+      name: selected.name ?? "",
+      phone: selected.phone,
+      email: selected.email,
+      country_calling_code: selected.country_calling_code,
+      cover: selected.cover,
+      isWalkIn: isWalkInCustomer(selected)
+    };
+  }
+  if (tempOrder && (tempOrder.customer_id != null || tempOrder.customer_name)) {
+    const id = tempOrder.customer_id ?? "";
+    return {
+      id,
+      name: tempOrder.customer_name ?? "",
+      phone: tempOrder.phone,
+      email: tempOrder.email,
+      country_calling_code: tempOrder.country_calling_code,
+      cover: void 0,
+      isWalkIn: isWalkInCustomer({ id })
+    };
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildCartItemView,
+  buildCartItemViews,
+  buildCustomerView,
+  indexBookingsByProductUid,
+  isWalkInCustomer
+});

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

@@ -14,6 +14,7 @@ export * from './types';
  * - 基础生命周期占位
  *
  * 不提前实现 store 编排、初始化流程细节、状态计算逻辑。
+ * TIPS：这块应该改名叫 ReservationModule 更合适一些，目前这边只服务于 Reservation 的 floormap 展示。
  */
 export declare class SalesImpl extends BaseModule implements Module, SalesModuleAPI {
     protected defaultName: string;

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

@@ -0,0 +1,146 @@
+import { Module, ModuleOptions, PisellCore } from '../../types';
+import { BaseModule } from '../../modules/BaseModule';
+import { ScanOrderAddLogParams, ScanOrderAvailabilityInfo, ScanOrderOrderProduct, ScanOrderOrderProductIdentity, ScanOrderScanCodeResult } from './types';
+import type { UpdateProductInOrderParams } from '../../modules/Order/types';
+import type { Discount } from '../../modules/Discount/types';
+import { type CartItemSummary, type PaxInfo, type QuantityCheckResult, type QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
+import type { StrategyConfig } from '../../model/strategy/type';
+export * from './types';
+interface ScanOrderItemRuleRuntimeConfig {
+    strategyConfigs?: StrategyConfig[];
+    pax?: Partial<PaxInfo>;
+    historicalItems?: CartItemSummary[];
+    serviceType?: string;
+    submissionIndex?: number;
+    custom?: Record<string, any>;
+}
+export declare class ScanOrderImpl extends BaseModule implements Module {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    isSolution: boolean;
+    private initializeOptions;
+    private store;
+    private otherParams;
+    private cacheId;
+    private window;
+    private request;
+    private itemRuleEvaluator;
+    private itemRuleConfigs;
+    private itemRuleConfigsPromise;
+    private itemRulePrefillApplied;
+    private itemRuleRuntimeConfig;
+    /** 最近一次 checkResourceAvailable 从预约规则 link 拉取的商品快照 */
+    private enabledReservationRuleProducts;
+    private loginEffectDisposers;
+    private customerLoginRefreshInFlight;
+    private customerLoginRefreshIdInFlight;
+    private static readonly PISELL1_LOGIN_SUCCESS;
+    private getScanOrderLoggerContext;
+    private serializeError;
+    private addScanOrderLog;
+    private logMethodStart;
+    private logMethodSuccess;
+    private logMethodError;
+    addLog(params: ScanOrderAddLogParams): Promise<void>;
+    private normalizeCustomerId;
+    private resolveCustomerIdFromLoginPayload;
+    private clearLoginEffectListeners;
+    private registerLoginEffect;
+    private registerCustomerLoginListeners;
+    private refreshOrderMarketingAfterLogin;
+    constructor(name?: string, version?: string);
+    /** 与 `otherParams.cacheId` 一致，供宿主在 URL 变化时判断是否需要重新注册模块 */
+    getCacheId(): string | undefined;
+    private destroyRegisteredChildModules;
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    destroy(): Promise<void>;
+    retryInit(): Promise<void>;
+    refresh(): Promise<void>;
+    getStatus(): import("./types").ScanOrderStatus;
+    getEntryContext(): import("./types").ScanOrderEntryContext | null;
+    getConfig(): Record<string, any>;
+    getItemRuleQuantityLimits(): QuantityLimitResult[];
+    getCartValidationPassed(): boolean | null;
+    getCartValidation(): {
+        passed: boolean | null;
+        failures: QuantityCheckResult[];
+    };
+    getTempOrder(): import("../../modules/Order/types").OrderTempOrder | null;
+    updateTempOrderNote(note: string): string;
+    setPickupReferenceMode(mode: 'counter_pickup' | 'table_service'): {
+        service_type: 'dine_in';
+        pickup_reference_mode: 'counter_pickup' | 'table_service';
+    };
+    setPickupRef(buzzer: string): string;
+    private ensureTempOrder;
+    addNewOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
+    restoreOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
+    getOrderProducts(): import("../../modules/Order/types").OrderProduct[];
+    getSummary(): Promise<import("../../modules/Order/types").OrderSummary>;
+    getDiscountList(): Discount[];
+    scanCode(code: string, customerId?: number): Promise<ScanOrderScanCodeResult>;
+    setDiscountSelected(params: {
+        discountId: number;
+        isSelected: boolean;
+    }): Promise<void>;
+    onCustomerLogin(params: {
+        customerId: number;
+    }): Promise<void>;
+    private buildSubmitPayloadEnhancer;
+    submitScanOrder<T = any>(): Promise<T>;
+    addProductToOrder(product: Partial<ScanOrderOrderProduct> & ScanOrderOrderProductIdentity): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    updateProductInOrder(params: UpdateProductInOrderParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    /**
+     * 设置单行商品备注（与整单 `updateTempOrderNote` 区分）。
+     * 多行同 SKU 时必须传入与删除/更新一致的 identity（如 `identity_key`）。
+     */
+    setOrderProductLineNote(identity: ScanOrderOrderProductIdentity, note: string): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductFromOrder(identity: ScanOrderOrderProductIdentity): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    private loadRuntimeConfigs;
+    private syncItemRuleConfigsFromDineInConfig;
+    private fetchItemRuleConfigsByModelIds;
+    private buildPrefillProductSourceMap;
+    private getItemRuleRuntimeConfig;
+    private ensureItemRuleConfigsLoaded;
+    private refreshItemRuleQuantityLimits;
+    private applyPrefillByItemRule;
+    applyItemRulePrefill(): Promise<void>;
+    private evaluateCartValidationByItemRule;
+    private validateBeforeSubmitByItemRule;
+    private refreshCartValidationPassed;
+    setItemRuleRuntimeConfig(config?: ScanOrderItemRuleRuntimeConfig): Promise<void>;
+    private normalizeResourceState;
+    private resolveResourceSelectType;
+    private fetchResourceOccupyDetailByResourceId;
+    checkResourceAvailable(resourceId: string, hasOrderId: boolean): Promise<ScanOrderAvailabilityInfo>;
+    getAdditionalOrderInfo(): Promise<{
+        orderId: string;
+        orderStatus: 'pending' | 'processing' | 'completed' | 'cancelled';
+        orderTime: string;
+        orderAmount: number;
+        orderItems: any[];
+    }>;
+    getProductList(): Promise<any>;
+    getOtherParams(): Record<string, any>;
+    setOtherParams(params: Record<string, any>, { cover }?: {
+        cover?: boolean;
+    }): Promise<void>;
+    private static readonly UI_STATE_KEY_PREFIX;
+    private getUIStateBucketKey;
+    private readUIStateBucket;
+    private writeUIStateBucket;
+    setUIState(key: string, value: any): void;
+    getUIState<T = any>(key: string): T | undefined;
+    deleteUIState(key: string): void;
+    clearUIState(): void;
+    setEntryPaxNumber(number: number): Promise<void>;
+    getEntryPaxNumber(): number | null;
+    getFulfillmentModes(): {
+        enablePickup: boolean;
+        enableTableService: boolean;
+    };
+    checkManualPickupRef(): {
+        enabled: boolean;
+        manualInputType?: string;
+    };
+}