微搭低代码MBA 培训管理系统实战 22——课程排课
目录
在上一讲中,我们完成了班级管理与花名册的搭建。学员已经分好班了,接下来教务老师面临的最头疼的工作就是排课。本讲将详细介绍如何实现排课功能,包括教室管理、课表设计以及核心的资源冲突检测机制。
第一步:数据准备
1.1 教室表(MBA_Classrooms)
创建教室表,用于管理物理空间:
| 字段名称 | 字段标识 | 类型 | 说明 |
|---|---|---|---|
| 教室名称 | room_name | 单行文本 | 如:第一阶梯教室、VIP面授室 |
| 容纳人数 | capacity | 数字 | 用于后期校验是否超载 |
| 状态 | status | 枚举 | 启用、停用、维护中 |
| 创建时间 | created_at | 日期时间 | 自动生成 |
| 更新时间 | updated_at | 日期时间 | 自动更新 |

1.2 课表/排课记录表(MBA_Schedules)
创建排课记录表,承载具体的上课时间与资源绑定:
| 字段名称 | 字段标识 | 类型 | 说明 |
|---|---|---|---|
| 关联班级 | rel_class_id | 关联关系 | 关联MBA_Classes表 |
| 关联教师 | rel_teacher_id | 关联关系 | 关联MBA_Teachers表 |
| 关联教室 | rel_room_id | 关联关系 | 关联MBA_Classrooms表 |
| 上课日期 | course_date | 日期 | 如:2026-04-15 |
| 开始时间 | start_time | 时间 | 如:09:00 |
| 结束时间 | end_time | 时间 | 如:11:30 |
| 课表状态 | status | 枚举 | 待上课、已结课、已取消 |
| 创建时间 | created_at | 日期时间 | 自动生成 |
| 更新时间 | updated_at | 日期时间 | 自动更新 |

第二步:教室管理页面搭建
2.1 页面整体布局
点击创建页面的图标

输入页面的名称"教室管理",布局选择管理员布局(基础数据管理通常由管理员维护)

切换到页面布局,选择管理员布局,添加平级菜单,添加教室管理菜单

2.2 数据表格配置
在管理员布局的内容插槽下添加布局组件

修改标题,改为"教室管理"

在页面布局中添加数据表格组件,数据模型选择教室表

2.3 配置查询条件
点击筛选器,给表格配置查询条件
添加具体的查询条件:
- 教室名称(模糊搜索)
- 状态(下拉选择)

2.4 配置排序字段
默认按照创建时间的倒序进行排序,最新的教室显示在最前面

第三步:排课页面布局搭建
3.1 页面整体布局
点击创建页面的图标

输入页面的名称"排课管理",布局选择教务布局(因为主要是教务人员使用)

切换到页面布局,选择教务布局,添加平级菜单,添加排课管理菜单

3.2 数据表格配置
在教务布局的内容插槽下添加布局组件

修改标题,改为"排课管理"

在页面布局中添加数据表格组件,数据模型选择课表

3.3 配置查询条件
点击筛选器,给表格配置查询条件
添加具体的查询条件:
- 关联班级(关联选择)
- 关联教师(关联选择)
- 关联教室(关联选择)
- 上课日期范围(日期范围)

3.4 配置排序字段
默认按照上课日期的倒序进行排序,最新的排课显示在最前面

第四步:排课弹窗实现
在排课管理页面添加弹窗组件,用于录入新的排课

从组件库中拖拽弹窗组件到页面,设置弹窗标题为"新增排课"

在弹窗中添加表单容器组件,数据模型选择课表

修改表单布局,改为双列布局

选中弹窗组件,关闭显示底部按钮,关闭弹窗默认打开状态


给新建按钮配置点击事件,打开弹窗

第五步:冲突检测与排课提交
创建自定义方法,用来检查排课是否冲突并且提交排课记录
// 提交排课asyncfunctioncheckScheduleConflict(params){const{ teacherId, roomId, classId, courseDate, startTime, endTime }= params;// 计算开始和结束的时间戳(日期毫秒值 + 时间毫秒值)const startTimestamp = courseDate + startTime;const endTimestamp = courseDate + endTime;// 构造核心的时间重叠查询条件: (新开始 < 旧结束) AND (新结束 > 旧开始)const timeOverlapFilter ={$and:[{course_date:{$eq: courseDate }},// 同一天{start_time:{$lt: endTime }},// 新开始时间 < 旧结束时间{end_time:{$gt: startTime }},// 新结束时间 > 旧开始时间{status:{$neq:'3'}}// 排除已取消的课程]};try{// 1. 检测【教师】冲突const teacherRes =await $w.cloud.callDataSource({dataSourceName:'MBA_Schedules',methodName:'wedaGetRecordsV2',params:{filter:{where:{$and:[{rel_teacher_id:{$eq: teacherId }}, timeOverlapFilter ]}},getCount:true}});if(teacherRes.total >0){return{code:-1,msg:'排课失败:该教师在此时间段已有排课安排!'};}// 2. 检测【教室】冲突const roomRes =await $w.cloud.callDataSource({dataSourceName:'MBA_Schedules',methodName:'wedaGetRecordsV2',params:{filter:{where:{$and:[{rel_room_id:{$eq: roomId }}, timeOverlapFilter ]}},getCount:true}});if(roomRes.total >0){return{code:-2,msg:'排课失败:该教室在此时间段已被占用!'};}// 3. 检测【班级】自身的冲突(防止同一班级同一时间排两节不同的课)const classRes =await $w.cloud.callDataSource({dataSourceName:'MBA_Schedules',methodName:'wedaGetRecordsV2',params:{filter:{where:{$and:[{rel_class_id:{$eq: classId }}, timeOverlapFilter ]}},getCount:true}});if(classRes.total >0){return{code:-3,msg:'排课失败:该班级在此时间段已排有课程!'};}// 全部通过,无冲突return{code:0,msg:'校验通过,资源可用'};}catch(error){ console.error('冲突检测失败:', error);return{code:-99,msg:'系统异常,请稍后重试'};}}exportdefaultasyncfunctionsubmitSchedule({ event, data }){// 1. 获取表单数据const formData = $w.form1.value;// 2. 校验时间合法性(course_date、start_time、end_time都是毫秒值)if(formData.start_time >= formData.end_time){ $w.utils.showToast({title:'开始时间必须小于结束时间',icon:'error'});return;} $w.utils.showLoading({title:'正在检测资源冲突...'});try{// 3. 调用前端的冲突检测方法const checkRes =awaitcheckScheduleConflict({teacherId: formData.rel_teacher_id,roomId: formData.rel_room_id,classId: formData.rel_class_id,courseDate: formData.course_date,startTime: formData.start_time,endTime: formData.end_time });// 4. 根据校验结果决定是否入库if(checkRes.code !==0){ $w.utils.hideLoading(); $w.utils.showModal({title:'冲突警告',content: checkRes.msg });return;}// 5. 校验通过,正式写入排课表await $w.cloud.callDataSource({dataSourceName:'MBA_Schedules',methodName:'wedaCreateV2',params:{data:{rel_class_id:{_id: formData.rel_class_id },rel_teacher_id:{_id: formData.rel_teacher_id },rel_room_id:{_id: formData.rel_room_id },course_date: formData.course_date,start_time: formData.start_time,end_time: formData.end_time,status:'1',// 待上课}}}); $w.utils.hideLoading(); $w.utils.showToast({title:'排课成功',icon:'success'}); $w.modal1.close({});// 关闭弹窗 $w.table1.refresh();// 刷新排课列表}catch(error){ $w.utils.hideLoading(); $w.utils.showToast({title:'系统异常',icon:'error'});}}选择表单容器,修改表单的提交方法,改为我们的自定义方法

最终效果
教务人员打开排课管理页面,可以看到所有的排课记录:

点击"新增排课"按钮,打开排课弹窗:

当试图把张老师同时排给 A 班和 B 班时,系统会立即拦截并弹出:"排课失败:该教师在此时间段已有排课安排!"的警告。

总结
本节我们完成了排课系统引擎的完整实现:
- 数据模型设计:
- 创建了
MBA_Classrooms教室表,管理物理空间 - 创建了
MBA_Schedules课表,记录排课信息
- 创建了
- 页面搭建:
- 创建排课管理页面,使用教务布局
- 配置数据表格,显示排课列表
- 配置查询条件和排序规则
- 冲突检测引擎:
- 实现教师冲突检测
- 实现教室冲突检测
- 实现班级冲突检测
- 使用
(Start A < End B) AND (End A > Start B)算法
- 排课提交:
- 时间戳转换与校验
- 冲突检测调用
- 排课数据写入
通过本讲的实现,教务人员可以方便地进行排课操作,系统会自动检测并拦截冲突的排课安排。
下一步,我们将继续完善考勤消课机制,实现扫码签到与课时扣减功能。