@pisell/pisellos 2.2.264 → 2.2.266

package/dist/server/modules/products/types.d.ts

@@ -28,6 +28,10 @@ export interface ProductIdScope {
     /** 指定商品集合 ID */
     collectionIds?: number[];
 }
+export interface ProductSnapshot {
+    cover?: ProductData['cover'];
+    holder_config?: ProductData['holder_config'];
+}
 /**
  * 加载报价单商品价格参数
  */
@@ -110,6 +114,8 @@ export interface ProductSyncMessage {
     change_types?: string[];
     /** 关联商品 ID（product_collection / product_category / product_quotation 变更时携带） */
     relation_product_ids?: number[];
+    /** 关联商品 ID（product_data_variant 变更时携带） */
+    product_ids?: number[];
     message_uuid?: string;
     timestamp?: string;
     /** 内部标记：来源频道 key */
@@ -124,6 +130,18 @@ export interface ProductFormatterContext {
     customer_id?: number | string;
     priceData?: LoadProductsPriceData[];
     scheduleModule?: any;
+    /** 全量餐牌列表，供智能定价 menu_match 等条件判断使用 */
+    menuList?: any[];
+    /** 全量日程列表，供智能定价 schedule_match 等条件判断使用 */
+    scheduleList?: any[];
+    /** 外部传入的策略上下文，仅承载定价条件，不参与商品集合筛选 */
+    strategy_context?: Record<string, any>;
+    /** 智能定价评估器，由宿主统一注入到 PisellOS context */
+    dataVariantEvaluator?: {
+        resolveProducts: (businessData: any) => {
+            products: ProductData[];
+        };
+    };
     locale?: string;
 }
 /**

package/dist/solution/BaseSales/index.d.ts

@@ -2,7 +2,7 @@ import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
 import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult } from './types';
 import { OrderModule } from '../../modules/Order';
-import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from '../../modules/Order/types';
+import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
@@ -24,6 +24,19 @@ export interface BaseSalesState {
     schedule?: ScheduleModule;
     quotation?: QuotationModule;
 }
+export interface BaseSalesUpdateOrderPaymentOptions extends OrderPaymentUpdateOptions {
+    persistDraft?: boolean;
+    submitWhenPaid?: boolean;
+    forceSubmitIfPaid?: boolean;
+    /** 草稿恢复时，允许将新回调字段合并进已 paid 的支付项。 */
+    applyUpdatesWhenPaid?: boolean;
+    smallTicketDataFlag?: number;
+}
+export interface BaseSalesUpdateOrderPaymentResult extends OrderPaymentUpdateResult {
+    draftResult?: unknown;
+    draftError?: unknown;
+    syncResult?: SyncPaymentsToOrderResult<any>;
+}
 export type BaseSalesPrintLocalOrderReceiptParams = string | number;
 export declare class BaseSalesImpl extends BaseModule implements Module {
     protected defaultName: string;
@@ -35,6 +48,11 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     protected store: BaseSalesState;
     protected otherParams: Record<string, any>;
     protected cacheId: string | undefined;
+    /**
+     * 由已在初始化阶段解析过设备短号的业务解决方案写入。
+     * 未设置时，支付编号仍按原逻辑实时读取设备信息。
+     */
+    protected paymentNumberDevicePrefix: string | null;
     /**
      * window / request 暴露为 public：现存外部工具（如 BookingTicket Scan）通过
      * `solution.window` / `solution.request` 直接访问插件，保持原有契约不破坏。
@@ -49,9 +67,13 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private queuedAutoPaymentSync;
     private autoPaymentSyncFlushing;
     private autoPaymentSyncTimer;
-    private salesDetailLoadInFlight;
+    private salesDetailLoadInFlightCount;
+    private salesDetailLoadSequence;
+    private salesDetailHydrateQueue;
     private serverOrderChangeUnsubscribe;
     private serverOrderChangeHydrateInFlight;
+    private queuedServerOrderChanges;
+    private serverOrderChangeSyncEnabled;
     constructor(name?: string, version?: string);
     /**
      * 子类可覆盖此方法以追加/收敛要注册的子模块。
@@ -73,8 +95,12 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      */
     private logError;
     private isCurrentSalesOrderRecord;
+    setServerOrderChangeSyncEnabled(enabled: boolean): void;
+    private queueLatestServerOrderChange;
+    private drainQueuedServerOrderChanges;
     private syncCurrentSalesDetailFromServerOrderChange;
     private registerServerOrderChangeSync;
+    private hydrateLatestLoadedSalesDetail;
     private hydrateOrderPaymentNames;
     get payment(): PaymentModule | undefined;
     private getCurrentOrderCustomerId;
@@ -120,6 +146,13 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      */
     protected readSessionCacheData(): Record<string, any>;
     protected getAppData<T>(key: string): T | undefined;
+    /**
+     * 复用业务解决方案初始化时已解析的支付设备短号。
+     * 空值会清除缓存，使后续支付恢复实时读取设备信息的兼容路径。
+     */
+    protected setPaymentNumberDevicePrefix(prefix: unknown): void;
+    private getPaymentNumberDevicePrefixSync;
+    private getPaymentNumberDevicePrefixAsync;
     private syncAppDataToTempOrder;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     destroy(): Promise<void>;
@@ -185,12 +218,24 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     }): Promise<{
         productList: Record<string, any>[];
         discountList: Discount[];
+        availableWalletIds: number[];
     }>;
+    getAvailableWalletIds(): number[];
     bestDiscount(cb?: (result: any) => void): Promise<{
         productList: Record<string, any>[];
         discountList: Discount[];
     }>;
     getDiscountList(): Discount[];
+    /** 读取 Discount 模块原始券列表（未经过 bookingTime 等过滤）。 */
+    getOriginalDiscountList(): Discount[];
+    /**
+     * 同步写入 Discount 模块的 discountList / originalDiscountList。
+     * 供 Holder 补全等场景在 OS store 层更新 machinecode holder 字段。
+     */
+    replaceDiscountStoreLists(params: {
+        discountList: Discount[];
+        originalDiscountList?: Discount[];
+    }): Promise<void>;
     scanPromotionCode(code: string, customerId?: number): Promise<BaseSalesScanCodeResult>;
     setDiscountSelected(params: {
         discountId: number;
@@ -220,6 +265,13 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         confirmPendingVoucherPayments?: boolean;
         enhancePayload?: SubmitPayloadEnhancer;
     }): Promise<T>;
+    saveSalesOrderDraft<T = any>(params?: {
+        platform?: string;
+        businessCode?: string;
+        channel?: string;
+        type?: string;
+        enhancePayload?: SubmitPayloadEnhancer;
+    }): Promise<T>;
     submitTempOrderAsync<T = any>(params?: {
         payments?: OrderPaymentSource[];
         paymentStatus?: BaseSalesPaymentStatus;
@@ -238,16 +290,27 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private queueLatestAutoPaymentSync;
     private scheduleQueuedAutoPaymentSyncFlush;
     private flushQueuedAutoPaymentSync;
-    /** 追加单个支付项到当前订单。 */
+    /**
+     * 同步兼容入口。无法等待 IoT 短号时，按调用当下的 device_id 或 LOCAL 生成。
+     */
     addOrderPayment(payment: OrderPaymentSource): OrderPaymentData[];
+    /**
+     * 创建新支付项时优先使用业务解决方案初始化阶段缓存的设备短号；
+     * 未缓存的通用 BaseSales 保持实时读取设备信息的兼容语义。
+     */
+    addOrderPaymentAsync(payment: OrderPaymentSource): Promise<OrderPaymentData[]>;
+    private addOrderPaymentWithDevicePrefix;
     /** 更新当前订单中的指定支付项。 */
-    updateOrderPayment(paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>): OrderPaymentData[];
+    updateOrderPayment(paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>, options?: BaseSalesUpdateOrderPaymentOptions): Promise<BaseSalesUpdateOrderPaymentResult>;
     /** 删除当前订单中的指定支付项。 */
     deleteOrderPayment(paymentIdentity: string | number): OrderPaymentData[];
     /** 覆盖 wallet pass 支付项，同时保留普通支付项。 */
     updateVoucherOrderPayments(payments: OrderPaymentSource[], options?: {
         status?: 'paid' | 'payment_pending';
     }): OrderPaymentData[];
+    updateVoucherOrderPaymentsAsync(payments: OrderPaymentSource[], options?: {
+        status?: 'paid' | 'payment_pending';
+    }): Promise<OrderPaymentData[]>;
     confirmPendingVoucherPayments(): OrderPaymentData[];
     discardPendingVoucherPayments(): OrderPaymentData[];
     private getWalletProductList;