feat(shared,server,web,client,plugin)!: 角色与权限重构 + 学期周次 + 课表方向反转（1.2.0）

学生、任课关系、周次口径三处长期靠约定维持的事情，改为由数据模型保证。

学生不是账号
- 拆出独立 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 原样搬迁，历史数据不丢），
升级前请先备份。

packages/shared/src/utils.ts

@@ -173,6 +173,30 @@ export function durationMinutes(startTime: string, endTime: string): number {
   return (eh as number) * 60 + (em as number) - ((sh as number) * 60 + (sm as number));
 }
 
+/* ------------------------------------------------------------------ 学生 / 学号 */
+
+/**
+ * 学号归一化：去掉**全部空白**（首尾与内部），字母统一转大写。
+ *
+ * 学号是学生的唯一标识与查询键，因此这些手输差异必须收敛到同一个键上，
+ * 否则同一个学生会在名单/成绩里变成两条：
+ *   「2026 001」与「2026001」 —— 多余空格；
+ *   「a2026001」与「A2026001」 —— 大小写。
+ * 统一转大写（而不是只去空格）是关键：`Student.studentNo` 上的唯一约束因此
+ * **天然就是大小写无关的**，不需要在写入前多查一次库，也不会出现
+ * "库里存着两条只差大小写的学号"这种脏数据。数字学号不受影响。
+ *
+ * 允许的字符集与后端 zod 校验一致：1~32 位数字 / 字母 / `.` `_` `-`。
+ */
+export function normalizeStudentNo(value: string): string {
+  return value.replace(/\s+/g, '').toUpperCase();
+}
+
+/** 学号格式校验（与后端 `studentNoSchema` 同一口径） */
+export function isValidStudentNo(value: string): boolean {
+  return /^[A-Za-z0-9._-]{1,32}$/.test(normalizeStudentNo(value));
+}
+
 /* ------------------------------------------------------------------ 成绩 */
 
 /** 得分率（0-100），总分非法时返回 0 */
@@ -181,7 +205,7 @@ export function gradePercent(score: number, totalScore: number): number {
   return round((score / totalScore) * 100, 1);
 }
 
-/** 等级换算，学生端图表与标签复用 */
+/** 等级换算，ClassHelper 班级端图表与标签复用 */
 export function gradeLevel(percent: number): GradeLevel {
   if (percent >= 90) return 'A';
   if (percent >= 80) return 'B';
@@ -291,6 +315,89 @@ export function resolveCurrentWeek(
   return clamp(week, 1, maxWeek);
 }
 
+/* ------------------------------------------------------------------ 学期周次区间 */
+
+/**
+ * 按**逐周区间**判定当前是第几教学周。
+ *
+ * 为什么需要它：`resolveCurrentWeek` 假设"每周都是七天、中间没有断档"，
+ * 而法定节假日调休、周末补课、错峰开学都会让某一周变长变短 —— 线性推算出来的周次
+ * 会与教室里实际情况整体错位（课表、作业、成绩都按周次组织，错一周就全错）。
+ *
+ * @returns 命中的周次；当前日期不在任何已配置的区间内时返回 `null`（交给调用方线性兜底）
+ */
+export function resolveWeekFromRanges(
+  ranges: readonly { weekNumber: number; startDate: string; endDate: string }[],
+  now: Date = new Date(),
+): number | null {
+  const today = dayKeyLocal(now);
+  if (!today) return null;
+  for (const range of ranges) {
+    // 日期串是 YYYY-MM-DD，字典序即时间序，不需要解析成 Date
+    if (today >= range.startDate && today <= range.endDate) return range.weekNumber;
+  }
+  return null;
+}
+
+/**
+ * 按"学期开始日期 + 每周七天"生成逐周区间（管理员的起点，生成后可以逐周微调）。
+ *
+ * @param termStartDate 第 1 教学周的**周一**（YYYY-MM-DD）
+ */
+export function buildAutoTermWeeks(
+  termStartDate: string,
+  maxWeek: number = MAX_TERM_WEEK,
+): Array<{ weekNumber: number; startDate: string; endDate: string; note: string }> {
+  if (!termStartDate) return [];
+  const start = toDate(termStartDate);
+  if (Number.isNaN(start.getTime())) return [];
+  const weekday = start.getDay() === 0 ? 7 : start.getDay();
+  const monday = new Date(start.getTime() - (weekday - 1) * MS_PER_DAY);
+  monday.setHours(0, 0, 0, 0);
+
+  const total = Math.max(1, Math.min(maxWeek, MAX_TERM_WEEK));
+  const weeks: Array<{ weekNumber: number; startDate: string; endDate: string; note: string }> = [];
+  for (let index = 0; index < total; index += 1) {
+    const from = new Date(monday.getTime() + index * 7 * MS_PER_DAY);
+    const to = new Date(from.getTime() + 6 * MS_PER_DAY);
+    weeks.push({
+      weekNumber: index + 1,
+      startDate: dayKeyLocal(from),
+      endDate: dayKeyLocal(to),
+      note: '',
+    });
+  }
+  return weeks;
+}
+
+/**
+ * 校验一组周次区间：周次为正整数、起止顺序正确、**区间之间不重叠**。
+ * 返回人类可读的错误列表（空数组 = 通过）。
+ */
+export function validateTermWeeks(
+  weeks: readonly { weekNumber: number; startDate: string; endDate: string }[],
+): string[] {
+  const errors: string[] = [];
+  const ordered = [...weeks].sort((a, b) => a.startDate.localeCompare(b.startDate));
+  for (const week of ordered) {
+    if (!isDayKey(week.startDate) || !isDayKey(week.endDate)) {
+      errors.push(`第 ${week.weekNumber} 周：日期格式应为 YYYY-MM-DD`);
+      continue;
+    }
+    if (week.startDate > week.endDate) {
+      errors.push(`第 ${week.weekNumber} 周：开始日期晚于结束日期`);
+    }
+  }
+  for (let index = 1; index < ordered.length; index += 1) {
+    const prev = ordered[index - 1]!;
+    const current = ordered[index]!;
+    if (current.startDate <= prev.endDate) {
+      errors.push(`第 ${prev.weekNumber} 周与第 ${current.weekNumber} 周的日期区间重叠`);
+    }
+  }
+  return errors;
+}
+
 /** 把课表条目转换成时段信息 */
 export function toClassPeriod(schedule: ScheduleDto): ClassPeriod {
   return {