| 项目 | 内容 |
|---|---|
| 2020春季计算机学院软件工程(罗杰 任健) | 博客园班级博客 |
| 作业要求 | Beta阶段发布声明 |
| 我们在这个课程的目标是 | 在团队合作中锻炼自己 |
| 这个作业在哪个具体方面帮助我们实现目标 | 对Beta阶段的发布进行说明和总结 |
一、新增功能
1.批量添加学生
进入教师端，在“班级管理”中选择“批量添加学生账户”，跳转至批量添加学生界面。按照规定的格式顺序输入每个学生的信息，点击”创建用户“按钮，即可批量添加学生。
上一个版本只能在GitLab上逐个创建账户，较为麻烦，增加此功能后，只要按照格式统计并导入学生信息，即可一键创建多个用户，为老师和助教的工作提供了方便。
| 版本 | 功能对比 | 界面对比 |
|---|---|---|
| Beta版本 | 可以按格式导入信息，批量添加学生，减少重复工作，更加便捷。 |  |
| Alpha版本 | 只能逐项输入信息，逐个添加学生，重复工作较多。 |  |
2.批量创建结对和团队项目
2.1 批量创建结对项目
在班级中的结对项目界面点击”结对项目管理面板“，选择”批量分配结对项目学生仓库“，跳转至批量分配结对项目学生仓库界面。
按照规定的格式导入结对学生的信息，点击”创建仓库“按钮，即可批量创建结对项目。
上一个版本只能逐个创建结对项目，增加此功能后，只要按照格式统计并导入学生信息，即可自动生成结对项目名称，批量创建多个结对项目，同样为老师和助教的工作提供了方便。
| 版本 | 功能对比 | 界面对比 |
|---|---|---|
| Beta版本 | 可以按格式导入信息，批量创建结对项目。 |  |
| Alpha版本 | 只能逐项输入信息，逐个创建结对项目。 |  |
2.2 批量创建团队项目
与批量创建结对项目类似，在班级中的团队项目界面点击”批量创建团队项目“，跳转至批量创建团队项目界面。按照规定的格式导入团队学生的信息，点击”创建仓库“按钮，即可批量创建团队项目。
| 版本 | 功能对比 | 界面对比 |
|---|---|---|
| Beta版本 | 可以按格式导入信息，批量创建团队项目。 |  |
| Alpha版本 | 只能逐项输入信息，逐个创建团队项目。 |  |
3.博客评分
新增博客评分功能，为教师和助教评阅博客作业提供了便捷，在平台上即可完成评阅博客作业，在线评分，并将评分结果反馈给学生。
在教师端可以为学生的博客作业评分，为各个分项单独打分后，点击”提交评分“按钮即可。
在学生端可以查看博客的得分情况。
4.博客作业
教师可以在班级中发布博客作业。
-
新建博客作业
在班级界面中点击“新建博客作业”按钮，跳转至新建博客作业界面。输入博客作业名称和作业描述，点击“创建博客作业”按钮，即可创建一个新的博客作业。
-
查看博客作业
在班级界面中点击“所有博客作业”按钮，即可查看所有已创建的博客作业。
-
创建博客时选择所属作业
学生在创建博客时，可以在“作业”选项中选择此博客所属的作业。
上一个版本中，平台上只支持发布和浏览博客。Beta阶段新增了博客评分和博客作业功能后，平台上的博客模块功能更加完善，实现了博客作业从发布、完成到打分的完整流程。
5.教学进度管理
新增教学进度管理功能，教师可以创建教学阶段，学生可以查看自己所在班级的教学进度。该功能对
教师端：在”班级管理“中选择”教学进度管理“并选择班级，跳转至相应班级的教学进度管理界面。
学生端：点击“教学进度”按钮，跳转至所在班级的教学进度管理界面。
-
创建教学阶段
点击“创建教学阶段”按钮，输入阶段标题，选择起止时间，即可创建一个教学阶段。
-
创建教学时间节点
在选定的教学阶段中，点击“创建教学时间节点”按钮，输入节点标题，选择起止时间，即可创建一个节点。
-
查看教学进度
6.完善评测系统
在Beta阶段，对评测系统进行了完善，增加了评测机的API，实现了多评测机评测，增加了评测指标，使得评测系统覆盖的功能更加全面，性能更加强大。
在“系统管理“中选择"评测节点管理"，跳转至评测节点管理控制界面。
6.1 查看和删除评测点
在查看评测点界面，可以查看评测点的数据信息。对于添加错误的评测点，可以进行删除操作。
6.2 多评测机
在评测节点管理控制界面，点击”添加评测节点“，输入评测机的名称和地址，即可添加一个新的评测机。
6.3 获取评测状态
实现获取评测机状态，如编译完成、运行完成、超时。
7.完善广播功能
实现收到新广播后及时在平台上进行通知。在导航栏的”广播“-”收到的广播“处显示通知气泡，提示未读广播数量。收到新的广播消息后，数字随之更新。
| 版本 | 功能对比 | 界面对比 |
|---|---|---|
| Beta版本 | 在导航栏中有红点提醒，一目了然。 |  |
| Alpha版本 | 导航栏中没有新消息提醒，只能点进“广播消息”中查看是否有新消息。 |  |
8.组织管理
增加了组织管理模块，对教师的身份进行管理。管理员具有新建组织的权限，并且可以对组织进行修改和删除。教师在登录时需要输入组织编号和口令，才能进入平台。
- 查看组织
- 编辑组织信息
- 删除组织
二、修复的缺陷
1.登录时的身份验证
在之前的版本中，登录时没有身份验证。新版本中在登录界面设置了身份验证，分为学生、教师和管理员三种身份。教师需要输入组织编号和口令进行验证，管理员需要输入二级密码进行验证，验证通过后才能以教师或管理员的身份登录。
| 身份 | 验证信息 |
|---|---|
| 学生 |  |
| 教师 |  |
| 管理员 |  |
2.界面大幅美化
在上一个版本中，我们的界面比较简单，在Beta阶段我们对界面进行了较大的改动。
2.1 导航栏功能整合
对导航栏进行了改动，增加了班级管理、系统管理、组织和博客栏，对相关功能进行整合。
| 导航栏功能 | 界面展示 |
|---|---|
| 班级管理 |  |
| 系统管理 |  |
| 组织 |  |
| 广播 |  |
| 博客 |  |
2.2 项目管理面板
增加了个人和结对项目管理面板，将与项目有关的功能整合到面板中，包括仓库管理和评测管理。
在班级界面的个人/结对项目列表中，点击”个人/结对项目管理面板“按钮，打开面板。
在控制面板中管理项目仓库、进行评测。
2.3 细节优化
- 登录界面
| 版本 | 界面对比 |
|---|---|
| Alpha |  |
| Beta |  |
-
班级界面
修改了编辑、退出、删除班级的按钮，增加了班级相关信息的展示。
| 版本 | 界面对比 |
|---|---|
| Alpha |  |
| Beta |  |
3.添加教师列表中也会显示学生
之前的版本中，由于在获取用户数据时没有根据用户类型进行筛选，导致添加教师、助教的列表中也会显示学生的账户，修复后在添加教师、助教的界面只会显示教师和助教。
4.评测等待时间过长
之前的版本中，采用同步HTTP请求，导致提交自动评测后客户端一直在等待评测完成，等待时间过长，导致浏览器报错。改为异步HTTP请求后修复正常。
5.添加评测点的链接
在添加结对项目评测点时，会链接到添加个人项目评测点，修复后链接正常。
6.学生列表空白
由于Element-UI的版本问题，导致前端的显示出现问题，通过恢复原来的版本修复正常。
三、运行环境
1.服务端
-
环境要求
在Linux或Mac系统上运行。
-
版本要求
Ruby 2.5，Rails 5.2。
-
其它要求
安装bundle，web packer，PostgreSQL，Node NPM，Nginx。
2.客户端
浏览器访问即可，windows系统上推荐浏览器为Chrome。
四、安装方法
1.服务端
详细安装过程请见：项目配置
2.客户端
用户直接访问网站即可，网址为：http://20.185.223.195。
登录后点击导航栏中的“软工平台”进入课程平台。
五、已知问题和限制
添加学生有多页时，只能显示第一页，点击其他页会报错。
六、软件的发布方式
我们已经将项目部署在服务器上，用户可通过http://20.185.223.195直接访问。
欢迎大家体验我们的项目平台，可通过在本博客下方留言的方式提出您的宝贵建议！