本项目是基于 Spring Boot 后端 + JavaFX 前端 的教务管理系统课设，具备学生管理、课程管理、选课与成绩录入等核心功能，适合高校教务管理场景的初步建模与实践。
本项目遵循标准的 Maven + Spring Boot 多模块分层设计，结构如下：
Campus_Management_System/
├── documents/ # 项目文档（设计说明、数据库设计等）
├── logs/ # 日志输出目录
├── src/
│ ├── main/
│ │ ├── java/com/orbithy/cms/
│ │ │ ├── annotation/ # 自定义注解（如权限控制等）
│ │ │ ├── aspect/ # AOP 切面处理类（如日志、权限校验）
│ │ │ ├── cache/ # 缓存接口封装（Redis）
│ │ │ │ └── impl/ # 缓存实现类
│ │ │ ├── config/ # 项目配置（拦截器、CORS等）
│ │ │ ├── controller/ # 控制器（处理前端请求）
│ │ │ ├── data/
│ │ │ │ ├── dto/ # Data Transfer Object，数据传输对象
│ │ │ │ ├── enums/ # 枚举类
│ │ │ │ │ └── handler/ # 枚举相关处理器（转换器等）
│ │ │ │ ├── po/ # Persistence Object，实体类，数据库映射
│ │ │ │ └── vo/ # View Object，封装返回前端的数据
│ │ │ ├── domain/ # 领域模型层（用于业务建模与封装）
│ │ │ ├── exception/ # 自定义异常处理（如全局异常、业务异常等）
│ │ │ ├── mapper/ # MyBatis-Plus Mapper 接口
│ │ │ ├── service/ # 业务逻辑接口及实现类
│ │ │ ├── solver/ # 排课算法相关类（如约束解算器）
│ │ │ └── utils/ # 工具类（如统一返回封装、加密工具等）
│ │ └── resources/
│ │ ├── mapper/ # MyBatis XML 映射文件
│ │ └── application.yml # 项目配置文件
├── src/test/java/com/orbithy/cms/ # 测试类目录
├── .github/workflows/ # GitHub Actions 工作流配置
├── .mvn/wrapper/ # Maven Wrapper 支持文件
├── .idea/ # IntelliJ IDEA 项目配置目录（可忽略）
└── target/ # Maven 编译输出目录（可忽略）- 学生信息展示与修改（姓名、性别、电话、邮箱等）
- 修改登录密码
- 学籍状态变更（休学、复学、转学、退学）
自动生成学籍卡片（PDF 或系统页面）
- 按学期查询成绩
- 成绩排名查看（班级/年级排名）
- 成绩单导出/打印
- 支持课程冲突检测（时间、课程类型）
- 课程类型区分（必修 / 限选 / 任选）
- 学分上限控制（如：35 学分）
- 多条件搜索（教师姓名、课程名、课序号）
- 选课时间窗口控制
- 当前选课结果查询
- 课程退选
- 自动生成学生课表
- 教师课程评价功能（TODO）
- 创建、修改、删除班级
- 查看班级成员、班级课程
- 教师创建课程后，教务管理员点击自动排课与分配教室
| 层级 | 技术 |
|---|---|
| 后端框架 | Spring Boot |
| ORM | MyBatis-Plus |
| 数据库 | MariaDB / MySQL |
| 安全认证 | JWT / 自定义注解权限控制 |
| 前端客户端 | JavaFX（另建仓库） |
| 缓存 | Redis |
暂无相关说明
本项目的前端使用 JavaFX 实现，代码托管于独立仓库：
👉 Tans-hub/Campus_Management_System_front
请参考该仓库中的 README.md 获取前端的构建与运行方式。
- 详见 Apifox
本项目不用于商业用途，代码中部分功能和逻辑为课设简化实现。