一、 项目背景与意义

在高校教育体系中，学科竞赛是培养学生创新实践能力、团队协作精神和解决复杂问题能力的重要途径。然而，传统的竞赛管理模式普遍存在以下痛点：

• 信息孤岛：竞赛通知、组队信息、作品提交分散在各个学院网站、QQ群或微信群，信息传递效率低，容易遗漏。
• 组队困难：学生难以跨专业、跨年级找到志同道合、技能互补的队友，团队组建过程耗时耗力。
• 流程繁琐：从报名、中期检查、作品提交到最终评审，涉及大量纸质或零散电子文档，管理成本高，透明度不足。
• 缺乏协同：团队成员间文档共享、任务分工、进度同步缺乏统一平台，沟通成本高，影响项目推进效率。

因此，构建一个集竞赛信息发布、智能组队匹配、全流程在线管理、团队协同办公于一体的综合性平台，具有重要的现实意义。它不仅能提升竞赛管理的规范化与信息化水平，更能优化学生的参赛体验，促进跨学科交流与合作，最终服务于高校创新人才培养的根本目标。

二、 技术栈选型与架构

本项目采用前后端分离的架构模式，后端基于 SpringBoot 快速构建，前端使用现代化框架，确保系统的高性能、可扩展性与良好的开发体验。

2.1 后端技术栈 (Backend)

• 核心框架：Spring Boot 2.7.x / 3.x，提供自动配置、快速启动能力。
• Web 框架：Spring MVC，处理 HTTP 请求与响应。
• 数据持久层：
  • ORM：MyBatis-Plus，极大简化 CRUD 操作，内置分页、代码生成器等实用功能。
  • 数据库：MySQL 8.0，存储核心业务数据。
  • 缓存：Redis，用于会话管理、热点数据缓存（如竞赛信息、首页榜单）。
• 安全与权限：
  • 认证授权：Spring Security + JWT (JSON Web Token)，实现无状态登录与细粒度权限控制（学生、队长、评委、管理员）。
  • 密码加密：BCryptPasswordEncoder。
• 消息队列：RabbitMQ / RocketMQ，用于异步处理任务（如发送组队成功通知、系统公告）。
• 文件存储：MinIO / 阿里云 OSS，用于存储竞赛附件、团队作品、头像等文件。
• API 文档：SpringDoc OpenAPI 3 (Swagger UI)，便于前后端协作与接口调试。
• 其他工具：Lombok（简化POJO）、Hutool（工具集）、MapStruct（对象转换）。

2.2 前端技术栈 (Frontend)

• 框架：Vue 3 (Composition API) 或 React 18。
• 构建工具：Vite，提供极速的开发服务器启动与热更新。
• UI 组件库：Element Plus (Vue) 或 Ant Design (React)，快速搭建美观、一致的界面。
• 状态管理：Pinia (Vue) 或 Redux Toolkit (React)。
• 路由：Vue Router 或 React Router。
• HTTP 客户端：Axios，封装请求拦截器，统一处理 Token 和错误。
• 实时通信：WebSocket (可选 SockJS + STOMP)，用于团队聊天、通知实时推送。

2.3 系统架构图 (逻辑视图)

graph TD A[用户端: Web/小程序] --> B[Nginx: 反向代理/负载均衡] B --> C[前端静态资源] B --> D[后端API网关: Spring Cloud Gateway] D --> E[认证服务: Spring Security + JWT] D --> F[竞赛服务] D --> G[组队服务] D --> H[团队协同服务] D --> I[文件服务] F --> J[(MySQL: 竞赛/报名数据)] G --> J H --> J F --> K[(Redis: 缓存)] E --> K I --> L[(MinIO/OSS: 文件存储)] M[消息队列: RabbitMQ] --> N[通知服务: 邮件/站内信] style A fill:#e1f5fe style C fill:#f3e5f5 style D fill:#fff3e0 style E,F,G,H,I fill:#e8f5e8 style J,K,L fill:#ffebee style M,N fill:#fce4ec

三、 核心功能模块与代码解析

以下选取几个关键业务模块，展示其核心实现思路与代码片段。

3.1 智能组队匹配算法

业务逻辑：根据学生填写的技能标签、参赛意向、空闲时间等信息，通过算法推荐潜在队友或团队。

/** * 组队匹配服务 */ @Service @Slf4j @RequiredArgsConstructor public class TeamMatchingService { private final UserSkillMapper userSkillMapper; private final CompetitionMapper competitionMapper; /** 为当前用户寻找匹配的队友 @param userId 当前用户ID @param competitionId 竞赛ID @return 匹配度最高的前N个用户列表 */ public List<MatchUserVO> findTeammates(Long userId, Long competitionId, int topN) { // 1. 获取当前用户的技能标签和参赛偏好 UserSkill currentUserSkill = userSkillMapper.selectByUserId(userId); Competition competition = competitionMapper.selectById(competitionId); // 2. 查询所有报名了同一竞赛且尚未组队完成的用户 List<UserSkill> candidateSkills = userSkillMapper.selectCandidatesByCompetition(competitionId, userId); // 3. 计算匹配度 (简化版：基于技能标签余弦相似度) List<MatchUserVO> matchedList = candidateSkills.stream() .map(candidate -> { MatchUserVO vo = new MatchUserVO(); vo.setUserId(candidate.getUserId()); vo.setUserName(candidate.getUser().getNickName()); vo.setSkillTags(candidate.getTags()); // 计算匹配分数 double score = calculateMatchingScore(currentUserSkill.getTags(), candidate.getTags()); vo.setMatchScore(score); return vo; }) .sorted(Comparator.comparing(MatchUserVO::getMatchScore).reversed()) // 按匹配分降序 .limit(topN) .collect(Collectors.toList()); return matchedList; } /** 计算技能标签匹配度 (余弦相似度简化版) */ private double calculateMatchingScore(List<String> tags1, List<String> tags2) { if (tags1 == null || tags2 == null || tags1.isEmpty() || tags2.isEmpty()) { return 0.0; } // 取交集 Set<String> intersection = new HashSet<>(tags1); intersection.retainAll(tags2); // 简化计算：交集数量 / 平均标签数 double avgSize = (tags1.size() + tags2.size()) / 2.0; return avgSize > 0 ? intersection.size() / avgSize : 0; } }

3.2 竞赛全流程状态机

业务逻辑：管理竞赛从创建、报名、进行中、提交作品到评审结束的全生命周期，确保状态流转的合法性与一致性。

/** * 竞赛状态枚举与状态机 */ public enum CompetitionStatus { DRAFT("草稿"), PUBLISHED("已发布，可报名"), REGISTERING("报名中"), IN_PROGRESS("进行中"), SUBMISSION("作品提交期"), REVIEWING("评审中"), FINISHED("已结束"), CANCELED("已取消"); private final String desc; CompetitionStatus(String desc) { this.desc = desc; } } /** 竞赛状态变更服务 / @Service @Slf4j public class CompetitionStateService { /* 尝试变更竞赛状态 @param competitionId 竞赛ID @param targetStatus 目标状态 @param operator 操作人 @return 是否成功 / @Transactional(rollbackFor = Exception.class) public boolean transitionStatus(Long competitionId, CompetitionStatus targetStatus, String operator) { Competition competition = competitionMapper.selectById(competitionId); CompetitionStatus current = competition.getStatus(); // 状态机校验 if (!isValidTransition(current, targetStatus)) { log.warn("非法状态流转: {} -> {}, 操作人: {}", current, targetStatus, operator); throw new BusinessException("当前状态不允许变更为目标状态"); } // 执行状态变更前置操作 beforeStatusChange(competition, targetStatus); // 更新状态 competition.setStatus(targetStatus); competition.setUpdateTime(LocalDateTime.now()); competitionMapper.updateById(competition); // 记录状态变更日志 logStatusChange(competitionId, current, targetStatus, operator); // 触发后置事件 (如：状态变为进行中时，通知所有报名团队) afterStatusChange(competition, targetStatus); return true; } /* 定义合法的状态流转规则 */ private boolean isValidTransition(CompetitionStatus from, CompetitionStatus to) { switch (from) { case DRAFT: return to == PUBLISHED || to == CANCELED; case PUBLISHED: return to == REGISTERING || to == CANCELED; case REGISTERING: return to == IN_PROGRESS || to == CANCELED; case IN_PROGRESS: return to == SUBMISSION; case SUBMISSION: return to == REVIEWING; case REVIEWING: return to == FINISHED; // FINISHED 和 CANCELED 为终态，不可再变 default: return false; } } // ... 其他方法：beforeStatusChange, afterStatusChange, logStatusChange }

3.3 团队协同：任务管理与文件共享

业务逻辑：团队内创建任务、分配负责人、更新进度，并共享项目相关文档。

/** * 团队任务控制器 */ @RestController @RequestMapping("/api/team/task") @RequiredArgsConstructor public class TeamTaskController { private final TeamTaskService teamTaskService; /** 创建团队任务 */ @PostMapping @PreAuthorize("@permissionCheck.isTeamMember(#request.teamId)") public R<Long> createTask(@RequestBody @Valid TaskCreateRequest request) { Long taskId = teamTaskService.createTask(request); return R.ok(taskId); } /** 更新任务进度 / @PutMapping("/{taskId}/progress") @PreAuthorize("@permissionCheck.isTaskAssignee(#taskId)") public R<Void> updateProgress(@PathVariable Long taskId, @RequestParam Integer progress) { teamTaskService.updateProgress(taskId, progress); return R.ok(); } } /* 文件上传与共享服务 / @Service @Slf4j public class FileShareService { private final MinioClient minioClient; private final FileRecordMapper fileRecordMapper; /* 上传团队共享文件 */ public FileUploadVO uploadTeamFile(MultipartFile file, Long teamId, Long uploaderId) throws Exception { // 1. 生成唯一文件名，避免冲突 String originalFilename = file.getOriginalFilename(); String fileExtension = originalFilename.substring(originalFilename.lastIndexOf(".")); String objectName = "team/" + teamId + "/" + UUID.randomUUID() + fileExtension; // 2. 上传至 MinIO minioClient.putObject( PutObjectArgs.builder() .bucket("competition-platform") .object(objectName) .stream(file.getInputStream(), file.getSize(), -1) .contentType(file.getContentType()) .build() ); // 3. 保存文件记录到数据库 FileRecord record = new FileRecord(); record.setTeamId(teamId); record.setUploaderId(uploaderId); record.setOriginalName(originalFilename); record.setStoragePath(objectName); record.setFileSize(file.getSize()); record.setFileType(fileExtension); fileRecordMapper.insert(record); // 4. 返回访问信息 FileUploadVO vo = new FileUploadVO(); vo.setFileId(record.getId()); vo.setFileName(originalFilename); vo.setFileUrl(generatePresignedUrl(objectName)); // 生成临时访问链接 return vo; } // ... 生成预签名URL等方法 }

四、 总结与展望

基于 SpringBoot 的大学生竞赛全流程与组队协同平台，通过整合现代 Web 开发技术栈，能够有效解决传统竞赛管理中的诸多痛点。其核心价值在于：

• 流程标准化：通过状态机驱动，规范竞赛生命周期管理。
• 协作高效化：提供任务、文件、通信一体化协同空间，提升团队生产力。
• 匹配智能化：利用算法降低组队成本，促进优质团队的形成。
• 数据可视化：为管理者提供数据看板，辅助决策。

未来可扩展方向包括：集成 AI 能力进行智能项目拆解与任务推荐、增加在线代码协作环境、与学校教务系统深度对接实现学分自动认定、开发微信小程序以提升移动端体验等。本项目不仅是一个软件系统，更是高校创新创业教育生态数字化升级的一次有益实践。