@pisell/pisellos 2.2.190 → 2.2.191

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

@@ -94,8 +94,6 @@ export interface OrderProductLineItem {
     num: number;
     /** 多规格 ID。来源：Detail.product_variant_id */
     product_variant_id?: number;
-    /** 选项配置 */
-    product_option_item?: unknown[];
     /**
      * 销售单价（交易快照，仅输出）。
      * 来源：Detail.selling_price

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

@@ -3,6 +3,36 @@ import { BaseModule } from '../../../modules/BaseModule';
 import { ProductData } from '../../../modules/Product/types';
 import type { RouteDefinition } from '../../types';
 import { ProductIdScope, ProductFormatter, ProductFormatterContext } from './types';
+/** 商品模块流程调试日志条目 */
+interface ProductFlowLogEntry {
+    ts: string;
+    step: string;
+    metadata?: Record<string, unknown>;
+}
+/** 单个商品 IndexDB 写入记录 */
+interface ProductWriteStatEntry {
+    ts: string;
+    writeSeq: number;
+    source: string;
+    writeMethod: string;
+    productId: number;
+    mergeAction?: 'insert' | 'update' | 'snapshot' | 'delete';
+}
+declare global {
+    interface Window {
+        __productModuleFlowLogs?: ProductFlowLogEntry[];
+        __productModuleWriteStats?: Record<string, ProductWriteStatEntry[]>;
+        clearProductModuleFlowLogs?: () => void;
+        exportProductModuleFlowLogs?: () => string;
+        exportProductModuleWriteStats?: () => string;
+        summarizeProductModuleWrites?: (topN?: number) => Array<{
+            productId: number;
+            writeCount: number;
+            sources: string[];
+            lastWriteAt: string;
+        }>;
+    }
+}
 /**
  * Products 模块 - 用于获取和管理完整的商品详细数据
  * 相比 ProductList 模块，Products 会获取所有详细信息并缓存
@@ -27,6 +57,14 @@ export declare class ProductsModule extends BaseModule implements Module {
     private productDataSource;
     private pendingSyncMessages;
     private syncTimer?;
+    /** IndexDB 写入序号，便于日志关联 */
+    private productFlowWriteSeq;
+    /** 最近一次 SSE 全量拉取完成时间 */
+    private lastServerFullFetchAtMs;
+    /** 最近一次 preload 完成时间（含 IndexDB 命中） */
+    private lastPreloadCompletedAtMs;
+    /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
+    private productIndexDBSaveQueue;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: any): Promise<void>;
     /**
@@ -47,6 +85,30 @@ export declare class ProductsModule extends BaseModule implements Module {
      * @param metadata 日志元数据
      */
     private logError;
+    /**
+     * 初始化 window 上的商品流程调试日志。
+     *
+     * @example
+     * window.clearProductModuleFlowLogs()
+     * copy(window.exportProductModuleFlowLogs?.() || '[]')
+     */
+    private initProductFlowLogs;
+    /**
+     * 写入 window 商品流程调试日志。
+     *
+     * @example
+     * this.pushProductFlowLog('mergeProductsToStore.start', { count: 3 })
+     */
+    private pushProductFlowLog;
+    /** 当前内存 store 快照，供流程日志使用 */
+    private getProductStoreSnapshot;
+    /**
+     * 记录 IndexDB 写入统计（按 productId 聚合）。
+     *
+     * @example
+     * this.trackProductWrite('pubsub.mergeProductsToStore', 'clear+bulkUpdate', products, { 1: 'update' })
+     */
+    private trackProductWrite;
     /**
      * 加载商品价格（原始方法，不带缓存）
      * @private
@@ -209,10 +271,28 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private loadProductsFromIndexDB;
     /**
-     * 保存商品数据到 IndexDB（平铺存储）
-     * @private
+     * 串行执行商品 IndexDB 写入，避免快照替换与增量 patch 并发交错。
+     *
+     * @example
+     * await this.runInProductIndexDBSaveQueue(async () => {
+     *   await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products)
+     * })
+     */
+    private runInProductIndexDBSaveQueue;
+    /**
+     * 全量快照写入 IndexDB：clear + bulkUpdate，仅用于 SSE/HTTP 全量拉取。
+     *
+     * @example
+     * await this.replaceProductsSnapshotInIndexDB(list, 'loadProductsByServer')
      */
-    private saveProductsToIndexDB;
+    private replaceProductsSnapshotInIndexDB;
+    /**
+     * 增量 upsert 商品到 IndexDB，不清空表；用于 pubsub 批次合并后的变更商品。
+     *
+     * @example
+     * await this.patchProductsInIndexDB(changedProducts, 'pubsub.processProductSyncMessages', mergeActions)
+     */
+    private patchProductsInIndexDB;
     /**
      * 同步更新商品 Map 缓存
      * 将 list 中的商品同步到 map，以 id 为 key
@@ -262,14 +342,17 @@ export declare class ProductsModule extends BaseModule implements Module {
     /**
      * 将 body 完整数据直接覆盖到本地 store（不调用报价单接口）
      * 已存在的 → 直接替换；不存在的 → 追加
-     * 同时更新 Map 缓存、IndexDB，触发 onProductsChanged
-     * 价格缓存由 processProductSyncMessages 末尾统一清除
+     *
+     * @example
+     * await this.applyBodyUpdatesToStore(bodyUpdates, { skipIndexDB: true })
      */
     private applyBodyUpdatesToStore;
     /**
      * 将增量拉取的商品合并到 store
      * 已存在的 → 替换；新的 → 追加
-     * 同时更新 store.map、IndexDB，触发 onProductsChanged
+     *
+     * @example
+     * await this.mergeProductsToStore(freshProducts, { skipIndexDB: true })
      */
     private mergeProductsToStore;
     /**
@@ -288,3 +371,4 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     getRoutes(): RouteDefinition[];
 }
+export {};