38 KiB
38 KiB
班级管理与排课系统设计方案
版本: v1.0 设计日期: 2026-02-22 设计目标: 支持多教师协作、学生调班、智能排课、课程提醒
一、需求总结
1.1 核心需求
| 需求 | 描述 | 优先级 |
|---|---|---|
| 多教师协作 | 一个班级支持主班、配班、保育员等多教师 | P1 |
| 学生调班 | 学校端可给学生调换班级 | P1 |
| 学校排课 | 学校统一安排课程计划（时间、课程、班级、教师） | P1 |
| 教师自排课 | 教师可自行安排上课或预约上课 | P1 |
| 课程提醒 | 上课前的提醒通知 | P2 |
| 模式兼容 | 学校排课与教师自排课两种模式共存 | P1 |
1.2 行业最佳实践参考
根据调研，优秀的排课系统应具备：
-
智能排课引擎
- 多约束条件优化（教师时间、教室容量、课程优先级）
- 冲突自动检测与修复
- 支持手动调整
-
可视化交互
- 周/月视图课表
- 拖拽式调课
- 实时冲突提示
-
多端协同
- 课表变更实时推送
- 教师/家长端同步
-
混合排课模式
- 支持自动排课 + 手动微调
- 支持学校统一排课 + 教师自主预约
二、数据模型设计
2.1 班级教师关联（新增）
问题：当前 Class.teacherId 只能指向一个教师，无法支持多教师协作。
解决方案：引入中间表 ClassTeacher
┌─────────────────────────────────────────────────────────────┐
│ 班级-教师关联模型 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────────┐ ┌──────────┐│
│ │ Class │ ◄───────│ClassTeacher │────────►│ Teacher ││
│ │ │ 1:N │ │ N:1 │ ││
│ └──────────┘ │ - role │ └──────────┘│
│ │ - isPrimary │ │
│ │ - startDate │ │
│ │ - endDate │ │
│ └──────────────┘ │
│ │
│ 角色类型 (role): │
│ - MAIN: 主班教师 │
│ - ASSIST: 配班教师 │
│ - CARE: 保育员 │
│ │
└─────────────────────────────────────────────────────────────┘
Prisma Schema:
model ClassTeacher {
id Int @id @default(autoincrement())
classId Int @map("class_id")
teacherId Int @map("teacher_id")
role String @default("MAIN") // MAIN, ASSIST, CARE
isPrimary Boolean @default(false) // 是否班主任
startDate DateTime? @map("start_date")
endDate DateTime? @map("end_date")
createdAt DateTime @default(now()) @map("created_at")
updatedAt DateTime @updatedAt @map("updated_at")
class Class @relation(fields: [classId], references: [id], onDelete: Cascade)
teacher Teacher @relation(fields: [teacherId], references: [id], onDelete: Cascade)
@@unique([classId, teacherId])
@@map("class_teachers")
}
2.2 学生班级历史（新增）
问题：学生调班后无法追溯历史记录。
解决方案：引入 StudentClassHistory 表
model StudentClassHistory {
id Int @id @default(autoincrement())
studentId Int @map("student_id")
classId Int @map("class_id")
startDate DateTime @map("start_date")
endDate DateTime? @map("end_date")
reason String? // 调班原因
createdBy Int? @map("created_by") // 操作人
createdAt DateTime @default(now()) @map("created_at")
student Student @relation(fields: [studentId], references: [id])
class Class @relation(fields: [classId], references: [id])
@@map("student_class_history")
}
2.3 排课计划表（新增）
核心设计：区分"排课计划"和"授课记录"
┌─────────────────────────────────────────────────────────────┐
│ 排课与授课模型 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │SchedulePlan │ 1:N │ Lesson │ │
│ │ (排课计划) │────────►│ (授课记录) │ │
│ │ │ │ │ │
│ │ 学校创建 │ │ 教师创建 │ │
│ │ 或教师预约 │ │ 或系统生成 │ │
│ └──────────────┘ └──────────────┘ │
│ │
│ SchedulePlan (排课计划): │
│ - 学校统一安排的课程计划 │
│ - 或教师预约的上课计划 │
│ - 可重复生成多个 Lesson │
│ │
│ Lesson (授课记录): │
│ - 实际的一次授课 │
│ - 包含上课状态、评价等 │
│ │
└─────────────────────────────────────────────────────────────┘
Prisma Schema:
model SchedulePlan {
id Int @id @default(autoincrement())
tenantId Int @map("tenant_id")
// 关联信息
classId Int @map("class_id")
courseId Int @map("course_id")
teacherId Int? @map("teacher_id") // 可选，未分配时为空
// 时间信息
scheduledDate DateTime? @map("scheduled_date") // 具体日期
scheduledTime String? @map("scheduled_time") // 时间段 "09:00-09:30"
weekDay Int? @map("week_day") // 周几 (1-7)，用于重复排课
// 重复规则
repeatType String @default("NONE") @map("repeat_type") // NONE, DAILY, WEEKLY
repeatEndDate DateTime? @map("repeat_end_date")
// 排课来源
source String @default("SCHOOL") // SCHOOL(学校排课), TEACHER(教师预约)
createdBy Int @map("created_by") // 创建人ID
// 状态
status String @default("ACTIVE") // ACTIVE, CANCELLED, COMPLETED
// 提醒设置
reminderEnabled Boolean @default(true) @map("reminder_enabled")
reminderMinutes Int @default(30) @map("reminder_minutes") // 提前多少分钟提醒
note String?
createdAt DateTime @default(now()) @map("created_at")
updatedAt DateTime @updatedAt @map("updated_at")
tenant Tenant @relation(fields: [tenantId], references: [id])
class Class @relation(fields: [classId], references: [id])
course Course @relation(fields: [courseId], references: [id])
teacher Teacher? @relation(fields: [teacherId], references: [id])
lessons Lesson[]
@@map("schedule_plans")
}
2.4 课程提醒（新增）
model CourseReminder {
id Int @id @default(autoincrement())
schedulePlanId Int? @map("schedule_plan_id")
lessonId Int? @map("lesson_id")
userId Int @map("user_id") // 接收提醒的用户
userType String @map("user_type") // TEACHER, PARENT
reminderType String @map("reminder_type") // BEFORE_CLASS, AFTER_CLASS
reminderTime DateTime @map("reminder_time")
content String
sent Boolean @default(false)
sentAt DateTime? @map("sent_at")
createdAt DateTime @default(now()) @map("created_at")
schedulePlan SchedulePlan? @relation(fields: [schedulePlanId], references: [id])
lesson Lesson? @relation(fields: [lessonId], references: [id])
@@map("course_reminders")
}
2.5 更新现有模型
Lesson 模型更新:
model Lesson {
id Int @id @default(autoincrement())
tenantId Int @map("tenant_id")
teacherId Int @map("teacher_id")
classId Int @map("class_id")
courseId Int @map("course_id")
// 新增：关联排课计划
schedulePlanId Int? @map("schedule_plan_id")
plannedDatetime DateTime? @map("planned_datetime")
startDatetime DateTime? @map("start_datetime")
endDatetime DateTime? @map("end_datetime")
actualDuration Int? @map("actual_duration")
status String @default("PLANNED") // PLANNED, IN_PROGRESS, COMPLETED, CANCELLED
// ... 其他字段保持不变
schedulePlan SchedulePlan? @relation(fields: [schedulePlanId], references: [id])
@@map("lessons")
}
Class 模型更新:
model Class {
id Int @id @default(autoincrement())
tenantId Int @map("tenant_id")
name String
grade String
// 修改：teacherId 改为可选，通过 ClassTeacher 关联多个教师
teacherId Int? @map("teacher_id") // 保留用于向后兼容
// 新增字段
classroom String? // 教室位置
capacity Int @default(30) // 班级容量
studentCount Int @default(0) @map("student_count")
lessonCount Int @default(0) @map("lesson_count")
createdAt DateTime @default(now()) @map("created_at")
updatedAt DateTime @updatedAt @map("updated_at")
tenant Tenant @relation(fields: [tenantId], references: [id])
teacher Teacher? @relation(fields: [teacherId], references: [id])
classTeachers ClassTeacher[]
students Student[]
lessons Lesson[]
schedulePlans SchedulePlan[]
studentHistory StudentClassHistory[]
@@map("classes")
}
三、功能模块设计
3.1 学校端功能
3.1.1 班级管理增强
┌─────────────────────────────────────────────────────────────┐
│ 学校端 - 班级管理 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 【班级列表】 │
│ ├── 班级基本信息（名称、年级、教室、容量） │
│ ├── 教师团队（主班、配班、保育员） │
│ ├── 学生列表 │
│ └── 操作：编辑、归档、删除 │
│ │
│ 【教师分配】 │
│ ├── 添加教师到班级 │
│ ├── 设置教师角色（主班/配班/保育） │
│ ├── 设置班主任 │
│ └── 移除教师 │
│ │
│ 【学生管理】 │
│ ├── 查看班级学生 │
│ ├── 添加学生到班级 │
│ ├── 学生调班（选择目标班级） │
│ └── 移除学生 │
│ │
└─────────────────────────────────────────────────────────────┘
3.1.2 排课管理（新增）
┌─────────────────────────────────────────────────────────────┐
│ 学校端 - 排课管理 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 【排课计划列表】 │
│ ├── 筛选：班级/教师/课程/日期范围 │
│ ├── 状态：待执行/已完成/已取消 │
│ └── 操作：编辑、取消、生成授课记录 │
│ │
│ 【新建排课】 │
│ ├── 选择班级 │
│ ├── 选择课程 │
│ ├── 选择教师（可选，不选则待分配） │
│ ├── 设置时间 │
│ │ ├── 单次：选择具体日期时间 │
│ │ └── 重复：每周X，开始日期，结束日期 │
│ ├── 提醒设置 │
│ └── 保存 │
│ │
│ 【课表视图】 │
│ ├── 周视图：按班级/教师展示一周课表 │
│ ├── 月视图：月度排课概览 │
│ └── 冲突检测：实时提示时间/教师/教室冲突 │
│ │
│ 【批量排课】 │
│ ├── Excel导入排课计划 │
│ └── 复制上周排课 │
│ │
└─────────────────────────────────────────────────────────────┘
3.2 教师端功能
3.2.1 我的班级
┌─────────────────────────────────────────────────────────────┐
│ 教师端 - 我的班级 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 【班级列表】 │
│ ├── 显示我参与的班级（主班/配班/保育） │
│ ├── 班级信息卡片 │
│ │ ├── 班级名称、年级 │
│ │ ├── 我的角色（标签显示） │
│ │ ├── 学生人数 │
│ │ └── 同班教师 │
│ └── 操作：查看学生、开始备课、查看课表 │
│ │
│ 【班级学生】 │
│ ├── 学生列表（同班所有学生） │
│ └── 学生详情 │
│ │
└─────────────────────────────────────────────────────────────┘
3.2.2 我的课表（新增）
┌─────────────────────────────────────────────────────────────┐
│ 教师端 - 我的课表 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 【课表视图】 │
│ ├── 周视图：显示本周所有排课 │
│ ├── 日视图：显示今日课程详情 │
│ └── 月视图：月度课程概览 │
│ │
│ 【课程来源标识】 │
│ ├── 🏫 学校排课：由学校统一安排 │
│ └── 👤 自主预约：教师自己创建 │
│ │
│ 【课程状态】 │
│ ├── 待上课：plannedDatetime 未到 │
│ ├── 进行中：已开始上课 │
│ ├── 已完成：上课结束 │
│ └── 已取消：排课被取消 │
│ │
│ 【操作】 │
│ ├── 查看课程详情 │
│ ├── 开始上课（进入上课模式） │
│ └── 申请调课（需学校审批） │
│ │
└─────────────────────────────────────────────────────────────┘
3.2.3 自主排课/预约上课
┌─────────────────────────────────────────────────────────────┐
│ 教师端 - 自主排课/预约 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 【预约上课】（原有功能增强） │
│ ├── 选择课程 │
│ ├── 选择班级 │
│ ├── 设置预约时间 │
│ ├── 开启课程提醒 │
│ └── 创建 │
│ │
│ 【即时上课】（原有功能） │
│ ├── 从课程详情页直接开始 │
│ └── 自动创建 Lesson 记录 │
│ │
│ 【我的预约列表】 │
│ ├── 查看所有预约记录 │
│ ├── 修改/取消预约 │
│ └── 开始上课 │
│ │
└─────────────────────────────────────────────────────────────┘
四、业务流程设计
4.1 排课模式对比
┌─────────────────────────────────────────────────────────────┐
│ 两种排课模式对比 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 【模式一：学校统一排课】 │
│ │
│ 学校教务 ──创建──► SchedulePlan ──生成──► Lesson │
│ │ │ │
│ │ ├── 关联班级 │
│ │ ├── 关联课程 │
│ │ ├── 指定教师（或待分配） │
│ │ └── 设置时间 │
│ │ │
│ └─────────── 发送通知给教师 ──────────────┘ │
│ │
│ 【模式二：教师自主预约】 │
│ │
│ 教师 ──创建──► SchedulePlan (source=TEACHER) │
│ │ │ │
│ │ └── 自动生成 Lesson │
│ │ │
│ └─────────── 设置提醒 ────────────────────┘ │
│ │
│ 【模式三：即时上课】（原有） │
│ │
│ 教师 ──开始上课──► 直接创建 Lesson │
│ │ │ │
│ │ └── 状态: IN_PROGRESS │
│ │ │
│ └─────────── 无需预约 ──────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
4.2 课程提醒流程
┌─────────────────────────────────────────────────────────────┐
│ 课程提醒流程 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ │
│ │ SchedulePlan │ │
│ │ (有提醒) │ │
│ └──────┬───────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ 定时任务扫描 │────►│ 检查提醒时间 │ │
│ │ (每分钟) │ │ │ │
│ └──────────────┘ └──────┬───────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ 创建提醒记录 │ │
│ │ CourseReminder │ │
│ └────────┬─────────┘ │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 站内消息 │ │ 微信推送 │ │ 短信通知 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ 提醒对象： │
│ - 主班教师、配班教师 │
│ - 可选：家长（需要家长端支持） │
│ │
│ 提醒时机： │
│ - 默认：上课前30分钟 │
│ - 可配置：15分钟、30分钟、1小时、1天 │
│ │
└─────────────────────────────────────────────────────────────┘
4.3 学生调班流程
┌─────────────────────────────────────────────────────────────┐
│ 学生调班流程 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 学校端操作： │
│ │
│ ┌────────┐ ┌────────┐ ┌────────┐ │
│ │选择学生│────►│选择新班│────►│确认调班│ │
│ └────────┘ └────────┘ └────┬───┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────┐ │
│ │ 系统自动处理： │ │
│ │ 1. 更新 Student.classId │ │
│ │ 2. 更新旧班 studentCount │ │
│ │ 3. 更新新班 studentCount │ │
│ │ 4. 创建 StudentClassHistory│ │
│ │ 5. 记录调班原因和操作人 │ │
│ └─────────────────────────────┘ │
│ │
│ 权限控制： │
│ - 只有学校端可以调班 │
│ - 教师端只能查看，无权操作 │
│ │
└─────────────────────────────────────────────────────────────┘
五、API 设计
5.1 学校端 API
# 班级管理
POST /school/classes # 创建班级
GET /school/classes # 班级列表
PUT /school/classes/:id # 更新班级
DELETE /school/classes/:id # 删除班级
# 班级教师管理
GET /school/classes/:id/teachers # 获取班级教师列表
POST /school/classes/:id/teachers # 添加教师到班级
PUT /school/classes/:id/teachers/:tid # 更新教师角色
DELETE /school/classes/:id/teachers/:tid # 移除教师
# 学生调班
POST /school/students/:id/transfer # 学生调班
GET /school/students/:id/history # 学生班级历史
# 排课管理
GET /school/schedules # 排课列表
POST /school/schedules # 创建排课
PUT /school/schedules/:id # 更新排课
DELETE /school/schedules/:id # 取消排课
POST /school/schedules/:id/generate # 生成授课记录
# 课表视图
GET /school/schedules/timetable # 课表视图（周/月）
GET /school/schedules/conflicts # 冲突检测
5.2 教师端 API
# 我的班级
GET /teacher/classes # 我的班级列表
GET /teacher/classes/:id # 班级详情
GET /teacher/classes/:id/students # 班级学生
GET /teacher/classes/:id/teachers # 同班教师
# 我的课表
GET /teacher/schedules # 我的排课列表
GET /teacher/schedules/timetable # 我的课表视图
GET /teacher/schedules/today # 今日课程
# 自主排课/预约
POST /teacher/schedules # 创建预约
PUT /teacher/schedules/:id # 修改预约
DELETE /teacher/schedules/:id # 取消预约
# 上课
POST /teacher/lessons # 开始上课（即时或预约）
POST /teacher/lessons/:id/start # 开始上课
POST /teacher/lessons/:id/finish # 结束上课
# 提醒
GET /teacher/reminders # 我的提醒列表
PUT /teacher/reminders/:id/read # 标记已读
六、前端页面设计
6.1 学校端新增页面
| 页面 | 路由 | 功能 |
|---|---|---|
| 排课管理 | /school/schedules | 排课列表、新建、编辑 |
| 课表视图 | /school/schedules/timetable | 周/月课表视图 |
| 班级教师 | /school/classes/:id/teachers | 管理班级教师团队 |
| 学生调班 | /school/students/:id/transfer | 学生调班操作 |
6.2 教师端新增/修改页面
| 页面 | 路由 | 功能 |
|---|---|---|
| 我的课表 | /teacher/schedules | 查看排课计划 |
| 预约上课 | /teacher/schedules/create | 创建预约 |
| 我的班级 | /teacher/classes | 修改：显示教师角色 |
七、实施计划
7.1 阶段划分
┌─────────────────────────────────────────────────────────────┐
│ 实施阶段 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 【Phase 1: 数据模型更新】(3天) │
│ ├── 创建 ClassTeacher 表 │
│ ├── 创建 StudentClassHistory 表 │
│ ├── 创建 SchedulePlan 表 │
│ ├── 创建 CourseReminder 表 │
│ ├── 数据迁移：现有数据兼容处理 │
│ └── 更新 Prisma schema │
│ │
│ 【Phase 2: 学校端功能】(5天) │
│ ├── 班级教师管理API + 前端 │
│ ├── 学生调班API + 前端 │
│ ├── 排课管理API + 前端 │
│ └── 课表视图前端 │
│ │
│ 【Phase 3: 教师端功能】(4天) │
│ ├── 我的班级增强（显示角色） │
│ ├── 我的课表API + 前端 │
│ ├── 自主预约功能增强 │
│ └── 课程来源标识 │
│ │
│ 【Phase 4: 提醒系统】(3天) │
│ ├── 提醒记录创建 │
│ ├── 定时任务服务 │
│ ├── 站内消息通知 │
│ └── (可选) 微信/短信推送 │
│ │
│ 【Phase 5: 测试与优化】(2天) │
│ ├── 功能测试 │
│ ├── 性能优化 │
│ └── 文档更新 │
│ │
│ 总计: 约17个工作日 │
│ │
└─────────────────────────────────────────────────────────────┘
7.2 优先级排序
| 优先级 | 功能 | 原因 |
|---|---|---|
| P0 | ClassTeacher 表 | 多教师协作的基础 |
| P0 | SchedulePlan 表 | 排课功能的基础 |
| P1 | 学校端排课管理 | 核心新功能 |
| P1 | 教师端课表查看 | 教师需要看到排课结果 |
| P1 | 学生调班 | 学校管理需求 |
| P2 | 课程提醒 | 提升用户体验 |
| P3 | 微信/短信推送 | 可后期扩展 |
八、风险与对策
| 风险 | 影响 | 对策 |
|---|---|---|
| 数据迁移复杂 | 现有数据丢失 | 保留 teacherId 字段向后兼容，渐进迁移 |
| 排课冲突 | 用户体验差 | 实时冲突检测，智能推荐替代方案 |
| 提醒延迟 | 用户错过课程 | 多渠道提醒，定时任务容错处理 |
| 前端改动大 | 开发周期长 | 分阶段实施，优先核心功能 |
九、总结
本设计方案实现了以下核心目标：
-
多教师协作 ✅
- 通过 ClassTeacher 中间表支持主班/配班/保育员
-
学生调班 ✅
- 学校端可操作，记录历史，更新统计
-
混合排课模式 ✅
- 学校统一排课 + 教师自主预约 + 即时上课
- 三种模式共存，灵活适配不同场景
-
课程提醒 ✅
- 可配置提醒时间
- 多渠道通知
-
扩展性 ✅
- 数据模型支持学期管理、教室管理等后续扩展
设计完成于 2026-02-22 文档版本: v1.0