代码结构整理

2025-08-11 16:08:59 +08:00
parent ab4d0093d9
commit dad0f47974
81 changed files with 2408 additions and 1179 deletions
@@ -0,0 +1,132 @@
+import { ViewManager } from "db://assets/Scripts/Main/Manager/ViewManager";
+
+/**
+ * 导航管理器
+ * 
+ * 负责管理游戏中的页面导航和路由，将导航逻辑从业务逻辑中分离出来
+ * 
+ * @author AI Chat System  
+ * @version 1.0.0
+ */
+export class NavigationManager {
+    private static _instance: NavigationManager;
+
+    /**
+     * 获取NavigationManager的单例实例
+     * 
+     * @returns {NavigationManager} 导航管理器实例
+     * @static
+     */
+    public static get Instance(): NavigationManager {
+        if (!this._instance) {
+            this._instance = new NavigationManager();
+        }
+        return this._instance;
+    }
+
+    private constructor() {}
+
+    /**
+     * 进入角色列表页面
+     * 
+     * @param {number} themeId - 主题ID，用于筛选角色
+     * 
+     * @example
+     * ```typescript
+     * NavigationManager.Instance.navigateToGirlList(1);
+     * ```
+     */
+    public navigateToGirlList(themeId: number): void {
+        if (themeId == null || themeId < 0) {
+            console.warn("Invalid theme ID for girl list navigation:", themeId);
+            return;
+        }
+
+        console.log(`Navigating to girl list with theme ID: ${themeId}`);
+        ViewManager.I.openBundlesView("GirlListPanel", themeId);
+    }
+
+    /**
+     * 进入聊天页面
+     * 
+     * @param {number} roleId - 角色ID
+     * 
+     * @example
+     * ```typescript  
+     * NavigationManager.Instance.navigateToChat(10001);
+     * ```
+     */
+    public navigateToChat(roleId: number): void {
+        if (roleId == null || roleId <= 0) {
+            console.warn("Invalid role ID for chat navigation:", roleId);
+            return;
+        }
+
+        console.log(`Navigating to chat with role ID: ${roleId}`);
+        ViewManager.I.openBundlesView("ChatPanel", roleId);
+    }
+
+    /**
+     * 进入角色详情页面
+     * 
+     * @param {number} roleId - 角色ID
+     * 
+     * @example
+     * ```typescript
+     * NavigationManager.Instance.navigateToGirlDetail(10001);
+     * ```
+     */
+    public navigateToGirlDetail(roleId: number): void {
+        if (roleId == null || roleId <= 0) {
+            console.warn("Invalid role ID for detail navigation:", roleId);
+            return;
+        }
+
+        console.log(`Navigating to girl detail with role ID: ${roleId}`);
+        ViewManager.I.openBundlesView("GirlDetailPanel", roleId);
+    }
+
+    /**
+     * 返回主界面
+     * 
+     * @example
+     * ```typescript
+     * NavigationManager.Instance.navigateToMainMenu();
+     * ```
+     */
+    public navigateToMainMenu(): void {
+        console.log("Navigating to main menu");
+        // TODO: 实现返回主界面的逻辑
+        // ViewManager.I.openBundlesView("MainMenu");
+    }
+
+    /**
+     * 检查是否可以导航到指定页面
+     * 
+     * @param {string} pageName - 页面名称
+     * @returns {boolean} 是否可以导航
+     */
+    public canNavigateTo(pageName: string): boolean {
+        const allowedPages = ["GirlListPanel", "ChatPanel", "GirlDetailPanel"];
+        return allowedPages.indexOf(pageName)>=0;
+    }
+
+    /**
+     * 获取当前页面的导航历史（预留功能）
+     * 
+     * @returns {string[]} 导航历史数组
+     */
+    public getNavigationHistory(): string[] {
+        // TODO: 实现导航历史记录功能
+        console.log("Navigation history feature not implemented yet");
+        return [];
+    }
+
+    /**
+     * 返回上一页（预留功能）
+     */
+    public goBack(): void {
+        // TODO: 实现返回上一页功能
+        console.log("Go back feature not implemented yet");
+    }
+}