@pisell/pisellos 2.3.40 → 2.3.41

package/lib/server/modules/order/index.d.ts

@@ -2,6 +2,7 @@ import { Module, ModuleOptions, PisellCore } from '../../../types';
 import { BaseModule } from '../../../modules/BaseModule';
 import type { RouteDefinition } from '../../types';
 import { OrderData, OrderId } from './types';
+import { type OrderPaymentIdentityType } from '../../../modules/Order/payment-utils';
 /**
  * Order 模块 - 基础框架
  */
@@ -89,8 +90,31 @@ export declare class OrderModule extends BaseModule implements Module {
     getOrderById(id: OrderId): OrderData | undefined;
     /** 按 order_id 查询内存订单。 */
     getOrderByOrderId(orderId: OrderId): OrderData | undefined;
+    private buildLocalPaymentOrderLogContext;
     getLocalOrderFromMemoryByLookup(lookup: OrderId): OrderData | null;
-    getLocalOrderByLookup(lookup: OrderId): Promise<OrderData | null>;
+    getLocalOrderByLookup(lookup: OrderId, options?: {
+        operationId?: string;
+    }): Promise<OrderData | null>;
+    getLocalPayment(params: {
+        saleId: OrderId;
+        paymentNumber: OrderId;
+        operationId?: string;
+    }): Promise<{
+        order: OrderData;
+        payment: Record<string, any>;
+        paymentIndex: number;
+        matchedBy: OrderPaymentIdentityType;
+    } | null>;
+    updateLocalPayment(params: {
+        saleId: OrderId;
+        paymentNumber: OrderId;
+        operationId?: string;
+        updates: Record<string, any>;
+    }): Promise<{
+        order: OrderData;
+        payment: Record<string, any>;
+        previousPayment: Record<string, any>;
+    } | null>;
     loadOrdersByServer(): Promise<OrderData[]>;
     /**
      * 静默全量刷新：后台重新拉取全量 SSE 订单数据并更新本地
@@ -99,6 +123,10 @@ export declare class OrderModule extends BaseModule implements Module {
      */
     silentRefresh(): Promise<OrderData[]>;
     private normalizeOrderForMemoryList;
+    private normalizeOrdersForMemoryList;
+    private hasRealOrderId;
+    private shouldKeepOrderInMemory;
+    private withoutSyntheticDraftOrderId;
     /**
      * 仅覆盖本地已存在的订单；不存在则直接跳过，不落库、不 emit。
      * 适用于"按 order_id 主动刷新本地订单详情"的代理场景。
@@ -110,7 +138,7 @@ export declare class OrderModule extends BaseModule implements Module {
      * 将远端拉取的订单合并进本地 store（已存在则更新，不存在则追加），落库并 emit onOrdersChanged。
      * 供 /update/localOrder 等在「本地尚无该单」时写入新建单。
      */
-    upsertOrdersFromRemote(freshOrders: OrderData[]): Promise<void>;
+    upsertOrdersFromRemote(freshOrders: OrderData[], source?: string): Promise<void>;
     markOrderSyncedByExternalSaleNumber(params: {
         externalSaleNumber: OrderId;
         patch?: Partial<OrderData>;
@@ -122,7 +150,14 @@ export declare class OrderModule extends BaseModule implements Module {
      * 将本地待同步订单按 SQLite storage key 合并进 store 并落库。
      * checkout 离线兜底可能没有 order_id，但通常会有 external_sale_number。
      */
-    upsertPendingSyncOrders(pendingOrders: OrderData[]): Promise<void>;
+    upsertPendingSyncOrders(pendingOrders: OrderData[], options?: {
+        throwOnError?: boolean;
+    }): Promise<void>;
+    /**
+     * 将 POS 草稿订单按 SQLite storage key 落库。
+     * 只有具备真实 order_id 的草稿进入 store；其余草稿仅供本地恢复查询。
+     */
+    upsertLocalDraftOrders(draftOrders: OrderData[]): Promise<void>;
     /**
      * 通过 SSE 按自定义 query 拉取订单（支持 select/with 精简字段）
      */
@@ -132,6 +167,11 @@ export declare class OrderModule extends BaseModule implements Module {
     private syncOrdersMap;
     private getOrderMapKey;
     private isBlankIdentityValue;
+    /**
+     * `/sales/draft` 的旧调用方可能把未设置的 business_code 传成空串。
+     * 对同一真实订单，空值不能覆盖已有的分类，否则 booking 查询会把该订单从 Party 列表过滤掉。
+     */
+    private preserveExistingBusinessCodeForDraft;
     private getOrderIdentityEntries;
     private getOrderIdentityKeys;
     private getOrderDateKey;
@@ -222,6 +262,12 @@ export declare class OrderModule extends BaseModule implements Module {
     private findOrderIndexByIdentity;
     private getOrderCompletenessScore;
     private pickPreferredOrder;
+    private getProductIdentityKeys;
+    private mergeOrderProductLists;
+    private mergeOrderPaymentLists;
+    private getIdentifiedPendingPayments;
+    private shouldProtectLocalOrderFromRemoteSnapshot;
+    private getUnmatchedIdentifiedPendingPayments;
     private mergeOrderRecords;
     private summarizeDuplicateOrders;
     private logDuplicateOrders;
@@ -238,7 +284,10 @@ export declare class OrderModule extends BaseModule implements Module {
     private setStorageItem;
     private loadOrdersFromSQLite;
     private isPendingSyncOrder;
+    private isDraftOrder;
+    private shouldProtectDraftOrderFromIncoming;
     private normalizeRemoteSyncedOrder;
+    private mergeRemoteIdentityIntoDraftOrder;
     private mergeRemoteSnapshotWithPendingOrders;
     /**
      * 串行执行订单 SQLite 写入任务，避免快照替换与增量 upsert 并发交错。
@@ -264,7 +313,8 @@ export declare class OrderModule extends BaseModule implements Module {
      */
     private updateOrderInSQLite;
     /**
-     * 全量快照替换 orders 表（clear + bulkAdd），用于 SSE 全量拉取与营业日窗口裁剪。
+     * 全量快照替换 orders 表（clear + bulkAdd），并保留本地 draft / need_sync / pending 支付订单。
+     * 用于 SSE 全量拉取与营业日窗口裁剪。
      *
      * @example
      * await this.replaceOrdersSnapshotInSQLite(orderList)