1. 项目背景与核心需求
校园竞赛管理系统是高校信息化建设中的重要组成部分。随着各类学科竞赛、创新创业大赛在高校中的普及，传统的人工管理方式已经无法满足日益增长的赛事组织需求。教务部门经常面临报名信息混乱、评审流程不透明、成绩统计效率低下等问题。
这个系统需要解决的核心痛点包括：
- 多角色协同管理（学生、教师、管理员）
- 线上报名与材料提交
- 自动化评审流程
- 实时成绩统计与公示
- 历史数据归档与分析
我去年为某211高校开发的这套系统，上线后使竞赛管理工作效率提升了60%，报名错误率从15%降至3%以下。下面分享具体实现方案中的关键技术选型和架构设计。
2. 技术栈选型分析
2.1 后端技术组合
选择SpringBoot作为后端框架主要基于：
- 自动配置特性：通过spring-boot-starter-web快速构建RESTful API
- 内嵌Tomcat：无需额外部署Servlet容器
- 与MyBatis的完美集成：通过mybatis-spring-boot-starter实现
- 丰富的生态：Spring Security用于认证授权，Spring Schedule用于定时任务
数据库选用MySQL 8.0考虑点：
- 高校IT部门普遍具备MySQL运维能力
- JSON字段支持便于存储动态表单数据
- 窗口函数简化排行榜统计查询
2.2 前端技术方案
Vue 3组合式API的优势体现：
javascript复制// 竞赛列表页示例
const competitions = ref([])
const pagination = reactive({
page: 1,
size: 10,
total: 0
})
onMounted(async () => {
const res = await getCompetitions(pagination)
competitions.value = res.data.records
pagination.total = res.data.total
})
对比React和Angular，Vue更适合高校场景：
- 学习曲线平缓，学生开发者容易上手
- 模板语法更接近原生HTML，方便教师参与维护
- Element Plus组件库提供完善的Admin模板
3. 系统架构设计
3.1 整体架构图
code复制[前端] Vue3 + Element Plus + Axios
↓
[网关] Nginx反向代理 + JWT校验
↓
[后端] SpringBoot + MyBatis + Redis
↓
[存储] MySQL主从集群 + MinIO文件存储
3.2 数据库关键表设计
sql复制CREATE TABLE `competition` (
`id` bigint NOT NULL AUTO_INCREMENT,
`name` varchar(100) NOT NULL COMMENT '竞赛名称',
`description` text COMMENT '竞赛说明',
`signup_start` datetime NOT NULL COMMENT '报名开始时间',
`signup_end` datetime NOT NULL COMMENT '报名结束时间',
`max_team_members` int DEFAULT '5' COMMENT '最大团队成员数',
`status` tinyint DEFAULT '0' COMMENT '0未开始 1报名中 2进行中 3已结束',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-- 团队表、用户表、评审表等约15张核心表
4. 核心功能实现细节
4.1 动态表单引擎
为适应不同竞赛的报名字段需求，实现动态表单配置：
java复制// FormConfig实体类
@Data
public class FormConfig {
private Long competitionId;
private String formItems; // JSON存储字段配置
private LocalDateTime createTime;
}
// 前端通过v-for渲染动态表单
<el-form-item
v-for="item in formConfig"
:key="item.field"
:label="item.label"
:prop="item.field"
>
<component
:is="getComponent(item.type)"
v-model="formData[item.field]"
/>
</el-form-item>
4.2 评审流程状态机
使用状态模式实现多阶段评审：
java复制public interface ReviewState {
void handle(ReviewContext context);
}
@Component
@Scope("prototype")
public class InitialState implements ReviewState {
@Override
public void handle(ReviewContext context) {
if (context.getAction().equals("SUBMIT")) {
context.setState(applicationContext.getBean(PreliminaryReviewState.class));
// 触发邮件通知评审专家
}
}
}
5. 性能优化实践
5.1 缓存策略
采用多级缓存提升并发处理能力：
- 本地Caffeine缓存热点数据（如竞赛基础信息）
- Redis集群缓存排行榜等高频访问数据
- MySQL查询优化：为status字段添加复合索引
5.2 文件处理优化
使用MinIO分布式存储解决文件上传瓶颈：
- 前端采用分片上传（每片5MB）
- 后端通过MD5校验实现断点续传
- 图片类资源自动生成缩略图
6. 安全防护措施
6.1 防SQL注入
MyBatis严格使用参数化查询：
xml复制<select id="selectByCondition" resultMap="BaseResultMap">
SELECT * FROM competition
WHERE status = #{status}
<if test="name != null">
AND name LIKE CONCAT('%',#{name},'%')
</if>
</select>
6.2 权限控制
基于RBAC模型的权限设计：
java复制@PreAuthorize("hasRole('ADMIN') or "
+ "(hasRole('TEACHER') and @competitionService.isOrganizer(#compId, principal.username))")
@PostMapping("/{compId}/announcement")
public Result publishAnnouncement(@PathVariable Long compId) {
// ...
}
7. 部署方案
7.1 容器化部署
Docker Compose编排方案：
yaml复制version: '3'
services:
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
volumes:
- ./mysql/data:/var/lib/mysql
backend:
build: ./backend
ports:
- "8080:8080"
depends_on:
- mysql
7.2 监控配置
Prometheus + Grafana监控看板包含：
- JVM内存使用情况
- MySQL连接池状态
- API接口响应时间P99
8. 典型问题解决方案
8.1 并发报名问题
使用分布式锁防止团队名额超限：
java复制public boolean joinTeam(Long teamId, Long userId) {
String lockKey = "team:lock:" + teamId;
try {
// 尝试获取锁，有效期30秒
Boolean locked = redisTemplate.opsForValue()
.setIfAbsent(lockKey, "1", 30, TimeUnit.SECONDS);
if (Boolean.TRUE.equals(locked)) {
// 查询当前人数
Integer count = teamMapper.selectMemberCount(teamId);
// 校验并添加成员
}
} finally {
redisTemplate.delete(lockKey);
}
}
8.2 跨学期数据迁移
采用Flyway管理数据库变更：
sql复制-- V20230501__add_year_column.sql
ALTER TABLE competition ADD COLUMN year varchar(10) NOT NULL DEFAULT '2023';
这套系统在实际运行中，单服务器可支撑5000+师生同时在线操作。关键点在于合理使用缓存、优化数据库查询以及做好接口限流。对于高校场景，还需要特别注意与现有教务系统的数据对接，通常需要通过中间表进行数据同步。