五星天皇岩里政男1. 项目背景与核心需求
教师薪酬管理系统是高校信息化建设中的重要组成部分。传统的手工核算方式存在效率低下、易出错、数据孤岛等问题。特别是在高校扩招和教师流动性增加的背景下，一套高效、准确的薪酬管理系统显得尤为重要。
这个毕业设计项目采用SpringBoot+Vue+MySQL技术栈，实现了教师薪酬的数字化管理。系统需要满足以下核心需求：
- 多角色权限管理（教师、院系管理员、财务人员等）
- 灵活的薪酬项目配置
- 自动化的工资计算
- 可视化的数据报表
- 完善的审计追踪
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术选型与架构设计
2.1 后端技术栈
后端采用SpringBoot框架，主要基于以下考虑：
- 快速开发：SpringBoot的自动配置和起步依赖大大简化了项目搭建
- 生态丰富：可以方便集成MyBatis、Spring Security等常用组件
- 易于部署：内嵌Tomcat，打包成jar即可运行
关键组件包括：
- Spring Security + JWT：实现认证和授权
- MyBatis-Plus：简化数据库操作
- Hibernate Validator：参数校验
- EasyExcel：处理Excel导入导出
- Lombok：减少样板代码
2.2 前端技术栈
前端选用Vue.js框架，主要优势：
- 组件化开发：提高代码复用性
- 响应式设计：更好的用户体验
- 丰富的生态系统：Element UI、ECharts等成熟组件库
主要技术组合：
- Vue CLI：项目脚手架
- Vue Router：前端路由
- Vuex：状态管理
- Axios：HTTP请求
- Element UI：UI组件库
- ECharts：数据可视化
2.3 数据库设计
MySQL作为关系型数据库，存储结构化的薪酬数据。主要表设计如下：
2.3.1 教职工表(teacher)
sql复制CREATE TABLE `teacher` (
`id` varchar(20) NOT NULL COMMENT '工号',
`name` varchar(50) NOT NULL COMMENT '姓名',
`gender` char(1) DEFAULT NULL COMMENT '性别',
`title` varchar(30) DEFAULT NULL COMMENT '职称',
`department_id` int DEFAULT NULL COMMENT '部门ID',
`entry_date` date DEFAULT NULL COMMENT '入职日期',
`phone` varchar(15) DEFAULT NULL COMMENT '联系电话',
`status` tinyint DEFAULT '1' COMMENT '状态(1在职 0离职)',
PRIMARY KEY (`id`),
KEY `idx_department` (`department_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
2.3.2 薪酬项目表(salary_item)
sql复制CREATE TABLE `salary_item` (
`id` int NOT NULL AUTO_INCREMENT,
`code` varchar(20) NOT NULL COMMENT '项目编码',
`name` varchar(100) NOT NULL COMMENT '项目名称',
`type` tinyint NOT NULL COMMENT '类型(1固定 2公式)',
`formula` text COMMENT '计算公式',
`taxable` tinyint DEFAULT '1' COMMENT '是否计税',
`display_order` int DEFAULT '0' COMMENT '显示顺序',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_code` (`code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
2.3.3 月度薪酬表(monthly_salary)
sql复制CREATE TABLE `monthly_salary` (
`id` bigint NOT NULL COMMENT 'ID',
`teacher_id` varchar(20) NOT NULL COMMENT '教师ID',
`year_month` char(6) NOT NULL COMMENT '年月',
`base_salary` decimal(12,2) DEFAULT '0.00' COMMENT '基本工资',
`performance` decimal(10,2) DEFAULT '0.00' COMMENT '绩效',
`bonus` decimal(10,2) DEFAULT '0.00' COMMENT '奖金',
`deduction` decimal(10,2) DEFAULT '0.00' COMMENT '扣款',
`tax` decimal(10,2) DEFAULT '0.00' COMMENT '个税',
`net_salary` decimal(12,2) DEFAULT '0.00' COMMENT '实发工资',
`status` tinyint DEFAULT '0' COMMENT '状态(0草稿 1已审核 2已发放)',
`create_time` datetime DEFAULT CURRENT_TIMESTAMP,
`update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
KEY `idx_teacher` (`teacher_id`),
KEY `idx_ym` (`year_month`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
3. 核心功能实现
3.1 权限管理模块
采用RBAC模型，实现基于角色的访问控制。关键实现点：
- 用户-角色-权限三级结构
- 接口级别的权限控制
- 前端菜单动态渲染
后端核心代码示例：
java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http.csrf().disable()
.authorizeRequests()
.antMatchers("/api/auth/**").permitAll()
.antMatchers("/api/**").authenticated()
.and()
.addFilter(new JwtAuthenticationFilter(authenticationManager()))
.addFilter(new JwtAuthorizationFilter(authenticationManager()))
.sessionManagement()
.sessionCreationPolicy(SessionCreationPolicy.STATELESS);
}
}
3.2 薪酬计算引擎
实现灵活可配置的薪酬计算规则：
- 支持固定值和公式两种计算方式
- 公式支持Groovy脚本引擎动态执行
- 计算过程记录详细日志
核心计算逻辑：
java复制public BigDecimal calculateSalary(String teacherId, String yearMonth) {
// 获取教师基本信息
Teacher teacher = teacherService.getById(teacherId);
// 获取所有激活的薪酬项目
List<SalaryItem> items = salaryItemService.listActiveItems();
// 初始化计算结果
Map<String, BigDecimal> result = new HashMap<>();
// 遍历计算每个项目
for (SalaryItem item : items) {
if (item.getType() == 1) { // 固定值
result.put(item.getCode(), item.getFixedValue());
} else { // 公式计算
Binding binding = new Binding();
binding.setVariable("teacher", teacher);
binding.setVariable("yearMonth", yearMonth);
GroovyShell shell = new GroovyShell(binding);
Object value = shell.evaluate(item.getFormula());
result.put(item.getCode(), new BigDecimal(value.toString()));
}
}
// 计算应发工资、扣款、个税等
// ...
return netSalary;
}
3.3 Excel导入导出
使用EasyExcel处理Excel数据：
- 教师信息批量导入
- 薪酬数据导出
- 自定义表头和数据格式
导出示例代码：
java复制@GetMapping("/export")
public void exportSalary(HttpServletResponse response,
@RequestParam String yearMonth) {
// 设置响应头
response.setContentType("application/vnd.ms-excel");
response.setCharacterEncoding("utf-8");
String fileName = URLEncoder.encode(yearMonth + "薪酬表", "UTF-8");
response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".xlsx");
// 查询数据
List<SalaryExportVO> list = salaryService.getExportData(yearMonth);
// 导出Excel
EasyExcel.write(response.getOutputStream(), SalaryExportVO.class)
.sheet("薪酬表")
.doWrite(list);
}
4. 系统部署与运行
4.1 开发环境搭建
-
后端环境：
- JDK 1.8+
- Maven 3.6+
- MySQL 5.7+
-
前端环境：
- Node.js 12+
- npm 6+
4.2 数据库初始化
- 创建数据库：
sql复制CREATE DATABASE teacher_salary DEFAULT CHARACTER SET utf8mb4;
- 执行SQL脚本初始化表结构
4.3 后端启动
- 修改application.yml中的数据库配置
- 打包项目：
bash复制mvn clean package
- 运行jar包：
bash复制java -jar teacher-salary.jar
4.4 前端启动
- 安装依赖：
bash复制npm install
- 开发模式运行：
bash复制npm run serve
- 生产环境打包：
bash复制npm run build
5. 常见问题与解决方案
5.1 跨域问题
前后端分离开发时常见的跨域问题，解决方案：
- 后端配置CORS：
java复制@Configuration
public class CorsConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOrigins("*")
.allowedMethods("*")
.allowedHeaders("*");
}
}
- 前端开发环境配置代理：
javascript复制module.exports = {
devServer: {
proxy: {
'/api': {
target: 'http://localhost:8080',
changeOrigin: true
}
}
}
}
5.2 性能优化
-
数据库层面：
- 添加合适的索引
- 使用连接池（如HikariCP）
- 批量操作代替循环单条操作
-
应用层面：
- 使用缓存（Redis）
- 异步处理耗时操作
- 分页查询大数据集
-
前端层面：
- 组件懒加载
- 路由懒加载
- 按需引入组件库
5.3 安全注意事项
- 密码存储：使用BCrypt加密
- SQL注入：使用预编译语句
- XSS防护：前端转义HTML，后端过滤敏感字符
- CSRF防护：虽然REST API通常不需要，但可以考虑使用CSRF Token
- 敏感数据：日志中避免打印敏感信息
6. 项目扩展方向
- 集成钉钉/企业微信：实现消息通知和移动端访问
- 增加多维度统计分析：使用更强大的可视化工具
- 对接财务系统：实现自动打款
- 支持多校区管理：更灵活的组织架构
- 增加教师自助服务：请假、报销等流程
在实际开发过程中，我发现薪酬计算规则的灵活性非常重要。最初采用硬编码方式实现计算逻辑，后期需求变更时修改成本很高。改为基于Groovy脚本的配置化方案后，系统适应能力大大增强。另外，Excel导入导出功能看似简单，但在处理复杂格式和大数据量时有很多细节需要注意，比如内存溢出问题、特殊字符处理等。