1. 项目概述
大创管理系统是面向高校大学生创新创业训练计划（简称"大创项目"）的全流程管理平台。作为一名参与过多个校园信息化系统开发的工程师，我发现传统的大创项目管理存在诸多痛点：纸质材料堆积如山、进度跟踪困难、师生沟通不畅、成果归档混乱。这个基于SpringBoot+Vue+MySQL的技术方案，正是为了解决这些实际问题而设计的全栈解决方案。
系统实现了从项目申报、中期检查到结题验收的全生命周期管理，包含学生端、导师端和管理员端三个角色门户。我在实际开发中特别注重两个核心体验：一是简化学生提交材料的操作流程，二是为管理员提供可视化的数据看板。下面我将从技术选型到部署上线的完整过程进行拆解，这个毕业设计项目已在实际校园环境中试运行一学期，累计处理了87个大创项目的全流程管理。
2. 技术架构解析
2.1 后端技术栈选型
选择SpringBoot 2.7作为后端框架主要基于三点考量：
- 快速开发特性：通过starter依赖简化了SSM框架的整合配置，比如用spring-boot-starter-data-jpa实现ORM时，相比传统MyBatis减少了约60%的XML配置
- 内嵌Tomcat：避免外置服务器部署的兼容性问题，特别适合学生机房等环境受限的场景
- 健康检查机制：配合Actuator端点可以实时监控系统状态，这在后期运维中非常实用
数据库选用MySQL 8.0而非5.7版本，主要看中其：
- 对JSON字段的原生支持（存储动态表单数据）
- 窗口函数（用于生成各类排名报表）
- 更好的索引优化（应对项目评审时的高并发查询）
2.2 前端技术方案设计
Vue 3的组合式API相比选项式API更适合这个管理系统：
javascript复制// 项目列表页的典型逻辑组织
const { searchQuery, tableData } = useSearch()
const { pagination, handlePageChange } = usePagination()
const { exportExcel } = useExport()
这种写法将相关逻辑集中管理，使代码可维护性提升明显。实测在开发复杂页面时，代码量比Vue 2减少约30%。
Element Plus组件库的选择经过实际对比测试：
- 表格组件虚拟滚动支持万级数据渲染
- 表单校验规则配置直观，适合快速构建管理系统界面
- 主题定制系统可以通过CSS变量轻松适配学校VI色系
3. 核心功能实现细节
3.1 多级审批工作流引擎
大创项目特有的三级审批流程（学院→校级→省级）采用状态机模式实现：
java复制// 审批状态枚举设计
public enum ProjectStatus {
DRAFT(0),
DEPARTMENT_APPROVING(1),
SCHOOL_APPROVING(2),
PROVINCE_APPROVING(3),
REJECTED(-1),
PASSED(10);
// 状态转移校验逻辑
public boolean canTransferTo(ProjectStatus target) {
return switch(this) {
case DRAFT -> target == DEPARTMENT_APPROVING;
case DEPARTMENT_APPROVING ->
target == SCHOOL_APPROVING || target == REJECTED;
// 其他状态转移规则...
};
}
}
审批链采用责任链模式实现，关键设计点：
- 每个审批节点对应一个具体Handler
- 通过数据库persistent_audit_event表记录完整审批轨迹
- 使用Spring事件机制触发邮件通知
3.2 动态表单解决方案
为适应不同学校的大创申报字段差异，设计了基于JSON Schema的表单引擎：
- 管理员后台配置表单结构
json复制{
"title": "大创项目申报书",
"properties": {
"projectName": {
"type": "string",
"title": "项目名称",
"minLength": 5
},
"innovationPoints": {
"type": "array",
"items": {
"type": "string",
"maxItems": 3
}
}
}
}
- 前端通过@formily/vue动态渲染表单
- 后端使用MySQL的JSON字段存储表单数据
这个方案在试点学校应用中，仅用2天就完成了某省级特色字段的适配，而传统硬编码方式至少需要1周。
4. 数据库设计优化
4.1 核心表结构设计
项目主表的关键字段设计：
sql复制CREATE TABLE `project` (
`id` BIGINT NOT NULL AUTO_INCREMENT,
`project_name` VARCHAR(100) NOT NULL COMMENT '项目名称',
`project_code` VARCHAR(20) GENERATED ALWAYS AS (
CONCAT('DC', YEAR(create_time), LPAD(id,5,'0'))
) STORED COMMENT '自动生成项目编号',
`form_data` JSON DEFAULT NULL COMMENT '动态表单数据',
`current_status` ENUM('draft','approving','rejected','passed') NOT NULL,
`version` INT DEFAULT 0 COMMENT '乐观锁版本号',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_project_code` (`project_code`),
KEY `idx_status` (`current_status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
特别说明几个设计考量：
- 使用生成列自动创建规范的项目编号（如DC202300123）
- JSON字段存储动态表单数据，避免频繁的ALTER TABLE操作
- 添加version字段实现乐观锁，解决多人同时编辑冲突
4.2 性能优化实践
在中期检查高峰期遇到的性能问题及解决方案：
- N+1查询问题：使用@EntityGraph优化关联查询
java复制@EntityGraph(attributePaths = {"members", "teacher"})
@Query("SELECT p FROM Project p WHERE p.currentStatus = :status")
List<Project> findByStatusWithGraph(@Param("status") ProjectStatus status);
- 报表查询慢：为统计报表创建专用物化视图
sql复制CREATE MATERIALIZED VIEW project_stats_view
REFRESH COMPLETE ON DEMAND
AS
SELECT
college,
COUNT(*) AS total,
SUM(current_status = 'passed') AS passed
FROM project
GROUP BY college;
- 文件导出OOM：采用分页流式处理
java复制try (ScrollableResults<Project> scroll = session.createQuery(
"FROM Project p WHERE p.createTime BETWEEN :start AND :end", Project.class)
.setParameter("start", startDate)
.setParameter("end", endDate)
.scroll()) {
while (scroll.next()) {
Project p = scroll.get();
// 流式处理每条记录
}
}
5. 系统部署实战
5.1 容器化部署方案
采用Docker Compose编排服务：
yaml复制version: '3.8'
services:
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASS}
MYSQL_DATABASE: dacheng
volumes:
- mysql_data:/var/lib/mysql
ports:
- "3306:3306"
backend:
build: ./backend
ports:
- "8080:8080"
depends_on:
- mysql
environment:
SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/dacheng
frontend:
build: ./frontend
ports:
- "80:80"
关键部署经验：
- MySQL配置优化：
ini复制[mysqld]
innodb_buffer_pool_size = 1G # 内存的50%-70%
innodb_log_file_size = 256M
max_connections = 200
- SpringBoot健康检查端点配置：
properties复制management.endpoint.health.show-details=always
management.endpoints.web.exposure.include=health,info,prometheus
5.2 前端性能调优
通过以下手段将Lighthouse评分从68提升到92：
- 路由懒加载：
javascript复制const ProjectDetail = () => import('./views/ProjectDetail.vue')
- 开启Gzip压缩（nginx配置示例）：
nginx复制gzip on;
gzip_types text/plain text/css application/json application/javascript;
- 静态资源CDN化：
javascript复制// vite.config.js
export default defineConfig({
build: {
rollupOptions: {
output: {
chunkFileNames: 'assets/[hash].js',
assetFileNames: 'assets/[hash][extname]'
}
}
}
})
6. 典型问题排查实录
6.1 文件上传失败问题
现象：上传超过10MB的附件时报413错误
排查过程：
- 检查Nginx配置发现client_max_body_size默认为1M
- SpringBoot默认文件大小限制为1MB
- 前端axios没有设置超时时间
完整解决方案：
properties复制# SpringBoot配置
spring.servlet.multipart.max-file-size=50MB
spring.servlet.multipart.max-request-size=50MB
nginx复制# Nginx配置
client_max_body_size 50M;
client_body_timeout 300s;
javascript复制// 前端axios配置
const instance = axios.create({
timeout: 300000,
headers: { 'Content-Type': 'multipart/form-data' }
})
6.2 并发提交冲突
现象：多人同时提交项目修改时出现数据覆盖
解决方案：
- 前端采用乐观锁机制：
javascript复制async function saveProject() {
try {
const res = await api.saveProject({
...formData,
version: currentVersion
})
currentVersion = res.data.version // 更新版本号
} catch (err) {
if (err.response?.data?.code === 'VERSION_CONFLICT') {
// 提示用户重新加载数据
}
}
}
- 后端实现版本校验：
java复制@Transactional
public void updateProject(Project project) {
Project existing = projectRepository.findById(project.getId())
.orElseThrow();
if (project.getVersion() != existing.getVersion()) {
throw new VersionConflictException();
}
// ...更新逻辑
project.setVersion(project.getVersion() + 1);
}
7. 论文写作要点
技术类毕业论文需要特别注意以下几点：
- 系统架构图建议使用PlantUML绘制，保持矢量图清晰度：
plantuml复制@startuml
skinparam monochrome true
node "前端" as front {
[Vue 3]
[Element Plus]
}
node "后端" as back {
[SpringBoot]
[MySQL]
}
front -> back : REST API
@enduml
- 性能对比数据要包含量化指标，例如：
- 动态表单配置耗时从4小时降至30分钟
- 项目查询响应时间从1200ms优化到280ms
- 创新点描述要具体，避免空泛表述。例如：
- 基于JSON Schema的动态表单引擎设计
- 三级审批工作流的状态机实现
- 自动生成的项目编码规则设计
在部署文档编写时，建议包含以下实用内容：
- 初始化SQL脚本（包含测试账号）
- 最小化环境检查清单（JDK版本、Node版本等）
- 常见错误代码速查表（如数据库连接失败、端口占用等）