添加了Swagger API文档以及诸多优化

static/js/main.js

@@ -50,13 +50,74 @@ function setupNavigation() {
     
     // 移动端侧边栏切换
     const toggleSidebar = document.getElementById('toggle-sidebar');
+    const closeSidebarBtn = document.getElementById('close-sidebar');
     const sidebar = document.getElementById('sidebar');
+    const sidebarOverlay = document.getElementById('sidebar-overlay');
     
-    if (toggleSidebar && sidebar) {
-        toggleSidebar.addEventListener('click', () => {
-            sidebar.classList.toggle('-translate-x-full');
-        });
+    // 打开侧边栏函数
+    function openSidebar() {
+        if (sidebar) {
+            sidebar.classList.remove('-translate-x-full');
+        }
+        if (sidebarOverlay) {
+            sidebarOverlay.classList.remove('hidden');
+        }
+        // 防止页面滚动
+        document.body.style.overflow = 'hidden';
     }
+    
+    // 关闭侧边栏函数
+    function closeSidebar() {
+        if (sidebar) {
+            sidebar.classList.add('-translate-x-full');
+        }
+        if (sidebarOverlay) {
+            sidebarOverlay.classList.add('hidden');
+        }
+        // 恢复页面滚动
+        document.body.style.overflow = '';
+    }
+    
+    // 切换侧边栏函数
+    function toggleSidebarVisibility() {
+        if (sidebar && sidebar.classList.contains('-translate-x-full')) {
+            openSidebar();
+        } else {
+            closeSidebar();
+        }
+    }
+    
+    // 绑定切换按钮事件
+    if (toggleSidebar) {
+        toggleSidebar.addEventListener('click', openSidebar);
+    }
+    
+    // 绑定关闭按钮事件
+    if (closeSidebarBtn) {
+        closeSidebarBtn.addEventListener('click', closeSidebar);
+    }
+    
+    // 绑定遮罩层点击事件
+    if (sidebarOverlay) {
+        sidebarOverlay.addEventListener('click', closeSidebar);
+    }
+    
+    // 移动端点击菜单项后自动关闭侧边栏
+    menuItems.forEach(item => {
+        item.addEventListener('click', () => {
+            // 检查是否是移动设备视图
+            if (window.innerWidth < 768) {
+                closeSidebar();
+            }
+        });
+    });
+    
+    // 添加键盘事件监听，按ESC键关闭侧边栏
+    document.addEventListener('keydown', (e) => {
+        if (e.key === 'Escape') {
+            closeSidebar();
+        }
+    });
 }
 
 // 初始化函数