LoveChengke
9d5ac7adf9
学生、任课关系、周次口径三处长期靠约定维持的事情，改为由数据模型保证。 学生不是账号 - 拆出独立 Student 表，没有 passwordHash / role / 任何登录字段 - 「学生不能登录」由表结构保证，不再靠「登录前判 role 再 403」的代码分支 - 三张个人数据表外键 userId → studentId；删掉 Enrollment 与 ClassTeacher - 学生一律称「学号」、教师一律称「工号」，「学生账号」这个概念消失 任课关系唯一来源 = Course（班级 + 科目 + 教师） - 班主任 = Class.teacherId，科任 = Course.teacherId，同一人两处指向同一账号、不重复建号 - 作业与成绩按科目再收一道：挂科目只由该科任课老师改，没挂科目归班主任 / 管理员 - 新增「任课教师分配」与「班级教师批量导入」（带「使用工号匹配」开关） 成绩与名单 - 成绩等级：百分制 / 等级制 A·B·C·D / 自定义，支持单个与批量改等级 - 按学号查成绩明细（教师端 + 班级端 + 设备令牌），受按班开关控制 - 调班 / 转出（单个与批量）+ 可查历史；学号不变、历史作业成绩留原归属 - 毕业归档页（按年度记录毕业班级 / 毕业生 / 转出学生 / 该届通知与作业） - 学年升级（未毕业不归档、数据沿用）；班级称呼改为「2026级1班」 ClassHelper 班级端在线状态 - Web 端显示 班级 / 设备名 / 设备号 / 在线离线 / 最后在线 / 最后心跳 - lastHeartbeatAt 驱动 60 秒在线窗口，与只表示「带状态上报」的 lastSeenAt 分开 学期周次 - 新增 TermWeek（classId 空串 = 全校默认），管理员可用日期范围选择器逐周配置 - 一键按开学日期生成整学期；联网拉取调休建议（只给建议、不改数据，无外网失败属正常） - 改周次后随课表下发给教室的 ClassHelper 班级端 课表方向反转 - 主方向改为「服务端 → 教室」自动下发；教室不再自动回传 - 取教室课表改为手动动作（点击前弹警告），插件按待办标记在下一次心跳补报 改名 - 班级小助手 → ClassHelper：界面、窗口标题、托盘、灵动岛、EXE、安装包、 安装目录、systemd 描述、插件清单与设置页、官网、文档站、README BREAKING CHANGE: 产品名与 EXE 名变更（班级小助手.exe → ClassHelper.exe）， 安装目录随之改变，不支持覆盖安装，需先卸载旧版。 服务端首次启动会自动应用 6 个数据库迁移（学生行按 id 原样搬迁，历史数据不丢）， 升级前请先备份。
79 lines
3.2 KiB
Docker
79 lines
3.2 KiB
Docker
# ClassHelper 服务端 · 生产镜像
|
||
#
|
||
# 两阶段构建：
|
||
# build —— 安装依赖并编译 shared / server / web-admin
|
||
# runtime —— 仅保留运行时所需内容（生产依赖 + 构建产物），镜像更小
|
||
#
|
||
# 构建（在仓库根目录执行）：
|
||
# docker build -f deploy/Dockerfile -t classhelper-server:1.1.0 .
|
||
#
|
||
# 运行（SQLite + 数据卷）：
|
||
# docker run -d --name classhelper -p 4000:4000 \
|
||
# -e JWT_SECRET=<48字节随机串> \
|
||
# -v classhelper-data:/app/data \
|
||
# classhelper-server:1.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
|
||
|
||
# 必须先生成 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"]
|