每年开学初的排课、教学任务指派,是高校教务办公室里最折腾人的一段日子。课程要按培养计划分配到学期,教师时间要避开冲突,教室容量还要匹配学生人数,任务从下发到教师确认再到教务处审核,每一步都可能要来回沟通。这个Spring Boot本科院校教学任务管理系统,就是专门把这一套线下流程搬到线上、做成可追踪闭环的Web应用,也是我在实际项目中完整跑通过的方案,程序、源码、数据库、调试部署全套的工程套路都能直接复用。
如果你正在准备Java方向的毕业设计、课程设计,或者想了解一个真实教学业务系统的后台该如何拆解,这篇笔记能帮你把模块边界、数据表设计、权限校验、排课冲突检测和文档写作一次理清楚。我当年也是从一张Excel排课表开始,慢慢折腾成能支撑几千条任务记录的正式系统,中间踩过不少坑,这篇文章就是把那些经验和教训原原本本讲出来,不藏私。
1. 系统整体设计与功能拆解:先盘业务再写代码
1.1 核心使用对象和业务流程
做管理系统最忌讳一上来就建表,业务角色还没梳理清楚就写接口,后面一定返工。我这个系统第一件事是先和教务人员聊了整整半天,最后理出四类角色:教务处管理员、院系教学秘书、授课教师、学生,他们的操作场景完全不一样。
| 角色 | 使用场景 | 核心功能 |
|---|---|---|
| 教务处管理员 | 每学期初制定整体教学计划 | 学期管理、课程管理、任务下发、审核确认、数据报表 |
| 院系教学秘书 | 核对本院系的教学任务 | 查看任务清单、补录教师安排、反馈问题 |
| 授课教师 | 查看自己下学期教什么课 | 查看个人教学任务、确认课时、填报授课进度 |
| 学生 | 查询本学期有什么课 | 按班级查看课表 |
底层业务流程也很固定:每个学期开设哪些课程来自专业培养计划,系统会根据课程归属专业自动生成“待指派任务”,管理员或秘书把课程指派给具体教师,再填写上课周次、星期几、起始节次、教室。任务保存之后进入待审核状态,教务处审核通过后正式生效,教师端和学生端就能同步看到相关信息。如果审核不通过,任务需要被打回,附带修改意见,修改后重新提交。这套流程本质上是“任务从生成到确认的审批流”。
这里要注意一个细节,任务下发通常是一次性导入几十甚至上百条,不是一个人在网页上慢慢点,因此系统必须支持Excel导入和批量保存。我第一版设计时没有加批量接口,结果测试阶段被教务员吐槽到不行,说这样录入效率比Excel还低,根本没法用。后来在服务层加了一个批量导入方法,用事务包裹,几百条数据一次性校验保存,才算真正达到替代线下办公的要求。
1.2 技术选型:Spring Boot 2.7为什么是这个项目的正解
技术栈是决定后续开发效率的关键。我选型时没有跟风上Spring Boot 3,而是固定在Spring Boot 2.7版本,配套JDK 1.8,原因是这个组合和高校教务现有环境的兼容性最好,旧的教学系统、老的数据库脚本、实验室服务器的JDK版本都能直接支持。
| 方案 | JDK要求 | Servlet坐标 | 适合场景 |
|---|---|---|---|
| Spring Boot 2.7.x | JDK 8 | javax.servlet | 老项目兼容、教学演示、多数云主机 |
| Spring Boot 3.x | JDK 17 | jakarta.servlet | 新项目、愿意处理新依赖 |
不要小看javax和jakarta的区别,Spring Boot 3.0把包名整个换了,如果项目迁移到3.x,代码里所有javax.servlet.http.HttpServletRequest都要改成jakarta.servlet.http.HttpServletRequest,很多原本刚开发的用户管理、文件上传模块全要跟着动。高校项目通常不会频繁升级线上系统,用了2.7.x之后,三年内的维护成本都要低很多。
持久层框架我选了MyBatis-Plus,不是纯粹为了少写几行SQL。原因是教学任务管理系统天然存在很多条件组合查询,比如按学期、按院系、按教师姓名、按课程类型筛选,普通MyBatis要写一堆动态SQL标签,MyBatis-Plus的LambdaQueryWrapper可以在Java代码里直接拼条件,代码写起来非常直观,后期加筛选条件也只需要链式调用。
前端没有采用前后端完全分离的方案,而是用Thymeleaf模板引擎加Bootstrap框架。原因也很现实:这类教务系统最看重的是数据录入和查询效率,页面交互复杂度不算高,不需要引入完整的Vue或React工程。前端一体化的最大优势是省掉跨域处理和接口联调成本,一个人开发半个月就能把核心页面全部铺完。如果后续有学生选课、在线调课这类高交互模块,再过渡到前后端分离也不迟。
1.3 工程结构:按业务分包而不是按层分包
有经验的开发者看到Spring Boot项目都会先看包结构。我见过不少课程设计项目把Controller、Service、Mapper各分一个包,然后所有业务类都堆在里面,看起来整齐,实际业务越迭代越乱。这系统我改成了按业务域分包,效果好了很多。
bash复制src/main/java/com/campus/task
├── common // 统一返回结果、全局异常、工具类
├── config // 拦截器配置、跨域配置、文件配置
├── controller // 接口层
├── entity // 数据库实体
├── mapper // MyBatis-Plus Mapper接口
├── service // 业务接口及实现
│ ├── auth // 登录鉴权相关业务
│ ├── taskmanage // 教学任务下发相关业务
│ ├── schedule // 排课冲突检测业务
│ └── statistics // 统计报表业务
└── vo // 视图对象,负责给前端组装数据
这样分的好处是,不同业务模块的代码不会互相纠缠。比如“排课冲突检测”这个模块,逻辑足够复杂,如果拆出来,它既依赖教师表,又依赖教室表,还依赖任务表,放在common或一个扁平的service包里会非常臃肿。单独做一个schedule包之后,新增一种冲突判断规则时只改这个包里的类,完全不影响任务管理的主逻辑。
实体类与视图对象的分离是我特别强调的一点。很多课程设计直接在Controller里返回数据库实体,一旦业务需求调整,比如页面上要多显示一个“教师所属院系名称”,最简单的做法是改实体,但这会造成数据库字段和接口字段耦合。我全部通过VO类向前端提供返回数据,实体结构变了,页面接口的输出结构依然稳定,这种习惯越早建立越好。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 数据库设计:教学任务表结构与状态机是关键
2.1 核心数据表的关系梳理
排课系统的数据表之间关系其实很典型,最核心的就是“用户-课程-任务”的关系链。用户表和教师信息表可以用一个逻辑主键关联,也可以把教师字段直接合并进用户表;课程信息表与教学任务表之间是一对多关系,一个课程会在多个学期、多个班级重复开设。还必须有班级表和学期表,否则任务数据的归属边界不清晰。
我当时的建表方案包含八张核心表:系统用户表sys_user、教师信息表teacher_info、班级表class_info、课程表course_info、学期表semester_info、教学任务表teaching_task、审核记录表task_audit、通知消息表notice。其中教学任务表的字段设计,是整个数据库的核心工程。
sql复制CREATE TABLE `teaching_task` (
`task_id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '任务主键',
`semester_id` BIGINT NOT NULL COMMENT '学期ID',
`course_id` BIGINT NOT NULL COMMENT '课程ID',
`teacher_id` BIGINT DEFAULT NULL COMMENT '教师ID',
`class_id` BIGINT NOT NULL COMMENT '班级ID',
`classroom_id` BIGINT DEFAULT NULL COMMENT '教室ID',
`start_week` INT DEFAULT 1 COMMENT '开始周次',
`end_week` INT DEFAULT 16 COMMENT '结束周次',
`week_type` TINYINT DEFAULT 0 COMMENT '0每周,1单周,2双周',
`day_of_week` TINYINT DEFAULT NULL COMMENT '星期几,1~7',
`start_section` INT DEFAULT NULL COMMENT '开始节次',
`end_section` INT DEFAULT NULL COMMENT '结束节次',
`student_count` INT DEFAULT 0 COMMENT '选修学生人数',
`task_status` VARCHAR(10) DEFAULT '0' COMMENT '状态:0待提交1待审核2已通过3已驳回4已归档',
`is_public` TINYINT DEFAULT 0 COMMENT '是否已发布可见',
`create_time` DATETIME DEFAULT NULL,
`update_time` DATETIME DEFAULT NULL,
PRIMARY KEY (`task_id`),
KEY `idx_semester_teacher` (`semester_id`, `teacher_id`),
KEY `idx_semester_class` (`semester_id`, `class_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='教学任务表';
这张表的设计要回答一个问题:一门课在什么时间、什么地点、由谁、上给哪个班。start_week和end_week组合定义上课起止周,week_type处理单双周,day_of_week配合start_section和end_section确定具体时间位置。特别注意student_count要单独存,不能每次临时去关联选课表统计,否则页面刷新一次就要做一次全表聚合,查询效率会非常差。
task_status字段承担了审批流里的状态流转。这里我踩过一个比较大的坑,最初把状态设计成“待审核/已通过/已驳回”三种,但实际使用中发现,如果院系秘书录完数据直接点保存,教务处希望这条任务先在“草稿池”里不进入审核队列;任务审核被打回后教师修改,状态又不应打断流程历史。最终我采用了“0待提交-1待审核-2已通过-3已驳回-4已归档”五段式状态,每个状态的操作权限边界也清楚了。
2.2 审核记录表与任务历史版本
教学任务在学期过程中经常发生“调课、换教室、换教师”等变更,不能直接把原任务记录改掉,否则历史数据全没了。这个场景下,我加了一张task_audit审核记录表,每次状态切换都往里插入一条记录,保存操作人、操作时间、操作动作和备注。这样做既方便追溯,也方便教务处追责。
审核记录表的结构很轻量:audit_id、task_id、operator_id、action_type、comment、create_time。不要试图在这张表里存快照,因为如果存下整条任务的JSON快照,表会越涨越大,字段也不规范。更合理的做法是保留状态变更日志,需要知道某次变更前的数据时,再查对应的操作日志去定位,或者把本次调整涉及的业务字段变化写进comment中,比如“由第2周改为第3周开始”。
另外建议在任务表里加一个version字段,在做并发编辑控制的时候非常有用。多个教务秘书如果同时编辑同一条教学任务,后保存的人往往会覆盖先前保存者的内容。加上版本号后,更新SQL里强制带上WHERE version = #{oldVersion},更新成功后版本号加1,如果更新影响行数为0,就说明数据已经被别人改过,界面直接提示“该任务已被其他管理员修改,请刷新后再操作”。这个功能在答辩环节也是很好的亮点,简单有效还能体现工程意识。
2.3 教室与教师的时间占用索引
数据库设计上还有一个容易被忽略的地方:索引要面向“查询场景”设计,而不是面向“业务直觉”。排课系统使用频率最高的查询就是冲突查询,它的条件是“在某学期、某时间段、某个教师或教室是否已占用”。我在设计联合索引时就特意建了idx_semester_teacher和idx_semester_class两个联合索引。
一个经常发生的坑是:单独在teacher_id字段上建索引,但查询条件同时包含semester_id,MySQL的优化器通常只能用一个索引,整体效率并不理想。只有把semester_id和teacher_id合成联合索引,才能在一次索引扫描中过滤掉大量无关记录。上面SQL里那两个索引,单从字段看并不复杂,实际在大数据量场景下就是几千毫秒跟几百毫秒的差别,值得提前规划。
3. 核心业务模块的代码实现:权限、下发、冲突检测
3.1 登录鉴权与角色权限控制
这类系统的权限控制并不需要引入特别重的Spring Security框架,因为用户数量有限、角色稳定,我用拦截器加Session就实现了完整效果。用户表只需记录用户ID、用户名、密码、真实姓名、角色标识即可,密码用MD5加盐保存。我建议别存明文密码,哪怕只是校内小系统,把密码用DigestUtils.md5DigestAsHex简单哈希一下也不费多少事。
拦截器实现思路是:定义AuthInterceptor,在preHandle方法里判断Session中是否有用户,如果没有就重定向到登录页;如果有用户,再判断当前请求的URL前缀是否匹配角色权限。比如/admin/**开头的必须角色为admin,/teacher/**开头的必须角色为teacher,否则直接跳转到无权限页面。
java复制@Component
public class AuthInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws IOException {
HttpSession session = request.getSession();
SysUser user = (SysUser) session.getAttribute("loginUser");
if (user == null) {
response.sendRedirect("/login");
return false;
}
String uri = request.getRequestURI();
if (uri.startsWith("/admin/") && !"admin".equals(user.getRole())) {
response.sendRedirect("/noPermission");
return false;
}
if (uri.startsWith("/teacher/") && !"teacher".equals(user.getRole())
&& !"admin".equals(user.getRole())) {
response.sendRedirect("/noPermission");
return false;
}
return true;
}
}
编写拦截器时有一个细节容易翻车:静态资源路径,比如CSS、JS、图片,也会经过拦截器。如果没在配置里排除/static/**、/templates/**、/css/**这类路径,用户还没登录时登录页样式会全部丢失。我最初就是没加放行规则,结果打开登录页面是全裸的HTML排版,排查了很久才发现资源被拦截器挡掉了。另外,登录状态建议用Session保存而不用JWT,原因是这类系统的用户都是固定校内人员,不存在跨域、多端的开放需求,维护Session比维护Token更简单,还能配合服务端随时剔除异常账号。
3.2 教学任务批量下发的Service实现
批量下发是教学任务管理的第一道入口。第1版本我只做了单条新增,后来被教务老师批评之后才重新改成批量接口。批量接口接收一个包含多条任务记录的列表,遍历时先做基础校验,包括课程是否存在、教师是否存在、学期是否匹配,然后调用冲突检测逻辑,最后在循环体内逐条保存。整个方法必须加上@Transactional事务注解,保证如果第一百条数据出错,前面九十九条也不会被保存进去,防止数据出现一半成功一半失败的情况。
java复制@Service
public class TeachingTaskServiceImpl implements TeachingTaskService {
@Resource
private TeachingTaskMapper taskMapper;
@Override
@Transactional(rollbackFor = Exception.class)
public boolean batchAssign(List<TeachingTaskDTO> taskList) {
if (CollectionUtils.isEmpty(taskList)) {
throw new BizException("导入任务列表不能为空");
}
for (TeachingTaskDTO dto : taskList) {
TeachingTask task = new TeachingTask();
BeanUtils.copyProperties(dto, task);
task.setTaskStatus("0");
task.setCreateTime(new Date());
// 这里优先调用冲突检测方法,有冲突直接抛异常回滚
checkTaskConflict(task);
taskMapper.insert(task);
}
return true;
}
}
实际开发中批量导入通常会有一个Excel文件当载体,服务端需要先解析Excel中的每一行数据,然后把行数据映射成DTO。解析Excel我最推崇的组件是EasyExcel,它在处理大数据量时内存占用比Apache POI低很多。遇到单元格是“周一3-4节”这种文本时,先拆出星期几和节次再填到DTO对应字段,才能通过后续冲突方法。解析过程必须在事务外层完成还是内层完成,这个先后顺序很多人会搞错,最好是先完整解析并校验格式,再开启事务执行批量保存,否则Excel某个单元格格式错了,整个事务都要回滚,排查起来很费劲。
3.3 排课冲突检测:最容易踩坑的一小段算法
排课冲突检测是系统最有技术含量的部分,也最容易被初级开发者写错。先明确冲突问题的数学模型:系统记录的时间段由“星期几 + 上课节次范围”组成,任意两条任务如果满足“同一个学期、同一个教学实体(教师或教室)、星期相同、节次区间重叠”则判定冲突。
判断两个区间是否重叠,我用的方法是:startSectionA < endSectionB 且 startSectionB < endSectionA。听起来很简单,但很多新手会用等号判断,例如查出教师周一第1节到第2节的记录后发现要新增周一第2节到第3节的任务,因为起始节次不同就判定不冲突,实际教师连上两节课完全没有休息时间,这显然是错误的。区间重叠判断最关键的是小于号而不是等号,写成<就天然包含了边界相邻冲突的情况。
java复制private void checkTaskConflict(TeachingTask task) {
// 检查教师冲突
int teacherConflict = taskMapper.countConflictByTeacher(
task.getSemesterId(),
task.getTeacherId(),
task.getDayOfWeek(),
task.getStartSection(),
task.getEndSection());
if (teacherConflict > 0) {
throw new BizException("教师时间冲突,请更换节次或日期");
}
// 检查教室冲突
int roomConflict = taskMapper.countConflictByClassroom(
task.getSemesterId(),
task.getClassroomId(),
task.getDayOfWeek(),
task.getStartSection(),
task.getEndSection());
if (roomConflict > 0) {
throw new BizException("教室时间冲突,请更换教室或节次");
}
}
对应SQL写出来如果放在MyBatis的XML文件里,需要格外注意小于号必须转义成<,大于号转义成>,否则XML解析直接报错。
xml复制<select id="countConflictByTeacher" resultType="int">
SELECT COUNT(*)
FROM teaching_task
WHERE semester_id = #{semesterId}
AND teacher_id = #{teacherId}
AND task_status IN ('0','1','2')
AND day_of_week = #{dayOfWeek}
<if test="weekType != null and weekType != 0">
AND week_type = #{weekType}
</if>
AND start_section < #{endSection}
AND end_section > #{startSection}
</select>
我实际踩过的坑是忘了在冲突查询里排除已驳回和已归档的任务。前端在修改一条刚被打回的任务时会重新调用冲突检测,结果把那条任务本身也作为待办记录查出来,因为数据库里它在“3已驳回”状态仍占用时间,导致自己和自己冲突,界面一直提示“教师时间冲突,请更换节次”,特别诡异。后来在SQL条件和通用状态过滤上补齐状态名单,问题才消失。这段经历说明:业务代码的每一处状态判断,都要反复确认是不是把不该过滤的状态也过滤掉,或者把该排除的状态漏掉了。
3.4 课时统计报表的SQL与导出
统计报表模块的价值是给教务处一个全局的计算结果。最核心的工作量统计规则是:某个教师的总课时数按明细任务的学时汇总,每一条教学任务的总学时为“每周节次数 × 实际上课周数”,然后再乘上班级数量或课程系数。如果系统没有维护详细参数,可以做成可配置的系数表,页面上让管理员自己填。
汇总SQL通常需要多表关联,教学任务表关联教师表、课程表,按教师ID和学期ID分组统计。这种分组统计用MyBatis-Plus的QueryWrapper反而显得别扭,直接写原生Mapper方法返回WorkloadDTO更高效。统计结果导出Excel时,我使用EasyExcel的注解方式定义导出字段,速度可以接受,在写文件的同时还能保留一个列表页预览,管理员可以前端先看总数再决定是否下载,交互上很友好。
另外数据库中的student_count、week_type等字段在统计时要考虑单双周的情况,每周都上的课和单周上的课工作总量不同。为了不让报表计算复杂化,我在下发任务时就把单双周信息单独标记,统计SQL里通过CASE WHEN week_type = 1 THEN 1 ELSE 0 END这类判断把周数映射成实际工作量,整个报表逻辑才更准确。
4. 从零搭建开发环境到部署上线的完整过程
4.1 开发环境初始化那些事
开发环境听起来简单,实际上我在帮几个同学搭建项目时发现80%的问题都出在这一步。首先是JDK版本不匹配,Spring Boot 2.7要求JDK8以上,但如果本机装了最新的JDK21,部分老版本Maven插件可能不兼容。开发时最好统一用JDK8或JDK11,我建议就用JDK 1.8.0_202这个经典版本,稳定且兼容性最好。
安装MySQL时最容易忽略时区问题。连接串必须指定时区参数,推荐写法是jdbc:mysql://localhost:3306/course_task_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true。如果不加serverTimezone,高版本MySQL驱动默认使用UTC时区,和本地时间差了8小时,系统里所有自动填充的createTime都会不对,页面上看到的数据总是晚8个小时,像灵异事件一样。
数据库初始化建议直接用SQL脚本导入。在Navicat或命令行的source执行建库脚本前,先确认字符集是utf8mb4,不要用默认的utf8,否则课程名称里有生僻字或学生姓名是繁体字时会出现乱码甚至插入异常。整个工程配置好之后,就是修改application.yml中的数据源账号密码和主类启动验证,这一步跑通了,后续接口开发就很顺畅了。
4.2 打包部署:jar包放上服务器的完整流程
在本地开发完成并通过功能测试后,需要将项目打包部署到服务器,这一步也是整个交付环节的重要部分。使用Maven打包时直接执行mvn clean package -DskipTests即可,得到target/course-task-manage-0.0.1.jar文件,通过scp命令或宝塔面板上传到服务器指定目录,然后使用nohup java -jar命令启动。
如果服务器内存只有2G,JVM初始内存和最大内存建议分别设为512M,避免默认启动占用过大。部署时还需要注意服务器防火墙端口开放,以及MySQL远程连接权限。很多时候本地测试没问题,一部署就出现连接不上数据库的报错,要分三步排查:数据库服务是否启动、账号是否允许远程访问、服务器安全组或防火墙是否放行了3306端口。这个问题不是代码问题,但一旦不解决整个系统就废了,所以发布环境配置必须提前确认好。
4.3 高频问题排查经验记录
开发过程中最耗费时间的问题类型往往是环境引起的,而不是真正的业务逻辑错误。我整理了这份排查表,后面几次复用这套项目时几乎只需要查这张表就够了。
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| 启动时提示Failed to configure a DataSource | 没有配置数据源或账号密码错误 | 检查application-dev.yml中的数据源信息 |
| 浏览器访问页面样式全丢 | 静态资源被拦截器拦住 | 在拦截器配置中放行/static/、/css/等路径 |
| SQL查询带小于号时报错 | MyBatis XML中小于号被当作标签开始 | 将<写为<,>写为> |
| 连接MySQL报Public Key Retrieval is not allowed | 高版本MySQL驱动默认行为变化 | 连接串加allowPublicKeyRetrieval=true |
| 服务器上中文乱码 | 文件编码或数据库字符集不是utf8 | 确保数据库和连接串都使用utf8mb4 |
| 任务保存后没出现在教师端 | 任务状态只停留在待提交 | 发布时需把is_public置为1并提交审核 |
我发现很多开发同学在遇到问题时不看日志,直接用猜的方式改代码,这是最大的低效来源。Spring Boot的默认日志已经能打印SQL执行语句、异常堆栈,只要启动时仔细看控制台的关键报错信息,90%的问题都能正确定位。在排查MySQL连接问题时,直接在命令行里用同样的账号密码执行连接命令,能快速分辨是网络问题、认证问题还是驱动问题,不用反复改代码重启应用,效率要高很多。
5. 测试验收与万字开发文档写作的落地经验
5.1 系统功能测试清单怎么设计
很多学生项目验收时被问倒,原因不是功能没实现,而是缺乏清晰的测试过程和验收清单。这份系统的测试应该覆盖登录鉴权、任务新增、批量导入、冲突检测、审核流、报表查询、权限拦截七个主要模块,每项功能至少设计两个用例,一个是正常流程、一个是非法输入或边界条件。比如批量导入Excel时,正常用例是导入50条合法任务后列表增加50条记录;异常用例是Excel第35行缺少教师信息,系统应提示具体行号和错误原因并整体回滚,而不是静默跳过或只保存一部分数据。
测试过程中还要专门花时间验证角色权限边界:用教师账号访问管理员专属接口时,应被拦截到无权限页面而不能返回数据;教务秘书账号不能审核自己提交的教学任务。这类业务权限规则容易遗漏,如果不在测试清单里明确标出来,验收时很容易被问懵。
5.2 开发文档写作:把项目写成系统方案的艺术
教学任务管理系统这种项目,论文或设计文档一般要求上万字。很多同学拿到要求就慌了,其实只要掌握了结构组织方式,一万字并不难写。最忌讳的写法是把代码Ctrl+C粘贴到文档里凑字数,那不是设计文档,老师在答辩时一眼就看穿,还会追着问代码细节。
我建议按需求分析、总体设计、数据库设计、系统实现、系统测试五大部分来组织内容。需求分析部分重点描述教务线下流程中的痛点,比如Excel排课极易出现教师教室冲突、任务状态不透明、教师无法在线确认等,再通过用例图或表格列出功能需求和非功能需求。总体设计部分画系统角色和核心模块关系,不要直接贴源码,而是用模块划分加功能说明的方式讲清楚。
数据库设计部分是字数很容易写长的段落,也是老师重点翻阅的部分。我的写作套路是对每一张核心表都做详细解释,写出字段名、类型、是否为空、业务含义,尤其对于task_status状态机这样的设计,要额外增加一段文字,说明为什么这样设计、每个状态之间如何迁移。系统实现部分千万不要平铺直叙地写代码,而是按核心模块来写:每个模块先概述它承担什么任务,再对关键接口方法和业务判断做局部代码展示,配合运行截图,这样的内容既有深度又不会让人觉得在凑篇幅。
5.3 答辩前容易被追问的几个点
系统做完之后如果把精力都放在叠功能上,不去沉淀模块间的设计思路,答辩环节会很吃亏。我把验收时老师最可能问的几个问题整理了出来:如何设计数据库避免排课冲突导致脏数据?任务下发与审核之间的事务边界是什么?课表有误时如何手动调课且不丢失历史记录?这些问题的答案都可以在前文的设计中找到,但要用自己的话再提前演练一遍。
其中自认为比较稳妥的经验是提前准备好几张典型页面的截图,包括管理员任务管理页、教师确认任务页、课表查看页,每张截图旁边写上一段“该页面主要完成XX功能,涉及XX表,前端通过XX方式交互”。不需要讲得天花乱坠,能把自己的代码逻辑和数据结构讲清楚,就远远好过背一堆不知道什么意思的原理。系统存在的意义是解决业务问题,每个人都能理解你在讲什么,比用术语包装更重要。
最后再分享一个我个人的实操体会。教学任务管理系统这类项目,真正难的地方不是Spring Boot注解或者MyBatis的写法,而是把“教务排课”这个复杂度极高的线下业务转成清晰的数据结构与状态机。排课算法层面哪怕只做到冲突检测和不重复分配,就已经能满足很多普通高校的实际诉求了。如果让我重新做一次,我会在开发第一周就把数据库中每一张表的状态字段和业务日志流程彻底确认好,而不是边写代码边想到哪改到哪,这样项目返回工成本能低一半。这套系统的价值就体现在每一条教学任务都能可追踪、可审核、可回溯,把教务老师从烦琐的表格中解放出来,而这种数据流转的干净程度,也正是作品答辩时最值得被看见的局部。
