feat: 生产化改造（服务端安装程序/PWA/Docker+HTTPS）并修复侧边栏点击无反应、SPA 静态托管 dotfiles 两个缺陷

- 修复 web-admin 与 desktop-client 侧边栏点击无反应：el-menu 的 index 是路径，不能当路由名使用
- 修复 Web 产物目录含点号目录（如 .cache）时 res.sendFile 因 dotfiles:ignore 返回 500
- 后端生产模式：静态托管 Web 端 + SPA 回退、helmet、限流（通用/登录）、trust proxy、
  /healthz 与 /readyz、请求耗时日志、生产环境变量强校验、首启动自动迁移与创建管理员、PID 文件
- Web 管理端 PWA：manifest + service worker + 图标，可在浏览器安装为应用
- 新增服务端 + Web 管理端 Windows 安装程序（内置 Node 运行时、启停与服务脚本、开机自启、卸载保留数据）
- 新增 Docker/Compose/Nginx 部署样例与 docs/production.md
- 新增 UI 回归测试：Web 端 Electron 驱动真实点击 7 项、客户端冒烟 11 项（含侧边栏点击与离线回退）

packages/web-admin/src/config.ts

@@ -1,12 +1,20 @@
 import { DEFAULT_SERVER_URL } from '@classhelper/shared';
 
+/** 页面是否由 http(s) 提供（生产环境由后端托管，浏览器里恒为 true） */
+const servedOverHttp = typeof window !== 'undefined' && /^https?:$/.test(window.location.protocol);
+
 /**
  * 运行时配置。
- * 默认直连后端（开发/生产都可用）；如需走 Vite 代理，把 .env 里的
- * VITE_API_BASE_URL 设为 /api 即可（vite.config.ts 已配置代理）。
+ *
+ * 默认使用**同源相对路径**：
+ * - 生产：后端同时托管 Web 管理端，`/api` 与 `/socket.io` 同源，无需任何配置；
+ * - 开发：Vite 已把 `/api` 与 `/socket.io` 代理到后端（见 vite.config.ts），同样可用；
+ * - 需要指向其它后端（例如静态托管在 CDN）时，构建期设置 VITE_API_BASE_URL / VITE_SOCKET_URL。
  */
-export const API_BASE_URL = import.meta.env.VITE_API_BASE_URL ?? `${DEFAULT_SERVER_URL}/api`;
+export const API_BASE_URL =
+  import.meta.env.VITE_API_BASE_URL ?? (servedOverHttp ? '/api' : `${DEFAULT_SERVER_URL}/api`);
 
-export const SOCKET_URL = import.meta.env.VITE_SOCKET_URL ?? DEFAULT_SERVER_URL;
+export const SOCKET_URL =
+  import.meta.env.VITE_SOCKET_URL ?? (servedOverHttp ? window.location.origin : DEFAULT_SERVER_URL);
 
 export const APP_TITLE = '班级小助手 · 管理端';

packages/web-admin/src/layouts/AdminLayout.vue

@@ -13,16 +13,36 @@ const auth = useAuthStore();
 const realtime = useRealtimeStore();
 
 const menuItems = [
-  { name: 'dashboard', title: '仪表盘', icon: 'Odometer' },
-  { name: 'classes', title: '班级管理', icon: 'School' },
-  { name: 'students', title: '学生管理', icon: 'User' },
-  { name: 'schedules', title: '课表管理', icon: 'Calendar' },
-  { name: 'homeworks', title: '作业发布', icon: 'Notebook' },
-  { name: 'notifications', title: '通知发布', icon: 'Bell' },
-  { name: 'grades', title: '成绩录入', icon: 'Trophy' },
+  { path: '/dashboard', title: '仪表盘', icon: 'Odometer' },
+  { path: '/classes', title: '班级管理', icon: 'School' },
+  { path: '/students', title: '学生管理', icon: 'User' },
+  { path: '/schedules', title: '课表管理', icon: 'Calendar' },
+  { path: '/homeworks', title: '作业发布', icon: 'Notebook' },
+  { path: '/notifications', title: '通知发布', icon: 'Bell' },
+  { path: '/grades', title: '成绩录入', icon: 'Trophy' },
 ];
 
-const activeMenu = computed(() => `/${String(route.name ?? 'dashboard')}`);
+/** 高亮当前菜单：直接比较路由路径，避免依赖路由名 */
+const activeMenu = computed(() => route.path);
+
+/**
+ * 菜单点击回调。
+ * 注意：el-menu 的 @select 抛出的是 el-menu-item 的 index（这里即路由路径），
+ * 不能当作路由名使用（router.push({ name }) 会因找不到同名路由而静默失败）。
+ */
+function handleMenuSelect(index: string): void {
+  void router.push(index);
+}
+
+/** 开发期自检：菜单路径必须存在于路由表中，防止再次出现"点了没反应" */
+if (import.meta.env.DEV) {
+  const knownPaths = new Set(router.getRoutes().map((item) => item.path));
+  for (const item of menuItems) {
+    if (!knownPaths.has(item.path)) {
+      console.error(`[AdminLayout] 菜单项未注册对应路由：${item.path}`);
+    }
+  }
+}
 
 const connectionText = computed(() => {
   if (realtime.connected) return '实时通道已连接';
@@ -34,10 +54,6 @@ const connectionType = computed(() =>
   realtime.connected ? 'success' : realtime.connecting ? 'warning' : 'danger',
 );
 
-function go(name: string): void {
-  void router.push({ name });
-}
-
 async function handleLogout(): Promise<void> {
   await ElMessageBox.confirm('确认退出当前账号？', '退出登录', { type: 'warning' });
   await auth.logout();
@@ -91,8 +107,8 @@ async function submitPassword(): Promise<void> {
         <el-icon :size="22"><School /></el-icon>
         <span class="brand-text">班级小助手</span>
       </div>
-      <el-menu :default-active="activeMenu" class="layout-menu" @select="go">
-        <el-menu-item v-for="item in menuItems" :key="item.name" :index="`/${item.name}`">
+      <el-menu :default-active="activeMenu" class="layout-menu" @select="handleMenuSelect">
+        <el-menu-item v-for="item in menuItems" :key="item.path" :index="item.path">
           <el-icon><component :is="item.icon" /></el-icon>
           <span>{{ item.title }}</span>
         </el-menu-item>

packages/web-admin/src/main.ts

@@ -21,3 +21,16 @@ app.use(router);
 app.use(ElementPlus, { locale: zhCn });
 
 app.mount('#app');
+
+/**
+ * 注册 Service Worker（仅生产构建）：
+ * - 浏览器可「安装为应用」（PWA），断网时仍能打开应用外壳
+ * - 不缓存 /api 与 /socket.io，保证数据实时性
+ */
+if (import.meta.env.PROD && 'serviceWorker' in navigator) {
+  window.addEventListener('load', () => {
+    void navigator.serviceWorker.register('/sw.js').catch((error) => {
+      console.warn('[pwa] Service Worker 注册失败：', error);
+    });
+  });
+}