【立项背景与目标】
高校教师绩效考核要汇总考勤、课程与学情、学生评教、科研、荣誉等多类材料。传统做法是教师交纸质材料,教务逐份核对后手工录入 Excel:一轮考核往往跨数周,易漏项、口径不统一,结果公示和事后追溯都很困难;教师反复跑腿补材料,教务也把大量时间花在整理而非评审上。本项目目标是搭建一套面向教师的线上绩效考核系统,把"填报—审核—计分—公示—复核"整条链路搬到浏览器:教师一次录入并上传证明,审核员在线核验,系统按权重自动结算并导出考核表,让考核全程留痕、可查可复算。
【软件功能与核心模块】
系统按考核流程拆分为 5 个模块、3 类角色(教师、审核员、管理员),菜单与路由按角色动态渲染:
1. 信息模块:注册登录、忘记密码、QQ 邮箱验证码身份校验、个人资料维护;首次登录强制完善资料,修改资料前须通过邮箱验证。
2. 提交考核模块:按考勤、课程、学生评教、科研、荣誉五类组织表单,支持新增/删除项目、上传证明文件并在线预览,仅考核开放期可进入。
3. 审核模块:审核员查看项目详情与证明材料,给出通过/驳回结论并填写理由;审核任务随机分配且不得审核本人项目,被驳回项目可申诉、由其他审核员复核。
4. 考核表模块:按权重汇总各类得分,生成明细与总分并支持导出 Excel;教师可查看每项驳回原因并发起申诉。
5. 管理后台:新教师账号注册、考核阶段切换、审核员任命,独立 /admin 入口与教师端隔离。
【业务流程与功能路径】
管理员建号并设置阶段 → 教师登录、完善资料 → 填报期在"考核填报"页提交项目 → 阶段切至审核,审核员在"审核"页逐项核验 → 系统结算生成"初步结果" → 教师查看明细、对驳回项提交申诉 → 其他审核员复核 → 公示最终考核表并导出 Excel。全流程由阶段表驱动,非开放期模块入口自动关闭,前端隐藏菜单与后端接口拦截双重生效。
【整体架构与技术栈】
采用 B/S 前后端分离架构。前端 Vue 3.4 + Vite 5 + Element Plus + Vue Router + Pinia + Axios,负责页面渲染、表单校验、按角色动态渲染菜单与路由;后端 Spring Boot 3.2(JDK 17)+ MyBatis + SQL Server,提供 REST 接口、业务计算与持久化;JWT(java-jwt)做无状态鉴权,spring-boot-starter-mail 对接 QQ 邮箱 SMTP 发送验证码,Apache POI 导出 xlsx,文件上传做类型白名单与大小限制。开发期通过 Vite 代理 /api 联调,接口统一返回结构,前后端可独立部署。
【我负责的模块与结果】
项目由我独立完成需求分析、库表设计、前后端开发与测试。设计 Teacher、Project、Course、Student、Stage、result 共 6 张表,项目表 17 个字段承载"提交—初审—申诉—复核"全状态;后端 20 个类约 1500 行、31 个接口;前端 27 个源码文件约 3200 行,覆盖登录、填报、审核、结果、后台五组页面。实现 3 类角色权限隔离与 5 个考核状态的流程控制;教师端 /login 与管理员端 /admin 双入口,规避管理员账号被暴力遍历。交付可运行系统、建表脚本与 6 组功能测试(注册、登录、改资料、新增项目、上传文件、管理员登录),覆盖空验证码、超类型文件、越权入口等异常输入,用例全部通过;考核表可一键导出含 5 项分项得分与总分的 Excel。
【难点、坑与解决方案】
1. 刷新丢登录态、重复请求:JWT 仅携带用户名,配合请求/响应拦截器统一校验,用 Pinia 缓存用户信息与 token,避免每次渲染都查库,在安全与性能间取平衡。
2. 审核公平与越权:审核任务随机均分,禁止审核本人项目,初审与复核人互斥;用 Project 状态位 + Stage 阶段表驱动流转,前后端双重校验,杜绝提前填报与重复审核。
3. 证明文件安全与预览:上传仅放行图片/文档白名单,重命名后落盘并返回映射路径,前端用 vue-office/pdfjs 在线预览;查询全部参数化防 SQL 注入,描述字段不直接渲染防 XSS。
4. 计分口径易错:考勤按扣分制、课程取 70% 成绩 + 30% 考勤再乘权重、评教均值乘权重、项目按等级计分,拆成独立方法;结果先落库再导出,有争议可复算追溯。