一、 项目背景与意义在高校计算机、软件工程等相关专业的实践教学中实训项目是连接理论知识与工程实践的关键环节。然而传统的实训项目管理多依赖人工、邮件或简单的共享文档存在项目进度难跟踪、资源分配不透明、师生沟通效率低、成果归档混乱等问题。因此设计并实现一个基于Spring Boot的实训项目管理平台具有重要的现实意义提升管理效率将项目立项、任务分解、进度跟踪、文档提交、成绩评定等流程线上化、标准化大幅减少重复性人工操作。促进过程透明学生、教师、企业导师等多角色可实时查看项目状态、任务分配与完成情况增强协作与信任。沉淀知识资产平台可集中存储项目需求文档、设计文档、源代码、测试报告、最终成果等形成可复用、可追溯的教学资源库。支撑教学改革为基于项目的学习PBL、翻转课堂等新型教学模式提供有力的技术平台支撑。二、 技术栈选型本项目采用前后端分离的架构模式后端基于Spring Boot生态前端选用主流Vue.js框架具体技术栈如下2.1 后端技术栈核心框架Spring Boot 3.x安全框架Spring Security JWT (JSON Web Token)数据持久层Spring Data JPA (默认) / MyBatis-Plus (可选)数据库MySQL 8.0 (主库) Redis 7.x (缓存与Session)API文档SpringDoc OpenAPI 3 (替代Swagger)消息队列RabbitMQ (用于异步通知、日志处理)文件存储本地存储 MinIO (对象存储用于大文件)任务调度Spring Scheduler / Quartz构建工具Maven 或 Gradle2.2 前端技术栈核心框架Vue 3 (Composition API)构建工具ViteUI组件库Element Plus状态管理Pinia路由Vue Router 4HTTP客户端Axios图表ECharts 或 AntV G22.3 开发与部署版本控制Git GitLab/Gitee容器化Docker Docker Compose持续集成/部署Jenkins 或 GitLab CI/CD三、 系统核心功能模块设计平台主要服务于三类角色系统管理员、指导教师、学生。核心功能模块如下3.1 用户与权限管理模块多角色管理员、教师、学生注册、登录与JWT认证。基于RBAC角色基于访问控制的细粒度权限管理。用户个人信息维护与头像上传。3.2 项目管理模块项目全生命周期管理创建、发布、立项、进行中、结项、归档。项目团队管理学生申请加入项目、教师审核组队、任命组长。项目看板可视化展示项目进度、成员贡献、里程碑。3.3 任务与进度管理模块任务分解将项目拆分为可执行的任务Task或子任务Sub-task。任务分配指派负责人、设置截止日期、优先级。进度跟踪任务状态待开始、进行中、待审核、已完成、工时填报、燃尽图。3.4 文档与成果管理模块文档中心在线创建/编辑需求文档、设计文档、API文档集成Swagger UI。成果提交支持源代码ZIP包、可执行文件、演示视频、论文等格式上传。版本控制文档与成果的版本历史与差异对比。3.5 沟通与通知模块站内消息项目组内讨论、提醒。公告系统教师发布项目重要通知。邮件/消息推送关键节点任务到期、提交审核通过邮件或集成钉钉/微信通知。3.6 评审与成绩管理模块多维度评分教师可对项目成果、文档质量、代码规范、团队协作等进行评分。互评系统支持小组成员间互评。成绩单导出支持按项目、按班级导出成绩为Excel。四、 核心代码实现示例4.1 项目实体与JPA映射import jakarta.persistence.*; import lombok.Data; import java.time.LocalDateTime; import java.util.List; Entity Data Table(name training_project) public class Project { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; Column(nullable false, length 200) private String name; // 项目名称 Column(columnDefinition TEXT) private String description; // 项目描述 Enumerated(EnumType.STRING) private ProjectStatus status ProjectStatus.DRAFT; // 状态草稿、已发布、进行中、已结项、已归档 ManyToOne JoinColumn(name teacher_id) private User teacher; // 指导教师 OneToMany(mappedBy project, cascade CascadeType.ALL) private Listlt;ProjectMembergt; members; // 项目成员 Column(name max_members) private Integer maxMembers; // 最大成员数 private LocalDateTime startTime; private LocalDateTime endTime; private LocalDateTime createTime; private LocalDateTime updateTime; // 省略 getter/setter } enum ProjectStatus { DRAFT, PUBLISHED, ONGOING, COMPLETED, ARCHIVED }4.2 基于Spring Security和JWT的认证配置import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.security.authentication.AuthenticationManager; import org.springframework.security.config.annotation.authentication.configuration.AuthenticationConfiguration; import org.springframework.security.config.annotation.web.builders.HttpSecurity; import org.springframework.security.config.http.SessionCreationPolicy; import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder; import org.springframework.security.crypto.password.PasswordEncoder; import org.springframework.security.web.SecurityFilterChain; import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter; Configuration public class SecurityConfig { private final JwtAuthenticationFilter jwtAuthFilter; public SecurityConfig(JwtAuthenticationFilter jwtAuthFilter) { this.jwtAuthFilter jwtAuthFilter; } Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http .csrf(csrf - csrf.disable()) .sessionManagement(session - session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)) .authorizeHttpRequests(auth - auth .requestMatchers(/api/auth/, /swagger-ui/, /v3/api-docs/).permitAll() .requestMatchers(/api/admin/).hasRole(ADMIN) .requestMatchers(/api/teacher/).hasAnyRole(TEACHER, ADMIN) .requestMatchers(/api/student/).hasAnyRole(STUDENT, TEACHER, ADMIN) .anyRequest().authenticated() ) .addFilterBefore(jwtAuthFilter, UsernamePasswordAuthenticationFilter.class); return http.build(); } Bean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } Bean public AuthenticationManager authenticationManager(AuthenticationConfiguration config) throws Exception { return config.getAuthenticationManager(); } }4.3 项目分页查询与条件过滤服务import com.example.project.dto.ProjectQueryDTO; import com.example.project.entity.Project; import com.example.project.repository.ProjectRepository; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.domain.Specification; import org.springframework.stereotype.Service; import org.springframework.util.StringUtils; import jakarta.persistence.criteria.Predicate; import java.util.ArrayList; import java.util.List; Service RequiredArgsConstructor public class ProjectService { private final ProjectRepository projectRepository; public Pagelt;Projectgt; queryProjects(ProjectQueryDTO queryDTO, Pageable pageable) { Specificationlt;Projectgt; spec (root, query, cb) - { Listlt;Predicategt; predicates new ArrayListlt;gt;(); // 按项目名称模糊查询 if (StringUtils.hasText(queryDTO.getName())) { predicates.add(cb.like(root.get(name), % queryDTO.getName() %)); } // 按状态筛选 if (queryDTO.getStatus() ! null) { predicates.add(cb.equal(root.get(status), queryDTO.getStatus())); } // 按指导教师ID筛选 if (queryDTO.getTeacherId() ! null) { predicates.add(cb.equal(root.get(teacher).get(id), queryDTO.getTeacherId())); } // 时间范围筛选开始时间之后 if (queryDTO.getStartTimeAfter() ! null) { predicates.add(cb.greaterThanOrEqualTo(root.get(startTime), queryDTO.getStartTimeAfter())); } // 时间范围筛选结束时间之前 if (queryDTO.getEndTimeBefore() ! null) { predicates.add(cb.lessThanOrEqualTo(root.get(endTime), queryDTO.getEndTimeBefore())); } return cb.and(predicates.toArray(new Predicate[0])); }; return projectRepository.findAll(spec, pageable); } }4.4 使用MinIO进行文件上传的Serviceimport io.minio.*; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Service; import org.springframework.web.multipart.MultipartFile; import java.io.InputStream; import java.util.UUID; Slf4j Service RequiredArgsConstructor public class FileStorageService { private final MinioClient minioClient; Value(${minio.bucket-name}) private String bucketName; public String uploadFile(MultipartFile file, String folder) throws Exception { // 生成唯一文件名 String originalFilename file.getOriginalFilename(); String fileExtension originalFilename.substring(originalFilename.lastIndexOf(.)); String objectName folder / UUID.randomUUID() fileExtension; // 检查存储桶是否存在不存在则创建 boolean found minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build()); if (!found) { minioClient.makeBucket(MakeBucketArgs.builder().bucket(bucketName).build()); } // 上传文件 try (InputStream inputStream file.getInputStream()) { minioClient.putObject( PutObjectArgs.builder() .bucket(bucketName) .object(objectName) .stream(inputStream, file.getSize(), -1) .contentType(file.getContentType()) .build() ); } // 返回文件访问路径需配置MinIO外部访问地址 return / bucketName / objectName; } // 省略下载、删除等方法 }五、 总结与展望本文阐述了基于Spring Boot的实训项目管理平台的设计与实现涵盖了项目背景、技术栈选型、核心功能模块以及关键代码示例。该平台能够有效解决传统实训管理中的痛点提升教学管理的数字化、智能化水平。未来可扩展方向集成代码质量分析对接SonarQube自动分析提交代码的复杂度、重复率、漏洞。引入AI辅助利用大模型对项目文档进行智能评审、生成代码建议。微服务化改造随着业务复杂化可将用户中心、项目服务、文件服务等拆分为独立微服务。移动端适配开发微信小程序或React Native App方便师生随时随地查看进度与通知。通过持续迭代该平台有望成为支撑高校工程实践教学的核心基础设施。