做了不少高校信息化项目竞赛管理系统属于那种看着简单、细节多到爆炸的类型。报名信息散落在导员的Excel表里作品提交靠U盘拷贝评审打分标准不统一统计报表每学期都得重新拉一次数据。今年完整整理出一套基于SpringBootVueMyBatis架构、MySQL数据库的竞赛平台管理系统源码把竞赛创建、在线报名、组队管理、作品提交、专家评审、成绩公示、数据统计这整条业务链都串了起来。它既能作为毕业设计、课程设计的完整参考架构也适合高校信息中心的技术老师拿去做内部系统快速迭代。下面我会从设计思路、数据库建模、前后端实现、上线部署、二次开发五个维度把这套源码里值得注意的关键点全部拆开讲一遍想直接拿去跑起来的同学也能照着做。1. 项目价值与选型思考1.1 高校竞赛业务的真实痛点竞赛管理这个场景在高校信息化里一直被低估。表面上看是发通知、收名单、评作品实际跑起来全是细节一个学校一年几十项赛事覆盖校级、省级、国家级每个赛事的报名时间、参赛资格、评审规则都不一样学生需要组队队伍里跨学院、跨年级是常态队长和成员的管理权限得分开作品提交环节涉及文件格式、大小限制、截止时间评审阶段要避免人情分需要多评委独立打分再汇总。这些需求堆在一起如果靠人工登记和Excel流转光是核对报名信息就能让人崩溃。竞赛平台要解决的本质上不是公告发布这种单点功能而是一条从赛事创建到成绩落库的可追溯流程。我见过很多做了一半的项目竞赛列表做得很漂亮结果报名模块用一张表硬扛所有报名方式team和individual不区分评审模块直接空着。这种系统交付到学校业务方用一周就会放弃。所以设计这套系统时我的出发点不是把功能写全而是把竞赛这件事的主干流程立住赛事维护是源头报名是入口队伍和作品是过程评审和成绩是出口。围绕这条主线做模块划分再往每个模块里填充细节。1.2 为什么锁定SpringBootVueMyBatisMySQL技术选型这件事我见过不少项目死在过度架构上。一个课程设计级别的系统上来就配微服务、上消息队列、搞分布式事务最后交付时连本地都跑不利索。这一套源码锁定SpringBootVueMyBatisMySQL核心原因是这四个组件组合的容错率极高适合绝大多数高校场景。SpringBoot的优势不用多吹自动配置、内嵌Tomcat、生态成熟一个school-competition.jar打出来服务器上直接就能跑对运维能力普遍薄弱的高校信息中心来说是最省心的方案。Vue这边组件化开发让后台管理页面的复用成本低很多列表页、表单页、弹窗组件抽出来之后新增一个管理模块的边际成本非常小。MyBatis在复杂查询上比JPA顺手得多竞赛系统里报表统计、条件筛选、多表联查都是高频操作写在XML里能把SQL看得清清楚楚。MySQL就更不用说了部署简单、文档丰富、DBA人才好找专科院校到双一流都适用。这四样东西组合起来还有一个隐性优势网上可找到的解决方案密度极高。接手这套源码的二次开发人员遇到问题搜一下就能找到答案不用在冷门框架上浪费时间。我一直觉得能给团队或者学弟学妹降低接手成本的技术栈才是高校项目里最合适的技术栈。2. 系统功能模块与数据库落地2.1 核心功能模块拆解整套系统按角色和业务维度划分为四大模块域每个模块域里再做细化。基础管理域用户管理、角色管理、菜单权限管理。这部分就是标准的RBAC模型用户表、角色表、菜单表、用户角色关联表、角色菜单关联表。实际项目里学生会用学号登录老师用工号登录系统管理员是预置账号。菜单权限不要求做到按钮级别但至少要保证不同角色登录后看到的左侧导航不一样——这个需求前端通过路由守卫配合后端返回的菜单列表就能实现。竞赛业务域这是系统的核心。竞赛分类、竞赛信息发布、赛事公告、报名管理、组队管理、作品提交。竞赛分类可以做成多级比如学科竞赛-电子信息类-全国大学生电子设计竞赛。竞赛信息里要有详细的赛事介绍、参赛对象、报名开始时间、报名截止时间、作品提交截止时间、奖项设置以及附带的报名材料模板下载。报名管理要区分个人赛和团队赛个人赛直接报名团队赛需要先创建队伍再报名。组队管理包括队长创建队伍、邀请成员、成员确认、队伍人数控制这块的实际交互最多。评审计分域评审分配、在线打分、成绩汇总、奖项设置。评审分配可以做成管理员按竞赛批次分配评委也可以做成评委自选。打分环节要考虑多个评审维度比如创新性、完成度、文档规范性每个维度权重不同。成绩汇总要支持去掉最高分最低分取平均或者直接平均分这个规则可以在竞赛配置里定义。奖项设置要能支持按比例排出一二三等奖。统计展示域参赛人数统计、学院参赛排行、作品类型分布、历年成绩对比。统计页建议用图表呈现前端用ECharts后端提供聚合查询接口。跑通统计模块系统从工具变成平台的价值就出来了这也是答辩或者汇报时最能打动人的部分。2.2 数据库表设计与建模要点数据库设计是这套源码的骨架我建表时坚持几个原则核心业务表都带create_time和update_time状态字段一律用tinyint并加注释避免魔法数字所有业务表必须有主键但拒绝无意义的自动增长作为唯一依赖业务唯一标识用单独的字段比如competition_no。竞赛主表competition_info大致长这样id、competition_no、title、category_id、level校级/省级/国家级、description、cover、type个人赛/团队赛/混合赛、register_start_time、register_end_time、submit_start_time、submit_end_time、status、create_time、update_time。报名字段competition_registerid、competition_id、user_id、team_id、member_count、status待审核/通过/驳回、register_time。这里一个核心约束是同一用户对同一竞赛只能有一条有效报名记录所以要在competition_id和user_id上建唯一索引否则并发点击会导致重复报名。队伍表team_infoid、competition_id、team_name、captain_id、member_limit、status、create_time。队名在同一个竞赛里要唯一建唯一索引时把competition_id和team_name一起放进去。队伍成员表team_memberid、team_id、user_id、role队长/成员、join_time。成员表设计的关键是队长必须同时在team_info和team_member里都有记录这样查询成员列表时逻辑才能统一。评审相关的表更需要仔细设计。评审表review_assignid、competition_id、reviewer_id、work_id、status。评分表score_recordid、review_assign_id、dimension_id、score、comment。评分维度表score_dimensionid、competition_id、dimension_name、weight。这三张表构成完整的评审模型评审分配的幂等性要靠reviewer_id和work_id的唯一索引来保证。2.3 表关系与权限设计的坑表关系上最容易出问题的是一对多和多对多的界限。一个竞赛下有多个公告是一对多一个用户可以属于多个角色是多对多一个用户可以创建多个队伍但同一时间只能在一个队里这个业务上的唯一性不能靠数据库关系表达必须在应用层做校验。我在注册、组队、报名这几个接口里都加了防重判断先查再插的方式在普通并发下够用真要加锁就锁竞赛ID级别不建议直接锁表。权限设计走RBAC但在用户表里加了一个user_type字段区分学生和教师配合角色表来用。原因是很多业务规则依赖身份类型比如学生可以报名参赛教师可以作为指导教师或者评委。如果全部走角色判断代码里会多出很多hasRole的判断反而麻烦。一个user_type字段配合必要的角色判断多数情况下更高效。3. 前后端核心实现与实操细节3.1 后端SpringBoot业务闭环怎么写后端代码组织我习惯按controller-service-mapper-pojo四层来controller只做参数接收和返回封装业务逻辑全部下沉到serviceservice里接口和实现分离。这种写法对后期维护价值很大比如报名模块抽一个CompetitionRegisterService接口实现类里处理报名校验、数据写入、通知公告这三个步骤新需求加实现方法而不用动controller。登录认证用的是JWT。实现要点是登录成功后把用户ID、用户名、用户类型放进token设置适当的过期时间生产环境建议2小时前端在请求头带Authorization: Bearer token。JWT的坑在于服务端无法主动让token失效如果遇到用户被禁用的情况只能等token自然过期。解决思路是在用户表加一个token_version字段JWT里带上这个版本号修改密码、禁用用户时递增版本号老token就被动失效了。这个技巧课程设计一般不会写但企业级系统里是刚需。报名接口的核心代码如下看起来简单实际上有个重要细节报名事务里同时包含了状态检查和数据插入必须加Transactional注解来保证一致性。Transactional(rollbackFor Exception.class) public Long register(RegisterRequest request) { Competition competition competitionMapper.selectById(request.getCompetitionId()); if (competition null) { throw new BusinessException(竞赛不存在); } if (LocalDateTime.now().isBefore(competition.getRegisterStartTime()) || LocalDateTime.now().isAfter(competition.getRegisterEndTime())) { throw new BusinessException(不在报名时间范围内); } Register register new Register(); register.setCompetitionId(request.getCompetitionId()); register.setUserId(LoginUserHolder.getUserId()); register.setStatus(0); registerMapper.insert(register); return register.getId(); }文件上传这边作品提交是最常见的高频操作。后端接口接收MultipartFile存储路径建议配置在application.yml里不要写死。本地存储方案要处理文件名重复问题用UUID重命名后再存储原始文件名单独存到数据库字段下载时做一次映射。3.2 前端Vue页面组织与接口对接前端技术栈是Vue全家桶加Element UI。项目目录我按功能模块划分src/api放接口请求封装每个业务模块一个JS文件src/views放页面组件src/router维护路由表src/utils放axios实例和工具函数。axios实例是全局统一的关键配置有两处请求拦截器加token响应拦截器统一处理错误码和401跳转。我在实际项目里见过太多前端同学每个请求单独发token、单独处理错误然后代码到处重复的情况。axios实例配好之后所有请求自动带凭证省心很多。// 响应拦截器核心逻辑 service.interceptors.response.use( response { const res response.data if (res.code ! 200) { Message.error(res.message) return Promise.reject(new Error(res.message)) } return res }, error { if (error.response.status 401) { // 清除token并跳转登录页 localStorage.removeItem(token) router.push(/login) } Message.error(接口调用异常) return Promise.reject(error) } )列表页用Element UI的el-table加分页组件是标配。有个经验值得分享表格的列不要全部由后端返回的字段名直接渲染建议在页面里维护一个columns配置数组把标题、字段、宽度、格式化函数统一管理。后续改列名、加列、调宽度只需要改配置不用在模板里反复查找。3.3 核心业务场景从报名到评审的完整数据流系统里最重要的一个业务闭环是学生在竞赛详情页看到报名中状态点击报名后如果是团队赛则跳转到组队页面队长创建队伍后邀请成员成员同意后才算组队成功队伍人数达到参赛要求后才可以提交报名管理员在后台审核报名审核通过后队伍处于可提交作品状态作品提交截止后管理员分配评委评委打分结束后系统按配置好的规则汇总成绩生成排名。这里有个容易忽略的细节报名状态和组队状态必须分离。团队赛中队伍已满员和报名已通过是两个独立的状态满员只是满足报名前置条件审核通过才是报名流程真正的终点。如果状态字段设计得不够细后续评审阶段哪些队伍可以评就会变得很难判断。我的做法是team_info.status维护队伍生命周期组建中、已满员、已报名、已通过、已驳回competition_register.status只维护报名审核状态待审核、通过、驳回两套状态通过关联查询得出当前阶段的业务状态。评审阶段的数据流同样需要仔细考虑。管理员批量分配评审时要校验评委和作品的对应关系防止同一评委被分配到同一作品多次评委打分接口要拦截截止时间逾期不能打分成绩汇总服务要按竞赛ID查询所有评分记录按配置好的规则聚合这里用MyBatis写一个带条件判断的统计SQL非常顺手。select idselectScoreSummary resultTypemap SELECT work_id, SUM(score * weight) AS total_score FROM score_record r LEFT JOIN score_dimension d ON r.dimension_id d.id WHERE r.competition_id #{competitionId} GROUP BY work_id ORDER BY total_score DESC /select4. 部署上线与常见问题排查4.1 一套可复现的从本地到服务器部署流程部署这件事我在项目里也算踩了不少坑。整套流程其实可以固化成标准步骤按这几步走基本不会出错。第一步打包后端。在项目根目录执行mvn clean package -DskipTests注意要用Maven的package而不是直接跑SpringBoot的插件bootJar如果pom里配置了finalNameJAR包名会固定下来避免每次版本变化导致启动脚本要改动。打包完成后在target目录拿到可执行JAR。第二步初始化数据库。把源码里的schema.sql在MySQL里执行一遍创建数据库时字符集选utf8mb4排序规则选utf8mb4_general_ci原因是对中文和表情符号的支持更完整。编码问题在高校系统里极易出现报名信息里带个少数民族姓名、指导教师备注里有个特殊字符用utf8mb4几乎不会出乱码。第三步配置后端。修改application.yml里的数据库连接串、文件上传路径、JWT密钥。服务器上数据库密码不要明文写在配置文件里如果条件允许用环境变量注入spring.datasource.password: ${DB_PASSWORD}在启动命令里通过--DB_PASSWORDxxx传入。第四步打包前端。npm run build生成dist目录然后配置Nginx把静态目录指向dist并把/api路径反向代理到后端服务的端口。server { listen 80; server_name your-domain.com; location / { root /var/www/competition/dist; index index.html; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }第五步配置后端守护进程。直接java -jar跑是方便但对生产环境不友好偶发报错或者服务器重启后进程就没了。用systemd管理是Linux下比较标准的做法。创建一个competition.service文件放在/etc/systemd/system/下内容大致是ExecStart/usr/bin/java -jar /opt/competition/school-competition.jar加上Restartalways。配置好后systemctl daemon-reload systemctl start competition以后开机自启、崩溃重启都自动处理了。4.2 高频报错与解决办法实录系统跑起来后一定会有各种报错。下面这五个是我在调试这类系统时遇到频率最高的每条都附上排查思路。MySQL连接报Public Key Retrieval is not allowed这个在MySQL 8.0连接时非常常见。解决办法是JDBC连接串加allowPublicKeyRetrievaltrue同时确认使用了useSSLfalse组合起来才能稳定连接。跨域请求报403或者response里没有Access-Control-Allow-Origin这是前后端分离最容易踩的坑。解决办法有两种一是后端在SpringBoot里配置CorsFilter指定允许的前端地址二是让前端统一走反向代理把跨域问题交给Nginx处理生产环境这套源码就是走Nginx的方案本地联调时用后端CORS配置。MyBatis的XML文件扫描不到导致启动报Invalid bound statement这属于配置问题。检查两处MapperScan的包路径是否正确以及application.yml里mybatis.mapper-locations是否指向了classpath:mapper/*.xml。Maven打包时如果XML文件没有被打进JAR检查pom里build-resources配置把src/main/resources显式声明进去。Vue打包部署后刷新页面404这个问题很多新手会蒙。原因是前端路由用了History模式刷新时Nginx找不到对应的物理文件。解决办法就是Nginx配置里已经写好的那行try_files $uri $uri/ /index.html把路由请求全部重写到index.html。文件上传成功但在服务器上找不到文件多半是路径的问题。本地Windows路径和服务器Linux路径不兼容配置文件里写绝对路径最靠谱比如/data/competition/upload并确保该目录存在且运行JAR的用户有读写权限。不要用相对路径JAR在不同的启动目录下相对路径解析不一致。下面把高频问题和配套解法整理成一张速查表方便排查时对照。表格只列场景和思路具体代码路径在源码注释里都有。现象直接原因解决思路前端请求接口不通后端地址未配置或CORS拦截检查Nginx代理配置或后端加CORS配置表单提交中文乱码数据库字符集不正确库表统一改成utf8mb4连接串加characterEncodingutf8同一队伍重复报名唯一索引缺失在competition_idteam_id建唯一索引评审分配重复评审记录幂等性不足在reviewer_idwork_id建唯一索引JAR启动后端口被占用内嵌Tomcat端口冲突修改server.port或杀掉占用进程打包后XML不生效Maven资源过滤配置缺失在pom配置build-resources包含XML文件4.3 初次启动源码的完整校验清单拿到源码后不要急着改代码先按校验清单把整个流程跑通。第一步本地装好JDK 8、Maven 3.6、Node.js 14、MySQL 5.7这几个基础环境版本不匹配后面会非常痛苦。我用的是JDK 8配合SpringBoot 2.3.xNode 14配合Vue 2.6二进制版本依赖这个组合已经实测过很多次非常稳定。第二步导入数据库脚本。源码根目录一般会有一个sql/init.sql或者sql/schema.sql执行后检查一下核心表的数量。第三步修改本地配置启动后端。观察启动日志确认没有报错看到Started Application in xx seconds就说明后端起来了。第四步进入前端目录执行npm install这一步如果卡在下载包可以换用淘宝镜像源安装完成后npm run serve启动开发模式访问本地的8080端口看能不能正常登录。我们在这套源码的交付文档里专门强调过如果能按顺序把登录、建赛、报名、组队、提交、评审、出分这七个动作完整走一遍这套系统在你的环境里就基本通了。之后再改业务代码出问题也知道是改出来的不是环境问题。5. 从能跑到好用源码改造与扩展建议5.1 课程设计级到企业级的差距在哪很多同学拿到源码后会问这套东西我交毕业设计够不够我的回答是如果只是跑通流程完成度已经相当高了但如果目标是让学校真正持续用起来还有几个地方值得花时间改造。第一个改动是引入Redis做缓存。竞赛分类、公告列表这些变化频率低的数据每次请求都打MySQL很浪费。用SpringCache配合Redis做简单缓存配置五分钟过期时间效果立竿见影。注意要保证缓存一致性在更新公告、竞赛信息的Service方法上加CacheEvict注解避免用户在列表页看到旧数据。第二个改动是文件存储替换。本地磁盘存储在小规模使用场景没问题但并发提交作品的高峰期读取、备份、迁移都是事。建议把上传组件改造为对接MinIO这是一个开源的分布式对象存储服务部署起来和MySQL一样容易对接方式和OSS、云存储几乎一样。改造涉及Service层和配置项前端接口不用动。第三个改动是增加定时任务。竞赛结束时间、报名截止时间这些节点系统只是被动地判断时间是否过期是不够的最好增加一个定时任务每天扫描竞赛状态把已过期的竞赛自动置为已结束并发送站内通知。用SpringBoot自带的Scheduled就能做不用引入额外的框架。第四个改动是审计日志。谁在什么时间改了评审结果、谁删除了报名记录这些操作在正式运营时是必须要查的。做法是在关键Service方法上用AOP切面记录操作日志或者更简单地维护一张operation_log表业务代码里手动记录关键操作类型、操作人、操作对象、操作内容、时间。这条看起来不显眼但真出问题要追溯数据时比什么都管用。5.2 我个人实操中的三点体会做到这一步我分享三个在多次实操中积累下来的个人经验。一是别在前期过度设计权限。很多同学一开始就想着把RBAC做得很复杂按钮权限、数据权限、接口权限全都上结果业务做不出来。竞赛管理系统实际使用中角色就那么几种把菜单权限控制好、接口做好登录拦截就够了。权限体系暴露出的问题通常是后期加功能时才出现到时候按需扩展反而更清晰。二是字段命名统一规范带来的收益被严重低估。这套源码里所有主键都叫id所有时间字段都叫create_time/update_time所有状态都叫status。看起来是约定俗成的小事但在做多表关联、写通用Mapper的时候会节省大量时间尤其当系统表数量超过二十张以后命名的混乱会直接转化为排查问题的成本。三是事务边界一定要画清楚。注册、组队、报名、分配评审这几个操作都是跨多表的写操作必须加上事务。但也别把不该放进来的操作塞进事务里比如上传文件这种耗时操作文件写入和数据库记录更新就不该放在同一个事务里否则文件系统故障会导致数据库回滚或者数据库事务长时间持有连接。我习惯的做法是先传文件得到存储路径再开事务把路径写入数据库。这套源码的扩展方向还可以有很多比如对接学校统一身份认证、增加移动端H5报名入口、接入企业微信消息通知。不管往哪个方向改只要主干业务保持清晰权限边界划分明确后续的迭代都不会太痛苦。如果你们学校正在选型或者你们项目组正在评估类似系统我的建议是先把完整流程跑通再结合实际业务场景逐步打磨细节这套代码作为起点已经完全够用。
做了不少高校信息化项目竞赛管理系统属于那种看着简单、细节多到爆炸的类型。报名信息散落在导员的Excel表里作品提交靠U盘拷贝评审打分标准不统一统计报表每学期都得重新拉一次数据。今年完整整理出一套基于SpringBootVueMyBatis架构、MySQL数据库的竞赛平台管理系统源码把竞赛创建、在线报名、组队管理、作品提交、专家评审、成绩公示、数据统计这整条业务链都串了起来。它既能作为毕业设计、课程设计的完整参考架构也适合高校信息中心的技术老师拿去做内部系统快速迭代。下面我会从设计思路、数据库建模、前后端实现、上线部署、二次开发五个维度把这套源码里值得注意的关键点全部拆开讲一遍想直接拿去跑起来的同学也能照着做。1. 项目价值与选型思考1.1 高校竞赛业务的真实痛点竞赛管理这个场景在高校信息化里一直被低估。表面上看是发通知、收名单、评作品实际跑起来全是细节一个学校一年几十项赛事覆盖校级、省级、国家级每个赛事的报名时间、参赛资格、评审规则都不一样学生需要组队队伍里跨学院、跨年级是常态队长和成员的管理权限得分开作品提交环节涉及文件格式、大小限制、截止时间评审阶段要避免人情分需要多评委独立打分再汇总。这些需求堆在一起如果靠人工登记和Excel流转光是核对报名信息就能让人崩溃。竞赛平台要解决的本质上不是公告发布这种单点功能而是一条从赛事创建到成绩落库的可追溯流程。我见过很多做了一半的项目竞赛列表做得很漂亮结果报名模块用一张表硬扛所有报名方式team和individual不区分评审模块直接空着。这种系统交付到学校业务方用一周就会放弃。所以设计这套系统时我的出发点不是把功能写全而是把竞赛这件事的主干流程立住赛事维护是源头报名是入口队伍和作品是过程评审和成绩是出口。围绕这条主线做模块划分再往每个模块里填充细节。1.2 为什么锁定SpringBootVueMyBatisMySQL技术选型这件事我见过不少项目死在过度架构上。一个课程设计级别的系统上来就配微服务、上消息队列、搞分布式事务最后交付时连本地都跑不利索。这一套源码锁定SpringBootVueMyBatisMySQL核心原因是这四个组件组合的容错率极高适合绝大多数高校场景。SpringBoot的优势不用多吹自动配置、内嵌Tomcat、生态成熟一个school-competition.jar打出来服务器上直接就能跑对运维能力普遍薄弱的高校信息中心来说是最省心的方案。Vue这边组件化开发让后台管理页面的复用成本低很多列表页、表单页、弹窗组件抽出来之后新增一个管理模块的边际成本非常小。MyBatis在复杂查询上比JPA顺手得多竞赛系统里报表统计、条件筛选、多表联查都是高频操作写在XML里能把SQL看得清清楚楚。MySQL就更不用说了部署简单、文档丰富、DBA人才好找专科院校到双一流都适用。这四样东西组合起来还有一个隐性优势网上可找到的解决方案密度极高。接手这套源码的二次开发人员遇到问题搜一下就能找到答案不用在冷门框架上浪费时间。我一直觉得能给团队或者学弟学妹降低接手成本的技术栈才是高校项目里最合适的技术栈。2. 系统功能模块与数据库落地2.1 核心功能模块拆解整套系统按角色和业务维度划分为四大模块域每个模块域里再做细化。基础管理域用户管理、角色管理、菜单权限管理。这部分就是标准的RBAC模型用户表、角色表、菜单表、用户角色关联表、角色菜单关联表。实际项目里学生会用学号登录老师用工号登录系统管理员是预置账号。菜单权限不要求做到按钮级别但至少要保证不同角色登录后看到的左侧导航不一样——这个需求前端通过路由守卫配合后端返回的菜单列表就能实现。竞赛业务域这是系统的核心。竞赛分类、竞赛信息发布、赛事公告、报名管理、组队管理、作品提交。竞赛分类可以做成多级比如学科竞赛-电子信息类-全国大学生电子设计竞赛。竞赛信息里要有详细的赛事介绍、参赛对象、报名开始时间、报名截止时间、作品提交截止时间、奖项设置以及附带的报名材料模板下载。报名管理要区分个人赛和团队赛个人赛直接报名团队赛需要先创建队伍再报名。组队管理包括队长创建队伍、邀请成员、成员确认、队伍人数控制这块的实际交互最多。评审计分域评审分配、在线打分、成绩汇总、奖项设置。评审分配可以做成管理员按竞赛批次分配评委也可以做成评委自选。打分环节要考虑多个评审维度比如创新性、完成度、文档规范性每个维度权重不同。成绩汇总要支持去掉最高分最低分取平均或者直接平均分这个规则可以在竞赛配置里定义。奖项设置要能支持按比例排出一二三等奖。统计展示域参赛人数统计、学院参赛排行、作品类型分布、历年成绩对比。统计页建议用图表呈现前端用ECharts后端提供聚合查询接口。跑通统计模块系统从工具变成平台的价值就出来了这也是答辩或者汇报时最能打动人的部分。2.2 数据库表设计与建模要点数据库设计是这套源码的骨架我建表时坚持几个原则核心业务表都带create_time和update_time状态字段一律用tinyint并加注释避免魔法数字所有业务表必须有主键但拒绝无意义的自动增长作为唯一依赖业务唯一标识用单独的字段比如competition_no。竞赛主表competition_info大致长这样id、competition_no、title、category_id、level校级/省级/国家级、description、cover、type个人赛/团队赛/混合赛、register_start_time、register_end_time、submit_start_time、submit_end_time、status、create_time、update_time。报名字段competition_registerid、competition_id、user_id、team_id、member_count、status待审核/通过/驳回、register_time。这里一个核心约束是同一用户对同一竞赛只能有一条有效报名记录所以要在competition_id和user_id上建唯一索引否则并发点击会导致重复报名。队伍表team_infoid、competition_id、team_name、captain_id、member_limit、status、create_time。队名在同一个竞赛里要唯一建唯一索引时把competition_id和team_name一起放进去。队伍成员表team_memberid、team_id、user_id、role队长/成员、join_time。成员表设计的关键是队长必须同时在team_info和team_member里都有记录这样查询成员列表时逻辑才能统一。评审相关的表更需要仔细设计。评审表review_assignid、competition_id、reviewer_id、work_id、status。评分表score_recordid、review_assign_id、dimension_id、score、comment。评分维度表score_dimensionid、competition_id、dimension_name、weight。这三张表构成完整的评审模型评审分配的幂等性要靠reviewer_id和work_id的唯一索引来保证。2.3 表关系与权限设计的坑表关系上最容易出问题的是一对多和多对多的界限。一个竞赛下有多个公告是一对多一个用户可以属于多个角色是多对多一个用户可以创建多个队伍但同一时间只能在一个队里这个业务上的唯一性不能靠数据库关系表达必须在应用层做校验。我在注册、组队、报名这几个接口里都加了防重判断先查再插的方式在普通并发下够用真要加锁就锁竞赛ID级别不建议直接锁表。权限设计走RBAC但在用户表里加了一个user_type字段区分学生和教师配合角色表来用。原因是很多业务规则依赖身份类型比如学生可以报名参赛教师可以作为指导教师或者评委。如果全部走角色判断代码里会多出很多hasRole的判断反而麻烦。一个user_type字段配合必要的角色判断多数情况下更高效。3. 前后端核心实现与实操细节3.1 后端SpringBoot业务闭环怎么写后端代码组织我习惯按controller-service-mapper-pojo四层来controller只做参数接收和返回封装业务逻辑全部下沉到serviceservice里接口和实现分离。这种写法对后期维护价值很大比如报名模块抽一个CompetitionRegisterService接口实现类里处理报名校验、数据写入、通知公告这三个步骤新需求加实现方法而不用动controller。登录认证用的是JWT。实现要点是登录成功后把用户ID、用户名、用户类型放进token设置适当的过期时间生产环境建议2小时前端在请求头带Authorization: Bearer token。JWT的坑在于服务端无法主动让token失效如果遇到用户被禁用的情况只能等token自然过期。解决思路是在用户表加一个token_version字段JWT里带上这个版本号修改密码、禁用用户时递增版本号老token就被动失效了。这个技巧课程设计一般不会写但企业级系统里是刚需。报名接口的核心代码如下看起来简单实际上有个重要细节报名事务里同时包含了状态检查和数据插入必须加Transactional注解来保证一致性。Transactional(rollbackFor Exception.class) public Long register(RegisterRequest request) { Competition competition competitionMapper.selectById(request.getCompetitionId()); if (competition null) { throw new BusinessException(竞赛不存在); } if (LocalDateTime.now().isBefore(competition.getRegisterStartTime()) || LocalDateTime.now().isAfter(competition.getRegisterEndTime())) { throw new BusinessException(不在报名时间范围内); } Register register new Register(); register.setCompetitionId(request.getCompetitionId()); register.setUserId(LoginUserHolder.getUserId()); register.setStatus(0); registerMapper.insert(register); return register.getId(); }文件上传这边作品提交是最常见的高频操作。后端接口接收MultipartFile存储路径建议配置在application.yml里不要写死。本地存储方案要处理文件名重复问题用UUID重命名后再存储原始文件名单独存到数据库字段下载时做一次映射。3.2 前端Vue页面组织与接口对接前端技术栈是Vue全家桶加Element UI。项目目录我按功能模块划分src/api放接口请求封装每个业务模块一个JS文件src/views放页面组件src/router维护路由表src/utils放axios实例和工具函数。axios实例是全局统一的关键配置有两处请求拦截器加token响应拦截器统一处理错误码和401跳转。我在实际项目里见过太多前端同学每个请求单独发token、单独处理错误然后代码到处重复的情况。axios实例配好之后所有请求自动带凭证省心很多。// 响应拦截器核心逻辑 service.interceptors.response.use( response { const res response.data if (res.code ! 200) { Message.error(res.message) return Promise.reject(new Error(res.message)) } return res }, error { if (error.response.status 401) { // 清除token并跳转登录页 localStorage.removeItem(token) router.push(/login) } Message.error(接口调用异常) return Promise.reject(error) } )列表页用Element UI的el-table加分页组件是标配。有个经验值得分享表格的列不要全部由后端返回的字段名直接渲染建议在页面里维护一个columns配置数组把标题、字段、宽度、格式化函数统一管理。后续改列名、加列、调宽度只需要改配置不用在模板里反复查找。3.3 核心业务场景从报名到评审的完整数据流系统里最重要的一个业务闭环是学生在竞赛详情页看到报名中状态点击报名后如果是团队赛则跳转到组队页面队长创建队伍后邀请成员成员同意后才算组队成功队伍人数达到参赛要求后才可以提交报名管理员在后台审核报名审核通过后队伍处于可提交作品状态作品提交截止后管理员分配评委评委打分结束后系统按配置好的规则汇总成绩生成排名。这里有个容易忽略的细节报名状态和组队状态必须分离。团队赛中队伍已满员和报名已通过是两个独立的状态满员只是满足报名前置条件审核通过才是报名流程真正的终点。如果状态字段设计得不够细后续评审阶段哪些队伍可以评就会变得很难判断。我的做法是team_info.status维护队伍生命周期组建中、已满员、已报名、已通过、已驳回competition_register.status只维护报名审核状态待审核、通过、驳回两套状态通过关联查询得出当前阶段的业务状态。评审阶段的数据流同样需要仔细考虑。管理员批量分配评审时要校验评委和作品的对应关系防止同一评委被分配到同一作品多次评委打分接口要拦截截止时间逾期不能打分成绩汇总服务要按竞赛ID查询所有评分记录按配置好的规则聚合这里用MyBatis写一个带条件判断的统计SQL非常顺手。select idselectScoreSummary resultTypemap SELECT work_id, SUM(score * weight) AS total_score FROM score_record r LEFT JOIN score_dimension d ON r.dimension_id d.id WHERE r.competition_id #{competitionId} GROUP BY work_id ORDER BY total_score DESC /select4. 部署上线与常见问题排查4.1 一套可复现的从本地到服务器部署流程部署这件事我在项目里也算踩了不少坑。整套流程其实可以固化成标准步骤按这几步走基本不会出错。第一步打包后端。在项目根目录执行mvn clean package -DskipTests注意要用Maven的package而不是直接跑SpringBoot的插件bootJar如果pom里配置了finalNameJAR包名会固定下来避免每次版本变化导致启动脚本要改动。打包完成后在target目录拿到可执行JAR。第二步初始化数据库。把源码里的schema.sql在MySQL里执行一遍创建数据库时字符集选utf8mb4排序规则选utf8mb4_general_ci原因是对中文和表情符号的支持更完整。编码问题在高校系统里极易出现报名信息里带个少数民族姓名、指导教师备注里有个特殊字符用utf8mb4几乎不会出乱码。第三步配置后端。修改application.yml里的数据库连接串、文件上传路径、JWT密钥。服务器上数据库密码不要明文写在配置文件里如果条件允许用环境变量注入spring.datasource.password: ${DB_PASSWORD}在启动命令里通过--DB_PASSWORDxxx传入。第四步打包前端。npm run build生成dist目录然后配置Nginx把静态目录指向dist并把/api路径反向代理到后端服务的端口。server { listen 80; server_name your-domain.com; location / { root /var/www/competition/dist; index index.html; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }第五步配置后端守护进程。直接java -jar跑是方便但对生产环境不友好偶发报错或者服务器重启后进程就没了。用systemd管理是Linux下比较标准的做法。创建一个competition.service文件放在/etc/systemd/system/下内容大致是ExecStart/usr/bin/java -jar /opt/competition/school-competition.jar加上Restartalways。配置好后systemctl daemon-reload systemctl start competition以后开机自启、崩溃重启都自动处理了。4.2 高频报错与解决办法实录系统跑起来后一定会有各种报错。下面这五个是我在调试这类系统时遇到频率最高的每条都附上排查思路。MySQL连接报Public Key Retrieval is not allowed这个在MySQL 8.0连接时非常常见。解决办法是JDBC连接串加allowPublicKeyRetrievaltrue同时确认使用了useSSLfalse组合起来才能稳定连接。跨域请求报403或者response里没有Access-Control-Allow-Origin这是前后端分离最容易踩的坑。解决办法有两种一是后端在SpringBoot里配置CorsFilter指定允许的前端地址二是让前端统一走反向代理把跨域问题交给Nginx处理生产环境这套源码就是走Nginx的方案本地联调时用后端CORS配置。MyBatis的XML文件扫描不到导致启动报Invalid bound statement这属于配置问题。检查两处MapperScan的包路径是否正确以及application.yml里mybatis.mapper-locations是否指向了classpath:mapper/*.xml。Maven打包时如果XML文件没有被打进JAR检查pom里build-resources配置把src/main/resources显式声明进去。Vue打包部署后刷新页面404这个问题很多新手会蒙。原因是前端路由用了History模式刷新时Nginx找不到对应的物理文件。解决办法就是Nginx配置里已经写好的那行try_files $uri $uri/ /index.html把路由请求全部重写到index.html。文件上传成功但在服务器上找不到文件多半是路径的问题。本地Windows路径和服务器Linux路径不兼容配置文件里写绝对路径最靠谱比如/data/competition/upload并确保该目录存在且运行JAR的用户有读写权限。不要用相对路径JAR在不同的启动目录下相对路径解析不一致。下面把高频问题和配套解法整理成一张速查表方便排查时对照。表格只列场景和思路具体代码路径在源码注释里都有。现象直接原因解决思路前端请求接口不通后端地址未配置或CORS拦截检查Nginx代理配置或后端加CORS配置表单提交中文乱码数据库字符集不正确库表统一改成utf8mb4连接串加characterEncodingutf8同一队伍重复报名唯一索引缺失在competition_idteam_id建唯一索引评审分配重复评审记录幂等性不足在reviewer_idwork_id建唯一索引JAR启动后端口被占用内嵌Tomcat端口冲突修改server.port或杀掉占用进程打包后XML不生效Maven资源过滤配置缺失在pom配置build-resources包含XML文件4.3 初次启动源码的完整校验清单拿到源码后不要急着改代码先按校验清单把整个流程跑通。第一步本地装好JDK 8、Maven 3.6、Node.js 14、MySQL 5.7这几个基础环境版本不匹配后面会非常痛苦。我用的是JDK 8配合SpringBoot 2.3.xNode 14配合Vue 2.6二进制版本依赖这个组合已经实测过很多次非常稳定。第二步导入数据库脚本。源码根目录一般会有一个sql/init.sql或者sql/schema.sql执行后检查一下核心表的数量。第三步修改本地配置启动后端。观察启动日志确认没有报错看到Started Application in xx seconds就说明后端起来了。第四步进入前端目录执行npm install这一步如果卡在下载包可以换用淘宝镜像源安装完成后npm run serve启动开发模式访问本地的8080端口看能不能正常登录。我们在这套源码的交付文档里专门强调过如果能按顺序把登录、建赛、报名、组队、提交、评审、出分这七个动作完整走一遍这套系统在你的环境里就基本通了。之后再改业务代码出问题也知道是改出来的不是环境问题。5. 从能跑到好用源码改造与扩展建议5.1 课程设计级到企业级的差距在哪很多同学拿到源码后会问这套东西我交毕业设计够不够我的回答是如果只是跑通流程完成度已经相当高了但如果目标是让学校真正持续用起来还有几个地方值得花时间改造。第一个改动是引入Redis做缓存。竞赛分类、公告列表这些变化频率低的数据每次请求都打MySQL很浪费。用SpringCache配合Redis做简单缓存配置五分钟过期时间效果立竿见影。注意要保证缓存一致性在更新公告、竞赛信息的Service方法上加CacheEvict注解避免用户在列表页看到旧数据。第二个改动是文件存储替换。本地磁盘存储在小规模使用场景没问题但并发提交作品的高峰期读取、备份、迁移都是事。建议把上传组件改造为对接MinIO这是一个开源的分布式对象存储服务部署起来和MySQL一样容易对接方式和OSS、云存储几乎一样。改造涉及Service层和配置项前端接口不用动。第三个改动是增加定时任务。竞赛结束时间、报名截止时间这些节点系统只是被动地判断时间是否过期是不够的最好增加一个定时任务每天扫描竞赛状态把已过期的竞赛自动置为已结束并发送站内通知。用SpringBoot自带的Scheduled就能做不用引入额外的框架。第四个改动是审计日志。谁在什么时间改了评审结果、谁删除了报名记录这些操作在正式运营时是必须要查的。做法是在关键Service方法上用AOP切面记录操作日志或者更简单地维护一张operation_log表业务代码里手动记录关键操作类型、操作人、操作对象、操作内容、时间。这条看起来不显眼但真出问题要追溯数据时比什么都管用。5.2 我个人实操中的三点体会做到这一步我分享三个在多次实操中积累下来的个人经验。一是别在前期过度设计权限。很多同学一开始就想着把RBAC做得很复杂按钮权限、数据权限、接口权限全都上结果业务做不出来。竞赛管理系统实际使用中角色就那么几种把菜单权限控制好、接口做好登录拦截就够了。权限体系暴露出的问题通常是后期加功能时才出现到时候按需扩展反而更清晰。二是字段命名统一规范带来的收益被严重低估。这套源码里所有主键都叫id所有时间字段都叫create_time/update_time所有状态都叫status。看起来是约定俗成的小事但在做多表关联、写通用Mapper的时候会节省大量时间尤其当系统表数量超过二十张以后命名的混乱会直接转化为排查问题的成本。三是事务边界一定要画清楚。注册、组队、报名、分配评审这几个操作都是跨多表的写操作必须加上事务。但也别把不该放进来的操作塞进事务里比如上传文件这种耗时操作文件写入和数据库记录更新就不该放在同一个事务里否则文件系统故障会导致数据库回滚或者数据库事务长时间持有连接。我习惯的做法是先传文件得到存储路径再开事务把路径写入数据库。这套源码的扩展方向还可以有很多比如对接学校统一身份认证、增加移动端H5报名入口、接入企业微信消息通知。不管往哪个方向改只要主干业务保持清晰权限边界划分明确后续的迭代都不会太痛苦。如果你们学校正在选型或者你们项目组正在评估类似系统我的建议是先把完整流程跑通再结合实际业务场景逐步打磨细节这套代码作为起点已经完全够用。
)
