| 项目 | 内容 |
|---|---|
| 2020春季计算机学院软件工程(罗杰 任健) | 博客园班级博客 |
| 作业要求 | 发布声明 |
| 我们在这个课程的目标是 | 在团队合作中锻炼自己 |
| 这个作业在哪个具体方面帮助我们实现目标 | 对Alpha阶段的发布进行说明和总结 |
一、新增功能
1.广播功能
实现了不同范围内的广播功能，教师可以向不同范围内的成员发送广播。
该功能的实用性较强，增加此功能后，教师可以很方便地向学生广播发送课程通知，作业相关事项等。
- 创建广播：教师选择广播范围，输入广播内容后，点击“发送广播”按钮，即可向指定范围内的成员发送广播。
- 查看收到的广播消息：学生和教师可以查看自己收到的广播消息，未读的广播以列表的形式展示。点击“已读”按钮后，该消息将从列表中删除。
2.评测功能
将创建评测点、提交评测任务、获取评测结果封装成按钮。实现自动拉取学生仓库，在评测机上进行自动评测，并返回评测结果。
增加此功能后，在平台上可以实现个人和结对项目的自动评测，而不需要助教去手动克隆每个学生的项目，再逐一进行评测，为助教评测作业提供了极大的便捷。
- 创建评测点
- 提交评测任务
- 获取评测结果
3.用户注销
在平台界面上添加“注销平台”按钮，点击按钮即可退出平台登录，进入GitLab界面进行注销。
增加此功能后，用户可以便捷地退出当前登录的账号，实现账号切换。
- 点击平台右上角的“注销平台”按钮后，跳转至GitLab界面，再点击“Sign out”即可彻底退出登录。
4.编辑班级
对编辑班级功能进行了封装，在班级列表中点击相应班级的“编辑”按钮，即可跳转至编辑班级界面。
增加此功能后，在平台上可以直接进行班级的编辑，而不需要跳转到GitLab去编辑。
5.创建项目
新增创建个人项目、结对项目、团队项目功能，在班级界面选择相应的项目，点击相应的创建按钮跳转至创建界面。在创建界面中填写项目名称，选择项目成员后，点击“创建”按钮，即可实现项目的创建和仓库分配。
增加此功能后，在平台上可以便捷地创建项目，而不需要跳转到GitLab上进行创建。
以创建个人和结对项目为例进行展示：
-
创建个人项目
点击“分配个人项目学生仓库”按钮，跳转至创建个人作业项目界面。
学生范围可选择“班级全体学生”和“单个学生”，可自动创建多个仓库或单个仓库。
-
创建结对项目
点击“创建结对项目学生仓库”按钮，跳转至创建结对项目界面。
6.删除项目
在项目列表中，点击“删除”按钮，即可完成项目的删除。
增加此功能后，用户可以在平台上直接删除项目，而不需要跳转到GitLab上去删除。
7.返回功能
为新建和编辑页面添加“返回”按钮，实现返回功能。
增加此功能后，能够方便地返回上一步的界面，用户体验有所优化。
8.新建标签
新增新建标签功能，用户可以在项目中自定义标签的名称。
之后在对应的项目中新建问题时可以使用新建的标签。
二、修复的缺陷
一开始接手项目时，项目中存在的bug较多，很多功能都存在缺陷。我们在Alpha阶段修复了大部分bug，能够保证基本功能的正常使用。
1.权限分配
在之前的版本中，权限管理比较混乱，每个学生不仅能看到自己的仓库，还能看到其他同学的仓库，私密性无法保证。我们修复了GitLab的权限分配模式，保证了每个学生只能看到自己的仓库，只有老师和助教可以看到所有同学的仓库。
2.项目看板
2.1 优先级和权重设置
在之前的版本中，优先级和权重的设置都是无效的，修复后可以正常设置。
2.2 项目看板计数
在之前的版本中，进入项目看板后计数会全部清零，修复后可以正常计数。
2.3 新建问题的显示
在之前的版本中，新建问题无论是什么类型，都会被默认显示在todo列，修复后可以正常显示。
3.创建项目
3.1 只能创建到结对项目
在之前的版本中，创建项目时无论项目类型是什么，都只能创建到结对项目。修复后可以正常创建。
3.2 重定向地址有误
在之前的版本中，添加个人和结对项目后会返回到班级列表，修复后可以返回到项目列表。
3.3 创建团队项目
在之前的版本中，学生点击创建团队项目会报错。修复后关闭了学生创建团队项目的功能，只有教师可以创建团队项目。
以及创建团队项目后再打开班级页面会报错，修复后可以正常打开。
4.博客部分
4.1 教师创建博客
在之前的版本中，教师创建博客时项目栏为空。创建博客是学生的作业，教师没有使用该功能的必要，因此关闭了教师创建博客的功能。
4.2 新建博客
在之前的版本中，新建博客和Scrum后会一直处于加载中，修复后恢复正常。
5.冲刺部分
5.1 无法区分班级
在之前的版本中，新建冲刺时只能看到项目名称而看不到班级名称，无法区分不同班级中的同名项目，修复后将班级和项目进行了合并。
6.其它缺陷
6.1 添加学生
在之前的版本中，教师点击添加学生后在学生列表里没有显示，修复后可以正常显示。
以及被教师加入班级的学生无法看到团队项目，退出班级时会报错，修复后恢复正常。
6.2 编辑班级
在之前的版本中，编辑班级后实际被修改的班级是错误的，修复后编辑的班级与实际被修改的班级相符。
三、运行环境
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。
登录后点击导航栏中的“More-BUAA SETP”进入课程平台，如下图所示。
五、已知问题和限制
-
登录时缺乏身份验证
-
编辑班级时，对已有内容没有填充，需要重新填写
-
添加学生只能手动添加，不能自动导入
-
创建团队项目时缺乏合法性检测，团队中成员数可以为0
-
新建问题时缺乏重名检查
-
进入项目看板后不再显示项目名
六、软件的发布方式
我们已经将项目部署在服务器上，用户可通过http://20.185.223.195直接访问。
欢迎大家体验我们的项目平台，可通过在本博客下方留言的方式提出您的宝贵建议，我们将会在下一个阶段改进！