@pisell/pisellos 0.0.479 → 0.0.481

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

@@ -13,4 +13,10 @@ export type { QuotationState, QuotationData, QuotationProductPrice } from './quo
 export { QuotationHooks } from './quotation/types';
 export { ScheduleModuleEx } from './schedule';
 export type { ScheduleState, ScheduleItem } from './schedule/types';
+export { OrderModule } from './order';
+export type { OrderState, OrderData, OrderId, OrderSummary, OrderBookingItem, OrderProductLineItem, OrderPaymentItem, OrderSurchargeItem, OrderProductDiscountItem, OrderWithoutBookings, BookingData, OrderFilters, BookingFilters, OrderFilterResult, BookingFilterResult, OrderModulePagedResult, } from './order/types';
+export { OrderHooks } from './order/types';
+export { ResourceModule, resourceModule } from './resource';
+export type { ResourceState, ResourceData, ResourceId, ResourceBooking, ResourcePageQuery, ResourcePageResult, QueryOptions, ScheduleEventResource, } from './resource';
+export { ResourceHooks } from './resource';
 export type { RouteHandler, HttpMethod, RouteDefinition, Router, ModuleRegistryConfig, } from '../types';

package/lib/server/modules/index.js

@@ -21,11 +21,16 @@ var modules_exports = {};
 __export(modules_exports, {
   MenuHooks: () => import_types2.MenuHooks,
   MenuModule: () => import_menu.MenuModule,
+  OrderHooks: () => import_types4.OrderHooks,
+  OrderModule: () => import_order.OrderModule,
   ProductsHooks: () => import_types.ProductsHooks,
   ProductsModule: () => import_products.ProductsModule,
   QuotationHooks: () => import_types3.QuotationHooks,
   QuotationModule: () => import_quotation.QuotationModule,
-  ScheduleModuleEx: () => import_schedule.ScheduleModuleEx
+  ResourceHooks: () => import_resource2.ResourceHooks,
+  ResourceModule: () => import_resource.ResourceModule,
+  ScheduleModuleEx: () => import_schedule.ScheduleModuleEx,
+  resourceModule: () => import_resource.resourceModule
 });
 module.exports = __toCommonJS(modules_exports);
 var import_products = require("./products");
@@ -35,13 +40,22 @@ var import_types2 = require("./menu/types");
 var import_quotation = require("./quotation");
 var import_types3 = require("./quotation/types");
 var import_schedule = require("./schedule");
+var import_order = require("./order");
+var import_types4 = require("./order/types");
+var import_resource = require("./resource");
+var import_resource2 = require("./resource");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   MenuHooks,
   MenuModule,
+  OrderHooks,
+  OrderModule,
   ProductsHooks,
   ProductsModule,
   QuotationHooks,
   QuotationModule,
-  ScheduleModuleEx
+  ResourceHooks,
+  ResourceModule,
+  ScheduleModuleEx,
+  resourceModule
 });

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

@@ -11,6 +11,7 @@ export declare class MenuModule extends BaseModule implements Module {
     private request;
     private store;
     private dbManager;
+    private logger;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     /**
@@ -60,4 +61,22 @@ export declare class MenuModule extends BaseModule implements Module {
      * 返回该模块需要注册的 API 路由
      */
     getRoutes(): RouteDefinition[];
+    /**
+     * 记录信息日志
+     * @param title 日志标题
+     * @param metadata 日志元数据
+     */
+    private logInfo;
+    /**
+     * 记录警告日志
+     * @param title 日志标题
+     * @param metadata 日志元数据
+     */
+    private logWarning;
+    /**
+     * 记录错误日志
+     * @param title 日志标题
+     * @param metadata 日志元数据
+     */
+    private logError;
 }

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

@@ -27,7 +27,7 @@ var import_BaseModule = require("../../../modules/BaseModule");
 var import_types = require("./types");
 var INDEXDB_STORE_NAME = "menu";
 var MenuModule = class extends import_BaseModule.BaseModule {
-  // IndexDBManager 实例
+  // LoggerManager 实例
   constructor(name, version) {
     super(name, version);
     this.defaultName = "menu";
@@ -53,18 +53,26 @@ var MenuModule = class extends import_BaseModule.BaseModule {
     if (appPlugin) {
       const app = appPlugin.getApp();
       this.dbManager = app.dbManager;
+      this.logger = app.logger;
       if (this.dbManager) {
         console.log("[Menu] IndexDB Manager 已初始化");
       } else {
         console.warn("[Menu] IndexDB Manager 未找到");
       }
     }
+    this.logInfo("模块初始化完成", {
+      hasDbManager: !!this.dbManager,
+      hasLogger: !!this.logger,
+      initialMenuCount: this.store.menuList.length
+    });
   }
   /**
    * 加载餐牌列表（从服务器）
    */
   async loadMenuList() {
     var _a;
+    this.logInfo("开始从服务器加载餐牌列表");
+    const startTime = Date.now();
     try {
       const response = await this.request.get(
         `/form/data/v1`,
@@ -73,14 +81,25 @@ var MenuModule = class extends import_BaseModule.BaseModule {
           num: 999,
           code: "menu_list"
         },
-        { useCache: true }
+        { cache: void 0 }
       );
       const menuList = ((_a = response == null ? void 0 : response.data) == null ? void 0 : _a.list) || [];
+      const duration = Date.now() - startTime;
+      this.logInfo("从服务器加载餐牌列表成功", {
+        menuCount: menuList.length,
+        duration: `${duration}ms`
+      });
       await this.saveMenuToIndexDB(menuList);
       await this.setMenuList(menuList);
       return menuList;
     } catch (error) {
+      const duration = Date.now() - startTime;
+      const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Menu] 加载餐牌数据失败:", error);
+      this.logError("从服务器加载餐牌列表失败", {
+        duration: `${duration}ms`,
+        error: errorMessage
+      });
       return [];
     }
   }
@@ -104,6 +123,7 @@ var MenuModule = class extends import_BaseModule.BaseModule {
    */
   getMenuByIds(ids) {
     if (!ids || ids.length === 0) {
+      this.logInfo("getMenuByIds: 未提供有效的 ids", { idsCount: 0 });
       return [];
     }
     const result = [];
@@ -113,6 +133,11 @@ var MenuModule = class extends import_BaseModule.BaseModule {
         result.push(menu);
       }
     }
+    this.logInfo("getMenuByIds: 查询完成", {
+      requestedCount: ids.length,
+      foundCount: result.length,
+      notFoundCount: ids.length - result.length
+    });
     return result;
   }
   /**
@@ -131,6 +156,9 @@ var MenuModule = class extends import_BaseModule.BaseModule {
    * 清空缓存
    */
   async clear() {
+    this.logInfo("开始清空缓存", {
+      currentMenuCount: this.store.menuList.length
+    });
     this.store.menuList = [];
     this.store.map.clear();
     this.store.currentMenu = void 0;
@@ -138,11 +166,15 @@ var MenuModule = class extends import_BaseModule.BaseModule {
       try {
         await this.dbManager.clear(INDEXDB_STORE_NAME);
         console.log("[Menu] IndexDB 缓存已清空");
+        this.logInfo("IndexDB 缓存已清空");
       } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
         console.error("[Menu] 清空 IndexDB 缓存失败:", error);
+        this.logError("清空 IndexDB 缓存失败", { error: errorMessage });
       }
     }
     console.log("[Menu] 缓存已清空");
+    this.logInfo("缓存清空完成");
   }
   /**
    * 从 IndexDB 加载餐牌数据
@@ -150,13 +182,19 @@ var MenuModule = class extends import_BaseModule.BaseModule {
    */
   async loadMenuFromIndexDB() {
     if (!this.dbManager) {
+      this.logWarning("loadMenuFromIndexDB: dbManager 不可用");
       return [];
     }
     try {
       const menuList = await this.dbManager.getAll(INDEXDB_STORE_NAME);
+      this.logInfo("从 IndexDB 加载餐牌数据", {
+        menuCount: (menuList == null ? void 0 : menuList.length) ?? 0
+      });
       return menuList || [];
     } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Menu] 从 IndexDB 读取数据失败:", error);
+      this.logError("从 IndexDB 读取数据失败", { error: errorMessage });
       return [];
     }
   }
@@ -166,8 +204,10 @@ var MenuModule = class extends import_BaseModule.BaseModule {
    */
   async saveMenuToIndexDB(menuList) {
     if (!this.dbManager) {
+      this.logWarning("saveMenuToIndexDB: dbManager 不可用");
       return;
     }
+    this.logInfo("开始保存餐牌数据到 IndexDB", { menuCount: menuList.length });
     try {
       await this.dbManager.clear(INDEXDB_STORE_NAME);
       const savePromises = menuList.map(
@@ -175,8 +215,14 @@ var MenuModule = class extends import_BaseModule.BaseModule {
       );
       await Promise.all(savePromises);
       console.log(`[Menu] 已将 ${menuList.length} 条餐牌数据保存到 IndexDB`);
+      this.logInfo("餐牌数据已保存到 IndexDB", { menuCount: menuList.length });
     } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Menu] 保存数据到 IndexDB 失败:", error);
+      this.logError("保存数据到 IndexDB 失败", {
+        menuCount: menuList.length,
+        error: errorMessage
+      });
     }
   }
   /**
@@ -185,6 +231,8 @@ var MenuModule = class extends import_BaseModule.BaseModule {
    */
   async preload() {
     console.log("[Menu] 开始预加载数据...");
+    const startTime = Date.now();
+    this.logInfo("开始预加载数据");
     try {
       const cachedData = await this.loadMenuFromIndexDB();
       if (cachedData && cachedData.length > 0) {
@@ -192,11 +240,20 @@ var MenuModule = class extends import_BaseModule.BaseModule {
         this.store.menuList = (0, import_lodash_es.cloneDeep)(cachedData);
         this.syncMenuMap();
         this.core.effects.emit(import_types.MenuHooks.onMenuChanged, this.store.menuList);
+        const duration = Date.now() - startTime;
+        this.logInfo("预加载完成（从 IndexDB）", {
+          menuCount: cachedData.length,
+          duration: `${duration}ms`,
+          source: "IndexDB"
+        });
         return;
       }
       console.log("[Menu] IndexDB 中没有缓存数据，从服务器加载...");
+      this.logInfo("IndexDB 中没有缓存数据，准备从服务器加载");
     } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
       console.warn("[Menu] 从 IndexDB 加载数据失败:", error);
+      this.logWarning("从 IndexDB 加载数据失败，准备从服务器加载", { error: errorMessage });
     }
     const menuList = await this.loadMenuList();
     if (menuList && menuList.length > 0) {
@@ -204,6 +261,17 @@ var MenuModule = class extends import_BaseModule.BaseModule {
       this.store.menuList = (0, import_lodash_es.cloneDeep)(menuList);
       this.syncMenuMap();
       this.core.effects.emit(import_types.MenuHooks.onMenuChanged, this.store.menuList);
+      const duration = Date.now() - startTime;
+      this.logInfo("预加载完成（从服务器）", {
+        menuCount: menuList.length,
+        duration: `${duration}ms`,
+        source: "Server"
+      });
+    } else {
+      const duration = Date.now() - startTime;
+      this.logWarning("预加载完成但未获取到数据", {
+        duration: `${duration}ms`
+      });
     }
   }
   /**
@@ -227,6 +295,57 @@ var MenuModule = class extends import_BaseModule.BaseModule {
       }
     ];
   }
+  /**
+   * 记录信息日志
+   * @param title 日志标题
+   * @param metadata 日志元数据
+   */
+  logInfo(title, metadata) {
+    try {
+      if (this.logger) {
+        this.logger.addLog({
+          type: "info",
+          title: `[MenuModule] ${title}`,
+          metadata: metadata || {}
+        });
+      }
+    } catch {
+    }
+  }
+  /**
+   * 记录警告日志
+   * @param title 日志标题
+   * @param metadata 日志元数据
+   */
+  logWarning(title, metadata) {
+    try {
+      if (this.logger) {
+        this.logger.addLog({
+          type: "warning",
+          title: `[MenuModule] ${title}`,
+          metadata: metadata || {}
+        });
+      }
+    } catch {
+    }
+  }
+  /**
+   * 记录错误日志
+   * @param title 日志标题
+   * @param metadata 日志元数据
+   */
+  logError(title, metadata) {
+    try {
+      if (this.logger) {
+        this.logger.addLog({
+          type: "error",
+          title: `[MenuModule] ${title}`,
+          metadata: metadata || {}
+        });
+      }
+    } catch {
+    }
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

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

@@ -0,0 +1,87 @@
+import { Module, ModuleOptions, PisellCore } from '../../../types';
+import { BaseModule } from '../../../modules/BaseModule';
+import type { RouteDefinition } from '../../types';
+import { OrderData, OrderId } from './types';
+/**
+ * Order 模块 - 基础框架
+ */
+export declare class OrderModule extends BaseModule implements Module {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private store;
+    private dbManager;
+    private orderDataSource;
+    private pendingSyncMessages;
+    private syncTimer?;
+    private readonly ORDER_SYNC_DEBOUNCE_MS;
+    private resourceIdIndex;
+    private logger;
+    private storage;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    /**
+   * 记录信息日志
+   * @param title 日志标题
+   * @param metadata 日志元数据
+   */
+    private logInfo;
+    /**
+     * 记录错误日志
+     * @param title 日志标题
+     * @param metadata 日志元数据
+     */
+    private logError;
+    preload(): Promise<void>;
+    getOrders(): OrderData[];
+    getOrderById(id: OrderId): OrderData | undefined;
+    /** 按 order_id 查询（推荐） */
+    getOrderByOrderId(orderId: OrderId): OrderData | undefined;
+    loadOrdersByServer(): Promise<OrderData[]>;
+    getOrdersByResourceId(resourceId: string | number): OrderData[];
+    getRoutes(): RouteDefinition[];
+    destroy(): void;
+    private syncOrdersMap;
+    private extractResourceIds;
+    private getOrderDateKey;
+    /**
+     * 初始化 OrderDataSource 实例
+     */
+    private initOrderDataSource;
+    /**
+     * 初始化 pubsub 订阅，监听订单变更
+     */
+    private setupOrderSync;
+    /**
+     * 处理防抖后的同步消息批次
+     *
+     * 后端统一发送 change 消息，不再区分新增/编辑/删除。
+     * - 单条（id/order_id）：若携带 body/data 则直接 upsert 到本地
+     * - 批量（ids）：通过 HTTP 按 ids 增量拉取，再 merge 到本地
+     */
+    private processOrderSyncMessages;
+    /**
+     * 通过 HTTP 按 ids 增量拉取订单
+     */
+    private fetchOrdersByHttp;
+    /**
+     * 将增量订单合并到 store
+     */
+    private mergeOrdersToStore;
+    private normalizeOrderSyncMessage;
+    private normalizeOrderSyncPayload;
+    private uniqueOrderIds;
+    private getIdKey;
+    /**
+     * 当前订单拉取窗口：
+     * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
+     * - 无法解析时退化为自然日窗口
+     */
+    private getCurrentPullWindow;
+    private hasPulledOrdersToday;
+    private markOrderPulledAtNow;
+    private getStorageItem;
+    private setStorageItem;
+    private loadOrdersFromSQLite;
+    private saveOrdersToSQLite;
+    clear(): Promise<void>;
+}