# Student_Registration_Management_System

**Repository Path**: Reol2022/Student_Registration_Management_System

## Basic Information

- **Project Name**: Student_Registration_Management_System
- **Description**: 本科生学籍管理系统.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-21
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 本科生学籍管理系统

一个功能完善的本科学籍管理 Web 系统，支持学生信息管理、学籍异动、成绩管理、奖惩记录、毕业审核和学位审核等核心功能。

## 技术栈

### 后端
- **框架**: Spring Boot 3.3.5
- **数据库**: MySQL + HikariCP 连接池
- **认证**: JWT Token
- **ORM**: JdbcTemplate (手写简单 ORM)

### 前端
- **框架**: Vue 3
- **UI 组件库**: Element Plus
- **构建工具**: Vite
- **状态管理**: Pinia
- **路由**: Vue Router

## 项目结构

```
├── backend/                 # Spring Boot 后端
│   └── src/main/java/com/example/studentstatus/
│       ├── common/          # 公共工具类
│       │   ├── BusinessException.java       # 业务异常
│       │   ├── DataScopeUtil.java           # 数据权限工具
│       │   ├── GlobalExceptionHandler.java  # 全局异常处理
│       │   ├── JwtUtil.java                 # JWT 工具
│       │   ├── PageResult.java              # 分页结果
│       │   ├── Result.java                  # 统一响应
│       │   └── SecurityUtil.java            # 安全工具
│       ├── config/           # 配置类
│       │   ├── AuthInterceptor.java         # 认证拦截器
│       │   └── WebMvcConfig.java            # Web MVC 配置
│       ├── modules/          # 业务模块
│       │   ├── audit/                      # 审核模块
│       │   │   ├── DegreeAuditController.java   # 学位审核
│       │   │   └── GraduationAuditController.java # 毕业审核
│       │   ├── auth/           # 认证模块
│       │   ├── course/         # 课程管理
│       │   ├── program/        # 培养方案
│       │   ├── register/       # 学籍注册
│       │   ├── rewardpunishment/ # 奖惩管理
│       │   ├── score/          # 成绩管理
│       │   ├── statistics/     # 统计分析
│       │   ├── statuschange/   # 学籍异动
│       │   ├── student/        # 学生信息
│       │   └── system/         # 系统管理
│       └── repository/         # 数据访问层
│           └── Db.java         # 通用数据库操作
├── frontend/                # Vue 3 前端
│   └── src/
│       ├── api/              # API 请求
│       ├── components/       # 公共组件
│       ├── layout/           # 布局组件
│       ├── router/           # 路由配置
│       ├── store/            # 状态管理
│       ├── styles/           # 样式文件
│       ├── utils/            # 工具函数
│       └── views/            # 页面视图
└── docs/                    # 数据库脚本
    └── graduate_2026-04-21_20-22-48_mysql_data_Whnp9.sql
```

## 功能模块

### 1. 用户认证
- JWT Token 登录认证
- 基于角色的权限控制 (RBAC)
- 数据范围控制 (全校/院系/个人)

### 2. 学生信息管理
- 学生基本信息维护
- 班级、專業、學院层级管理
- 学籍状态跟踪

### 3. 学籍异动
- 休学、复学、转专业申请
- 多级审批流程 (辅导员 → 院系 → 教务)

### 4. 成绩管理
- 成绩录入与批量导入
- GPA 自动计算
- 成绩审核确认

### 5. 奖惩管理
- 奖励记录管理
- 处分记录管理
- 撤销功能

### 6. 毕业审核
- 学分审核
- 培养方案课程审核
- 毕业资格预检

### 7. 学位审核
- 学位课程审核
- 加权平均分计算
- 处分限制检查

### 8. 统计分析
- 在校生人数统计
- 学籍注册率
- 毕业率/学位率
- 学籍状态变更趋势

## 启动步骤

### 后端启动

1. **配置数据库**
   ```yaml
   # backend/src/main/resources/application.yml
   spring:
     datasource:
       url: jdbc:mysql://localhost:3306/student_status?useSSL=false&serverTimezone=Asia/Shanghai
       username: your_username
       password: your_password
   ```

2. **初始化数据库**
   ```bash
   # 执行 docs/ 目录下的 SQL 脚本
   mysql -u root -p < docs/graduate_2026-04-21_20-22-48_mysql_data_Whnp9.sql
   ```

3. **启动后端**
   ```bash
   cd backend
   mvn spring-boot:run
   ```

   后端默认端口: `8080`

### 前端启动

```bash
cd frontend
npm install
npm run dev
```

前端默认端口: `5173`

## 默认账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | admin123 |
| 辅导员 | counselor1 | counselor123 |
| 教务人员 | academic1 | academic123 |
| 学生 | student2024001 | student123 |

## 主要接口

### 认证
- `POST /api/auth/login` - 登录
- `GET /api/auth/me` - 获取当前用户信息
- `POST /api/auth/logout` - 登出

### 学生管理
- `GET /api/students` - 学生列表
- `POST /api/students` - 新增学生
- `PUT /api/students/{id}` - 更新学生
- `DELETE /api/students/{id}` - 删除学生
- `GET /api/students/{id}/scores` - 成绩单

### 学籍异动
- `POST /api/status-changes` - 申请异动
- `POST /api/status-changes/{id}/counselor-audit` - 辅导员审核
- `POST /api/status-changes/{id}/college-audit` - 院系审核
- `POST /api/status-changes/{id}/academic-audit` - 教务审核

### 成绩管理
- `POST /api/scores` - 录入成绩
- `POST /api/scores/batch` - 批量导入
- `POST /api/scores/{id}/audit` - 成绩审核

### 审核模块
- `POST /api/graduation-audits/precheck/{studentId}` - 毕业预检
- `POST /api/degree-audits/precheck/{studentId}` - 学位预检
- `GET /api/graduation-audits/results` - 审核结果列表

### 统计分析
- `GET /api/statistics/students/count` - 学生总数
- `GET /api/statistics/register-rate` - 注册率
- `GET /api/statistics/graduation-rate` - 毕业率
- `GET /api/statistics/degree-rate` - 学位率

## 许可证

MIT License