1. 项目概述与核心价值这个基于SpringBootVue3的学生竞赛报名管理系统是我去年为本地高校开发的一个实战项目。系统上线后成功支撑了全校12个院系、累计3000人次的竞赛报名工作将原本需要3天完成的报名流程压缩到2小时内完成。传统纸质报名方式存在信息收集慢、数据易丢失、统计困难等问题。我们设计的这套系统实现了从竞赛发布、学生报名、材料提交到成绩管理的全流程数字化。特别在跨院系联合竞赛场景下系统通过院系权限隔离和自动数据汇总功能解决了以往需要人工对接的痛点。2. 技术架构设计2.1 前后端分离架构系统采用经典的前后端分离模式前端Vue3 TypeScript Element Plus后端SpringBoot 2.7 MyBatis-Plus数据库MySQL 8.0读写分离部署选择Vue3而非Vue2主要考虑Composition API更适合复杂业务逻辑组织更好的TypeScript支持性能提升打包体积减少41%2.2 核心功能模块graph TD A[竞赛管理] -- B[发布竞赛] A -- C[报名审核] D[学生端] -- E[在线报名] D -- F[材料上传] G[评审管理] -- H[成绩录入] G -- I[获奖统计]注实际开发中我们使用PlantUML绘制架构图此处仅为示意3. 关键技术实现3.1 动态表单引擎为适应不同竞赛的报名需求我们开发了动态表单系统// 表单配置实体 public class FormConfig { private Long id; private String formName; private ListFormItem items; // 表单项列表 } // 表单项基类 public abstract class FormItem { private String label; private String fieldName; private Boolean required; // 公共校验逻辑... }具体实现时使用策略模式处理不同类型表单项文本/文件/单选等前端通过JSON Schema渲染表单提交数据采用差异化存储设计3.2 文件上传优化针对作品提交场景的特殊处理分块上传前端使用vue-simple-uploader文件校验格式白名单病毒扫描调用ClamAV存储策略小文件直接MySQL5MB大文件MinIO分布式存储// 前端上传组件关键配置 const uploader new Uploader({ target: /api/upload/chunk, chunkSize: 5 * 1024 * 1024, testChunks: true, maxChunkRetries: 3 })4. 权限系统设计4.1 RBAC模型扩展在标准RBAC基础上增加数据权限按院系隔离临时权限竞赛负责人特殊权限操作日志审计追踪权限表结构设计CREATE TABLE sys_role ( id bigint NOT NULL AUTO_INCREMENT, role_name varchar(50) NOT NULL, data_scope tinyint COMMENT 1-全部 2-本院系 3-自定义, PRIMARY KEY (id) );4.2 JWT优化方案安全增强措施双Token机制access_token refresh_token指纹校验前端生成设备指纹敏感操作二次验证登录流程时序图sequenceDiagram 用户-前端: 输入账号密码 前端-后端: 认证请求带设备指纹 后端---前端: 返回双token 前端-前端: 存储token内存HttpOnly Cookie5. 性能优化实践5.1 报名高峰应对实测数据在2000人同时报名时初始方案平均响应时间1.2s错误率8%优化后平均响应时间300ms错误率0.1%具体措施数据库添加报名记录分表按竞赛ID哈希热点数据Redis缓存接口提交接口异步化采用令牌桶限流前端请求队列控制失败自动重试5.2 报表生成优化对比三种方案性能方案1000条数据耗时内存占用POI直接导出12s800MBEasyExcel3s100MB预生成缓存0.5s50MB最终采用EasyExcel定时预生成方案// 使用注解定义导出模型 Data public class ExportModel { ExcelProperty(学号) private String studentId; ExcelProperty(姓名) private String name; ExcelProperty(value 提交时间, converter LocalDateTimeConverter.class) private LocalDateTime submitTime; }6. 部署方案6.1 容器化部署Docker Compose编排文件关键部分services: backend: image: registry.cn-hangzhou.aliyuncs.com/edu/competition:1.2.0 environment: - SPRING_PROFILES_ACTIVEprod deploy: resources: limits: cpus: 2 memory: 2G frontend: image: nginx:1.23-alpine volumes: - ./dist:/usr/share/nginx/html ports: - 80:806.2 监控方案Prometheus监控指标配置示例- job_name: springboot metrics_path: /actuator/prometheus static_configs: - targets: [backend:8080] relabel_configs: - source_labels: [__address__] target_label: instance regex: (.*):\d replacement: $17. 踩坑实录7.1 Vue3响应式问题典型问题使用reactive包裹的对象解构后失去响应性解决方案使用toRefs保持响应性或直接使用ref组合式函数返回响应式对象// 错误示例 const state reactive({ count: 0 }) let { count } state // 失去响应性 // 正确写法 const { count } toRefs(state)7.2 MyBatis-Plus逻辑删除踩坑点默认逻辑删除值配置与数据库定义不符正确配置方式mybatis-plus: global-config: db-config: logic-delete-field: deleted logic-not-delete-value: 0 logic-delete-value: 18. 扩展思考8.1 微信小程序集成后续扩展方案复用现有API层增加WXML适配层采用uni-app跨端方案8.2 智能推荐功能可扩展方向基于历史参赛记录的推荐相似学生参赛路径分析竞赛热度预测模型# 简单的推荐算法示例 def recommend_competitions(student): history get_history(student.id) similar_students find_similar(history) return aggregate_competitions(similar_students)这个项目让我深刻体会到教育类系统的开发不仅要考虑技术实现更要理解教学管理的实际场景。比如在权限设计时我们最初忽略了竞赛临时负责人这个角色导致后期不得不重构权限体系。建议开发类似系统时一定要先深入业务现场调研至少2周时间。