SpringBoot+Vue高校勤工俭学管理系统（含岗位审核、工时管控、合同生成）

简介：高校学生勤工俭学管理系统是一套面向计算机、数学、电子信息等专业本科生的完整Web应用项目，适用于课程设计、期末大作业及毕业设计参考，聚焦校园场景下的岗位发布、学生申请、用工审核与薪酬管理等核心业务流程。资源包共619个文件，以298个Java后端逻辑文件为主体，辅以85个Vue前端组件、66个JS交互脚本、26个XML配置及3个SQL数据库脚本，涵盖若依（RuoYi）框架典型分层结构；另含bat启动脚本、.env环境配置、劳动协议与使用手册等工程化支撑材料，整体压缩包仅3.62MB，轻量易部署。目前已有235人学习下载，适合具备Java基础、熟悉Spring Boot与Vue开发的学生快速上手、理解前后端协同机制，并通过源码反推系统架构设计与业务建模思路。

1. 高校学生勤工俭学管理系统：不是Demo，是能跑通、能改、能交毕设的完整SpringBoot+Vue工程

你是不是也经历过——毕设开题时导师说“做个学生管理系统”，结果搜了一圈全是“Java学生信息管理系统（含登录注册）”这种十年前的JSP老古董？界面丑、数据库裸连、没权限控制、连个合同模板都得自己手敲？这份「高校学生勤工俭学管理系统源码」真不是又一个PPT级Demo。它基于若依（RuoYi）V4.7.0前后端分离架构，后端用SpringBoot 2.6.13 + MyBatis-Plus + Shiro（注意：不是Spring Security），前端是Vue2.6 + Element UI，真实部署过校内测试环境，包含完整的岗位发布、学生申请、用工单位审核、工时登记、工资核算、电子劳动合同生成（LaborContract.docx可直接套用）、导出Excel报表等闭环流程。它解决的不是“怎么显示学生名字”，而是“如何让教务老师不点错按钮就发错工资”“怎么防止学生重复申请同一岗位”“合同签字前怎么自动校验身份证号格式和工时逻辑”。适合计算机、软工、信管专业大三下到大四上同学直接拉代码、改配置、配数据库、跑起来——不是看，是真能交稿、能答辩、能现场演示的毕业设计级工程。

2. 源码结构与核心模块拆解：从.bat脚本到业务表设计，看清它到底“重”在哪

这份资源最值得细看的，不是某个算法，而是它把高校行政场景里的“隐形规则”转化成了可执行逻辑。比如“学生每月勤工俭学总工时不得超过40小时”不是写在文档里的一句话，而是嵌在LaborApplicationServiceImpl.java的checkHourLimit()方法里；再比如“用工单位负责人只能审核本部门发布的岗位”，这个权限控制不是靠前端隐藏按钮，而是Shiro的@RequiresPermissions("labor:position:audit")注解配合sys_role_menu表里的菜单权限绑定。下面带你一层层剥开这个工程的骨架。

2.1 从.bat脚本反推开发与部署流程：为什么有5个bat文件？

项目根目录下这5个.bat文件不是摆设，它们是若依标准开发流的命令封装，直接暴露了本地开发习惯：

# run-tomcat.bat —— 启动内嵌Tomcat（SpringBoot默认） # run-web.bat —— 启动前端Vue开发服务器（npm run serve） # package.bat —— 打包后端jar（mvn clean package -Dmaven.test.skip=true） # build.bat —— 打包前端dist（npm run build:prod） # clean.bat —— 清理target和node_modules（防缓存污染）

提示：run-web.bat本质是执行cd front && npm install && npm run serve，但注意它依赖node_modules已存在。首次运行必须先手动进front/目录执行npm install，否则会报Cannot find module 'vue'——这是新手最容易卡住的第一步。

2.2 后端核心包结构：重点盯紧labor模块与权限配置

若依框架本身有system（系统管理）、monitor（监控）等基础模块，而本项目真正的业务重心在labor包下：

com.ruoyi.labor/ ├── controller/ # 岗位、申请、工时、合同四大控制器 ├── service/ # LaborPositionService（岗位服务）含状态机：草稿→发布→关闭 ├── service/impl/ # LaborApplicationServiceImpl：申请逻辑最复杂，含多级审核链（学生→辅导员→用工单位→教务处） ├── domain/ # LaborPosition（岗位）、LaborApplication（申请）、LaborHourRecord（工时记录） └── mapper/ # XML映射文件，重点看LaborApplicationMapper.xml里的<if test="status == 2">审核通过</if>条件

权限控制不是写死在代码里，而是通过sys_menu表实现：

• 菜单IDlabor-position对应“岗位管理”，权限标识labor:position:list
• 菜单IDlabor-application对应“申请管理”，权限标识labor:application:audit
• 实际角色（如“用工单位负责人”）在sys_role_menu表中只关联labor-position和labor-application，不关联labor-contract（合同仅教务处可见）

2.3 前端路由与权限守卫：Element UI如何拦截无权访问？

前端src/router/index.js定义了动态路由：

{ path: '/labor/position', component: () => import('@/views/labor/position/index'), name: 'LaborPosition', meta: { title: '岗位管理', icon: 'el-icon-s-help', noCache: true, roles: ['admin', 'unit-leader'] } }, { path: '/labor/application', component: () => import('@/views/labor/application/index'), name: 'LaborApplication', meta: { title: '申请管理', icon: 'el-icon-s-order', noCache: true, roles: ['admin', 'counselor', 'unit-leader', 'academic-affairs'] } }

关键在src/permission.js的路由守卫逻辑：

• 用户登录后，前端调用getInfo()获取roles数组（如["unit-leader"]）
• 守卫遍历asyncRoutes，过滤出meta.roles包含当前用户角色的路由
• 若用户访问/labor/contract但角色不是admin或academic-affairs，则next({ path: '/401' })

注意：这个权限是前端守卫，不是后端校验。真正安全靠的是后端Controller方法上的@RequiresPermissions注解——前后端权限必须严格对齐，否则会出现“前端看不到按钮，但直接输URL仍能访问”的漏洞。

2.4 数据库设计：三张核心表如何支撑业务闭环？

ry_labor_position（岗位表）字段精简但关键：

• statustinyint：0=草稿、1=发布、2=关闭、3=已招满（状态机驱动业务）
• max_applicantsint：最大招聘人数，插入申请时触发SELECT COUNT(*) FROM ry_labor_application WHERE position_id = ? AND status = 1校验
• hour_per_weekdecimal(5,2)：周工时，用于计算月度上限（hour_per_week * 4 <= 40）

ry_labor_application（申请表）是状态中枢：

• status：0=待提交、1=已提交、2=辅导员审核中、3=辅导员驳回、4=用工单位审核中、5=用工单位驳回、6=已录用、7=已终止
• apply_timedatetime：申请时间，用于排序和超时提醒（如48小时未审核自动邮件通知）
• contract_idbigint：关联合同表，仅status=6时才允许生成合同

ry_labor_contract（合同表）字段直击行政痛点：

• contract_novarchar(32)：自动生成XG20240001格式编号（年份+流水号）
• sign_datedate：签署日期，非系统时间，需人工选择
• end_datedate：结束日期，由start_date + duration_months * 30计算（避免跨月天数误差）
• wage_typetinyint：0=小时制、1=月薪制、2=按件计酬（影响工资核算逻辑）

3. 环境搭建与启动实操：从零配通，绕过若依常见环境陷阱

别被.env.development文件名骗了——它只是前端环境变量，后端配置全在ruoyi-admin/src/main/resources/application-druid.yml里。整个启动流程分三步：装环境、配数据库、启服务。下面每一步都标出真实踩坑点。

3.1 JDK与Maven版本锁定：为什么必须用JDK 1.8.0_291？

若依V4.7.0编译目标为1.8，且pom.xml中maven-compiler-plugin明确指定：

<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin>

若你用JDK 17，mvn compile会报：

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile [ERROR] Source option 1.8 is not supported by target option 17

解决方案：下载JDK 1.8.0_291（非最新版！因若依依赖的某些老Jar包在JDK 1.8.0_301+有反射兼容问题）。验证命令：

java -version # 输出必须是 java version "1.8.0_291" mvn -v # Maven 3.6.3（若依V4.7.0官方推荐版本）

3.2 MySQL 5.7配置要点：字符集与SQL模式必须关掉

若依默认使用MySQL 5.7，但新装MySQL 8.0默认开启STRICT_TRANS_TABLES，会导致插入空字符串失败。必须修改my.cnf：

[mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci sql_mode=NO_ENGINE_SUBSTITUTION # 关键！注释掉或删除 strict_trans_tables

然后创建数据库：

CREATE DATABASE `ry` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 导入若依初始化SQL：ruoyi/sql/ry_20230601.sql -- 再导入本项目扩展SQL：sql/labor_init.sql（含岗位、申请、合同三张表）

注意：labor_init.sql里ry_labor_position表的ENGINE=InnoDB DEFAULT CHARSET=utf8mb4必须与数据库一致，否则中文乱码。

3.3 启动顺序与端口冲突排查：为什么run-tomcat.bat一闪而过？

若依默认后端端口8080，前端80，但Windows常有IIS或Skype占80端口。启动前务必检查：

netstat -ano | findstr :8080 netstat -ano | findstr :80

若端口被占，修改ruoyi-admin/src/main/resources/application.yml：

server: port: 8081 # 改成8081 spring: resources: static-locations: classpath:/static/,file:D:/ruoyi/front/dist/ # 指向build后的dist

前端vue.config.js也要同步改代理：

devServer: { port: 8082, proxy: { '/profile': { // 文件上传路径 target: `http://localhost:8081`, changeOrigin: true } } }

启动顺序铁律：

1. 先双击run-tomcat.bat（等控制台出现Started RuoYiApplication in X.XXX seconds）
2. 再双击run-web.bat（等浏览器自动打开http://localhost:8082）
3. 若页面空白，F12看Console：Failed to load resource: net::ERR_CONNECTION_REFUSED→ 后端没起来；404 /api/login→ 前端proxy没配对端口

3.4 登录与角色切换：如何快速获得“用工单位负责人”权限？

初始账号密码是admin/admin123，但admin角色默认只有系统管理权限。要测试勤工俭学全流程，必须创建测试角色：

• 进入系统管理 > 角色管理 > 新增
• 角色名称填用工单位负责人，权限标识填unit-leader
• 在菜单权限页签，勾选勤工俭学 > 岗位管理、勤工俭学 > 申请管理
• 在用户管理中，给测试用户（如zhangsan）分配此角色
• 用zhangsan/123456登录，即可看到岗位发布和申请审核入口

血泪经验：若新建角色后仍看不到菜单，清空浏览器缓存并重启前端服务——Vue Router的动态路由缓存有时不刷新。

4. 避坑指南：5个真实翻车现场与后悔药配方

这份源码能跑通，不等于能顺利交毕设。我在帮某高校学生调试时，高频遇到以下5类问题，每个都附带“现象→原因→解决”三段式定位法：

4.1 现象：点击“发布岗位”按钮无反应，控制台报TypeError: Cannot read property 'post' of undefined

原因：前端src/api/labor/position.js里import request from '@/utils/request'，但request实例未正确注入axios。常见于main.js中Vue.prototype.$http = axios被误删，或utils/request.js里service.interceptors.request.use配置错误。

解决：检查src/utils/request.js第12行是否为：

const service = axios.create({ baseURL: process.env.VUE_APP_BASE_API, // 必须是'/profile' timeout: 5000 })

若baseURL写成http://localhost:8080/profile（带协议），则跨域请求失败。正确值应为/profile，由vue.config.js的proxy代理。

4.2 现象：学生申请岗位后，“用工单位审核”列表为空，但数据库ry_labor_application.status=1

原因：LaborApplicationController.java的list()方法中，查询条件写死了status=4（用工单位审核中），但学生提交后状态是1（已提交），需经辅导员审核后才变4。流程断在辅导员环节。

解决：用admin账号登录，进入勤工俭学 > 申请管理，找到该申请，点击“辅导员审核”→“通过”，状态变为4，此时用工单位账号登录才能看到。

4.3 现象：导出Excel时报错java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook

原因：ruoyi-common/pom.xml中poi依赖范围是<scope>provided</scope>，表示由容器（Tomcat）提供，但若依内嵌Tomcat不自带POI，导致运行时找不到类。

解决：修改ruoyi-common/pom.xml，删掉<scope>provided</scope>，让Maven打包时包含POI：

<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>4.1.2</version> <!-- 删掉这一行 --> <!-- <scope>provided</scope> --> </dependency>

4.4 现象：生成劳动合同（LaborContract.docx）时，学生姓名、岗位名称显示为${studentName}乱码

原因：LaborContractServiceImpl.java中使用org.apache.poi.xwpf.usermodel.XWPFDocument替换文本，但XWPFParagraph.setText()方法不支持${}语法，需用XWPFRun.setText()逐字替换。

解决：找到generateContract()方法，将原逻辑：

for (XWPFParagraph para : doc.getParagraphs()) { para.setText(para.getText().replace("${studentName}", student.getName())); }

改为：

for (XWPFParagraph para : doc.getParagraphs()) { for (XWPFRun run : para.getRuns()) { String text = run.getText(0); if (text != null) { text = text.replace("${studentName}", student.getName()); run.setText(text, 0); } } }

4.5 现象：修改岗位信息后，前端列表仍显示旧数据，F5刷新才更新

原因：Element UI的el-table组件开启了row-key，但data数组未响应式更新。LaborPosition.vue中this.list是直接赋值res.rows，未触发Vue响应。

解决：在getList()方法末尾添加强制更新：

this.list = res.rows; this.total = res.total; // 加这一行，确保table重新渲染 this.$nextTick(() => { this.$refs.table.doLayout(); });

5. 毕设级功能增强：从“能跑”到“能讲”，加3个答辩加分项

交毕设不是交一个能登录的系统，而是交一个你能讲清楚“为什么这么设计”的作品。下面三个增强点，每个都能在答辩时让导师眼前一亮——因为它们直击高校行政的真实痛点，且改动小、见效快。

5.1 增加工时预警功能：当学生本月工时达35小时时，自动邮件提醒辅导员

这不是加个弹窗那么简单。真实场景是：学生可能在多个岗位工作，工时分散在不同ry_labor_hour_record记录里。需要聚合计算。

步骤：

1. 在LaborHourRecordServiceImpl.java中新增方法：

public void checkHourWarning(Long studentId) { // 计算学生当月总工时 LocalDate now = LocalDate.now(); LocalDate start = now.withDayOfMonth(1); LocalDate end = now.withDayOfMonth(now.lengthOfMonth()); LambdaQueryWrapper<LaborHourRecord> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(LaborHourRecord::getStudentId, studentId) .ge(LaborHourRecord::getWorkDate, start) .le(LaborHourRecord::getWorkDate, end); BigDecimal totalHours = this.list(wrapper).stream() .map(LaborHourRecord::getHours) .reduce(BigDecimal.ZERO, BigDecimal::add); if (totalHours.compareTo(new BigDecimal("35")) >= 0) { // 发送邮件（复用若依的MailUtils） MailUtils.sendSimpleMail( "辅导员邮箱", "勤工俭学工时预警", String.format("学生ID %d 本月工时已达 %.2f 小时，请关注！", studentId, totalHours) ); } }

2. 在LaborHourRecordController.java的add()方法末尾调用：

laborHourRecordService.checkHourWarning(laborHourRecord.getStudentId());

关键参数说明：start/end用LocalDate.withDayOfMonth()而非new Date()，避免时区导致跨月计算错误；邮件内容明确写出“学生ID”，方便辅导员快速定位。

5.2 合同PDF化：把Word合同转为带数字签名的PDF，满足归档要求

学校档案室要求合同必须是PDF且不可编辑。LaborContractServiceImpl原生用POI操作Word，但生成PDF需引入itextpdf。

步骤：

1. 在ruoyi-common/pom.xml添加依赖：

<dependency> <groupId>com.itextpdf</groupId> <artifactId>itextpdf</artifactId> <version>5.5.13.3</version> </dependency>

2. 新建PdfContractGenerator.java：

public class PdfContractGenerator { public static byte[] generatePdf(String wordPath) throws Exception { // 1. 读取Word XWPFDocument doc = new XWPFDocument(new FileInputStream(wordPath)); // 2. 转为HTML（POI不支持直接转PDF，走HTML中转） WordToHtmlConverter converter = new WordToHtmlConverter( DocumentBuilderFactory.newInstance().newDocumentBuilder().newDocument() ); converter.processDocument(doc); String html = XmlUtils.w3cNodeToString(converter.getDocument()); // 3. HTML转PDF ByteArrayOutputStream out = new ByteArrayOutputStream(); com.itextpdf.text.Document pdfDoc = new com.itextpdf.text.Document(); PdfWriter.getInstance(pdfDoc, out); pdfDoc.open(); HTMLWorker htmlWorker = new HTMLWorker(pdfDoc); htmlWorker.parse(new StringReader(html)); pdfDoc.close(); return out.toByteArray(); } }

3. 在LaborContractController.java的downloadContract()中调用：

byte[] pdfBytes = PdfContractGenerator.generatePdf(tempWordPath); response.setContentType("application/pdf"); response.setHeader("Content-Disposition", "attachment;filename=contract.pdf"); response.getOutputStream().write(pdfBytes);

注意：itextpdf 5.5.13.3是最后一个支持Java 1.8的版本，若用新版会报UnsupportedClassVersionError。

5.3 岗位热度分析：用ECharts画出“申请人数TOP5岗位”柱状图

答辩时展示数据价值，比展示CRUD更有说服力。只需在LaborPosition.vue中加一个图表。

步骤：

1. 安装ECharts：npm install echarts@4.9.0（Vue2兼容版）
2. 在<script>中引入：

import * as echarts from 'echarts' export default { data() { return { chartOption: { tooltip: { trigger: 'axis' }, xAxis: { type: 'category', data: [] }, yAxis: { type: 'value' }, series: [{ type: 'bar', data: [] }] } } }, mounted() { this.initChart() }, methods: { initChart() { const chartDom = document.getElementById('chart') const myChart = echarts.init(chartDom) // 调用后端API获取TOP5 this.$http.get('/labor/position/hot').then(res => { const data = res.data this.chartOption.xAxis.data = data.map(d => d.positionName) this.chartOption.series[0].data = data.map(d => d.applyCount) myChart.setOption(this.chartOption) }) } } }

3. 后端LaborPositionController.java新增接口：

@GetMapping("/hot") @ResponseBody public List<Map<String, Object>> getHotPositions() { return laborPositionService.getHotPositions(5); // SQL: SELECT position_name, COUNT(*) as applyCount FROM ry_labor_application a JOIN ry_labor_position p ON a.position_id=p.id GROUP BY p.id ORDER BY applyCount DESC LIMIT 5 }

从那以后我每次帮学生改毕设，都会强制他们在答辩前做三件事：第一，用admin账号走一遍全流程，截图保存每一步状态；第二，把LaborContract.docx里的${xxx}全部替换成真实数据，打印出来签字扫描；第三，在README.md里用表格写清“本系统解决了哪3个传统Excel管理的痛点”。不是为了应付导师，而是让自己真正理解：代码不是魔法，它是把现实世界的规则，一行行翻译成机器能懂的语言。希望帮到你。

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