mirror of
https://hub.gitmirror.com/https://github.com/ExamAware/ExamCloudSchedule
synced 2025-04-29 14:06:35 +00:00
116 lines
3.4 KiB
Markdown
116 lines
3.4 KiB
Markdown
# ExamCloudSechdule
|
||
|
||
ExamCloudSechdule 是一个用于管理和查看考试安排的系统。它包括以下几个主要功能:
|
||
|
||
1. **考试看板配置查询**:用户可以通过输入配置 ID 来获取考试安排的详细信息。
|
||
2. **考试安排显示**:显示考试的详细安排,包括科目、开始时间和结束时间。
|
||
3. **管理员后台**:管理员可以登录后台管理考试配置文件,包括创建、编辑和删除配置文件。
|
||
4. **明暗色主题**: 随心所欲切换主题。
|
||
|
||
## 文件结构
|
||
|
||
- `/index.php`:考试看板配置查询页面。
|
||
- `/ExamCloudSchedule`:考试安排显示页面。
|
||
- `/admin/login.php`:管理员登录页面。
|
||
- `/admin/index.php`:管理员后台主页,显示所有配置文件。
|
||
- `/admin/edit.php`:编辑或创建新的考试配置文件。
|
||
- `/admin/detete.php`: 删除指定配置文件。
|
||
- `/includes`: 管理员认证目录。
|
||
- `/configs`: 安排存放目录。
|
||
|
||
## 使用方法
|
||
|
||
### 考试看板配置查询
|
||
|
||
1. 打开根目录页面。
|
||
2. 输入配置 ID,例如 `room301`。
|
||
3. 点击“获取配置”按钮,查看考试安排的详细信息。
|
||
4. 点击“进入”按钮,跳转到考试安排显示页面。
|
||
|
||
### 考试安排显示
|
||
|
||
1. 上一部操作后会打开 `ExamCloudSchedule/index.html` 页面。
|
||
2. 页面会自动根据 URL 参数 `configId` 显示相应的考试安排。
|
||
|
||
### 管理员后台
|
||
|
||
1. 点击 `管理后台` 或者,手动打开 `admin` 目录,输入管理员用户名和密码进行登录。
|
||
2. 登录后,跳转到 `admin/index.php` 页面,显示所有配置文件。
|
||
3. 点击“新建配置”按钮,跳转到 `admin/edit.php` 页面,创建新的配置文件。
|
||
4. 在配置文件列表中,可以点击“编辑”按钮编辑配置文件,点击“删除”按钮删除配置文件,点击“预览”按钮查看配置文件的详细信息。
|
||
|
||
## 配置文件格式
|
||
|
||
配置文件为 JSON 格式,包含以下字段:
|
||
|
||
- `examName`:考试名称。
|
||
- `message`:考试提示语。
|
||
- `room`:考场号。
|
||
- `examInfos`:考试科目安排列表,每个科目包含以下字段:
|
||
- `name`:科目名称。
|
||
- `start`:开始时间。
|
||
- `end`:结束时间。
|
||
|
||
示例配置文件:
|
||
|
||
```json
|
||
{
|
||
"examName": "期末考试",
|
||
"message": "请提前10分钟进入考场",
|
||
"room": "room301",
|
||
"examInfos": [
|
||
{
|
||
"name": "数学",
|
||
"start": "2023-12-01T09:00:00",
|
||
"end": "2023-12-01T11:00:00"
|
||
},
|
||
{
|
||
"name": "英语",
|
||
"start": "2023-12-01T13:00:00",
|
||
"end": "2023-12-01T15:00:00"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
## 开发环境
|
||
|
||
- PHP 7.4+
|
||
- HTML5
|
||
- JavaScript
|
||
- CSS3
|
||
|
||
## 安装和运行
|
||
|
||
1. 克隆项目到本地:
|
||
|
||
```bash
|
||
git clone https://github.com/ExamAware/ExamCloudSechdule.git
|
||
```
|
||
|
||
2. 将项目文件放置到 Web 服务器的根目录下。
|
||
3. 确保 Web 服务器支持 PHP,并启动服务器。
|
||
4. 访问 `index.php` 页面,开始使用系统。
|
||
|
||
## 贡献
|
||
|
||
欢迎提交问题和功能请求,您可以通过提交 Pull Request 来贡献代码。
|
||
|
||
## 许可证
|
||
|
||
本项目采用 MIT 许可证。
|
||
|
||
## CodeSpace 开发提示
|
||
|
||
```bash
|
||
# 初始化 Codespace 时运行:
|
||
|
||
sudo sed -i 's/Listen 80$//' /etc/apache2/ports.conf
|
||
sudo sed -i 's/<VirtualHost \*:80>/ServerName 127.0.0.1\n<VirtualHost \*:8080>/' /etc/apache2/sites-enabled/000-default.conf
|
||
apache2ctl start
|
||
|
||
# 以后直接运行:
|
||
|
||
apache2ctl start
|
||
```
|