@pisell/pisellos 2.2.153 → 2.2.154

package/lib/modules/Payment/types.d.ts

@@ -349,6 +349,18 @@ export interface EftposPayment {
 /**
  * 钱包支付接口
  */
+export interface WalletInitializationResult {
+    walletRecommendList: WalletRecommendItem[];
+    userIdentificationCodes: UserIdentificationCodeItem[];
+    transformList: any[];
+    noApplicableVoucher: any[];
+    products: any[];
+}
+export interface WalletStoredInitData {
+    transformList: any[];
+    noApplicableVoucher: any[];
+    products: any[];
+}
 export interface WalletPassPayment {
     /** 生成钱包API默认参数 */
     generateWalletParams: (businessData: WalletInitBusinessData) => WalletDeductionRecommendParams;
@@ -357,21 +369,25 @@ export interface WalletPassPayment {
     /** 清理已存储的钱包参数 */
     clearStoredWalletParams: () => void;
     /** 初始化钱包数据（从业务数据开始，内部生成参数） */
-    initializeWalletDataFromBusinessAsync: (businessData: WalletInitBusinessData) => Promise<{
-        walletRecommendList: WalletRecommendItem[];
-        userIdentificationCodes: UserIdentificationCodeItem[];
-    }>;
+    initializeWalletDataFromBusinessAsync: (businessData: WalletInitBusinessData) => Promise<WalletInitializationResult>;
     /** 初始化钱包数据（先获取推荐列表，再获取用户识别码列表） */
-    initializeWalletDataAsync: (baseParams: WalletDeductionRecommendParams) => Promise<{
-        walletRecommendList: WalletRecommendItem[];
-        userIdentificationCodes: UserIdentificationCodeItem[];
-    }>;
+    initializeWalletDataAsync: (baseParams: WalletDeductionRecommendParams) => Promise<WalletInitializationResult>;
     /** 获取钱包推荐扣款列表（异步获取并缓存） */
     getWalletPassRecommendListAsync: (params: WalletDeductionRecommendParams) => Promise<WalletRecommendItem[]>;
     /** 查询用户识别码列表（异步获取并缓存） */
     getUserIdentificationCodeListAsync: (params: UserIdentificationCodeParams) => Promise<UserIdentificationCodeItem[]>;
     /** 搜索识别码信息 */
-    searchIdentificationCodeAsync: (params: SearchIdentificationCodeParams) => Promise<SearchIdentificationCodeResult>;
+    searchIdentificationCodeAsync: (params: SearchIdentificationCodeParams, config?: {
+        noCache?: boolean;
+    }) => Promise<SearchIdentificationCodeResult>;
+    /** 将推荐钱包列表转换为 prepare_payments */
+    formatWalletPassList2PreparePayments: (list: WalletRecommendItem[]) => {
+        voucher_id: number;
+        amount: number;
+        tag: string;
+        wallet_pass_usage_unit?: unknown;
+        wallet_pass_use_value?: string | number | null;
+    }[];
     /** 获取缓存的搜索结果列表 */
     getSearchResults: () => SearchIdentificationCodeItem[];
     /** 根据识别码查找搜索结果 */
@@ -384,6 +400,10 @@ export interface WalletPassPayment {
     clearWalletRecommendList: () => void;
     /** 清除用户识别码列表 */
     clearUserIdentificationCodes: () => void;
+    /** 获取缓存的钱包初始化数据 */
+    getStoredWalletInitData: () => WalletStoredInitData | null;
+    /** 清除缓存的钱包初始化数据 */
+    clearStoredWalletInitData: () => void;
     /** 清除搜索结果缓存 */
     clearSearchResults: () => void;
     /** 清除所有缓存数据 */

package/lib/modules/SalesSummary/index.d.ts

@@ -5,20 +5,22 @@ export * from './types';
 export declare class SalesSummaryModule extends BaseModule implements Module, SalesSummaryModuleAPI {
     protected defaultName: string;
     protected defaultVersion: string;
-    private shopStore;
+    private appPlugin;
     private store;
     private request;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     getSurchargeList(): Promise<void>;
+    private getAppData;
+    private getTaxConfig;
     getSummary(params: {
         products: any[];
         isPriceIncludeTax?: number;
         taxRate?: number;
         shopDiscount?: string | number;
     }): Promise<{
-        tax_title: any;
-        tax_rate: any;
+        tax_title: string;
+        tax_rate: number | undefined;
         product_quantity: number;
         product_original_amount: string;
         product_amount: string;
@@ -42,8 +44,8 @@ export declare class SalesSummaryModule extends BaseModule implements Module, Sa
         pay_service_charge_amount: string;
         is_price_include_tax?: number | undefined;
     } | {
-        tax_title: any;
-        tax_rate: any;
+        tax_title: string;
+        tax_rate: number | undefined;
         product_quantity: number;
         product_original_amount: string;
         product_amount: string;

package/lib/modules/SalesSummary/index.js

@@ -27,6 +27,11 @@ var import_BaseModule = require("../BaseModule");
 var import_Schedule = require("../Schedule");
 var import_utils = require("./utils");
 __reExport(SalesSummary_exports, require("./types"), module.exports);
+var salesSummaryDataKeys = {
+  isPriceIncludeTax: "is_price_include_tax",
+  taxRate: "tax_rate",
+  taxTitle: "tax_title"
+};
 var SalesSummaryModule = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
@@ -37,12 +42,12 @@ var SalesSummaryModule = class extends import_BaseModule.BaseModule {
     var _a, _b;
     this.core = core;
     this.store = options.store;
-    this.shopStore = this.core.getPlugin("shopStore");
+    this.appPlugin = this.core.getPlugin("app");
     this.request = this.core.getPlugin("request");
     this.store.surchargeList = ((_a = options.initialState) == null ? void 0 : _a.surchargeList) || [];
     this.store.summary = ((_b = options.initialState) == null ? void 0 : _b.summary) || (0, import_utils.createEmptySalesSummary)();
-    if (!this.shopStore) {
-      throw new Error("SalesSummaryModule 需要 shopStore 插件支持");
+    if (!this.appPlugin) {
+      throw new Error("SalesSummaryModule 需要 app 插件支持");
     }
     if (!this.request) {
       throw new Error("SalesSummaryModule 需要 request 插件支持");
@@ -66,10 +71,25 @@ var SalesSummaryModule = class extends import_BaseModule.BaseModule {
       this.store.surchargeList = [];
     }
   }
+  getAppData(key) {
+    var _a, _b, _c, _d, _e, _f;
+    const getData = (_b = (_a = this.appPlugin).getData) == null ? void 0 : _b.call(_a);
+    if (typeof getData === "function")
+      return getData(key);
+    const app = this.appPlugin.getApp();
+    const coreData = (_f = (_d = (_c = app == null ? void 0 : app.models) == null ? void 0 : _c.getStore) == null ? void 0 : (_e = _d.call(_c)).getDataByModel) == null ? void 0 : _f.call(_e, "core", "core");
+    return coreData == null ? void 0 : coreData[key];
+  }
+  getTaxConfig() {
+    return {
+      isPriceIncludeTax: this.getAppData(salesSummaryDataKeys.isPriceIncludeTax),
+      taxRate: this.getAppData(salesSummaryDataKeys.taxRate),
+      taxTitle: this.getAppData(salesSummaryDataKeys.taxTitle)
+    };
+  }
   async getSummary(params) {
-    var _a, _b;
     const { products = [], isPriceIncludeTax, taxRate, shopDiscount } = params;
-    const shopInfo = ((_b = (_a = this.shopStore.get("core")) == null ? void 0 : _a.core) == null ? void 0 : _b.shop) || {};
+    const taxConfig = this.getTaxConfig();
     const summarySchedule = this.core.getModule(
       `${this.name.split("_")[0]}_schedule`
     );
@@ -83,8 +103,8 @@ var SalesSummaryModule = class extends import_BaseModule.BaseModule {
     }
     const summary = (0, import_utils.calculateSalesSummary)({
       products,
-      isPriceIncludeTax: isPriceIncludeTax ?? (shopInfo == null ? void 0 : shopInfo.is_price_include_tax) ?? 1,
-      taxRate: taxRate ?? (shopInfo == null ? void 0 : shopInfo.tax_rate),
+      isPriceIncludeTax: isPriceIncludeTax ?? taxConfig.isPriceIncludeTax ?? 1,
+      taxRate: taxRate ?? taxConfig.taxRate,
       surchargeList: this.store.surchargeList,
       scheduleById,
       isInScheduleByDate: import_Schedule.ScheduleModule.isInScheduleByDate,
@@ -92,8 +112,8 @@ var SalesSummaryModule = class extends import_BaseModule.BaseModule {
     });
     const summaryWithTaxMeta = {
       ...summary,
-      tax_title: (shopInfo == null ? void 0 : shopInfo.tax_title) || "",
-      tax_rate: taxRate ?? (shopInfo == null ? void 0 : shopInfo.tax_rate)
+      tax_title: taxConfig.taxTitle || "",
+      tax_rate: taxRate ?? taxConfig.taxRate
     };
     this.store.summary = summaryWithTaxMeta;
     return summaryWithTaxMeta;

package/lib/plugins/app.d.ts

@@ -1,8 +1,10 @@
 import { Plugin } from '../types';
 import App from './app-types/app';
+export type AppDataGetter = (key: string) => any;
 /**
  * AppPlugin 接口定义
  */
 export interface AppPlugin extends Plugin {
     getApp: () => App;
+    getData?: () => AppDataGetter;
 }

package/lib/server/index.d.ts

@@ -372,13 +372,10 @@ declare class Server {
      */
     private recomputeAndNotifyBookingQuery;
     /**
-     * 根据餐牌配置过滤商品
-     * @param products 所有商品列表
-     * @param activeMenuList 生效的餐牌列表
-     * @returns 过滤后的商品列表
+     * 根据餐牌配置提取轻量商品范围。
      * @private
      */
-    private filterProductsByMenuConfig;
+    private getProductScopeByMenuConfig;
     /**
      * 记录信息日志
      * @param title 日志标题

package/lib/server/index.js

@@ -2060,16 +2060,16 @@ var Server = class {
     if (product_id != null && Number.isFinite(Number(product_id))) {
       const pid = Number(product_id);
       const tPrice2 = performance.now();
-      const allProductsWithPrice2 = await this.products.getProductsWithPrice(schedule_date, {
+      const allProductsWithPrice = await this.products.getProductsWithPrice(schedule_date, {
         scheduleModule: this.getSchedule()
       }, {
         changedIds: options == null ? void 0 : options.changedIds
       });
       (0, import_product.perfMark)("computeQuery.getProductsWithPrice(single)", performance.now() - tPrice2, {
-        count: allProductsWithPrice2.length,
+        count: allProductsWithPrice.length,
         productId: pid
       });
-      const published = allProductsWithPrice2.filter((p) => ((p == null ? void 0 : p.status) || "published") === "published");
+      const published = allProductsWithPrice.filter((p) => ((p == null ? void 0 : p.status) || "published") === "published");
       const item = published.find((p) => Number(p.id) === pid) ?? null;
       (0, import_product.perfMark)("computeProductQueryResult", performance.now() - tTotal, {
         mode: "single",
@@ -2108,22 +2108,26 @@ var Server = class {
         activeMenu: activeMenuList.length
       });
     }
+    const tFilter = performance.now();
+    const productScope = this.getProductScopeByMenuConfig(activeMenuList);
+    const scopedProductIds = this.products.getProductIdsByScope(productScope);
+    (0, import_product.perfMark)("computeQuery.filterByMenu", performance.now() - tFilter, {
+      scopedProductCount: scopedProductIds.length,
+      activeMenuCount: activeMenuList.length,
+      isAllProducts: !!productScope.isAllProducts
+    });
     const tPrice = performance.now();
-    const allProductsWithPrice = await this.products.getProductsWithPrice(schedule_date, {
+    let filteredProducts = scopedProductIds.length > 0 ? await this.products.getProductsWithPrice(schedule_date, {
       scheduleModule: this.getSchedule(),
       schedule_datetime,
       customer_id
     }, {
-      changedIds: options == null ? void 0 : options.changedIds
-    });
+      changedIds: options == null ? void 0 : options.changedIds,
+      productIds: productScope.isAllProducts ? void 0 : scopedProductIds
+    }) : [];
     (0, import_product.perfMark)("computeQuery.getProductsWithPrice", performance.now() - tPrice, {
-      count: allProductsWithPrice.length
-    });
-    const tFilter = performance.now();
-    let filteredProducts = this.filterProductsByMenuConfig(allProductsWithPrice, activeMenuList);
-    (0, import_product.perfMark)("computeQuery.filterByMenu", performance.now() - tFilter, {
-      before: allProductsWithPrice.length,
-      after: filteredProducts.length
+      count: filteredProducts.length,
+      scopedProductCount: scopedProductIds.length
     });
     const tStatus = performance.now();
     const beforeStatusCount = filteredProducts.length;
@@ -2141,12 +2145,12 @@ var Server = class {
     });
     (0, import_product.perfMark)("computeQuery.sort", performance.now() - tSort, { count: filteredProducts.length });
     (0, import_product.perfMark)("computeProductQueryResult", performance.now() - tTotal, {
-      originalCount: allProductsWithPrice.length,
+      scopedProductCount: scopedProductIds.length,
       filteredCount: filteredProducts.length,
       activeMenuCount: activeMenuList.length
     });
     this.logInfo("computeProductQueryResult 完成", {
-      originalCount: allProductsWithPrice.length,
+      scopedProductCount: scopedProductIds.length,
       filteredCount: filteredProducts.length,
       activeMenuCount: activeMenuList.length
     });
@@ -2249,29 +2253,25 @@ var Server = class {
     }
   }
   /**
-   * 根据餐牌配置过滤商品
-   * @param products 所有商品列表
-   * @param activeMenuList 生效的餐牌列表
-   * @returns 过滤后的商品列表
+   * 根据餐牌配置提取轻量商品范围。
    * @private
    */
-  filterProductsByMenuConfig(products, activeMenuList) {
+  getProductScopeByMenuConfig(activeMenuList) {
     if (!activeMenuList || activeMenuList.length === 0) {
       console.log("[Server] 没有生效的餐牌，返回空数组");
-      this.logInfo("filterProductsByMenuConfig: 没有生效的餐牌，返回空数组", {
-        productCount: products.length,
+      this.logInfo("getProductScopeByMenuConfig: 没有生效的餐牌，返回空数组", {
         activeMenuCount: 0
       });
-      return [];
+      return { productIds: [], collectionIds: [] };
     }
-    let allowedProductIds = /* @__PURE__ */ new Set();
-    let allowedCollectionIds = /* @__PURE__ */ new Set();
+    const allowedProductIds = /* @__PURE__ */ new Set();
+    const allowedCollectionIds = /* @__PURE__ */ new Set();
     let hasProductAll = false;
     for (const menu of activeMenuList) {
       const config = menu.partyroom_package;
       if (!config) {
         console.warn("[Server] 餐牌缺少 partyroom_package 配置:", menu);
-        this.logWarning("filterProductsByMenuConfig: 餐牌缺少 partyroom_package 配置", {
+        this.logWarning("getProductScopeByMenuConfig: 餐牌缺少 partyroom_package 配置", {
           menuId: menu.form_record_id,
           menuName: menu.name
         });
@@ -2279,7 +2279,7 @@ var Server = class {
       }
       if (config.type === "product_all") {
         console.log("[Server] 餐牌允许所有商品:", menu.name);
-        this.logInfo("filterProductsByMenuConfig: 餐牌允许所有商品", {
+        this.logInfo("getProductScopeByMenuConfig: 餐牌允许所有商品", {
           menuId: menu.form_record_id,
           menuName: menu.name,
           configType: config.type
@@ -2291,7 +2291,7 @@ var Server = class {
         const productIds = config.products.map((item) => item.product_id);
         productIds.forEach((id) => id && allowedProductIds.add(id));
         console.log("[Server] 餐牌允许指定商品 (product_ids):", menu.name, productIds);
-        this.logInfo("filterProductsByMenuConfig: 餐牌允许指定商品", {
+        this.logInfo("getProductScopeByMenuConfig: 餐牌允许指定商品", {
           menuId: menu.form_record_id,
           menuName: menu.name,
           configType: config.type,
@@ -2302,7 +2302,7 @@ var Server = class {
         const collectionIds = config.products.map((item) => item.product_collection_id);
         collectionIds.forEach((id) => id && allowedCollectionIds.add(id));
         console.log("[Server] 餐牌允许商品集合 (product_collection):", menu.name, collectionIds);
-        this.logInfo("filterProductsByMenuConfig: 餐牌允许商品集合", {
+        this.logInfo("getProductScopeByMenuConfig: 餐牌允许商品集合", {
           menuId: menu.form_record_id,
           menuName: menu.name,
           configType: config.type,
@@ -2311,48 +2311,28 @@ var Server = class {
       }
     }
     if (hasProductAll) {
-      this.logInfo("filterProductsByMenuConfig: 返回所有商品（product_all）", {
-        productCount: products.length
-      });
-      return products;
+      this.logInfo("getProductScopeByMenuConfig: 返回所有商品 scope（product_all）");
+      return { isAllProducts: true };
     }
     if (allowedProductIds.size === 0 && allowedCollectionIds.size === 0) {
       console.log("[Server] 没有允许的商品和集合");
-      this.logWarning("filterProductsByMenuConfig: 没有允许的商品和集合", {
-        productCount: products.length,
+      this.logWarning("getProductScopeByMenuConfig: 没有允许的商品和集合", {
         activeMenuCount: activeMenuList.length
       });
-      return [];
+      return { productIds: [], collectionIds: [] };
     }
     const allowedProductIdsArray = Array.from(allowedProductIds);
     const allowedCollectionIdsArray = Array.from(allowedCollectionIds);
     console.log("[Server] 允许的商品 IDs:", allowedProductIdsArray);
     console.log("[Server] 允许的集合 IDs:", allowedCollectionIdsArray);
-    this.logInfo("filterProductsByMenuConfig: 收集到的允许规则", {
+    this.logInfo("getProductScopeByMenuConfig: 收集到的允许规则", {
       allowedProductCount: allowedProductIds.size,
       allowedCollectionCount: allowedCollectionIds.size
     });
-    const filteredProducts = products.filter((product) => {
-      if (allowedProductIds.has(product.id)) {
-        return true;
-      }
-      if (allowedCollectionIds.size > 0 && Array.isArray(product.collection)) {
-        const hasMatchingCollection = product.collection.some(
-          (col) => allowedCollectionIds.has(col.id)
-        );
-        if (hasMatchingCollection) {
-          return true;
-        }
-      }
-      return false;
-    });
-    console.log("[Server] 过滤结果: 原始 %d 个，过滤后 %d 个", products.length, filteredProducts.length);
-    this.logInfo("filterProductsByMenuConfig: 过滤完成", {
-      originalCount: products.length,
-      filteredCount: filteredProducts.length,
-      removedCount: products.length - filteredProducts.length
-    });
-    return filteredProducts;
+    return {
+      productIds: allowedProductIdsArray,
+      collectionIds: allowedCollectionIdsArray
+    };
   }
   /**
    * 记录信息日志

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

@@ -3,7 +3,7 @@
  * 包含新增的 Products、Menu、Quotation 和扩展的 Schedule 模块
  */
 export { ProductsModule } from './products';
-export type { ProductsState } from './products/types';
+export type { ProductIdScope, ProductsState } from './products/types';
 export { ProductsHooks } from './products/types';
 export { MenuModule } from './menu';
 export type { MenuState, MenuData } from './menu/types';

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

@@ -2,7 +2,7 @@ import { Module, PisellCore } from '../../../types';
 import { BaseModule } from '../../../modules/BaseModule';
 import { ProductData } from '../../../modules/Product/types';
 import type { RouteDefinition } from '../../types';
-import { ProductFormatter, ProductFormatterContext } from './types';
+import { ProductIdScope, ProductFormatter, ProductFormatterContext } from './types';
 /**
  * Products 模块 - 用于获取和管理完整的商品详细数据
  * 相比 ProductList 模块，Products 会获取所有详细信息并缓存
@@ -80,10 +80,12 @@ export declare class ProductsModule extends BaseModule implements Module {
      * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
      * @param options 可选参数
      * @param options.changedIds 变更的商品 IDs，非空时仅对这些商品增量执行 prepare 并更新缓存
+     * @param options.productIds 指定商品 IDs，仅对这些商品执行价格计算；不传则处理全量
      * @returns 应用了价格的商品列表
      */
     getProductsWithPrice(schedule_date: string, extraContext?: Partial<ProductFormatterContext>, options?: {
         changedIds?: number[];
+        productIds?: number[];
     }): Promise<ProductData[]>;
     /**
      * 准备带价格的商品数据（通过格式化器流程处理）
@@ -96,6 +98,11 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private prepareProductsWithPrice;
     private getProductsPriceCacheKey;
+    private normalizeProductIds;
+    /**
+     * 按轻量范围返回商品 ID，不做 structuredClone。
+     */
+    getProductIdsByScope(scope: ProductIdScope): number[];
     /**
      * 应用所有已注册的格式化器
      * @param products 商品列表
@@ -173,6 +180,10 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 仅供内部 formatter 流程使用，因为 formatter 会创建新对象
      */
     private getProductsRef;
+    /**
+     * 按 ID 从 Map 取商品引用，供内部 formatter 流程使用。
+     */
+    private getProductsRefByIds;
     /**
      * 根据ID获取单个商品（从内存缓存）
      * 使用 Map 快速查询，时间复杂度 O(1)

package/lib/server/modules/products/index.js

@@ -326,12 +326,16 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
    * @param options 可选参数
    * @param options.changedIds 变更的商品 IDs，非空时仅对这些商品增量执行 prepare 并更新缓存
+   * @param options.productIds 指定商品 IDs，仅对这些商品执行价格计算；不传则处理全量
    * @returns 应用了价格的商品列表
    */
   async getProductsWithPrice(schedule_date, extraContext, options) {
+    var _a;
     const t0 = performance.now();
-    const cacheKey = this.getProductsPriceCacheKey(schedule_date, extraContext);
-    const changedIds = options == null ? void 0 : options.changedIds;
+    const scopedProductIds = this.normalizeProductIds(options == null ? void 0 : options.productIds);
+    const cacheKey = this.getProductsPriceCacheKey(schedule_date, extraContext, scopedProductIds);
+    const scopedProductIdSet = scopedProductIds ? new Set(scopedProductIds) : void 0;
+    const changedIds = scopedProductIdSet ? (_a = options == null ? void 0 : options.changedIds) == null ? void 0 : _a.filter((id) => scopedProductIdSet.has(id)) : options == null ? void 0 : options.changedIds;
     if (this.productsPriceCache.has(cacheKey)) {
       const cachedProducts = this.productsPriceCache.get(cacheKey);
       if (changedIds && changedIds.length > 0) {
@@ -398,8 +402,15 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       });
       return cachedProducts;
     }
-    this.logInfo("商品价格缓存未命中，准备获取", { cacheKey });
-    const result = await this.prepareProductsWithPrice(schedule_date, extraContext);
+    this.logInfo("商品价格缓存未命中，准备获取", {
+      cacheKey,
+      scopedProductCount: scopedProductIds == null ? void 0 : scopedProductIds.length
+    });
+    const result = await this.prepareProductsWithPrice(
+      schedule_date,
+      extraContext,
+      scopedProductIds ? { productIds: scopedProductIds } : void 0
+    );
     this.productsPriceCache.set(cacheKey, result);
     this.logInfo("商品价格已缓存", {
       cacheKey,
@@ -425,7 +436,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     var _a, _b;
     const tTotal = performance.now();
     const targetIds = options == null ? void 0 : options.productIds;
-    const isIncremental = targetIds && targetIds.length > 0;
+    const isIncremental = Array.isArray(targetIds);
     this.logInfo("prepareProductsWithPrice 开始处理", {
       schedule_date,
       mode: isIncremental ? "incremental" : "full",
@@ -435,8 +446,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       let products;
       let ids;
       if (isIncremental) {
-        const idSet = new Set(targetIds);
-        products = this.getProductsRef().filter((p) => idSet.has(p.id));
+        products = this.getProductsRefByIds(targetIds);
         ids = products.map((p) => p.id);
       } else {
         products = this.getProductsRef();
@@ -499,9 +509,47 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     }
     return [];
   }
-  getProductsPriceCacheKey(schedule_date, extraContext) {
+  getProductsPriceCacheKey(schedule_date, extraContext, productIds) {
     const datetime = (extraContext == null ? void 0 : extraContext.schedule_datetime) || schedule_date;
-    return `${datetime}:customer:${(extraContext == null ? void 0 : extraContext.customer_id) ?? ""}`;
+    const productScope = productIds ? `:products:${productIds.join(",")}` : "";
+    return `${datetime}:customer:${(extraContext == null ? void 0 : extraContext.customer_id) ?? ""}${productScope}`;
+  }
+  normalizeProductIds(productIds) {
+    if (!Array.isArray(productIds))
+      return void 0;
+    return Array.from(new Set(
+      productIds.map((id) => Number(id)).filter((id) => Number.isFinite(id))
+    )).sort((a, b) => a - b);
+  }
+  /**
+   * 按轻量范围返回商品 ID，不做 structuredClone。
+   */
+  getProductIdsByScope(scope) {
+    const productIds = this.normalizeProductIds(scope.productIds) || [];
+    const collectionIds = this.normalizeProductIds(scope.collectionIds) || [];
+    if (scope.isAllProducts) {
+      return this.getProductsRef().map((product) => product.id);
+    }
+    if (productIds.length === 0 && collectionIds.length === 0)
+      return [];
+    const result = /* @__PURE__ */ new Set();
+    for (const id of productIds) {
+      if (this.store.map.has(id))
+        result.add(id);
+    }
+    if (collectionIds.length === 0)
+      return Array.from(result);
+    const collectionIdSet = new Set(collectionIds);
+    for (const product of this.getProductsRef()) {
+      if (result.has(product.id))
+        continue;
+      if (!Array.isArray(product.collection))
+        continue;
+      const isInCollection = product.collection.some((collection) => collectionIdSet.has(collection.id));
+      if (isInCollection)
+        result.add(product.id);
+    }
+    return Array.from(result);
   }
   /**
    * 应用所有已注册的格式化器
@@ -776,6 +824,18 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   getProductsRef() {
     return this.store.list;
   }
+  /**
+   * 按 ID 从 Map 取商品引用，供内部 formatter 流程使用。
+   */
+  getProductsRefByIds(ids) {
+    const products = [];
+    for (const id of ids) {
+      const product = this.store.map.get(id);
+      if (product)
+        products.push(product);
+    }
+    return products;
+  }
   /**
    * 根据ID获取单个商品（从内存缓存）
    * 使用 Map 快速查询，时间复杂度 O(1)

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

@@ -17,6 +17,17 @@ export interface FormattedProductData extends ProductData {
     /** 购物车详情值 */
     cartDetailValue?: any;
 }
+/**
+ * 商品轻量查询范围
+ */
+export interface ProductIdScope {
+    /** 是否返回全部商品 ID */
+    isAllProducts?: boolean;
+    /** 指定商品 ID */
+    productIds?: number[];
+    /** 指定商品集合 ID */
+    collectionIds?: number[];
+}
 /**
  * 加载报价单商品价格参数
  */

package/lib/server/utils/product.js

@@ -195,7 +195,7 @@ var formatDataKey = (data) => {
   }
   if ((_a = _data == null ? void 0 : _data.option) == null ? void 0 : _a.length) {
     for (const item of _data.option) {
-      let str = `_${item.option_group_id}_${item.product_option_item_id}`;
+      let str = `_${item.option_group_id}_${item.option_group_item_id}`;
       key += str;
       rowKey += `${str}_${item.quantity || item.num}`;
     }
@@ -207,7 +207,7 @@ var formatDataKey = (data) => {
       rowKey += `${str}_${item.quantity || item.num}`;
       if (item == null ? void 0 : item.option) {
         for (const opt of item.option) {
-          let str2 = `_${opt.option_group_id}_${opt.product_option_item_id}`;
+          let str2 = `_${opt.option_group_id}_${opt.option_group_item_id}`;
           key += str2;
           rowKey += `${str2}_${opt.quantity || opt.num}`;
         }