Merge branch 'main' into main

This commit is contained in:
fhz08 2025-02-07 15:45:31 +08:00 committed by GitHub
commit 05031b7206
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
6 changed files with 142 additions and 6 deletions

View File

@ -47,10 +47,11 @@ export const zhSidebar = sidebar({
children: [ children: [
"README.md", "README.md",
{ {
text: "集控服务器",
text: "考试服务器",
collapsible: true, collapsible: true,
expanded: true, expanded: true,
prefix: "management-server/", prefix: "examcloudsechdule/",
children: [ children: [
"README.md", "README.md",
{ {
@ -58,7 +59,6 @@ export const zhSidebar = sidebar({
link: "web-deploy.md", link: "web-deploy.md",
icon: "fa-solid fa-file-lines" icon: "fa-solid fa-file-lines"
}, },
"client-identify.md",
], ],
icon: "fa-solid fa-file-lines" icon: "fa-solid fa-file-lines"
}, },

View File

@ -14,4 +14,8 @@ category:
## 编写配置文件 ## 编写配置文件
请参阅[编写配置文件](profile/faq.md)。 请参阅[编写配置文件](profile/faq.md)。
## 问题反馈
如果您在使用的过程中遇到了 Bug或者对本项目有任何的建议可以在[这里](https://github.com/ExamAware/ExamAware2-Desktop/issues)提交 Issue。

View File

@ -68,5 +68,9 @@ tag:
| 移动端 | [dsz-examaware-mobile/releases](https://github.com/ExamAware/dsz-examaware-mobile/releases) | [dsz-examaware-mobile/actions](https://github.com/ExamAware/dsz-examaware-mobile/actions) | | 移动端 | [dsz-examaware-mobile/releases](https://github.com/ExamAware/dsz-examaware-mobile/releases) | [dsz-examaware-mobile/actions](https://github.com/ExamAware/dsz-examaware-mobile/actions) |
::: :::
> [!tip]
>移动端目前缓慢更新,待`ExamAware2-Desktop`成熟后继续维护
>移动端请前往[交流群](https://qm.qq.com/q/zDiEipHsaI)下载
[^1]: Windows 7 生命周期策略:<https://learn.microsoft.com/zh-cn/lifecycle/products/windows-7>。Windows 7 ESU 结束支持于 2023/1/10。 [^1]: Windows 7 生命周期策略:<https://learn.microsoft.com/zh-cn/lifecycle/products/windows-7>。Windows 7 ESU 结束支持于 2023/1/10。

View File

@ -12,13 +12,20 @@ category:
## 开始使用 ## 开始使用
本功能支持通过静态配置文件部署,也可以通过管理服务器部署。您可以根据情况自由选择部署方式。 本功能支持通过静态配置文件部署,也可以通过集控服务器部署。您可以根据情况自由选择部署方式。
<a id="get-started-static"></a> <a id="get-started-static"></a>
### 集控服务器 ### 集控服务器
[🚀入门教程](management-server/) 🚧正在开发
### 考试服务器
本功能只能起到下发配置的功能,无法实现集控服务器的功能。
[🚀入门教程](examcloudsechdule/)
<a id="get-started-server"></a> <a id="get-started-server"></a>
### 使用静态托管配置文件 ### 使用静态托管配置文件

View File

@ -0,0 +1,64 @@
# 考试服务器介绍
ExamCloudSechdule 是一个用于管理和查看考试安排的系统。它包括以下几个主要功能:
1. **考试看板配置查询**:用户可以通过输入配置 ID 来获取考试安排的详细信息。
![ec-query.png](../images/ec-query.png)
2. **考试安排显示**:显示考试的详细安排,包括科目、开始时间和结束时间。
![ec-exam.png](../images/ec-exam.png)
3. **管理员后台**:管理员可以登录后台管理考试配置文件,包括创建、编辑和删除配置文件。
![ec-admin.png](../images/ec-admin.png)
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` 目录,输入管理员用户名和密码进行登录。
> [!tip]
>
> 管理员用户名和密码初始均为 `admin`
2. 登录后,跳转到 `admin/index.php` 页面,显示所有配置文件。
![ec-admin.png](../images/ec-admin.png)
3. 点击“新建配置”按钮,跳转到 `admin/edit.php` 页面,创建新的配置文件。
![ec-add.png](../images/ec-add.png)
4. 在配置文件列表中,可以点击“编辑”按钮编辑配置文件,点击“删除”按钮删除配置文件,点击“预览”按钮查看配置文件的详细信息。
## 配置文件格式
配置文件为 JSON 格式,包含以下字段:
- `examName`:考试名称。
- `message`:考试提示语。
- `room`:考场号。
- `examInfos`:考试科目安排列表,每个科目包含以下字段:
- `name`:科目名称。
- `start`:开始时间。
- `end`:结束时间。
## 开始使用/如何部署?
请参阅[部署教程](./web-deploy.md)。

View File

@ -0,0 +1,57 @@
# 部署教程
## 使用宝塔面板部署
- 确保安装[宝塔面板](https://www.bt.cn/new/download.html)
- 将域名解析A记录解析到您的服务器IP地址。
- 在宝塔面板中,点击 `网站` -> `HTML项目`-> `添加站点`
![bt-1](../images/bt01.png)
- 在 `域名` 中输入您的域名。
![bt2](../images/bt02.png)
- 在 `网站根目录` 中上传最新版的项目代码。
- 点击 `确定` 即可完成部署。
> [!tip]
>
>如果您没有域名,可以前往[购买域名](https://www.dynadot.com/?s59Ms8lK8u7gQ)。
>或者您也可以直接使用IP+端口直连访问。
>
## 使用IIS部署
- 开启IIS功能
1.打开`设置`
![iis-1](../images/iis01.png)
2.输入`控制面板`
![iis-2](../images/iis02.png)
3.点开`程序`
![iis-3](../images/iis03.png)
4.点击`启用或关闭Windows功能`
5.勾选`Internet Information Services`并点击`确定`
6.点击`确定`,等待安装完成。
![iis-4](../images/iis04.png)
- 部署`ExamCloudSechdule`服务
1.在任务栏的`搜索框`中输入`IIS`并点击`IIS管理器`进入管理页面。
![iis-5](../images/iis05.png)
2.在左侧导航栏中,选择`网站`右键点击`添加网站`
![iis-6](../images/iis06.jpg)
3.在此输入网站名称:`ExamCloudSechdule`
- 物理路径:`C:\inetpub\wwwroot`
- IP地址可以是全部未分配也可以是网卡地址建议使用网卡地址这样校园局域网下就可以通过网卡地址访问
- 端口最好是默认的80端口一般网站访问网址也是默认访问80的不需要同时输入网址和端口可通过网址直接访问
- 主机名这里设置网址可以通过这个网址直接访问当端口不是80时需要网址加端口才能访问(当仅在局域网访问的情况下,主机名可以随意填写)
填写完成后,点击`确定`
![iis-7](../images/iis07.png)
4.点击右侧的`浏览`会跳转到网站的根目录
![iis-8](../images/iis08.png)
5.上传`ExamSchedule`项目代码到网站根目录。
![iis-9](../images/iis09.png)
6.最后,在浏览器中输入您的网卡地址(教程中的地址为`192.168.1.16`),看到项目图片即部署成功
![ec-main](../images/ec-main.png)
> [!tip]
> 如果您希望在公网访问需要在域名提供商处添加A记录将域名解析到您的服务器IP地址并填写正确的主机名。
>
# 终极部署方案
都不会部署?或者……尝试终极解决方案:
邮箱联系 `admin@fhzit.top` ,如果我有空我可以为你的安装提供帮助😊