@pisell/pisellos 2.2.148 → 2.2.150

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

@@ -23,7 +23,8 @@ export interface FormattedProductData extends ProductData {
 export interface LoadProductsPriceParams {
     ids: number[];
     schedule_date: string;
-    customer_id?: number;
+    schedule_datetime?: string;
+    customer_id?: number | string;
 }
 /**
  * 加载报价单商品价格返回数据
@@ -47,6 +48,7 @@ export interface LoadProductsPriceData {
             bundle_product_id: number;
             bundle_variant_id: number;
             price: number;
+            base_price?: number | string;
             price_type: string;
             price_type_ext: string;
         }[];
@@ -107,6 +109,8 @@ export interface ProductSyncMessage {
  */
 export interface ProductFormatterContext {
     schedule_date: string;
+    schedule_datetime?: string;
+    customer_id?: number | string;
     priceData?: LoadProductsPriceData[];
     scheduleModule?: any;
     locale?: string;

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

@@ -0,0 +1,175 @@
+import { Module, ModuleOptions, PisellCore } from '../../types';
+import { BaseModule } from '../../modules/BaseModule';
+import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesScanCodeResult } from './types';
+import { OrderModule } from '../../modules/Order';
+import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateProductInOrderParams } from '../../modules/Order/types';
+import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
+import type { Discount } from '../../modules/Discount/types';
+import { RequestPlugin, WindowPlugin } from '../../plugins';
+export * from './types';
+import { ProductList } from '../../modules/ProductList';
+import type { SalesSummaryModule } from '../../modules/SalesSummary';
+import type { ScheduleModule } from '../../modules/Schedule';
+import type { ISalesDetail, ISalesDetailHeader, ISalesBooking, ISalesPayment, ISalesSurcharge } from './utils/parseSalesResponse';
+export interface BaseSalesState {
+    order?: OrderModule;
+    products?: ProductList;
+    salesSummary?: SalesSummaryModule;
+    schedule?: ScheduleModule;
+}
+export declare class BaseSalesImpl extends BaseModule implements Module {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    isSolution: boolean;
+    protected initializeOptions: ModuleOptions;
+    protected store: BaseSalesState;
+    protected otherParams: Record<string, any>;
+    protected cacheId: string | undefined;
+    /**
+     * window / request 暴露为 public：现存外部工具（如 BookingTicket Scan）通过
+     * `solution.window` / `solution.request` 直接访问插件，保持原有契约不破坏。
+     */
+    window: WindowPlugin;
+    request: RequestPlugin;
+    protected currentSalesDetail: ISalesDetail | null;
+    constructor(name?: string, version?: string);
+    /**
+     * 子类可覆盖此方法以追加/收敛要注册的子模块。
+     * 默认包含通用销售模块：products / order / salesSummary / schedule。
+     */
+    protected getRegisteredModuleNames(): readonly string[];
+    /**
+     * 工厂入口：根据子模块名实例化对应模块。
+     * 默认使用 BookingByStep 公共 `createModule`。子类若需引入额外类型（如 customer），
+     * 可覆盖此方法并把未识别的 name 委托给 `super.createSubModule(name)`。
+     */
+    protected createSubModule(moduleName: string): Module | null;
+    /**
+     * 读取 sessionStorage[this.name][cacheId]，作为子模块 initialState 的来源。
+     * sessionStorage 损坏时静默忽略，按空状态注册。
+     */
+    protected readSessionCacheData(): Record<string, any>;
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    destroy(): Promise<void>;
+    /**
+     * 加载销售订单到统一 tempOrder 工作区。
+     * 有 app.sqlite 时优先读取本地记录；本地未命中或 forceRemote=true 时再拉云端。
+     *
+     * 子类可在 `super.loadSalesDetail` 之后基于返回的 `sales` 做业务侧装配
+     * （比如把 `sales.customer` 写入 CustomerModule、emit 业务 hook 等）。
+     */
+    loadSalesDetail(orderIdOrParams: number | string | LoadSalesDetailParams): Promise<ISalesDetail>;
+    /** 获取当前已加载的销售详情（只读快照）。未加载过则返回 null。 */
+    getSalesOrder(): ISalesDetail | null;
+    /** 获取销售详情顶部业务字段（订单号/状态/金额等通用字段集合）。 */
+    getOrderHeader(): ISalesDetailHeader | null;
+    /** 获取所有 booking（含 root + children），按服务端原始顺序输出。 */
+    getBookings(): ISalesBooking[];
+    /** 获取根 booking（is_next === 0 / is_root === 1），多个时取第一个。 */
+    getRootBooking(): ISalesBooking | null;
+    /** 按 product_uid 反查 booking 列表（用于商品行 ↔ booking 映射）。 */
+    getChildBookingsByProductUid(productUid: string): ISalesBooking[];
+    /** 获取支付列表（已支付/退款等明细）。 */
+    getPayments(): ISalesPayment[];
+    /** 获取附加费用（运费/服务费/税费等）。 */
+    getSurcharges(): ISalesSurcharge[];
+    getTempOrder(): import("../../modules/Order/types").OrderTempOrder | null;
+    getOrderIdentity(): import("../../modules/Order/types").OrderIdentitySnapshot | null;
+    getOrderSnapshot(): import("../../modules/Order/types").OrderSnapshot | null;
+    getOrderSyncState(): import("../../modules/Order/types").OrderSyncState;
+    getOrderAmountSnapshot(): import("../../modules/Order/types").OrderAmountSnapshot | null;
+    getTempOrderNote(): string;
+    updateTempOrderNote(note: string): string;
+    updateOrderShopDiscount(amount: string | number): string;
+    private ensureTempOrder;
+    addNewOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
+    saveDraft(): Promise<void>;
+    restoreOrder(): Promise<import("../../modules/Order/types").OrderTempOrder>;
+    getOrderProducts(): import("../../modules/Order/types").OrderProduct[];
+    getSummary(): Promise<import("../../modules/Order/types").OrderSummary>;
+    getDiscountList(): Discount[];
+    scanPromotionCode(code: string, customerId?: number): Promise<BaseSalesScanCodeResult>;
+    setDiscountSelected(params: {
+        discountId: number;
+        isSelected: boolean;
+    }): Promise<void>;
+    submitScanOrder<T = any>(params?: {
+        payments?: OrderPaymentSource[];
+        paymentStatus?: BaseSalesPaymentStatus;
+        smallTicketDataFlag?: number;
+        enhancePayload?: SubmitPayloadEnhancer;
+    }): Promise<T>;
+    /**
+     * 提交当前 Sales 订单。
+     *
+     * PaymentModal 场景通过 smallTicketDataFlag=1 请求 B 端小票数据；
+     * payments 会交给 OrderModule 统一映射为 Sales 协议支付项。
+     */
+    submitSalesOrder<T = any>(params?: {
+        payments?: OrderPaymentSource[];
+        paymentStatus?: BaseSalesPaymentStatus;
+        smallTicketDataFlag?: number;
+        enhancePayload?: SubmitPayloadEnhancer;
+    }): Promise<T>;
+    syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
+    /** 读取当前 BaseSales 订单上下文中的 Sales 协议支付项。 */
+    getOrderPayments(): OrderPaymentData[];
+    /** 覆盖当前订单支付项，内部由 OrderModule 清洗为 Sales 协议字段。 */
+    setOrderPayments(payments: OrderPaymentSource[]): OrderPaymentData[];
+    /** 追加单个支付项到当前订单。 */
+    addOrderPayment(payment: OrderPaymentSource): OrderPaymentData[];
+    /** 更新当前订单中的指定支付项。 */
+    updateOrderPayment(paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>): OrderPaymentData[];
+    /** 删除当前订单中的指定支付项。 */
+    deleteOrderPayment(paymentIdentity: string | number): OrderPaymentData[];
+    /** 覆盖 wallet pass 支付项，同时保留普通支付项。 */
+    updateVoucherOrderPayments(payments: OrderPaymentSource[]): OrderPaymentData[];
+    /**
+     * 更新当前订单客户字段。
+     *
+     * 这是 PaymentModal 客户切换的订单事实入口；外部客户模块同步应由
+     * 调用方通过 onCustomerChange 回调完成。
+     */
+    updateOrderCustomer(customer: UpdateTempOrderCustomerInput): {
+        customerId: number | null;
+        customerName: string;
+        phone: string;
+        email: string;
+    };
+    /** 获取可用支付方式列表，供 PaymentModal 渲染支付选项。 */
+    getPaymentMethodsAsync(): Promise<any[]>;
+    /** 轻量舍入能力，供现金支付 UI 计算 rounding_amount。 */
+    roundAmount(params: {
+        amount: string | number;
+        interval?: string | number;
+        rule?: 'standard_rounding' | 'standard_down' | 'always_up' | 'always_down' | string;
+    }): {
+        originalAmount: string;
+        roundedAmount: string;
+        roundingDifference: string;
+    };
+    /**
+     * 发送支付链接。
+     *
+     * 如果没有 orderIds 或显式 submitBeforeSend，会先提交当前本地订单到云端；
+     * 只有成功拿到远端 order_id 后才调用 OrderModule 发送邮件。
+     */
+    sendCustomerPayLink<T = any>(params: Omit<SendCustomerPayLinkParams, 'orderIds' | 'order_ids'> & {
+        orderIds?: Array<number | string>;
+        order_ids?: Array<number | string>;
+        submitBeforeSend?: boolean;
+    }): Promise<T>;
+    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    updateProductInOrder(params: UpdateProductInOrderParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    /**
+     * 设置单行商品备注（与整单 `updateTempOrderNote` 区分）。
+     * 多行同 SKU 时必须传入与删除/更新一致的 unique_identification_number。
+     */
+    setOrderProductLineNote(identity: BaseSalesOrderProductIdentity, note: string): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductFromOrder(identity: BaseSalesOrderProductIdentity): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    getProductList(): Promise<any>;
+    getOtherParams(): Record<string, any>;
+    setOtherParams(params: Record<string, any>, { cover }?: {
+        cover?: boolean;
+    }): Promise<void>;
+}