企业官网建设流程全解析

简介：软件项目管理课程期末作业的完整参考方案，面向高校软件工程及相关专业学生，以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/resources，Java 目录里放着 AttendanceApplication.java 启动类，还有按 controller、service、mapper 分层的业务代码；resources 目录放配置文件和页面模板。
• mvnw.cmd：Maven 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。完整顺序是：

1. 把压缩包解压到一个英文路径，比如 D:\attendance-system。别放中文目录，别放桌面。内嵌 Tomcat 和部分旧版编码方案对中文路径敏感，这是第一个容易翻车的地方。
2. 打开 IDEA，选 File → Open，选中解压后的目录，等待 IDEA 识别出 pom.xml，然后选 Open as Project。
3. 等右下角进度条把 Maven 依赖拉完。首次导入要下载 spring-boot-starter-web、数据库驱动、模板引擎等一大堆依赖，时间长短取决于网络。依赖拉完，左侧 Project 窗口能正常展开所有目录。
4. 打开 AttendanceApplication.java，找到 main 方法，点绿色三角运行。

这里有一个高频问题：如果 IDEA 没有自动把项目识别为 Maven 工程，左侧不会出现 maven 面板，依赖也不会下载。这时候右键 pom.xml，选择 Add as Maven Project，IDEA 才会把项目正式当成 Maven 工程处理。

2.3 mvnw.cmd 在 IDEA 里的角色

mvnw.cmd 这个文件暴露了一个重要信息：项目用 Maven Wrapper 锁定了构建工具版本。在 IDEA 里，你不需要在命令行手动执行 mvnw.cmd，IDEA 的 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.yml：

server.port=8081

配完重启，访问地址变成 http://localhost:8081。改完不重启，端口不会松动，这点和 Spring Boot 1.x 时代的热加载不一样，现在的版本对配置文件改动不会自动生效。

3. 数据库与初始化数据：账号 123/123 是怎么进到表里的

考勤系统的核心是数据，不是页面。学生签到、老师补录、出勤率统计，最后都落在数据库表里。软件项目管理期末作业的验收重点也在这里：老师会问“考勤记录存在哪张表”“测试账号是怎么进数据库的”，答不上来，前面演示再顺也会扣印象分。

这一章把数据库链路完整拆开：连接配置、初始化脚本、表结构、演示前重置，一条线走到底。

3.1 数据库连接配置：先对齐库名、账号、密码三要素

启动后端之前，数据库必须就绪。绝大多数 Java 课程设计项目默认接 MySQL，连接参数写在 application.properties 里，核心几条：

spring.datasource.url=jdbc:mysql://localhost:3306/attendance?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai spring.datasource.username=root spring.datasource.password=123456

字段含义拆开说：url 里的 attendance 是数据库名，必须和 .sql 文件里建库的名称一致；useUnicode 和 characterEncoding=utf8 是让中文不乱码的经典组合；serverTimezone=Asia/Shanghai 专门解决 MySQL 8 的时区报错。username 默认是 root，password 是你本机 MySQL 的真实密码。

如果没有连接池概念，直接用 Spring Boot 自带的 HikariCP 就行，它是默认连接池，不用额外配置。如果项目里额外配了 Druid，你会看到类似这样一段：

spring.datasource.type=com.alibaba.druid.pool.DruidDataSource spring.datasource.druid.initial-size=5 spring.datasource.druid.max-active=20

initial-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 三张核心表：用户、课程、考勤怎么关联

一个学生考勤管理系统，数据库里最核心的是三类表，分工如下：

考勤表里的 user_id 指向用户表的 id，course_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 里按 Ctrl+Shift+R 全局搜签到按钮的文字，能沿着一条清晰的路找到后端：页面 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 rel="stylesheet" href="../static/bootstrap.min.css"> <link rel="stylesheet" href="../static/style.min.css"> <link rel="stylesheet" href="../static/materialdesignicons.min.css">

href 路径必须和文件实际位置对得上，否则样式全丢。很多答辩现场页面“裸奔”，功能正常但布局全乱，多半就是这里少了一个 ../。后面避坑章节专门写它。

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> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <name>阿里云公共仓库</name> <url>https://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.xml：

<properties> <java.version>1.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 'root'@'localhost' (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 看库名，最后启动后端。顺序对了，翻车率能降一半以上。这套学生考勤管理系统资源本身就是按这条路设计的，希望你能一次跑通，答辩顺利，希望帮到你。

本文还有配套的精品资源，点击获取