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 项(含侧边栏点击与离线回退)
This commit is contained in:
LoveChengke committed 2026-09-12 00:20:21 +08:00
1 parent 6e4c7c1050
commit 5545ef6f55
46 files changed
+3020 -152

No files matched your search

+73
View File
@@ -0,0 +1,73 @@
# 班级小助手服务端 · 生产镜像
#
# 两阶段构建:
# build —— 安装依赖并编译 shared / server / web-admin
# runtime —— 仅保留运行时所需内容(生产依赖 + 构建产物),镜像更小
#
# 构建(在仓库根目录执行):
# docker build -f deploy/Dockerfile -t classhelper-server:0.1.0 .
#
# 运行(SQLite + 数据卷):
# docker run -d --name classhelper -p 4000:4000 \
# -e JWT_SECRET=<48字节随机串> \
# -v classhelper-data:/app/data \
# classhelper-server:0.1.0
#
# 生产推荐用 docker compose(见 deploy/docker-compose.yml,含 MySQL 与 HTTPS 反代)
# ---------------------------------------------------------------- 构建阶段
FROM node:22-slim AS build
WORKDIR /app
# 启用 pnpm(用 corepack 保证版本与仓库一致)
RUN corepack enable && corepack prepare pnpm@11.8.0 --activate
# 先只拷贝清单以提高缓存命中率
COPY pnpm-workspace.yaml pnpm-lock.yaml package.json tsconfig.base.json ./
COPY packages/shared/package.json packages/shared/
COPY packages/server/package.json packages/server/
COPY packages/web-admin/package.json packages/web-admin/
COPY packages/desktop-client/package.json packages/desktop-client/
RUN pnpm install --frozen-lockfile --ignore-scripts
# 再拷贝源码并构建(只构建服务端与 Web 管理端,桌面客户端不参与)
COPY packages ./packages
COPY scripts ./scripts
RUN pnpm build:shared \
&& pnpm --filter @classhelper/server build \
&& pnpm --filter @classhelper/web-admin build
# ---------------------------------------------------------------- 运行时阶段
FROM node:22-slim AS runtime
WORKDIR /app
ENV NODE_ENV=production \
HOST=0.0.0.0 \
PORT=4000 \
LOG_LEVEL=info \
TRUST_PROXY=1 \
RATE_LIMIT_ENABLED=true \
STARTUP_DB_CHECK=true
# 生产依赖(清单由 scripts/dist-server.mjs 依据 packages/server/package.json 生成)
COPY deploy/package.runtime.json ./package.json
RUN npm install --omit=dev --no-audit --no-fund
# 后端产物 + 迁移文件 + Web 管理端 + 工作区共享包
COPY --from=build /app/packages/server/dist ./server/dist
COPY --from=build /app/packages/server/prisma/migrations ./server/prisma/migrations
COPY --from=build /app/packages/web-admin/dist ./web
COPY --from=build /app/packages/shared/dist ./node_modules/@classhelper/shared/dist
COPY packages/shared/package.json ./node_modules/@classhelper/shared/package.json
# 数据目录(SQLite 文件 / PID 文件),建议挂载数据卷
RUN mkdir -p /app/data /app/logs
VOLUME ["/app/data"]
EXPOSE 4000
# 容器健康检查:就绪探针(数据库不可用会返回 503)
HEALTHCHECK --interval=30s --timeout=5s --start-period=25s --retries=3 \
CMD node -e "fetch('http://127.0.0.1:4000/readyz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
CMD ["node", "server/dist/index.js"]