一个基于 Spring Boot 3 和 Vue 3 开发的全功能学籍管理系统。系统覆盖学生基本信息、学籍状态、奖惩记录、学籍变动、离校手续等全流程管理，支持学生、辅导员、教务管理员、宿管、图书馆管理员、财务管理员等多角色权限控制与协同审批。
- 🎭 多角色系统 - 学生/辅导员/多类型管理员，权限隔离
- 📋 完整审批流 - 奖励、处分、学籍变动、离校手续多级审批
- 🔐 JWT 鉴权 - 无状态 Token 认证，支持自动续期
- 📊 数据看板 - 各角色专属统计面板
- 📁 附件管理 - 支持文件上传下载
- 📤 Excel 导出 - 一键导出学生数据
- 📝 操作日志 - 全链路审计追踪
| 类别 | 技术 | 版本 |
|---|---|---|
| 语言 | Java | 17 |
| 框架 | Spring Boot | 3.0.2 |
| ORM | MyBatis-Plus | 3.5.6 |
| 数据库 | MySQL | 8.0+ |
| 连接池 | Druid | 1.2.23 |
| API 文档 | Knife4j (OpenAPI 3) | 4.4.0 |
| 鉴权 | JWT (jjwt) | 0.11.5 |
| 工具 | Lombok, POI, Validation | - |
| 类别 | 技术 | 版本 |
|---|---|---|
| 运行环境 | Node.js | >= 20 |
| 框架 | Vue | 3.5 |
| 构建工具 | Vite | 7.2 |
| 语言 | TypeScript | 5.9 |
| UI 组件库 | Element Plus | 2.11 |
| 状态管理 | Pinia | 3.0 |
| 路由 | Vue Router | 4.6 |
| HTTP | Axios | 1.13 |
┌─────────────┐ HTTP/JSON ┌─────────────┐
│ Browser │ ◄───────────────► │ Nginx │
│ (Vue SPA) │ │ (Proxy) │
└─────────────┘ └──────┬──────┘
│
▼
┌─────────────┐
│ Spring Boot │
│ Backend │
└──────┬──────┘
│
▼
┌─────────────┐
│ MySQL │
└─────────────┘
smProject/
├── sm-backend/ # 后端项目
│ ├── sql/ # 数据库脚本
│ │ ├── sm数据库设计.sql # 建表语句 (13张表)
│ │ └── 示例数据.sql # 测试数据
│ └── src/main/java/is/smbackend/
│ ├── controller/ # 控制层 (17个模块)
│ ├── service/ # 业务逻辑层
│ ├── mapper/ # 数据访问层
│ ├── pojo/ # 实体类
│ ├── dto/ # 数据传输对象
│ ├── config/ # 配置类
│ ├── interceptor/ # JWT 拦截器
│ └── exception/ # 全局异常处理
│
└── sm-frontend/ # 前端项目
└── src/
├── api/ # API 接口封装
├── views/ # 页面组件
│ ├── student/ # 学生端 (9个页面)
│ ├── advisor/ # 辅导员端 (6个页面)
│ └── admin/ # 管理员端 (9个页面)
├── router/ # 路由配置
├── stores/ # Pinia 状态
└── utils/ # 工具函数
- JDK 17+
- Node.js 20+
- MySQL 8.0+
- Maven 3.6+
# 登录 MySQL 创建数据库
mysql -u root -p
CREATE DATABASE studentstatus_manage CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
# 导入表结构和测试数据
mysql -u root -p studentstatus_manage < sm-backend/sql/sm数据库设计.sql
mysql -u root -p studentstatus_manage < sm-backend/sql/示例数据.sqlcd sm-backend
# 修改数据库配置 (src/main/resources/application.yml)
# spring.datasource.url / username / password
# 启动服务
mvn clean spring-boot:run- 服务地址:
http://localhost:8080/smbackend - API 文档: http://localhost:8080/smbackend/doc.html
cd sm-frontend
npm install
npm run dev- 访问地址: http://localhost:5173
| 角色 | 账号 | 密码 | 说明 |
|---|---|---|---|
| 学生 | U202341001 | 123 | 大雄 |
| 辅导员 | G202310001 | 123 | 张三 |
| 教务管理员 | G202350001 | 123 | 路人丁 |
| 宿管管理员 | G202320001 | 123 | 路人甲 |
| 图书馆管理员 | G202330001 | 123 | 路人乙 |
| 财务管理员 | G202340001 | 123 | 路人丙 |
系统包含 13 张核心数据表：
| 表名 | 描述 | 主要字段 |
|---|---|---|
student_basic_info |
学生基本信息 | 学号、姓名、身份证、政治面貌 |
student_status_info |
学籍信息 | 院系、专业、班级、学籍状态 |
award |
奖励记录 | 类型、等级、金额、审批状态 |
punishment |
处分记录 | 类型、原因、生效状态 |
appeal |
申诉记录 | 申诉理由、审理状态 |
status_change |
学籍变动 | 变动类型、目标院校/专业 |
leave_school |
离校手续 | 四部门审批状态 |
notice |
系统通知 | 标题、内容、已读状态 |
attachment |
附件 | 文件名、路径、关联业务 |
log |
操作日志 | 操作类型、IP、详情 |
user_student |
学生账号 | - |
user_advisor |
辅导员账号 | - |
user_admin |
管理员账号 | 角色类型 |
- 个人信息查看
- 学籍状态查询
- 奖励申请
- 处分查看与申诉
- 学籍变动申请 (转专业/休学/复学等)
- 离校手续办理
- 系统通知
- 学生列表管理
- 奖励初审
- 申诉初审
- 学籍变动初审
- 通知管理
- 教务管理员: 学生管理、奖励/申诉/变动终审、通知发布、日志查看
- 宿管/图书馆/财务管理员: 离校手续对应环节审核
奖励申请: 学生提交 → 辅导员初审 → 教务处终审 → 生效
处分申诉: 学生申诉 → 辅导员初审 → 教务处终审 → 撤销/维持
学籍变动: 学生申请 → 辅导员审核 → 教务处审核 → 状态变更
离校手续: 学生发起 → 宿管审核 → 图书馆审核 → 财务审核 → 教务归档
MIT License