简介软件项目管理课程期末作业的完整参考方案面向高校软件工程及相关专业学生以Java学生考勤管理系统为实践载体展示需求分析、进度规划、代码实现与文档编写在项目中的综合落地。资源共319个文件涵盖52个Java源码、170个JS脚本、14个HTML页面、13个CSS样式以及SQL数据库脚本和多个docx说明文档同时包含项目配置文件与运行依赖压缩包整体约36.23MB结构与课堂作业要求高度对应。已有969人学习下载。包内附测试账号学生123/123老师124/123使用说明清晰提供数据库脚本、前后端分离的Web工程目录及完整的项目文档学生拿到后可用IDEA直接打开运行对照源码理解模块划分与业务逻辑也可借鉴文档结构完成自己的课程设计报告适合作为期末答辩前的参考范本。1. 软件项目管理期末作业救场把考勤系统源码跑通要比写需求分析更先一步期末周的软件项目管理作业最耗时间的往往不是文档而是系统实现需求分析写得再漂亮代码跑不起来照样是扣分项。这份学生考勤管理系统的 Java 源码包就是把期末最怕的这一步直接踩平了——Spring Boot 后端、Bootstrap 前端、数据库初始化脚本和说明文档都在一个压缩包里导入 IDEA 把依赖拉完运行 AttendanceApplication.java浏览器访问 localhost:8080 就能看到登录页。学生角色账号 123/123老师角色账号 124/123演示链路是一套现成闭环。适用对象很明确软件项目管理期末要交可运行系统、又不想从零敲业务代码的同学以及想搞明白考勤系统里数据库、角色权限和后端接口是怎么串联起来的入门者。2. IDEA 导入与启动流程从 zip 压缩包到 localhost:8080 的五个必经点先说结论这个项目不需要额外安装 Maven。压缩包里带了 mvnw.cmd也就是 Maven Wrapper 的 Windows 脚本。有它和没它导入 IDEA 之后的体验完全不同没它你得手工配 Maven 环境变量配错后每次拉依赖都在报错有它IDEA 打开 pom.xml 之后会自动按项目指定的 Maven 版本去下载依赖少一个变量。但“不用装 Maven”不等于“不用管依赖”。依赖下载在国内网络环境下是最大变量我见过太多人卡在这一步半小时起步。这一章先把从压缩包到登录页的五个必经点理顺照着走多数机器十分钟内能见到登录页。2.1 压缩包里的文件排布每种文件各管什么事打开压缩包先别急着解压确认里面有几类东西每一类在后面的环节里角色完全不同源码目录核心部分。src 下分 main/java 和 main/resourcesJava 目录里放着 AttendanceApplication.java 启动类还有按 controller、service、mapper 分层的业务代码resources 目录放配置文件和页面模板。mvnw.cmdMaven Wrapper 的 Windows 执行脚本作用是指定一个固定的 Maven 版本帮你拉依赖避免“我机器上 Maven 版本和项目不兼容”这类问题。前端静态资源bootstrap.min.css、style.min.css、materialdesignicons.min.css、animate.css、bootstrap-datepicker3.css、bootstrap-datepicker3.min.css、jquery-confirm.min.css、ion.rangeSlider.min.css、bootstrap-datetimepicker.css。它们应该被放在 src/main/resources/static 下Spring Boot 会把它自动映射成可直接访问的静态资源。数据库脚本一般是一个 .sql 文件里面既有建表语句也有初始化数据测试账号 123/123 就是从这个脚本进数据库的。说明文档操作步骤和测试账号都写在这里。期末作业里它还能直接当“系统使用手册”章节的素材。压缩包里同时出现 bootstrap-datepicker3 和 bootstrap-datetimepicker 两套日期组件说明项目里既有纯日期选择也有日期时间选择。前者通常用在考勤记录筛选条件里后者多用于补录签到时间或后端管理页里。一个项目混用多个前端组件这是课程设计里的常态不用觉得奇怪。2.2 IDEA 打开项目的标准动作打开这个项目不要用 New Project要用 Open。完整顺序是把压缩包解压到一个英文路径比如 D:\attendance-system。别放中文目录别放桌面。内嵌 Tomcat 和部分旧版编码方案对中文路径敏感这是第一个容易翻车的地方。打开 IDEA选 File → Open选中解压后的目录等待 IDEA 识别出 pom.xml然后选 Open as Project。等右下角进度条把 Maven 依赖拉完。首次导入要下载 spring-boot-starter-web、数据库驱动、模板引擎等一大堆依赖时间长短取决于网络。依赖拉完左侧 Project 窗口能正常展开所有目录。打开 AttendanceApplication.java找到 main 方法点绿色三角运行。这里有一个高频问题如果 IDEA 没有自动把项目识别为 Maven 工程左侧不会出现 maven 面板依赖也不会下载。这时候右键 pom.xml选择 Add as Maven ProjectIDEA 才会把项目正式当成 Maven 工程处理。2.3 mvnw.cmd 在 IDEA 里的角色mvnw.cmd 这个文件暴露了一个重要信息项目用 Maven Wrapper 锁定了构建工具版本。在 IDEA 里你不需要在命令行手动执行 mvnw.cmdIDEA 的 Maven 面板会自动读取 wrapper 配置并调用对应版本。如果你偏好在命令行操作在项目根目录执行mvnw.cmd spring-boot:run这条命令会先下载项目指定版本的 Maven再用它启动 Spring Boot 应用。等价于你在 IDEA 里直接运行 AttendanceApplication.java。注意 mvnw.cmd 是 Windows 版脚本macOS/Linux 对应的文件名是 mvnw没有后缀。有一点要提醒Maven Wrapper 第一次运行同样要联网下载 Maven 本身如果网络不通它也会卡住。IDEA 里运行和命令行运行二选一即可不用两个都用否则依赖目录 .m2 会被多线程写可能出现“明明刚才还好的现在突然报包损坏”的玄学问题。2.4 运行入口 AttendanceApplication 与正常启动日志Spring Boot 项目里标注 SpringBootApplication 的类就是启动入口。AttendanceApplication 这个名字是约定俗成的项目名 Application。这类启动类代码通常长这样SpringBootApplication MapperScan(com.example.attendance.mapper) public class AttendanceApplication { public static void main(String[] args) { SpringApplication.run(AttendanceApplication.class, args); } }SpringBootApplication 把组件扫描、自动配置、配置绑定合并成一个注解MapperScan 告诉 MyBatis 去哪里扫描 Mapper 接口。如果项目里搜不到 MapperScan说明持久层可能用的不是 MyBatis而是 Spring Data JPA。课程设计里这两条路线都很常见判断依据就是启动类上注解长什么样。运行成功以后控制台会出现一行关键日志Tomcat started on port(s): 8080。看到这行再去浏览器访问 http://localhost:8080。如果日志还没出来就急着开浏览器会看到连接被拒绝这不是代码问题是启动没完成。2.5 测试地址与局域网演示摘要里写的“测试地址路径地址:8080”在本地就是 localhost:8080。如果你想让老师直接用手机访问需要把地址换成电脑的局域网 IP比如 192.168.1.101:8080前提是 Windows 防火墙放行了 8080 端口。期末答辩时让老师用手机连着同一个 WiFi 访问比一群人围着一台电脑看效果好得多。如果 8080 端口被占优先改配置而不是杀进程。在 src/main/resources 下找到 application.properties 或 application.ymlserver.port8081配完重启访问地址变成 http://localhost:8081。改完不重启端口不会松动这点和 Spring Boot 1.x 时代的热加载不一样现在的版本对配置文件改动不会自动生效。3. 数据库与初始化数据账号 123/123 是怎么进到表里的考勤系统的核心是数据不是页面。学生签到、老师补录、出勤率统计最后都落在数据库表里。软件项目管理期末作业的验收重点也在这里老师会问“考勤记录存在哪张表”“测试账号是怎么进数据库的”答不上来前面演示再顺也会扣印象分。这一章把数据库链路完整拆开连接配置、初始化脚本、表结构、演示前重置一条线走到底。3.1 数据库连接配置先对齐库名、账号、密码三要素启动后端之前数据库必须就绪。绝大多数 Java 课程设计项目默认接 MySQL连接参数写在 application.properties 里核心几条spring.datasource.urljdbc:mysql://localhost:3306/attendance?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai spring.datasource.usernameroot spring.datasource.password123456字段含义拆开说url 里的 attendance 是数据库名必须和 .sql 文件里建库的名称一致useUnicode 和 characterEncodingutf8 是让中文不乱码的经典组合serverTimezoneAsia/Shanghai 专门解决 MySQL 8 的时区报错。username 默认是 rootpassword 是你本机 MySQL 的真实密码。如果没有连接池概念直接用 Spring Boot 自带的 HikariCP 就行它是默认连接池不用额外配置。如果项目里额外配了 Druid你会看到类似这样一段spring.datasource.typecom.alibaba.druid.pool.DruidDataSource spring.datasource.druid.initial-size5 spring.datasource.druid.max-active20initial-size 是启动时初始连接数max-active 是最大活动连接数。课程设计里配 Druid 通常是为了它的监控页面期末文档里可以截图写“系统性能优化”。演示场景下这两个参数不用细调保持默认足够。3.2 初始化 SQL建表与测试账号一次灌进去压缩包里的 .sql 文件就是整套数据库脚本。用 Navicat 或 IDEA 数据库工具连上 MySQL先手动新建一个数据库库名和连接串保持一致然后执行整个脚本。执行成功后用户表里就躺着 123/123 和 124/123 两个账号。账号 123 是学生账号 124 是老师密码都是 123。这种账号密码同数字的设计是课程设计的常规操作为了让答辩演示不卡在输入环节。看脚本时注意密码字段如果 INSERT 语句里 password 直接写 123就是明文存储如果是一串 32 位十六进制字符就是 MD5 加密后存进去的。判断脚本结构有个简单办法按顺序看三类语句。第一类 CREATE DATABASE 或 USE确定库名第二类 CREATE TABLE确定表名第三类 INSERT INTO确定初始数据。很多翻车现场是上来就双击执行整个 SQL结果文件开头写的是别人的库名数据灌错地方登录怎么都登不上。执行 SQL 前有一个习惯值得养成先复制一份 .sql 留底。演示前要重置数据直接重新执行原始脚本比手写 DELETE 语句安全得多。3.3 三张核心表用户、课程、考勤怎么关联一个学生考勤管理系统数据库里最核心的是三类表分工如下表常见命名关键字段职责用户表 sys_user / t_userid、account、password、role、name、class_id学生和老师账号都在这role 区分身份课程表 t_course / t_classid、name、teacher_id课程信息teacher_id 关联授课老师考勤表 t_attendanceid、user_id、course_id、date、status一次签到就是一行记录考勤表里的 user_id 指向用户表的 idcourse_id 指向课程表的 id。这是一个经典的一对多关系一个学生可以有多条考勤记录一门课可以有多个学生的打卡记录。status 字段的取值一般是状态码比如 0 正常、1 迟到、2 请假不同的项目定义不同具体含义要看 SQL 注释或说明文档。答辩时如果被问“出勤率怎么算”标准答法是统计某门课程下状态为正常的记录数除以该课程应到总人数。能把这个公式解释清楚数据库设计这一关基本稳了。3.4 演示前重置数据为什么重跑一遍脚本最稳顺序一定要固定先建库 → 执行 SQL → 启动后端 → 打开浏览器。有些同学先启动后端看到控制台不报错就以为数据库没问题等登录页出来输入 123/123 却提示账号不存在才回头排查数据库。如果演示前数据被点乱了最稳的恢复方式不是写 UPDATE 改数据而是重新执行原始 SQL 脚本。手动改数据容易漏签到表里残留了多条记录界面统计数字不对老师一眼就能看出是数据被改过。启动日志里如果出现 Communications link failure 或 Access denied for user优先检查三件事MySQL 服务有没有启动、库名是否和连接串一致、密码是否写对。百分之九十的数据库问题出在这三处而不是代码坏了。4. 双角色业务链路学生、老师从登录到考勤的全流程登录入口是理解系统最顺的起点你一眼就能看到“账号密码角色”三个要素。学生 123、老师 124角色不同登录后的菜单和可用操作完全不同。这一章把两条角色链路分别拆开再看后端如何把一次点击变成一条数据库记录。4.1 登录与角色分发同一套登录接口怎么区分身份登录接口接收账号和密码校验通过后返回用户信息其中 role 字段决定你是什么角色。前端拿到 role 之后渲染不同的菜单。这个机制通常写成类似下面的结构public LoginResult login(String account, String password) { User user userMapper.findByAccountAndPassword(account, password); if (user null) { return LoginResult.error(账号或密码错误); } if (student.equals(user.getRole())) { return LoginResult.success(user, STUDENT_MENU); } else if (teacher.equals(user.getRole())) { return LoginResult.success(user, TEACHER_MENU); } return LoginResult.error(未知角色); }这里 findByAccountAndPassword 是 Mapper 层最常见的查询方法按账号和密码去用户表里查一行。前端拿到返回的菜单数组后动态渲染导航栏。这就是为什么学生和老师登录后界面不一样后端只做了一件事查用户看角色给对应菜单。4.2 学生链路看课、签到、查记录学生账号 123 登录后典型操作链是首页看到我的课程列表 → 点击某门课 → 发起签到 → 在考勤记录页看到自己的出勤状态和日期。后端对应的接口是课程列表接口根据当前登录用户的 id 查出他选的课签到接口往考勤表插一条记录记录查询接口按 user_id 反查当前学生全部考勤记录。三条接口串起来就是一个完整的学生闭环。学生视角和老师视角的核心差异就一个字看。学生只能看到自己老师能看到班级粒度。落到代码上就是查询条件不同——学生端固定带 user_id 当前登录人老师端按 course_id 查不强制带 user_id。这个差异是答辩时最容易讲清楚的点。4.3 老师链路看全班、补录、统计老师账号 124 登录后进入教室端界面能看见自己教的所有课程。点进一门课能看到选这门课的所有学生和他们的考勤状态。如果学生忘打卡老师还能手动补录一条记录。统计功能是期末答辩的高频提问点。最简单的统计口径是出勤率 某课程下正常签到人数 ÷ 应到人数。按这个口径统计接口的 SQL 大致是SELECT COUNT(DISTINCT CASE WHEN status 0 THEN user_id END) AS normal_count, COUNT(DISTINCT user_id) AS total_count FROM t_attendance WHERE course_id ?CASE WHEN 把正常签到的人标记出来DISTINCT 防止同一学生重复打卡被多次计数total_count 是这门课下所有出现过考勤记录的学生数。两道计数一除就是脱敏后的出勤率。4.4 从页面按钮到数据库记录的阅读路径在 IDEA 里按 CtrlShiftR 全局搜签到按钮的文字能沿着一条清晰的路找到后端页面 HTML → JavaScript Ajax 请求 → Controller → Service → Mapper → 数据库。以签到接口为例后端结构通常是RestController RequestMapping(/attendance) public class AttendanceController { Resource private AttendanceService attendanceService; PostMapping(/sign) public Result sign(RequestBody SignParam param) { Attendance record new Attendance(); record.setUserId(param.getUserId()); record.setCourseId(param.getCourseId()); record.setStatus(param.getStatus()); record.setCreateTime(new Date()); attendanceService.addRecord(record); return Result.success(签到成功); } }PostMapping(/sign) 表示接收 POST 请求完整路径是 /attendance/sign。RequestBody 表示前端传的是 JSON字段映射到 SignParam 对象。改这个接口时最值得加的逻辑是重复签到校验课程设计版里很多没有这段但你加上去答辩演示时会很出彩public Result addRecord(Attendance record) { int count attendanceMapper.countByUserAndCourseAndDate( record.getUserId(), record.getCourseId(), record.getCreateTime()); if (count 0) { return Result.error(今天已签到不能重复操作); } attendanceMapper.insert(record); return Result.success(签到成功); }countByUserAndCourseAndDate 是三个条件同时匹配才算重复同一用户、同一课程、同一日期。演示时老师如果手快点两次签到界面直接提示不能重复效果比单纯报成功真实得多。这个改动工作量小属于高性价比的答辩亮点。4.5 前端静态资源与页面组件的对应关系前面那串 CSS 文件不是摆设。bootstrap.min.css 负责栅格和按钮基础样式style.min.css 是项目自定义全局样式materialdesignicons.min.css 提供图标字体bootstrap-datepicker3.css 和 bootstrap-datetimepicker.css 渲染日期、日期时间控件jquery-confirm.min.css 是确认弹窗的样式ion.rangeSlider.min.css 是滑块样式常用于筛选出勤率区间。页面模板里引用这些资源的方式link relstylesheet href../static/bootstrap.min.css link relstylesheet href../static/style.min.css link relstylesheet href../static/materialdesignicons.min.csshref 路径必须和文件实际位置对得上否则样式全丢。很多答辩现场页面“裸奔”功能正常但布局全乱多半就是这里少了一个 ../。后面避坑章节专门写它。5. 避坑排查端口占用、依赖下载、JDK 版本、数据库连接、样式丢失五连问这一章是实践下来的高频问题每条按“现象→原因→解决”写遇到问题时直接对号入座。这些坑我基本都在课程设计环境里见过属于真正的血泪经验。5.1 端口 8080 被占用启动日志直接报错现象控制台日志最后几行出现 Port 8080 was already in use没有出现 Tomcat started on port(s): 8080浏览器访问 localhost:8080 直接打不开。原因本机已经有其他程序占用了 8080。常见的是微信开发者工具、另一个后端项目或者之前测试时没关掉的旧实例。解决Windows 命令行执行netstat -ano | findstr :8080最后一列是进程 PID然后强制结束taskkill /pid 进程号 /f不想杀进程就改端口按第二章的方式把 server.port 改成 8081重启项目。改端口比杀进程稳妥因为占用 8080 的可能是你不想误伤的服务。5.2 Maven 依赖下载卡住pom 文件一片爆红现象IDEA 右下角一直显示下载进度但这个“一直”持续几十分钟或者 pom.xml 里 spring-boot-starter-web 这种坐标一直标红代码里 import 的类全都找不到。原因Maven 中央仓库在国外访问速度不稳定甚至被断开。课程设计季集中下载情况更明显。解决换国内镜像源。在用户目录 .m2 下新建 settings.xml写入阿里云镜像mirrors mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors然后在 IDEA 的 Settings → Maven 里把 User settings file 指向这个文件File → Reload All Maven Projects 重新加载。这套操作是依赖问题最快见效的一招。5.3 JDK 版本不一致编译期、运行期两处报错现象编译报错 java: diamond operator is not supported in -source 1.6或者运行时 UnsupportedClassVersionError。报错方向随 JDK 版本高低各不相同。原因项目要求的 JDK 版本和 IDEA 当前 Project SDK 不一致。IDEA 默认用的 JDK 可能比项目老或者你本地只装了新版 JDK项目却是按旧版标准写的。解决File → Project Structure → Project SDK改成你本机实际安装的版本。同时看 pom.xmlproperties java.version1.8/java.version /properties把 java.version 和 Project SDK 对齐。判断项目到底需要哪个版本有两个线索pom.xml 的 java.version 标签以及代码里有没有 var、List.of() 这种新语法。有这些写法至少 JDK 10 以上没有就 JDK 8 最稳。课程设计项目大部分按 JDK 8 配就能跑。5.4 数据库拒绝访问或通信失败现象启动时日志出现 Access denied for user rootlocalhost (using password: YES)或者 Communications link failure。页面勉强能开但登录一提交就 500 或白屏。原因数据库密码和配置文件不一致。注意这里说的密码是 MySQL 的数据库账号密码不是业务账号 123/123。配置文件里默认写的可能是 root/123456但你 MySQL 实际密码不是这个。解决打开 resources 下的配置文件把 spring.datasource.password 改成你 MySQL 的真实密码username 也确认一致改完重启。如果密码确认无误再检查 MySQL 服务是否启动Windows 服务管理里找到 MySQL 服务手动启动。还有一种小概率情况是连接串里的库名 attendance 还没建回到第三章执行初始化脚本。5.5 登录页能打开但 CSS 样式全丢现象页面能显示文字和输入框但布局错乱按钮没有样式按 F12 打开控制台网络面板里一堆 404全是 bootstrap.min.css、style.min.css 之类的请求。原因页面模板里引用静态资源的路径和实际文件层级不一致。常见的两种情况文件在 static/css/ 目录页面引用却写成 /css/style.min.css或者文件在 static 根目录页面写成 /css/xxx.css。Spring Boot 默认静态资源映射是 classpath:/static/路径对不上就 404。解决直接看页面模板的引用路径再对比 resources 下的真实目录。浏览器地址栏输入 http://localhost:8080/bootstrap.min.css能出文件内容就说明路径对404 就是层级不对。改完模板刷新页面不需要重启后端。6. 答辩前自测三步验证演示链路再做两处低成本定制课程设计答辩最怕的不是功能缺失而是演示到一半页面崩了。基于这套考勤系统我习惯在答辩前一天强制走一遍三步验证前后不到二十分钟却能避开大多数意外状况。第一步验证数据库是最新状态。重新执行一遍初始化 SQL或者用 Navicat 打开用户表确认 123 和 124 两条记录都在。很多项目改着改着数据被删了演示时登录失败都是因为这些记录不在。执行前先把现有数据备份一份万一演示数据是你精心准备的重跑脚本反而会覆盖掉。第二步验证后端启动到结尾。运行 AttendanceApplication.java一直盯着控制台日志确认看到 Tomcat started on port(s): 8080再访问 http://localhost:8080。这一步顺手确认端口没冲突不让答辩现场临时处理“上次好好的现在怎么访问不了”。第三步把两个角色链路各走一遍。用 123/123 登录学生端进课程列表点签到确认生成了一条新记录退出换 124/123 登录老师端进考勤记录页确认能看见学生刚签到的那条数据。两条链路跑通核心演示就稳了。想给演示加亮点还有两处低成本改动给签到接口加重复判断就是第四章那段代码或者把系统标题从默认的考勤管理改成你班级的项目名页面 logo 和你答辩 PPT 统一。改这几处就行不要贪多改乱了答辩反而扣分。从那以后我每次拿到课程设计源码包都强制走一遍固定顺序先解压到英文目录再打开 SQL 看库名最后启动后端。顺序对了翻车率能降一半以上。这套学生考勤管理系统资源本身就是按这条路设计的希望你能一次跑通答辩顺利希望帮到你。本文还有配套的精品资源点击获取