@pisell/pisellos 2.3.27 → 2.3.29

package/lib/modules/Order/utils.d.ts

@@ -3,6 +3,7 @@ import type { CartItem } from "../Cart";
 import type { OrderProductDiscountItem, OrderProduct, OrderSubmitPayload, OrderSubmitProduct, OrderSummary, OrderTempOrder } from './types';
 import type { RulesParamsHooks } from '../Rules/types';
 import type { MapOrderPaymentsOptions, OrderPaymentData, OrderPaymentSource } from './types';
+import { createUuidV4 } from './utils/orderCollectionIdentity';
 export interface OrderProductsDepositProtocol {
     id: number;
     title: string;
@@ -177,7 +178,7 @@ export declare const mergeRelationForms: (relationForms: {
     form_record_ids: number[];
 }[];
 export declare const getAllDiscountList: (cartItem: CartItem) => any;
-export declare function createUuidV4(): string;
+export { createUuidV4 };
 export declare function isTempOrder(data: any): data is OrderTempOrder;
 export declare function formatDateTime(date: Date): string;
 export declare function normalizeBookingIsAll(booking: Record<string, any>): 0 | 1;

package/lib/modules/Order/utils.js

@@ -37,7 +37,7 @@ __export(utils_exports, {
   createDefaultOrderRulesHooks: () => createDefaultOrderRulesHooks,
   createDefaultTempOrder: () => createDefaultTempOrder,
   createEmptySummary: () => import_utils2.createEmptySummary,
-  createUuidV4: () => createUuidV4,
+  createUuidV4: () => import_orderCollectionIdentity.createUuidV4,
   ensureManualProductDiscountList: () => import_manualProductDiscount.ensureManualProductDiscountList,
   ensureProductSku: () => ensureProductSku,
   findManualProductDiscountItem: () => import_manualProductDiscount.findManualProductDiscountItem,
@@ -86,6 +86,7 @@ module.exports = __toCommonJS(utils_exports);
 var import_dayjs = __toESM(require("dayjs"));
 var import_decimal = __toESM(require("decimal.js"));
 var import_utils = require("../../solution/ScanOrder/utils");
+var import_orderCollectionIdentity = require("./utils/orderCollectionIdentity");
 var import_utils2 = require("../../solution/ScanOrder/utils");
 var import_manualProductDiscount = require("./utils/manualProductDiscount");
 function composeLinePrice(params) {
@@ -641,14 +642,6 @@ var getAllDiscountList = (cartItem) => {
   });
   return discountList;
 };
-function createUuidV4() {
-  const template = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx";
-  return template.replace(/[xy]/g, (char) => {
-    const randomValue = Math.floor(Math.random() * 16);
-    const value = char === "x" ? randomValue : randomValue & 3 | 8;
-    return value.toString(16);
-  });
-}
 function isTempOrder(data) {
   if (!data || typeof data !== "object")
     return false;
@@ -938,7 +931,7 @@ function buildSubmitPayload(params) {
     enhance
   } = params;
   const scheduleDate = tempOrder.schedule_date || tempOrder.created_at || formatDateTime(now);
-  const bookingUuid = createUuidV4();
+  const bookingUuid = (0, import_orderCollectionIdentity.createUuidV4)();
   const {
     _extend,
     relation_id: _relationId,
@@ -1086,7 +1079,7 @@ function formatV1Product(products) {
       note: String(product.note ?? ""),
       rowKey: product.product_id,
       session: null,
-      unique: createUuidV4()
+      unique: (0, import_orderCollectionIdentity.createUuidV4)()
     };
   });
 }

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

@@ -9,6 +9,26 @@ export interface ProductCollection {
     /** 商品集合封面 */
     cover: string;
 }
+/**
+ * 商品 Data Variant 记录，结构与后端 data_variant 表对齐。
+ */
+export interface ProductDataVariant {
+    /** 变体记录 id */
+    id: number;
+    /** 店铺 id */
+    shop_id: number;
+    /** 所属模块，商品场景固定为 product */
+    module: string;
+    /** 模块数据 id，商品场景对应 product.id */
+    module_data_id: number;
+    /** 关联 data_variant_rule.id */
+    data_variant_rule_id: number;
+    /** 命中策略后覆盖到商品上的字段 */
+    data: Record<string, any>;
+    created_at: string | null;
+    updated_at: string | null;
+    deleted_at: string | null;
+}
 /**
  * 商品基本信息接口
  */
@@ -214,6 +234,8 @@ export interface ProductData {
     bundle_group_count: number;
     /** 选项组数量 */
     option_group_count: number;
+    /** 智能定价变体列表，/product/query with dataVariants 返回 */
+    data_variants?: ProductDataVariant[];
     /** 服务时长 */
     service_times?: any;
 }

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

@@ -26,7 +26,7 @@ export declare class ProductList extends BaseModule implements Module {
      * const products = await productList.getAddTimeProducts({ schedule_date: '2026-06-16' });
      */
     getAddTimeProducts(params?: ProductListLoadProductsParams): Promise<any>;
-    loadProducts({ category_ids, product_ids, collection, menu_list_ids, customer_id: paramsCustomerId, with_count, schedule_datetime, schedule_date, cacheId, with_schedule, extension_type, status, }?: ProductListLoadProductsParams, options?: {
+    loadProducts({ category_ids, product_ids, collection, menu_list_ids, customer_id: paramsCustomerId, with_count, schedule_datetime, schedule_date, cacheId, with_schedule, extension_type, status, strategy_context, }?: ProductListLoadProductsParams, options?: {
         callback?: (result: any) => void;
         subscriberId?: string;
     }): Promise<any>;

package/lib/modules/ProductList/index.js

@@ -95,7 +95,8 @@ var ProductList = class extends import_BaseModule.BaseModule {
     cacheId,
     with_schedule,
     extension_type,
-    status = "published"
+    status = "published",
+    strategy_context
   } = {}, options) {
     var _a, _b;
     let userPlugin = this.core.getPlugin("user");
@@ -135,7 +136,8 @@ var ProductList = class extends import_BaseModule.BaseModule {
         is_eject: 1,
         with_schedule,
         schedule_datetime,
-        extension_type
+        extension_type,
+        strategy_context
       },
       { osServer: true, callback: options == null ? void 0 : options.callback, subscriberId: options == null ? void 0 : options.subscriberId, customToast: () => {
       } }

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

@@ -12,6 +12,8 @@ export interface ProductListLoadProductsParams {
     with_schedule?: number;
     extension_type?: string[];
     status?: string;
+    /** 智能定价条件上下文，仅影响策略命中，不参与商品集合筛选 */
+    strategy_context?: Record<string, any>;
 }
 export interface ProductListData {
     list: ProductData[];

package/lib/server/index.d.ts

@@ -47,6 +47,8 @@ declare class Server {
     private prefixRouterGet;
     router: Router;
     private productQuerySubscribers;
+    /** subscriberId → 智能定价变价时间点定时器句柄（与 subscriber 分离存储，便于 clear） */
+    private productQueryScheduleTimers;
     private orderQuerySubscribers;
     private bookingQuerySubscribers;
     private bookingRemoteQuerySubscribers;
@@ -210,6 +212,48 @@ declare class Server {
      * 根据 subscriberId 移除商品查询订阅者
      */
     removeProductQuerySubscriber(subscriberId?: string): void;
+    /**
+     * 构建商品 query 响应 data 段，附带智能定价 schedule_time_points 元数据。
+     */
+    private buildProductQueryResultPayload;
+    /**
+     * 是否启用商品 query 订阅的 schedule 时间点定时重算。
+     * strategy_context.enable_schedule_reload === false 时关闭。
+     */
+    private shouldScheduleProductQueryReload;
+    /**
+     * 清除指定 subscriber 的全部 schedule 定时器，防止重复 query 或 unsubscribe 后泄漏。
+     */
+    private clearSubscriberScheduleTimers;
+    /**
+     * 从 productQueryScheduleTimers 移除已触发的 timer 引用。
+     */
+    private removeScheduleTimerRef;
+    /**
+     * 计算 schedule 变价时间点到当前时刻的延迟（ms）。已过期返回 -1。
+     */
+    private computeScheduleTimePointDelayMs;
+    /**
+     * 定时重算前刷新 subscriber schedule 上下文：使用执行瞬间时间，禁止沿用首次 query 的 schedule_datetime。
+     */
+    private refreshSubscriberScheduleAtExecution;
+    /**
+     * 为 subscriber 注册智能定价 scheduleTimePoints 定时重算。
+     * 必须先 clearSubscriberScheduleTimers，再调用本方法。
+     */
+    private scheduleSubscriberTimePointReloads;
+    /**
+     * schedule 变价时间点定时器触发：刷新 schedule_datetime 后重算并 callback。
+     */
+    private onScheduleTimePointTimerFire;
+    /**
+     * 对单个商品 query 订阅者重算并推送（定时路径；不新建 schedule timer）。
+     */
+    private recomputeAndNotifySubscriber;
+    /**
+     * query 完成后为 subscriber 同步 schedule 定时器（先 clear 再 schedule）。
+     */
+    private syncProductQueryScheduleTimers;
     /**
      * 处理商品查询请求
      * 存储订阅者信息，便于数据变更时推送最新结果
@@ -570,6 +614,12 @@ declare class Server {
      * @param options.changedIds 变更的商品 IDs，用于增量更新价格缓存
      */
     private computeProductQueryResult;
+    /**
+     * 构建商品格式化上下文。
+     *
+     * 智能定价条件使用全量 menuList/scheduleList；Product Query 顶层参数只保留筛选商品集合所需字段。
+     */
+    private buildProductFormatterContext;
     /**
      * 数据变更后，遍历所有订阅者重新计算查询结果并通过 callback 推送
      * 由 ProductsModule 的 onProductsSyncCompleted 事件触发

package/lib/server/index.js

@@ -76,6 +76,8 @@ var Server = class {
     };
     // ---- 商品查询订阅者 ----
     this.productQuerySubscribers = /* @__PURE__ */ new Map();
+    /** subscriberId → 智能定价变价时间点定时器句柄（与 subscriber 分离存储，便于 clear） */
+    this.productQueryScheduleTimers = /* @__PURE__ */ new Map();
     // ---- 订单 / 预约列表查询订阅者 ----
     this.orderQuerySubscribers = /* @__PURE__ */ new Map();
     this.bookingQuerySubscribers = /* @__PURE__ */ new Map();
@@ -208,7 +210,7 @@ var Server = class {
      */
     this.handleProductQuery = async ({ url, method, data, config }) => {
       console.log("[Server] handleProductQuery:", url, method, data, config);
-      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, extension_type } = data;
+      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, extension_type, strategy_context } = data;
       const { callback, subscriberId } = config || {};
       this.logInfo("handleProductQuery: 开始处理商品查询请求", {
         menu_list_ids,
@@ -216,19 +218,32 @@ var Server = class {
         schedule_datetime,
         schedule_date,
         customer_id,
-        extension_type
+        extension_type,
+        strategyContextKeys: strategy_context ? Object.keys(strategy_context) : []
       });
       if (subscriberId && typeof callback === "function") {
         this.productQuerySubscribers.set(subscriberId, {
           callback,
-          context: { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type }
+          context: { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, strategy_context }
         });
         this.logInfo("handleProductQuery: 已注册订阅者", {
           subscriberId,
           totalSubscribers: this.productQuerySubscribers.size
         });
       }
-      return this.computeProductQueryResult({ menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type });
+      const result = await this.computeProductQueryResult({
+        menu_list_ids,
+        ids,
+        schedule_date,
+        schedule_datetime,
+        customer_id,
+        extension_type,
+        strategy_context
+      });
+      if (subscriberId && typeof callback === "function") {
+        this.syncProductQueryScheduleTimers(subscriberId, strategy_context);
+      }
+      return result;
     };
     /**
      * 按商品 id 查询单条（GET /shop/product/query/:productId）
@@ -1911,6 +1926,7 @@ var Server = class {
    */
   removeProductQuerySubscriber(subscriberId) {
     if (subscriberId) {
+      this.clearSubscriberScheduleTimers(subscriberId);
       this.productQuerySubscribers.delete(subscriberId);
       this.logInfo("removeProductQuerySubscriber: 已移除订阅者", {
         subscriberId,
@@ -1918,6 +1934,156 @@ var Server = class {
       });
     }
   }
+  /**
+   * 构建商品 query 响应 data 段，附带智能定价 schedule_time_points 元数据。
+   */
+  buildProductQueryResultPayload(list, count) {
+    var _a, _b;
+    return {
+      list,
+      count: count ?? list.length,
+      schedule_time_points: ((_b = (_a = this.products) == null ? void 0 : _a.getLastScheduleTimePoints) == null ? void 0 : _b.call(_a)) ?? []
+    };
+  }
+  /**
+   * 是否启用商品 query 订阅的 schedule 时间点定时重算。
+   * strategy_context.enable_schedule_reload === false 时关闭。
+   */
+  shouldScheduleProductQueryReload(strategy_context) {
+    return (strategy_context == null ? void 0 : strategy_context.enable_schedule_reload) !== false;
+  }
+  /**
+   * 清除指定 subscriber 的全部 schedule 定时器，防止重复 query 或 unsubscribe 后泄漏。
+   */
+  clearSubscriberScheduleTimers(subscriberId) {
+    const timers = this.productQueryScheduleTimers.get(subscriberId);
+    if (timers == null ? void 0 : timers.length) {
+      timers.forEach((timerId) => clearTimeout(timerId));
+    }
+    this.productQueryScheduleTimers.delete(subscriberId);
+    const subscriber = this.productQuerySubscribers.get(subscriberId);
+    if (subscriber) {
+      subscriber.scheduleTimerIds = [];
+    }
+  }
+  /**
+   * 从 productQueryScheduleTimers 移除已触发的 timer 引用。
+   */
+  removeScheduleTimerRef(subscriberId, timerId) {
+    const timers = this.productQueryScheduleTimers.get(subscriberId);
+    if (!(timers == null ? void 0 : timers.length))
+      return;
+    const next = timers.filter((id) => id !== timerId);
+    if (next.length === 0) {
+      this.productQueryScheduleTimers.delete(subscriberId);
+    } else {
+      this.productQueryScheduleTimers.set(subscriberId, next);
+    }
+    const subscriber = this.productQuerySubscribers.get(subscriberId);
+    if (subscriber) {
+      subscriber.scheduleTimerIds = next;
+    }
+  }
+  /**
+   * 计算 schedule 变价时间点到当前时刻的延迟（ms）。已过期返回 -1。
+   */
+  computeScheduleTimePointDelayMs(scheduleDate, timePoint) {
+    const parts = timePoint.split(":");
+    if (parts.length < 2)
+      return -1;
+    const hours = parseInt(parts[0], 10);
+    const minutes = parseInt(parts[1], 10);
+    if (!Number.isFinite(hours) || !Number.isFinite(minutes))
+      return -1;
+    const target = (0, import_dayjs.default)(scheduleDate).hour(hours).minute(minutes).second(4).millisecond(0);
+    const delayMs = target.diff((0, import_dayjs.default)());
+    return delayMs >= 0 ? delayMs : -1;
+  }
+  /**
+   * 定时重算前刷新 subscriber schedule 上下文：使用执行瞬间时间，禁止沿用首次 query 的 schedule_datetime。
+   */
+  refreshSubscriberScheduleAtExecution(subscriber) {
+    const executedAt = (0, import_dayjs.default)();
+    const bookingDate = subscriber.context.schedule_date || executedAt.format("YYYY-MM-DD");
+    subscriber.context.schedule_date = bookingDate;
+    subscriber.context.schedule_datetime = `${bookingDate} ${executedAt.format("HH:mm:ss")}`;
+  }
+  /**
+   * 为 subscriber 注册智能定价 scheduleTimePoints 定时重算。
+   * 必须先 clearSubscriberScheduleTimers，再调用本方法。
+   */
+  scheduleSubscriberTimePointReloads(subscriberId, timePoints) {
+    const subscriber = this.productQuerySubscribers.get(subscriberId);
+    if (!subscriber || !timePoints.length)
+      return;
+    const scheduleDate = subscriber.context.schedule_date || (0, import_dayjs.default)().format("YYYY-MM-DD");
+    const timerIds = [];
+    for (const timePoint of timePoints) {
+      const delayMs = this.computeScheduleTimePointDelayMs(scheduleDate, timePoint);
+      if (delayMs < 0)
+        continue;
+      const timerId = setTimeout(() => {
+        void this.onScheduleTimePointTimerFire(subscriberId, timerId);
+      }, delayMs);
+      timerIds.push(timerId);
+    }
+    if (timerIds.length > 0) {
+      this.productQueryScheduleTimers.set(subscriberId, timerIds);
+      subscriber.scheduleTimerIds = timerIds;
+      this.logInfo("scheduleSubscriberTimePointReloads: 已注册定时器", {
+        subscriberId,
+        timerCount: timerIds.length,
+        timePoints
+      });
+    }
+  }
+  /**
+   * schedule 变价时间点定时器触发：刷新 schedule_datetime 后重算并 callback。
+   */
+  async onScheduleTimePointTimerFire(subscriberId, timerId) {
+    this.removeScheduleTimerRef(subscriberId, timerId);
+    if (!this.productQuerySubscribers.has(subscriberId))
+      return;
+    const subscriber = this.productQuerySubscribers.get(subscriberId);
+    this.refreshSubscriberScheduleAtExecution(subscriber);
+    await this.recomputeAndNotifySubscriber(subscriberId);
+  }
+  /**
+   * 对单个商品 query 订阅者重算并推送（定时路径；不新建 schedule timer）。
+   */
+  async recomputeAndNotifySubscriber(subscriberId) {
+    const subscriber = this.productQuerySubscribers.get(subscriberId);
+    if (!subscriber)
+      return;
+    try {
+      const result = await this.computeProductQueryResult(subscriber.context);
+      subscriber.callback(result);
+      this.logInfo("recomputeAndNotifySubscriber: 已推送", {
+        subscriberId,
+        schedule_datetime: subscriber.context.schedule_datetime
+      });
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logError("recomputeAndNotifySubscriber: 推送失败", {
+        subscriberId,
+        error: errorMessage
+      });
+    }
+  }
+  /**
+   * query 完成后为 subscriber 同步 schedule 定时器（先 clear 再 schedule）。
+   */
+  syncProductQueryScheduleTimers(subscriberId, strategy_context) {
+    var _a, _b;
+    this.clearSubscriberScheduleTimers(subscriberId);
+    if (!this.shouldScheduleProductQueryReload(strategy_context)) {
+      return;
+    }
+    const timePoints = ((_b = (_a = this.products) == null ? void 0 : _a.getLastScheduleTimePoints) == null ? void 0 : _b.call(_a)) ?? [];
+    if (timePoints.length > 0) {
+      this.scheduleSubscriberTimePointReloads(subscriberId, timePoints);
+    }
+  }
   /**
    * 执行 sales 搜索并登记可见订单号。
    * 搜索参数完全透传后端，OS 不做过滤、筛选、排序。
@@ -4111,8 +4277,14 @@ var Server = class {
    */
   async computeProductQueryResult(context, options) {
     const tTotal = performance.now();
-    const { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id } = context;
+    const { menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, extension_type, product_id, strategy_context } = context;
     const queryIds = Array.isArray(ids) ? ids.map((id) => Number(id)).filter((id) => Number.isFinite(id)) : [];
+    const formatterContext = this.buildProductFormatterContext({
+      schedule_date,
+      schedule_datetime,
+      customer_id,
+      strategy_context
+    });
     this.logInfo("computeProductQueryResult 开始", {
       menuListIdsCount: (menu_list_ids == null ? void 0 : menu_list_ids.length) ?? 0,
       ids: queryIds,
@@ -4121,20 +4293,17 @@ var Server = class {
       customer_id,
       extension_type,
       product_id,
+      strategyContextKeys: strategy_context ? Object.keys(strategy_context) : [],
       changedIds: options == null ? void 0 : options.changedIds
     });
     if (!this.products) {
       this.logError("computeProductQueryResult: Products 模块未注册");
-      return { message: "Products 模块未注册", data: { list: [], count: 0 } };
+      return { message: "Products 模块未注册", data: this.buildProductQueryResultPayload([], 0) };
     }
     if (queryIds.length > 0) {
       const uniqueIds = Array.from(new Set(queryIds));
       const tPrice2 = performance.now();
-      const productsWithPrice = await this.products.getProductsWithPrice(schedule_date, {
-        scheduleModule: this.getSchedule(),
-        schedule_datetime,
-        customer_id
-      }, {
+      const productsWithPrice = await this.products.getProductsWithPrice(schedule_date, formatterContext, {
         changedIds: options == null ? void 0 : options.changedIds,
         productIds: uniqueIds
       });
@@ -4155,7 +4324,7 @@ var Server = class {
       });
       return {
         code: 200,
-        data: { list: extensionFilteredProducts, count: extensionFilteredProducts.length },
+        data: this.buildProductQueryResultPayload(extensionFilteredProducts),
         message: "",
         status: true
       };
@@ -4163,9 +4332,7 @@ var Server = class {
     if (product_id != null && Number.isFinite(Number(product_id))) {
       const pid = Number(product_id);
       const tPrice2 = performance.now();
-      const allProductsWithPrice = await this.products.getProductsWithPrice(schedule_date, {
-        scheduleModule: this.getSchedule()
-      }, {
+      const allProductsWithPrice = await this.products.getProductsWithPrice(schedule_date, formatterContext, {
         changedIds: options == null ? void 0 : options.changedIds
       });
       (0, import_product.perfMark)("computeQuery.getProductsWithPrice(single)", performance.now() - tPrice2, {
@@ -4195,11 +4362,7 @@ var Server = class {
     }
     if (this.shouldQueryProductsByExtensionTypes(extension_type)) {
       const tPrice2 = performance.now();
-      let filteredProducts2 = await this.products.getProductsWithPrice(schedule_date, {
-        scheduleModule: this.getSchedule(),
-        schedule_datetime,
-        customer_id
-      }, {
+      let filteredProducts2 = await this.products.getProductsWithPrice(schedule_date, formatterContext, {
         changedIds: options == null ? void 0 : options.changedIds
       });
       (0, import_product.perfMark)("computeQuery.getProductsWithPrice(extensionType)", performance.now() - tPrice2, {
@@ -4239,18 +4402,18 @@ var Server = class {
       });
       return {
         code: 200,
-        data: { list: filteredProducts2, count: filteredProducts2.length },
+        data: this.buildProductQueryResultPayload(filteredProducts2),
         message: "",
         status: true
       };
     }
     if (!this.menu) {
       this.logError("computeProductQueryResult: Menu 模块未注册");
-      return { message: "Menu 模块未注册", data: { list: [], count: 0 } };
+      return { message: "Menu 模块未注册", data: this.buildProductQueryResultPayload([], 0) };
     }
     if (!this.schedule) {
       this.logError("computeProductQueryResult: Schedule 模块未注册");
-      return { message: "Schedule 模块未注册", data: { list: [], count: 0 } };
+      return { message: "Schedule 模块未注册", data: this.buildProductQueryResultPayload([], 0) };
     }
     let activeMenuList = [];
     if (menu_list_ids && Array.isArray(menu_list_ids) && menu_list_ids.length > 0) {
@@ -4274,11 +4437,7 @@ var Server = class {
       isAllProducts: !!productScope.isAllProducts
     });
     const tPrice = performance.now();
-    let filteredProducts = scopedProductIds.length > 0 ? await this.products.getProductsWithPrice(schedule_date, {
-      scheduleModule: this.getSchedule(),
-      schedule_datetime,
-      customer_id
-    }, {
+    let filteredProducts = scopedProductIds.length > 0 ? await this.products.getProductsWithPrice(schedule_date, formatterContext, {
       changedIds: options == null ? void 0 : options.changedIds,
       productIds: productScope.isAllProducts ? void 0 : scopedProductIds
     }) : [];
@@ -4321,11 +4480,29 @@ var Server = class {
     });
     return {
       code: 200,
-      data: { list: filteredProducts, count: filteredProducts.length },
+      data: this.buildProductQueryResultPayload(filteredProducts),
       message: "",
       status: true
     };
   }
+  /**
+   * 构建商品格式化上下文。
+   *
+   * 智能定价条件使用全量 menuList/scheduleList；Product Query 顶层参数只保留筛选商品集合所需字段。
+   */
+  buildProductFormatterContext(context) {
+    var _a, _b, _c, _d;
+    const scheduleModule = this.getSchedule();
+    return {
+      scheduleModule,
+      schedule_datetime: context.schedule_datetime,
+      customer_id: context.customer_id,
+      strategy_context: context.strategy_context,
+      menuList: ((_b = (_a = this.menu) == null ? void 0 : _a.getMenuList) == null ? void 0 : _b.call(_a)) || [],
+      scheduleList: ((_c = scheduleModule == null ? void 0 : scheduleModule.getScheduleList) == null ? void 0 : _c.call(scheduleModule)) || [],
+      dataVariantEvaluator: (_d = this.core.context) == null ? void 0 : _d.dataVariantEvaluator
+    };
+  }
   /**
    * 数据变更后，遍历所有订阅者重新计算查询结果并通过 callback 推送
    * 由 ProductsModule 的 onProductsSyncCompleted 事件触发

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

@@ -43,6 +43,16 @@ export declare class OrderModule extends BaseModule implements Module {
      */
     private logError;
     private logWarning;
+    /**
+     * 在订单进入内存或 SQLite 前统一压缩子项强身份重复并补齐协议 UID。
+     * 仅记录计数与订单标识，不输出商品、预约、支付或客户明细。
+     */
+    private normalizeOrderCollectionsForIngress;
+    /**
+     * incoming 决定权威成员集合；同一持久化行仍从 existing 补齐 incoming 省略的本地展示字段。
+     */
+    private mergeAuthoritativeOrderCollection;
+    private reconcileOverwriteOrderCollections;
     /**
      * 记录订单最近一次 SQLite 写入，供 pubsub 回声去重使用。
      *
@@ -212,10 +222,6 @@ export declare class OrderModule extends BaseModule implements Module {
     private findOrderIndexByIdentity;
     private getOrderCompletenessScore;
     private pickPreferredOrder;
-    private getProductIdentityKeys;
-    private mergeOrderProductLists;
-    private getPaymentMergeKey;
-    private mergeOrderPaymentLists;
     private mergeOrderRecords;
     private summarizeDuplicateOrders;
     private logDuplicateOrders;