# 班级管理与排课系统设计方案 > 版本: v1.0 > 设计日期: 2026-02-22 > 设计目标: 支持多教师协作、学生调班、智能排课、课程提醒 --- ## 一、需求总结 ### 1.1 核心需求 | 需求 | 描述 | 优先级 | |-----|------|-------| | 多教师协作 | 一个班级支持主班、配班、保育员等多教师 | P1 | | 学生调班 | 学校端可给学生调换班级 | P1 | | 学校排课 | 学校统一安排课程计划（时间、课程、班级、教师） | P1 | | 教师自排课 | 教师可自行安排上课或预约上课 | P1 | | 课程提醒 | 上课前的提醒通知 | P2 | | 模式兼容 | 学校排课与教师自排课两种模式共存 | P1 | ### 1.2 行业最佳实践参考 根据调研，优秀的排课系统应具备： 1. **智能排课引擎** - 多约束条件优化（教师时间、教室容量、课程优先级） - 冲突自动检测与修复 - 支持手动调整 2. **可视化交互** - 周/月视图课表 - 拖拽式调课 - 实时冲突提示 3. **多端协同** - 课表变更实时推送 - 教师/家长端同步 4. **混合排课模式** - 支持自动排课 + 手动微调 - 支持学校统一排课 + 教师自主预约 --- ## 二、数据模型设计 ### 2.1 班级教师关联（新增） **问题**：当前 `Class.teacherId` 只能指向一个教师，无法支持多教师协作。 **解决方案**：引入中间表 `ClassTeacher` ``` ┌─────────────────────────────────────────────────────────────┐ │ 班级-教师关联模型 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────┐ ┌──────────────┐ ┌──────────┐│ │ │ Class │ ◄───────│ClassTeacher │────────►│ Teacher ││ │ │ │ 1:N │ │ N:1 │ ││ │ └──────────┘ │ - role │ └──────────┘│ │ │ - isPrimary │ │ │ │ - startDate │ │ │ │ - endDate │ │ │ └──────────────┘ │ │ │ │ 角色类型 (role): │ │ - MAIN: 主班教师 │ │ - ASSIST: 配班教师 │ │ - CARE: 保育员 │ │ │ └─────────────────────────────────────────────────────────────┘ ``` **Prisma Schema**: ```prisma 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` 表 ```prisma 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**: ```prisma 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 课程提醒（新增） ```prisma 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 模型更新**: ```prisma 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 模型更新**: ```prisma 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 字段向后兼容，渐进迁移 | | 排课冲突 | 用户体验差 | 实时冲突检测，智能推荐替代方案 | | 提醒延迟 | 用户错过课程 | 多渠道提醒，定时任务容错处理 | | 前端改动大 | 开发周期长 | 分阶段实施，优先核心功能 | --- ## 九、总结 本设计方案实现了以下核心目标： 1. **多教师协作** ✅ - 通过 ClassTeacher 中间表支持主班/配班/保育员 2. **学生调班** ✅ - 学校端可操作，记录历史，更新统计 3. **混合排课模式** ✅ - 学校统一排课 + 教师自主预约 + 即时上课 - 三种模式共存，灵活适配不同场景 4. **课程提醒** ✅ - 可配置提醒时间 - 多渠道通知 5. **扩展性** ✅ - 数据模型支持学期管理、教室管理等后续扩展 --- *设计完成于 2026-02-22* *文档版本: v1.0*