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 原样搬迁，历史数据不丢）， 升级前请先备份。
This commit is contained in:
LoveChengke committed
1 parent
17f55864bf
commit
9d5ac7adf9
172 files changed
+8761
-1896
No files matched your search
+208
-42
@@ -2,15 +2,25 @@
|
||||
* 种子数据：pnpm db:seed
|
||||
*
|
||||
* 会清空业务表后重建一套完整演示数据：
|
||||
* 1 管理员 / 2 教师 / 3 个班级 / 15 名学生 / 课程 / 课表 / 作业 / 通知 / 成绩
|
||||
* 1 管理员 / 2 教师 / 3 个在读班级 / 1 个已毕业届别 / 15 名学生 /
|
||||
* 课程（含各科任课老师）/ 课表 / 作业 / 通知 / 成绩 / 调班与转出历史
|
||||
*
|
||||
* 班级称呼一律是「XXXX级X班」（入学年份 + 班号）—— 见 shared 的 `formatClassName()`。
|
||||
*
|
||||
* 演示账号（密码见文件末尾打印结果）：
|
||||
* admin / admin123 - 系统管理员
|
||||
* teacher1 / teacher123 - 张老师（高一(1)班、高二(3)班班主任）
|
||||
* teacher2 / teacher123 - 李老师（高一(2)班班主任，高二(3)班协作教师）
|
||||
* student01..student15 / student123
|
||||
* teacher1 / teacher123 - 张老师（2026级1班 班主任，兼 2026级1班 数学）
|
||||
* teacher2 / teacher123 - 李老师（2026级2班 班主任，兼 2026级1班 语文）
|
||||
* （学生只有名单、没有账号：ClassHelper 班级端统一用班级码 + 班级密码登录）
|
||||
*/
|
||||
import { SUBJECT_CATALOG, dayKeyLocal } from '@classhelper/shared';
|
||||
import {
|
||||
SUBJECT_CATALOG,
|
||||
dayKeyLocal,
|
||||
formatClassName,
|
||||
formatYearLabel,
|
||||
gradeLevel,
|
||||
gradePercent,
|
||||
} from '@classhelper/shared';
|
||||
import { disconnectPrisma, prisma } from '../src/lib/db.js';
|
||||
import { logger } from '../src/lib/logger.js';
|
||||
import { hashPassword } from '../src/lib/password.js';
|
||||
@@ -67,11 +77,13 @@ async function resetDatabase(): Promise<void> {
|
||||
await prisma.notification.deleteMany();
|
||||
await prisma.schedule.deleteMany();
|
||||
await prisma.course.deleteMany();
|
||||
await prisma.enrollment.deleteMany();
|
||||
await prisma.classTeacher.deleteMany();
|
||||
await prisma.user.updateMany({ data: { classId: null } });
|
||||
await prisma.studentClassTransfer.deleteMany();
|
||||
// 学生要排在调班历史之后、班级之前（Student.classId 是 SetNull，但历史是 Cascade）
|
||||
await prisma.student.deleteMany();
|
||||
await prisma.user.deleteMany();
|
||||
// 班级归到届别上，所以先删班级再删届别
|
||||
await prisma.class.deleteMany();
|
||||
await prisma.archivedYear.deleteMany();
|
||||
}
|
||||
|
||||
async function main(): Promise<void> {
|
||||
@@ -86,11 +98,11 @@ async function main(): Promise<void> {
|
||||
const random = createRandom(20260901);
|
||||
|
||||
// 同一角色共用密码，只需各哈希一次
|
||||
// 学生没有密码：个人学生账号已清理（2026-10-01），学生端统一用班级码 + 班级密码登录
|
||||
// 学生没有密码：个人学生账号已清理（2026-10-01），ClassHelper 班级端统一用班级码 + 班级密码登录
|
||||
const [adminHash, teacherHash, classPasswordHash] = await Promise.all([
|
||||
hashPassword('admin123'),
|
||||
hashPassword('teacher123'),
|
||||
// 班级账号默认密码（学生端「班级登录」）
|
||||
// 班级账号默认密码（ClassHelper 班级端「班级登录」）
|
||||
hashPassword('123456'),
|
||||
]);
|
||||
|
||||
@@ -105,19 +117,24 @@ async function main(): Promise<void> {
|
||||
data: { username: 'teacher2', name: '李老师', role: 'TEACHER', passwordHash: teacherHash },
|
||||
});
|
||||
|
||||
// 班级账号：班级码（学生端「班级登录」的账号）+ 班级密码（默认 123456，可在班级管理里重置）
|
||||
// 班级账号：班级码（ClassHelper 班级端「班级登录」的账号）+ 班级密码（默认 123456，可在班级管理里重置）
|
||||
//
|
||||
// 称呼按「入学年份 + 班号」生成：2026 级是高一（当前学年 2026-2027），2025 级是高二。
|
||||
// 毕业年份 = 入学年份 + 3，所以这一届 2026 级将在 2029 年归档。
|
||||
const classSeeds = [
|
||||
{ name: '高一(1)班', grade: '高一', teacherId: teacher1.id, code: 'G101' },
|
||||
{ name: '高一(2)班', grade: '高一', teacherId: teacher2.id, code: 'G102' },
|
||||
{ name: '高二(3)班', grade: '高二', teacherId: teacher1.id, code: 'G203' },
|
||||
{ enrollmentYear: 2026, classIndex: 1, grade: '高一', teacherId: teacher1.id, code: 'G101' },
|
||||
{ enrollmentYear: 2026, classIndex: 2, grade: '高一', teacherId: teacher2.id, code: 'G102' },
|
||||
{ enrollmentYear: 2025, classIndex: 3, grade: '高二', teacherId: teacher1.id, code: 'G203' },
|
||||
];
|
||||
|
||||
const classes = [];
|
||||
for (const [index, seed] of classSeeds.entries()) {
|
||||
const created = await prisma.class.create({
|
||||
data: {
|
||||
name: seed.name,
|
||||
name: formatClassName(seed.enrollmentYear, seed.classIndex),
|
||||
grade: seed.grade,
|
||||
enrollmentYear: seed.enrollmentYear,
|
||||
classIndex: seed.classIndex,
|
||||
teacherId: seed.teacherId,
|
||||
code: seed.code,
|
||||
passwordHash: classPasswordHash,
|
||||
@@ -126,37 +143,41 @@ async function main(): Promise<void> {
|
||||
classes.push({ ...created, room: CLASS_ROOMS[index] ?? '教学楼 A101' });
|
||||
}
|
||||
|
||||
// 高二(3)班：李老师作为协作教师
|
||||
await prisma.classTeacher.create({
|
||||
data: { classId: classes[2]!.id, teacherId: teacher2.id },
|
||||
});
|
||||
|
||||
// ---------------------------------------------------------------- 学生
|
||||
// ---------------------------------------------------------------- 学生（只是名单，不是账号）
|
||||
const students = [];
|
||||
for (let index = 0; index < STUDENT_NAMES.length; index += 1) {
|
||||
const classIndex = Math.floor(index / 5);
|
||||
const targetClass = classes[classIndex] ?? classes[0]!;
|
||||
const student = await prisma.user.create({
|
||||
const classSlot = Math.floor(index / 5);
|
||||
const targetClass = classes[classSlot] ?? classes[0]!;
|
||||
// 学号：入学年份 + 两位序号（与班级称呼同一套「届别」口径）
|
||||
const student = await prisma.student.create({
|
||||
data: {
|
||||
username: `student${String(index + 1).padStart(2, '0')}`,
|
||||
studentNo: `${targetClass.enrollmentYear}${String(index + 1).padStart(2, '0')}`,
|
||||
name: STUDENT_NAMES[index] ?? `学生${index + 1}`,
|
||||
role: 'STUDENT',
|
||||
classId: targetClass.id,
|
||||
// 空串占位：User.passwordHash 必填，但学生登录的 403 判定在密码校验之前，永远用不到
|
||||
passwordHash: '',
|
||||
gender: index % 2 === 0 ? 'MALE' : 'FEMALE',
|
||||
guardianPhone: `138${String(10000000 + index * 137).slice(0, 8)}`,
|
||||
},
|
||||
});
|
||||
students.push(student);
|
||||
await prisma.enrollment.create({ data: { userId: student.id, classId: targetClass.id } });
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 课程
|
||||
// ---------------------------------------------------------------- 课程（= 班级 + 科目 + 教师的任课关系）
|
||||
//
|
||||
// 每门课都要挂一位**任课老师**：作业与成绩能不能被某位老师改动，查的就是 `Course.teacherId`。
|
||||
// 演示数据刻意让「语文」由另一位老师任教 —— 这样班主任在语文上就没有编辑权，
|
||||
// 正好覆盖需求「班主任不自动拥有所有科目作业成绩编辑权」这条规则。
|
||||
const OTHER_TEACHER_SUBJECT = '语文';
|
||||
const coursesByClass = new Map<string, { id: string; name: string }[]>();
|
||||
for (const targetClass of classes) {
|
||||
const otherTeacher = targetClass.teacherId === teacher1.id ? teacher2.id : teacher1.id;
|
||||
const created = [];
|
||||
for (const courseName of COURSE_NAMES) {
|
||||
const course = await prisma.course.create({
|
||||
data: { name: courseName, classId: targetClass.id, teacherId: targetClass.teacherId },
|
||||
data: {
|
||||
name: courseName,
|
||||
classId: targetClass.id,
|
||||
teacherId: courseName === OTHER_TEACHER_SUBJECT ? otherTeacher : targetClass.teacherId,
|
||||
},
|
||||
});
|
||||
created.push({ id: course.id, name: course.name });
|
||||
}
|
||||
@@ -280,7 +301,7 @@ async function main(): Promise<void> {
|
||||
const completed = (index + homework.title.length) % 3 !== 0;
|
||||
if (!completed && index % 2 === 1) continue;
|
||||
await prisma.homeworkStatus.create({
|
||||
data: { homeworkId: homework.id, userId: student.id, completed },
|
||||
data: { homeworkId: homework.id, studentId: student.id, completed },
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -331,7 +352,7 @@ async function main(): Promise<void> {
|
||||
const classmates = (studentsByClass.get(targetClass.id) ?? []).slice(0, 3);
|
||||
for (const student of classmates) {
|
||||
await prisma.notificationRead.create({
|
||||
data: { notificationId: notification.id, userId: student.id },
|
||||
data: { notificationId: notification.id, studentId: student.id },
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -339,23 +360,46 @@ async function main(): Promise<void> {
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 成绩
|
||||
//
|
||||
// 三种等级口径各演示一门，方便在界面上看出差别：
|
||||
// 数学（percent）—— 按得分率自动换算 A~E
|
||||
// 语文（custom） —— 自定义等级文本
|
||||
// 英语（letter） —— A / B / C / D
|
||||
const examNames = ['第一次月考', '期中考试'];
|
||||
const customLevels = ['优', '良', '合格'] as const;
|
||||
const letterLevels = ['A', 'B', 'C', 'D'] as const;
|
||||
const levelPlan = [
|
||||
{ type: 'percent' as const },
|
||||
{ type: 'custom' as const },
|
||||
{ type: 'letter' as const },
|
||||
];
|
||||
|
||||
for (const targetClass of classes) {
|
||||
const classCourses = coursesByClass.get(targetClass.id) ?? [];
|
||||
const classmates = studentsByClass.get(targetClass.id) ?? [];
|
||||
for (const [examIndex, examName] of examNames.entries()) {
|
||||
for (const course of classCourses.slice(0, 3)) {
|
||||
for (const [courseIndex, course] of classCourses.slice(0, 3).entries()) {
|
||||
const plan = levelPlan[courseIndex % levelPlan.length]!;
|
||||
for (const student of classmates) {
|
||||
const base = 60 + random() * 38;
|
||||
const score = Math.round(Math.min(100, Math.max(35, base - examIndex * 2)));
|
||||
const percent = gradePercent(score, 100);
|
||||
const level =
|
||||
plan.type === 'percent'
|
||||
? gradeLevel(percent)
|
||||
: plan.type === 'letter'
|
||||
? (letterLevels[Math.min(letterLevels.length - 1, Math.floor((100 - percent) / 12))] ?? 'D')
|
||||
: (customLevels[Math.min(customLevels.length - 1, Math.floor((100 - percent) / 15))] ?? '合格');
|
||||
await prisma.grade.create({
|
||||
data: {
|
||||
classId: targetClass.id,
|
||||
courseId: course.id,
|
||||
userId: student.id,
|
||||
studentId: student.id,
|
||||
examName,
|
||||
score,
|
||||
totalScore: 100,
|
||||
levelType: plan.type,
|
||||
level,
|
||||
publishedAt: new Date(now - (examIndex + 1) * 6 * day),
|
||||
},
|
||||
});
|
||||
@@ -364,24 +408,146 @@ async function main(): Promise<void> {
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 调班 / 转出历史
|
||||
//
|
||||
// 调班只改 `Student.classId`（学号不变，历史作业与成绩留在原班级），并留一条可查的痕迹。
|
||||
const movedStudent = students[7]!; // 赵依然：2026级2班 → 2026级1班（曾经）
|
||||
await prisma.student.update({
|
||||
where: { id: movedStudent.id },
|
||||
data: { classId: classes[0]!.id },
|
||||
});
|
||||
await prisma.studentClassTransfer.create({
|
||||
data: {
|
||||
studentId: movedStudent.id,
|
||||
studentNo: movedStudent.studentNo,
|
||||
studentName: movedStudent.name,
|
||||
fromClassId: classes[0]!.id,
|
||||
fromClassName: classes[0]!.name,
|
||||
toClassId: classes[1]!.id,
|
||||
toClassName: classes[1]!.name,
|
||||
operatorId: admin.id,
|
||||
operatorName: admin.name,
|
||||
mode: 'batch',
|
||||
note: '军训后按分班考试成绩重新均衡',
|
||||
createdAt: new Date(now - 30 * day),
|
||||
},
|
||||
});
|
||||
|
||||
// 转出：学籍离开本校（不是调班），班级归属保留作历史
|
||||
const transferredStudent = students[13]!; // 朱佳琪
|
||||
await prisma.student.update({
|
||||
where: { id: transferredStudent.id },
|
||||
data: {
|
||||
status: 'transferred',
|
||||
transferredAt: new Date(now - 12 * day),
|
||||
transferNote: '随家长工作调动转学至外地',
|
||||
},
|
||||
});
|
||||
await prisma.studentClassTransfer.create({
|
||||
data: {
|
||||
studentId: transferredStudent.id,
|
||||
studentNo: transferredStudent.studentNo,
|
||||
studentName: transferredStudent.name,
|
||||
fromClassId: transferredStudent.classId,
|
||||
fromClassName: classes[2]!.name,
|
||||
toClassId: null,
|
||||
toClassName: '转出本校',
|
||||
operatorId: admin.id,
|
||||
operatorName: admin.name,
|
||||
mode: 'transfer-out',
|
||||
note: '随家长工作调动转学至外地',
|
||||
createdAt: new Date(now - 12 * day),
|
||||
},
|
||||
});
|
||||
|
||||
// ---------------------------------------------------------------- 已毕业届别（归档页的演示数据）
|
||||
//
|
||||
// 归档 = 打标记 + 只读：班级与它的作业/通知原样留在库里，只是从常规列表里隐去。
|
||||
const graduatedClass = await prisma.class.create({
|
||||
data: {
|
||||
name: formatClassName(2023, 1),
|
||||
grade: '高三',
|
||||
enrollmentYear: 2023,
|
||||
classIndex: 1,
|
||||
teacherId: teacher1.id,
|
||||
code: 'G231',
|
||||
passwordHash: classPasswordHash,
|
||||
},
|
||||
});
|
||||
const archivedYear = await prisma.archivedYear.create({
|
||||
data: {
|
||||
enrollmentYear: 2023,
|
||||
graduationYear: 2023 + 3,
|
||||
name: formatYearLabel(2023),
|
||||
note: '演示用：2023 级已于 2026 年 6 月毕业',
|
||||
operatorId: admin.id,
|
||||
operatorName: admin.name,
|
||||
archivedAt: new Date(now - 100 * day),
|
||||
},
|
||||
});
|
||||
await prisma.class.update({
|
||||
where: { id: graduatedClass.id },
|
||||
data: { archivedYearId: archivedYear.id, archivedAt: new Date(now - 100 * day) },
|
||||
});
|
||||
|
||||
const graduateNames = ['毕业演示甲', '毕业演示乙', '毕业演示丙'];
|
||||
for (const [index, name] of graduateNames.entries()) {
|
||||
await prisma.student.create({
|
||||
data: {
|
||||
studentNo: `2023${String(index + 1).padStart(2, '0')}`,
|
||||
name,
|
||||
classId: graduatedClass.id,
|
||||
gender: index % 2 === 0 ? 'MALE' : 'FEMALE',
|
||||
status: 'graduated',
|
||||
archivedYearId: archivedYear.id,
|
||||
archivedAt: new Date(now - 100 * day),
|
||||
},
|
||||
});
|
||||
}
|
||||
// 这一届也要有作业与通知，「记录每个年度毕业班级的消息和作业」才有东西可看
|
||||
await prisma.homework.create({
|
||||
data: {
|
||||
classId: graduatedClass.id,
|
||||
title: '高考前最后一轮复习',
|
||||
content: '按考点清单过一遍错题本，重点看函数与数列。',
|
||||
assignDate: dayKeyLocal(new Date(now - 120 * day)),
|
||||
createdBy: teacher1.id,
|
||||
},
|
||||
});
|
||||
await prisma.notification.create({
|
||||
data: {
|
||||
classId: graduatedClass.id,
|
||||
title: '毕业典礼安排',
|
||||
content: '6 月 20 日上午 9 点在礼堂举行毕业典礼，请全体同学准时参加。',
|
||||
priority: 'HIGH',
|
||||
createdBy: teacher1.id,
|
||||
createdAt: new Date(now - 110 * day),
|
||||
},
|
||||
});
|
||||
|
||||
const counts = {
|
||||
用户: await prisma.user.count(),
|
||||
班级: await prisma.class.count(),
|
||||
账号: await prisma.user.count(),
|
||||
在读班级: await prisma.class.count({ where: { archivedYearId: null } }),
|
||||
学生: await prisma.student.count({ where: { status: 'active' } }),
|
||||
课程: await prisma.course.count(),
|
||||
课表: await prisma.schedule.count(),
|
||||
作业: await prisma.homework.count(),
|
||||
通知: await prisma.notification.count(),
|
||||
成绩: await prisma.grade.count(),
|
||||
调班历史: await prisma.studentClassTransfer.count(),
|
||||
归档届别: await prisma.archivedYear.count(),
|
||||
};
|
||||
|
||||
logger.info('种子数据写入完成', counts);
|
||||
|
||||
console.log('\n================ 演示账号 ================');
|
||||
console.log(`管理员 admin / admin123 (${admin.name})`);
|
||||
console.log(`教师 teacher1 / teacher123 (${teacher1.name} · 高一(1)班、高二(3)班)`);
|
||||
console.log(`教师 teacher2 / teacher123 (${teacher2.name} · 高一(2)班、高二(3)班协作)`);
|
||||
console.log('学生端（班级账号）：G101 / G102 / G203，密码 123456');
|
||||
console.log('（学生只有名单、没有个人账号，成绩/未交/叫人按名单记录）');
|
||||
console.log(`管理员 admin / admin123 (${admin.name} · 可执行毕业归档与调班)`);
|
||||
console.log(`教师 teacher1 / teacher123 (${teacher1.name} · ${classes[0]!.name} 班主任，教数学)`);
|
||||
console.log(`教师 teacher2 / teacher123 (${teacher2.name} · ${classes[1]!.name} 班主任，教 ${classes[0]!.name} 语文)`);
|
||||
console.log('ClassHelper 班级端（班级码）：G101 / G102 / G203，密码 123456');
|
||||
console.log('（学生只有名单、没有账号：成绩/未交/叫人按学号记录）');
|
||||
console.log(`已在读班级：${classes.map((item) => item.name).join(' / ')}`);
|
||||
console.log(`已归档届别：${formatYearLabel(2023)}（${graduatedClass.name}，${graduateNames.length} 名毕业生）`);
|
||||
console.log('==========================================\n');
|
||||
}
|
||||
|
||||
|
||||
Reference in new issue
Block a user