@pisell/pisellos 2.2.97 → 2.2.99

package/dist/server/types.d.ts

@@ -25,6 +25,8 @@ export type RouteHandler = (params: {
     method: 'get' | 'post' | 'remove' | 'put';
     data?: any;
     config?: RequestSetting;
+    /** 路由路径（前缀匹配时由 handleRoute 注入，便于 handler 解析动态段） */
+    path?: string;
 }) => Promise<any> | any;
 /**
  * HTTP 方法类型

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

@@ -344,7 +344,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
     };
     setOtherData(key: string, value: any): void;
     getOtherData(key: string): any;
-    getProductTypeById(id: number): Promise<"duration" | "session" | "normal">;
+    getProductTypeById(id: number): Promise<"normal" | "duration" | "session">;
     /**
      * 提供给 UI 的方法，减轻 UI 层的计算压力，UI 层只需要传递 cartItemId 和 resourceCode 即返回对应的 renderList
      *

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

@@ -87,10 +87,11 @@ export declare class SalesImpl extends BaseModule implements Module, SalesModule
     /**
      * 标准化单条 booking：
      * - 过滤终态（rejected/cancelled/completed）
+     * - 当 deviceTime 早于 currentTime 时，过滤 end_time 早于 currentTime 的历史数据
      * - 注入 status / isTimeout / reserved_status
      */
     private normalizeMatchedBooking;
-    getResourceBookingList(currentTime: string, bookingList?: BookingData[]): Promise<SalesResourceBookingItem[]>;
+    getResourceBookingList(currentTime: string, bookingList?: BookingData[], deviceTime?: string): Promise<SalesResourceBookingItem[]>;
 }
 export { SalesImpl as Sales };
 export default SalesImpl;

package/dist/solution/Sales/index.js

@@ -423,18 +423,21 @@ export var SalesImpl = /*#__PURE__*/function (_BaseModule) {
     /**
      * 标准化单条 booking：
      * - 过滤终态（rejected/cancelled/completed）
+     * - 当 deviceTime 早于 currentTime 时，过滤 end_time 早于 currentTime 的历史数据
      * - 注入 status / isTimeout / reserved_status
      */
   }, {
     key: "normalizeMatchedBooking",
-    value: function normalizeMatchedBooking(current, booking) {
+    value: function normalizeMatchedBooking(current, deviceCurrent, booking) {
       var _ref3, _booking$appointment_;
       var appointmentStatus = String((_ref3 = (_booking$appointment_ = booking.appointment_status) !== null && _booking$appointment_ !== void 0 ? _booking$appointment_ : booking.status) !== null && _ref3 !== void 0 ? _ref3 : '');
       if (appointmentStatus === 'rejected' || appointmentStatus === 'cancelled' || appointmentStatus === 'completed') {
         return null;
       }
-      var bookingStatus = this.getBookingStatus(appointmentStatus);
       var endAt = this.toBookingDateTime(booking.end_date, booking.end_time);
+      var shouldFilterHistoryByCurrent = deviceCurrent.isBefore(current);
+      if (shouldFilterHistoryByCurrent && endAt.isValid() && endAt.isBefore(current)) return null;
+      var bookingStatus = this.getBookingStatus(appointmentStatus);
       var startAt = this.toBookingDateTime(booking.start_date, booking.start_time);
       var isTimeout = bookingStatus === 'occupied' && endAt.isValid() && current.isAfter(endAt);
       var timeoutTime = isTimeout ? current.diff(endAt, 'minute') : undefined;
@@ -478,7 +481,9 @@ export var SalesImpl = /*#__PURE__*/function (_BaseModule) {
           _resourceResponse$dat2,
           _this3 = this;
         var bookingList,
+          deviceTime,
           current,
+          deviceCurrent,
           resourceResponse,
           resourceList,
           normalizedBookings,
@@ -488,15 +493,23 @@ export var SalesImpl = /*#__PURE__*/function (_BaseModule) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
               bookingList = _args3.length > 1 && _args3[1] !== undefined ? _args3[1] : [];
+              deviceTime = _args3.length > 2 && _args3[2] !== undefined ? _args3[2] : currentTime;
               // currentTime 约定为完整 datetime；非法值直接返回空，避免误判
               current = dayjs(currentTime);
               if (current.isValid()) {
-                _context3.next = 4;
+                _context3.next = 5;
+                break;
+              }
+              return _context3.abrupt("return", []);
+            case 5:
+              deviceCurrent = dayjs(deviceTime);
+              if (deviceCurrent.isValid()) {
+                _context3.next = 8;
                 break;
               }
               return _context3.abrupt("return", []);
-            case 4:
-              _context3.next = 6;
+            case 8:
+              _context3.next = 10;
               return this.request.get('/shop/form/resource/page', {
                 skip: 1,
                 num: 999
@@ -506,18 +519,18 @@ export var SalesImpl = /*#__PURE__*/function (_BaseModule) {
                 osServer: true,
                 isShopApi: true
               });
-            case 6:
+            case 10:
               resourceResponse = _context3.sent;
               resourceList = (_resourceResponse$dat = resourceResponse === null || resourceResponse === void 0 || (_resourceResponse$dat2 = resourceResponse.data) === null || _resourceResponse$dat2 === void 0 ? void 0 : _resourceResponse$dat2.list) !== null && _resourceResponse$dat !== void 0 ? _resourceResponse$dat : [];
               if (!(!Array.isArray(resourceList) || resourceList.length === 0)) {
-                _context3.next = 10;
+                _context3.next = 14;
                 break;
               }
               return _context3.abrupt("return", []);
-            case 10:
+            case 14:
               // 全局先做 booking 标准化 + start_time 升序，后续映射直接复用
               normalizedBookings = bookingList.map(function (booking) {
-                return _this3.normalizeMatchedBooking(current, booking);
+                return _this3.normalizeMatchedBooking(current, deviceCurrent, booking);
               }).filter(function (booking) {
                 return Boolean(booking);
               }).sort(function (left, right) {
@@ -548,7 +561,7 @@ export var SalesImpl = /*#__PURE__*/function (_BaseModule) {
                   bookings: bookings
                 });
               }));
-            case 14:
+            case 18:
             case "end":
               return _context3.stop();
           }

package/dist/solution/Sales/types.d.ts

@@ -61,7 +61,7 @@ export interface SalesModuleAPI {
     /** 重置预约列表为空 */
     resetReservationList: () => Reservation[];
     /** 获取资源维度的预约占用列表 */
-    getResourceBookingList: (currentTime: string, bookingList: BookingData[]) => Promise<SalesResourceBookingItem[]>;
+    getResourceBookingList: (currentTime: string, bookingList: BookingData[], deviceTime?: string) => Promise<SalesResourceBookingItem[]>;
     /** 获取时间轴每个时间片的预约数量 */
     getTimelineHighlights: (bookingList: BookingData[], startDateTime?: string, endDateTime?: string) => SalesTimelineHighlights;
 }

package/lib/model/strategy/adapter/walletPass/type.d.ts

@@ -41,7 +41,7 @@ export interface Voucher {
         allowCrossProduct: boolean;
         /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
         applicableProductLimit: number;
-        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品行最多抵扣次数）。默认为 0，表示不限制。 */
+        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品的每个 unit 最多抵扣次数，总上限 = maxPassesPerItem × quantity）。默认为 0，表示不限制。 */
         maxPassesPerItem: number;
     };
 }
@@ -129,7 +129,7 @@ export interface EvaluatorInput {
         allowCrossProduct: boolean;
         /** 可用商品数量上限 （仅多商品） 默认为0，表示不限制商品数量。 */
         applicableProductLimit: number;
-        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品行最多抵扣次数）。默认为 0，表示不限制。 */
+        /** 单商品可用卡券上限（同一 Wallet Pass 商品生成的卡券对同一商品的每个 unit 最多抵扣次数，总上限 = maxPassesPerItem × quantity）。默认为 0，表示不限制。 */
         maxPassesPerItem: number;
     }>[];
 }

package/lib/model/strategy/adapter/walletPass/utils.js

@@ -82,6 +82,9 @@ var getApplicableProducts = (voucher, productsData) => {
   }
   return productsData.filter((p) => applicableProductIds.includes(p.product_id));
 };
+var getTotalQuantityByProductId = (allProducts, productId) => {
+  return allProducts.filter((p) => p.product_id === productId).reduce((sum, p) => sum + getProductQuantity(p), 0);
+};
 function processVouchers(applicableVouchers, orderTotalAmount, products) {
   console.log(products, "products123");
   const productsCopy = expandProductsWithBundleItems(products, true);
@@ -90,18 +93,18 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
     var _a;
     return ((_a = usageMap.get(walletPassProductId)) == null ? void 0 : _a.get(orderItemProductId)) || 0;
   };
-  const incrementItemPassUsage = (usageMap, walletPassProductId, orderItemProductId) => {
+  const incrementItemPassUsage = (usageMap, walletPassProductId, orderItemProductId, count = 1) => {
     if (!usageMap.has(walletPassProductId)) {
       usageMap.set(walletPassProductId, /* @__PURE__ */ new Map());
     }
     const innerMap = usageMap.get(walletPassProductId);
-    innerMap.set(orderItemProductId, (innerMap.get(orderItemProductId) || 0) + 1);
+    innerMap.set(orderItemProductId, (innerMap.get(orderItemProductId) || 0) + count);
   };
-  const filterByMaxPassesPerItem = (products2, usageMap, walletPassProductId, maxPassesPerItem) => {
+  const filterByMaxPassesPerItem = (products2, allProducts, usageMap, walletPassProductId, maxPassesPerItem) => {
     if (maxPassesPerItem <= 0)
       return products2;
     return products2.filter(
-      (p) => getItemPassUsage(usageMap, walletPassProductId, p.product_id) < maxPassesPerItem
+      (p) => getItemPassUsage(usageMap, walletPassProductId, p.product_id) < maxPassesPerItem * getTotalQuantityByProductId(allProducts, p.product_id)
     );
   };
   const calculateAvailableMaxAmount = (voucher, productsData, itemPassUsage) => {
@@ -116,7 +119,7 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
     const amountField = deductTaxAndFee ? "remainingAmountWithTax" : "remainingAmountPure";
     let applicableProducts = getApplicableProducts(voucher, productsData).filter((p) => p[amountField].greaterThan(0));
     if (itemPassUsage) {
-      applicableProducts = filterByMaxPassesPerItem(applicableProducts, itemPassUsage, voucher.product_id, maxPassesPerItem);
+      applicableProducts = filterByMaxPassesPerItem(applicableProducts, productsData, itemPassUsage, voucher.product_id, maxPassesPerItem);
     }
     if (applicableProducts.length === 0) {
       return new import_decimal.default(0);
@@ -146,14 +149,16 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
       }
     } else {
       const maxProduct = applicableProducts.reduce(
-        (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-      );
-      const currentAvailableQty = Math.ceil(maxProduct[amountField].dividedBy(maxProduct[unitPriceField]).toNumber());
-      const deductQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-      finalApplicableAmount = import_decimal.default.min(
-        maxProduct[unitPriceField].times(deductQty),
-        maxProduct[amountField]
+        (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
       );
+      if (maxPassesPerItem > 0) {
+        finalApplicableAmount = import_decimal.default.min(
+          maxProduct[unitPriceField].times(maxPassesPerItem),
+          maxProduct[amountField]
+        );
+      } else {
+        finalApplicableAmount = maxProduct[amountField];
+      }
     }
     return import_decimal.default.min(baseAmount, finalApplicableAmount, remainingOrderAmount);
   };
@@ -180,7 +185,7 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
     if (maxPassesPerItem > 0 && itemPassUsage) {
       const deductTaxAndFee = (config == null ? void 0 : config.deductTaxAndFee) ?? true;
       const amountField = deductTaxAndFee ? "remainingAmountWithTax" : "remainingAmountPure";
-      const availableAfterPassLimit = getApplicableProducts(voucher, productsData).filter((p) => p[amountField].greaterThan(0)).filter((p) => getItemPassUsage(itemPassUsage, product_id, p.product_id) < maxPassesPerItem);
+      const availableAfterPassLimit = getApplicableProducts(voucher, productsData).filter((p) => p[amountField].greaterThan(0)).filter((p) => getItemPassUsage(itemPassUsage, product_id, p.product_id) < maxPassesPerItem * getTotalQuantityByProductId(productsData, p.product_id));
       if (availableAfterPassLimit.length === 0) {
         return { isAvailable: false, reasonCode: "max_passes_per_item_reached" };
       }
@@ -230,7 +235,7 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
       voucher,
       productsForRecommendation
     ).filter((p) => p[amountField].greaterThan(0));
-    applicableProducts = filterByMaxPassesPerItem(applicableProducts, itemPassUsageMap, product_id, maxPassesPerItem);
+    applicableProducts = filterByMaxPassesPerItem(applicableProducts, productsForRecommendation, itemPassUsageMap, product_id, maxPassesPerItem);
     if (applicableProducts.length === 0)
       return false;
     const usageAmount = typeof voucher.edit_current_amount === "number" ? voucher.edit_current_amount : getRecommendedAmount(voucher);
@@ -263,14 +268,16 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
       }
     } else {
       const maxProduct = applicableProducts.reduce(
-        (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-      );
-      const currentAvailableQty = Math.ceil(maxProduct[amountField].dividedBy(maxProduct[unitPriceField]).toNumber());
-      const deductQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-      calculatedAvailableMaxAmount = import_decimal.default.min(
-        maxProduct[unitPriceField].times(deductQty),
-        maxProduct[amountField]
+        (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
       );
+      if (maxPassesPerItem > 0) {
+        calculatedAvailableMaxAmount = import_decimal.default.min(
+          maxProduct[unitPriceField].times(maxPassesPerItem),
+          maxProduct[amountField]
+        );
+      } else {
+        calculatedAvailableMaxAmount = maxProduct[amountField];
+      }
     }
     const availableMaxAmount = import_decimal.default.min(
       baseAmount,
@@ -314,14 +321,15 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
       }
     } else {
       const targetProduct = applicableProducts.reduce(
-        (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-      );
-      const currentAvailableQty = Math.ceil(targetProduct[amountField].dividedBy(targetProduct[unitPriceField]).toNumber());
-      const availableQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-      const maxDeductForProduct = import_decimal.default.min(
-        targetProduct[unitPriceField].times(availableQty),
-        targetProduct[amountField]
+        (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
       );
+      let maxDeductForProduct = targetProduct[amountField];
+      if (maxPassesPerItem > 0) {
+        maxDeductForProduct = import_decimal.default.min(
+          targetProduct[unitPriceField].times(maxPassesPerItem),
+          targetProduct[amountField]
+        );
+      }
       const actualDeductAmount = import_decimal.default.min(deductionLeft, maxDeductForProduct);
       const actualDeductQty = Math.ceil(actualDeductAmount.dividedBy(targetProduct[unitPriceField]).toNumber());
       targetProduct[amountField] = targetProduct[amountField].minus(actualDeductAmount);
@@ -331,9 +339,7 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
         parent_product_id: targetProduct.parent_product_id || null,
         is_bundle_item: targetProduct.is_bundle_item || false,
         deductAmount: actualDeductAmount.toNumber(),
-        // 转换为数字
         deductQuantity: actualDeductQty
-        // 抵扣涉及的数量（用于记录）
       });
     }
     const totalDeducted = maxDeduction.minus(deductionLeft);
@@ -341,7 +347,7 @@ function processVouchers(applicableVouchers, orderTotalAmount, products) {
       remainingOrderAmount = remainingOrderAmount.minus(totalDeducted);
       usedVoucherCounts.set(product_id, (usedVoucherCounts.get(product_id) || 0) + 1);
       deductionDetails.forEach((detail) => {
-        incrementItemPassUsage(itemPassUsageMap, product_id, detail.product_id);
+        incrementItemPassUsage(itemPassUsageMap, product_id, detail.product_id, detail.deductQuantity);
       });
       recommendedVouchers.push({
         ...voucher,
@@ -389,18 +395,18 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
     var _a;
     return ((_a = itemPassUsageMap.get(walletPassProductId)) == null ? void 0 : _a.get(orderItemProductId)) || 0;
   };
-  const incrementItemPassUsage = (walletPassProductId, orderItemProductId) => {
+  const incrementItemPassUsage = (walletPassProductId, orderItemProductId, count = 1) => {
     if (!itemPassUsageMap.has(walletPassProductId)) {
       itemPassUsageMap.set(walletPassProductId, /* @__PURE__ */ new Map());
     }
     const innerMap = itemPassUsageMap.get(walletPassProductId);
-    innerMap.set(orderItemProductId, (innerMap.get(orderItemProductId) || 0) + 1);
+    innerMap.set(orderItemProductId, (innerMap.get(orderItemProductId) || 0) + count);
   };
   const filterByMaxPassesPerItem = (products2, walletPassProductId, maxPassesPerItem) => {
     if (maxPassesPerItem <= 0)
       return products2;
     return products2.filter(
-      (p) => getItemPassUsage(walletPassProductId, p.product_id) < maxPassesPerItem
+      (p) => getItemPassUsage(walletPassProductId, p.product_id) < maxPassesPerItem * getTotalQuantityByProductId(productsForCalc, p.product_id)
     );
   };
   selectedVouchers.forEach((selectedVoucher) => {
@@ -463,14 +469,15 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
       }
     } else {
       const targetProduct = applicableProducts.reduce(
-        (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-      );
-      const currentAvailableQty = Math.ceil(targetProduct[amountField].dividedBy(targetProduct[unitPriceField]).toNumber());
-      const availableQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-      const maxDeductForProduct = import_decimal.default.min(
-        targetProduct[unitPriceField].times(availableQty),
-        targetProduct[amountField]
+        (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
       );
+      let maxDeductForProduct = targetProduct[amountField];
+      if (maxPassesPerItem > 0) {
+        maxDeductForProduct = import_decimal.default.min(
+          targetProduct[unitPriceField].times(maxPassesPerItem),
+          targetProduct[amountField]
+        );
+      }
       const actualDeductAmount = import_decimal.default.min(deductionLeft, maxDeductForProduct);
       const actualDeductQty = Math.ceil(actualDeductAmount.dividedBy(targetProduct[unitPriceField]).toNumber());
       targetProduct[amountField] = targetProduct[amountField].minus(actualDeductAmount);
@@ -480,15 +487,13 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
         parent_product_id: targetProduct.parent_product_id || null,
         is_bundle_item: targetProduct.is_bundle_item || false,
         deductAmount: actualDeductAmount.toNumber(),
-        // 转换为数字
         deductQuantity: actualDeductQty
-        // 抵扣涉及的数量（用于记录）
       });
     }
     const totalDeducted = maxDeduction.minus(deductionLeft);
     remainingOrderAmount = remainingOrderAmount.minus(totalDeducted);
     deductionDetails.forEach((detail) => {
-      incrementItemPassUsage(selectedVoucher.product_id, detail.product_id);
+      incrementItemPassUsage(selectedVoucher.product_id, detail.product_id, detail.deductQuantity);
     });
     selectedWithDetails.push({
       ...selectedVoucher,
@@ -572,14 +577,16 @@ function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmount, pr
             }
           } else {
             const maxProduct = applicableProducts.reduce(
-              (max, p) => p[amountField].greaterThan(max[amountField]) ? p : max
-            );
-            const currentAvailableQty = Math.ceil(maxProduct[amountField].dividedBy(maxProduct[unitPriceField]).toNumber());
-            const deductQty = applicableProductLimit > 0 ? Math.min(currentAvailableQty, applicableProductLimit) : currentAvailableQty;
-            calculatedMaxAmount = import_decimal.default.min(
-              maxProduct[unitPriceField].times(deductQty),
-              maxProduct[amountField]
+              (max, p) => p[unitPriceField].greaterThan(max[unitPriceField]) ? p : max
             );
+            if (maxPassesPerItem > 0) {
+              calculatedMaxAmount = import_decimal.default.min(
+                maxProduct[unitPriceField].times(maxPassesPerItem),
+                maxProduct[amountField]
+              );
+            } else {
+              calculatedMaxAmount = maxProduct[amountField];
+            }
           }
           calculatedMaxAmount = import_decimal.default.min(
             baseAmount,

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

@@ -23,7 +23,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      */
     private logError;
     createOrder(params: CommitOrderParams['query']): {
-        type: "appointment_booking" | "virtual";
+        type: "virtual" | "appointment_booking";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;

package/lib/server/index.d.ts

@@ -3,6 +3,7 @@ import { MenuModule } from './modules/menu';
 import { QuotationModule } from './modules/quotation';
 import { ScheduleModuleEx } from './modules/schedule';
 import { ResourceModule } from './modules/resource';
+import { FloorPlanModule } from './modules/floor-plan';
 import { PisellCore, ServerModuleConfig, InitializeServerOptions } from '../types';
 import type { RouteHandler, HttpMethod, RouteDefinition, Router, ModuleRegistryConfig, RequestSetting } from './types';
 import { OrderModule } from './modules/order';
@@ -21,10 +22,14 @@ declare class Server {
     schedule?: ScheduleModuleEx;
     resource?: ResourceModule;
     order?: OrderModule;
+    floor_plan?: FloorPlanModule;
+    /** GET 前缀路由（最长前缀优先匹配） */
+    private prefixRouterGet;
     router: Router;
     private productQuerySubscribers;
     private orderQuerySubscribers;
     private bookingQuerySubscribers;
+    private floorPlanQuerySubscribers;
     private moduleRegistry;
     constructor(core: PisellCore);
     /**
@@ -32,6 +37,10 @@ declare class Server {
      * @param routes 路由定义数组
      */
     private registerRoutes;
+    /**
+     * 注册前缀路由（仅 GET）。匹配规则：path === prefix 或 path 以 prefix + '/' 开头；最长前缀优先。
+     */
+    private registerPrefixRoutes;
     /**
      * 注册单个模块并自动注册其路由
      * @param module 模块实例
@@ -184,6 +193,27 @@ declare class Server {
      * 转发到资源模块去
      */
     private handleResourceList;
+    /**
+     * 从 url 或路由 path 解析 pathname（不含 query，去掉末尾 /）
+     */
+    private parseRequestPath;
+    /**
+     * 解析平面图 GET 路径为查询上下文
+     */
+    private resolveFloorPlanQueryContext;
+    /**
+     * GET /shop/schedule/floor-plan* 前缀路由：读本地 store；支持 subscriberId + callback 订阅更新
+     */
+    private handleFloorPlanGet;
+    private computeFloorPlanQueryResult;
+    /**
+     * 平面图数据变更后向所有 GET 订阅者推送最新结果
+     */
+    private recomputeAndNotifyFloorPlanQuery;
+    /**
+     * 取消平面图 GET 订阅（也可走 GET .../unsubscribe + subscriberId）
+     */
+    removeFloorPlanQuerySubscriber(subscriberId?: string): void;
     /**
      * 取消预约列表查询订阅（HTTP 路由入口）
      */