# MUC-schoolOJ **Repository Path**: HuoHanDu/muc-school-oj ## Basic Information - **Project Name**: MUC-schoolOJ - **Description**: MUC-schoolOJ-backend - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-14 - **Last Updated**: 2026-07-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🏫 SchoolOJ - 校园在线评测系统 校园在线评测系统,用于支撑程序设计课程作业管理、自动评测和成绩统计。 ## 📋 项目文档 详细的项目文档请查看 `需求分析与规划v1.03/` 目录: - 项目记忆库 (`oj_project_memory.md`) - 数据字典 (`data_dict.md`) - ER图、时序图、用例图等设计文档 ## 🚀 快速开始 ### 1. 克隆项目 ```bash git clone https://gitee.com/your-username/SchoolOJ.git cd SchoolOJ ``` ### 2. 环境要求 - JDK 17+ - MySQL 8.0+ - Redis(可选,用于缓存) - Maven 3.6+ ### 3. 配置数据库 **创建数据库:** ```sql CREATE DATABASE schooloj CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ``` **修改配置文件:** ```bash # 复制配置模板 cp src/main/resources/application-template.yml src/main/resources/application.yml # 编辑 application.yml,修改以下配置: # - spring.datasource.password(MySQL密码) # - spring.data.redis.password(Redis密码,如无则留空) ``` ### 4. 初始化数据库 Spring Boot 启动时会自动执行 `src/main/resources/db/schema.sql` 创建表结构。 ### 5. 运行项目 ```bash # 使用 Maven mvn clean spring-boot:run # 或打包为 WAR 部署到 Tomcat mvn clean package # 将 target/SchoolOJ.war 复制到 Tomcat 的 webapps 目录 ``` ### 6. 访问系统 - 基础页面:http://localhost:8080/ - 登录页:http://localhost:8080/pages/login.html > **注意**:未登录状态下,访问任何页面都会自动跳转到登录页。 ## 🔐 测试账号 | 角色 | 手机号 | 密码 | |------|-------------|----------| | 学生 | 18888880002 | stu123 | | 教师 | 13900000001 | tea123 | | 管理员 | 13800000000 | admin123 | ## 🛠️ 技术栈 | 组件 | 版本 | |------|------| | Spring Boot | 3.1.5 | | Java | 17 | | MySQL | 8.0 | | MyBatis-Plus | 3.5.5 | | Redis | 7.x | | 前端 | HTML + JavaScript + CSS | ## 📁 项目结构 ``` SchoolOJ/ ├── src/main/ │ ├── java/com/schooloj/ │ │ ├── SchoolOJApplication.java # 启动类 │ │ ├── common/ # 通用类(Result等) │ │ ├── config/ # 配置类 │ │ ├── controller/ # 控制器 │ │ ├── entity/ # 实体类 │ │ ├── mapper/ # MyBatis接口 │ │ ├── service/ # 业务逻辑 │ │ ├── util/ # 工具类 │ │ ├── filter/ # 过滤器 │ │ └── judge/ # 评测引擎 │ ├── resources/ │ │ ├── application.yml # 本地配置(不提交) │ │ ├── application-template.yml # 配置模板 │ │ └── db/schema.sql # 数据库建表脚本 │ └── webapp/ # 前端静态资源 │ ├── css/ # 样式文件 │ ├── js/ # JavaScript文件 │ ├── fonts/ # 字体文件 │ └── pages/ # HTML页面 ├── 需求分析与规划v1.03/ # 项目文档 └── pom.xml ``` ## 📄 前端页面说明 ### 通用页面 | 文件 | 功能 | |------|------| | `login.html` | 手机号+密码登录入口 | | `ProblemList.html` | 题目列表、筛选搜索 | | `ProblemDetail.html` | 题目详情、代码编辑器、提交评测 | | `Profile.html` | 个人信息、提交记录、修改密码 | ### 管理员页面 | 文件 | 功能 | |------|------| | `AdminHome.html` | 系统数据概览、用户统计、系统状态监控 | ### 教师页面 | 文件 | 功能 | |------|------| | `TeacherHome.html` | 教学数据概览、课程动态 | | `ClassManage.html` | 院系→专业→班级三级架构管理 | | `CourseManage.html` | 创建/编辑课程、关联班级 | | `HomeworkManage.html` | 创建作业、选题、设置分值 | | `ScoreStats.html` | 作业成绩统计、导出报表 | ### 学生页面 | 文件 | 功能 | |------|------| | `StudentHome.html` | 学习轨迹、课程动态、待完成作业 | | `HomeworkView.html` | 作业题目列表、提交代码入口 | | `MyScores.html` | 各课程作业成绩总览 | | `MyClass.html` | 班级信息、教师、同学列表 | ## 🔗 页面跳转关系 ``` login.html (登录) ├── 管理员 → AdminHome.html ├── 教师 → TeacherHome.html └── 学生 → StudentHome.html 所有角色首页均可访问: ├── ProblemList.html (题目列表) │ └── ProblemDetail.html (题目详情+提交) ├── Profile.html (个人中心) └── 退出登录 → login.html 教师专用: ├── ClassManage.html (班级管理) ├── CourseManage.html (课程管理) ├── HomeworkManage.html (作业管理) └── ScoreStats.html (成绩统计) 学生专用: ├── HomeworkView.html (我的作业) ├── MyScores.html (我的成绩) └── MyClass.html (我的班级) ``` ## ⚙️ 配置说明 克隆后需要修改的配置: | 文件 | 说明 | |------|------| | `src/main/resources/application.yml` | 本地配置文件(包含数据库密码等敏感信息) | | `.idea/` | IDEA 本地配置 | | `target/` | Maven 编译产物 | ## 📄 版本历史 | 版本 | 日期 | 说明 | |------|------|------| | v1.03 | 2026-05-12 | 完成数据字典设计,确认核心业务规则 | | v1.04 | 2026-06-10 | 补充前端页面说明,完善项目结构 | | v1.05 | 2026-06-10 | 补充学生、老师测试账号,退出登录增加确认框 | | v1.06 | 2026-06-13 | 优化未登录重定向逻辑,完善 README |