LoveChengke
572295c297
- 服务端新增 database 模块（/api/database/*，仅 ADMIN）：全库 JSON 快照（备份 / 恢复 / 导入导出 / 定时备份
共用同一格式，14 张表按拓扑序导出、恢复时关外键检查）、连接测试与目标库校验、一键 SQLite ⇄ MySQL 切换
（备份 → 导出 → 测试连接 → 校验空库 → 改 schema → 子进程 generate / tsc / db push → 写数据，全部成功才改写
.env，中途失败回滚 schema）；XML 快照与 SQLite 数据文件均可下载；打包形态随包带上 prisma CLI 与 typescript
（prisma-client 生成物是 .ts，需再编进 dist/generated，安装包因之变大）
- Web 管理端新增「数据库管理」页（仅管理员），并加首次登录新手引导（el-tour，可跳过、可随时重看，版本号写
localStorage，改版后老用户会再收到一次）
- 客户端设置改版：侧边栏改为分组折叠菜单，设置拆成 6 个子路由
（/settings/{general,appearance,island,reminder,account,about}），新增深色模式（主题持久化到主进程配置，
主窗口底色跟主题走，避免"先白后黑"闪一下），新增「关于」页（应用信息 / 诊断信息）
- 客户端新增首启六步引导（OnboardingWelcome，状态存主进程配置 onboardingDone）
- 客户端主窗口初始尺寸与 ClassIsland 对齐（1242x582 / minHeight 540 / 居中）
- 版本号统一提升到 1.0.0：5 个 package.json、部署配置与镜像标签（.env.example / docker-compose / Dockerfile）、
服务端 /health 与首页、插件 manifest.yml 与 BridgeService.PluginVersion、文档里的安装包名
- 文档与验收同步：AGENTS.md 补第 37~51 条约定（深色主题实现边界、设置子路由、数据库管理三件事、侧栏与窗口
尺寸、引导在自动化里的判据等），README 补「数据库管理 / 新手引导 / 设置改版」三节；verify:e2e 增补 13 条
数据库管理用例，客户端冒烟与 Web UI 冒烟跟进子路由、深色主题、侧栏与引导
验证：pnpm lint 0 error；pnpm typecheck 全过；verify:e2e 186/186；verify:classisland-plugin 68/68；
build:desktop 通过（含产物凭据门禁）；verify:desktop 99/102（3 项为上课时段下的"真实通知链路"用例，
客户端按产品规则暂存普通通知所致，见下）；插件 dotnet 编译 0 错误。
注：verify:desktop 的「真实通知链路 / 标记已读」三项要求当前不在上课时段——本次运行时种子课表恰有
「周五 10:55-11:40 生物」正在进行，客户端正确地暂存了普通通知（AGENTS.md 第 18 条），属时间相关用例，
与本次改动无关。
79 lines
3.2 KiB
Docker
79 lines
3.2 KiB
Docker
# 班级小助手服务端 · 生产镜像
|
||
#
|
||
# 两阶段构建：
|
||
# build —— 安装依赖并编译 shared / server / web-admin
|
||
# runtime —— 仅保留运行时所需内容（生产依赖 + 构建产物），镜像更小
|
||
#
|
||
# 构建（在仓库根目录执行）：
|
||
# docker build -f deploy/Dockerfile -t classhelper-server:1.0.0 .
|
||
#
|
||
# 运行（SQLite + 数据卷）：
|
||
# docker run -d --name classhelper -p 4000:4000 \
|
||
# -e JWT_SECRET=<48字节随机串> \
|
||
# -v classhelper-data:/app/data \
|
||
# classhelper-server:1.0.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
|
||
|
||
# 必须先生成 Prisma Client：`pnpm install --ignore-scripts` 跳过了 postinstall，
|
||
# 而生成产物 `packages/server/src/generated/prisma` 是 gitignored 的（clone 下来没有），
|
||
# 少了这一步下面的 tsc 会报 "Cannot find module '../generated/prisma/client.js'"。
|
||
RUN pnpm build:shared \
|
||
&& pnpm --filter @classhelper/server run db:generate \
|
||
&& 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"]
|