Beta阶段展示博客

Beta阶段展示博客

1. 团队成员的简介和个人博客地址

刘畅

博客园ID：森高Slontia

身份：PM

个人介绍：

弹丸粉 || 小说创作爱好者 || 撸猫狂魔(x || 生命的价值在于创造

（我绝对不知道，我一个写代码的怎么就当PM去了？）

---

张安澜

博客园ID：MinstrelZ

身份：后端开发

个人介绍：

张安澜，来自北京航空航天大学2015级计算机学院，喜欢旅游，修仙党，lol大乱斗选手，吃鸡萌新，喊666贼6

---

辛德泰

博客园ID：Alethia

身份：前端开发

个人介绍：

我是ZnTcTi

---

赵奕

博客园ID：ohazyi

身份：开发

个人介绍：

擅长做梦，喜欢折腾

---

*科栋

身份：测试

个人介绍：

无。

2. 团队开发情况

2.1 项目预期

2.1.1 团队项目的目标

红色为Alpha阶段实现的功能，蓝色为Beta阶段实现的功能。

完善功能

Beta阶段中我们对Alpha阶段实现的功能进行了改进，增加了课程收藏功能、资源评价功能、资源分类功能等等，这些细微的功能可以大大增强用户体验。

提供交流平台

我们认为，在学习过程中，同学们最需要的是总结和交流。和Alpha阶段一样，我们的最终目标一直是排除同学们在学习道路上的困难，因此在Beta阶段中，我们增加了讨论版功能，同学们遇到任何问题都可以在讨论版进行交流。

2.2 用户量情况

在排除所有测试账号的情况下：

• 截至Alpha阶段结束，网站访问ip数（不计APP）约为220，注册量为30；
• 截至Beta阶段结束，网站访问ip数为633，同期增长率为187.7%，注册量为148，同期增长率为393.3%。

经统计，截至Beta阶段结束，Android用户占比最高，为45%，其次为网页端用户，为33%，同袍用户占19%。此外，还有少部分用户同时为同袍和Android用户。

结果显示，超过80%用户只是临时使用iCourse获取资源，但依然有近百位用户多次使用iCourse获取资源（访问天数为10以上的ip可能属于开发人员）（该结果仅为网页端）

目前APP下载量为214

2.3 一些进步

2.3.1 分工协作情况

Beta阶段相比于Alpha阶段，团队的分工更明确了。在Beta阶段开始前，我们将要实现的功能分为两类，一类是对资源共享的扩展，一类是全新的博文功能。这两大类功能之间关联性较低，由两位后端成员各自负责一类最为合适，这样各自的工作会变得独立，降低沟通带来的成本。

2.3.2 贡献分分配

在Alpha阶段中，贡献分分配规则太过复杂，如任务难度还要分为预计和实际两部分，记录贡献的成本有些高。在Beta阶段中，贡献分被简化为时长、难度和完成情况三部分，其中难度和完成情况的评分有着明确的标准，而时长一旦确定，之后会尽量避免改动。对本人实现功能的bug修正，不再新建“贡献项”，而是根据bug类型适当提高原“贡献项”的难度。

任务完成得分 = 完成度 * 时长 * (1 + 难度) * 5

2.3.3 文档完善情况

Beta阶段我们有了较为完备的数据库说明文档、API说明文档，并在老师的建议下添加了配置说明文档，全部文档位于/docs/目录下。

在Beta阶段中，成员们可以根据事先设计的API文档实现功能，缩短了沟通的时间，提高了工作效率。

同时，每名成员的贡献分也同样在/docs/目录下，做到了贡献情况的透明，保证公平性。

2.3.4 issue的建立

经老师建议，我们将测试及使用中遇到的bug及时以issue的形式记录在github上，当bug被解决的时候再将其close。

2.3.5 推广手段

Alpha阶段中，我们唯一的推广手段只有朋友圈；而在Beta阶段中，除了在朋友圈中进行推广，我们还在未来花园、同袍App、公众号上进行推广，从用户量增长情况可以看出取得了一定的效果。

未来花园：

同袍：

2.4 时间/质量/资源的平衡

Beta阶段中团队面临的情况十分险峻——前端开发人员的减少（2人变为1人）、编译课设的开始、期末各种DDL轮番轰炸都是我们面临的挑战。不仅人手少了，成员们可分配给软工的时间也远远不如Alpha阶段。最终的结果是后端实现了充分的功能，而前端只能视情况挑选必要的将其衔接到界面中。

2.5 测试情况

• jmeter中设置用户数为30，循环次数为“永远”，运行起始时间为2017.12.23 00：30， 运行结束时间为2017.11.25 00：34， 平均请求响应时间为3.6s，错误率为0，30个用户，3.6s的平均响应时间偏慢，响应最慢的url是course/contrib，这个是计算课程的用户贡献度的，速度比较慢的原因推测是每次计算课程用户复杂度时，都要重新遍历数据库，重新计算用户贡献度，因此较慢，具体数据见下图：
  
  

• 测试人员同样尝试了用户数为35,33,31的情况，运行10min左右后，发现均会出现微小的错误，大约千分之几到百分之几的样子，这说明30个用户已是网站的最大负载。

• 2017.12.28 将服务器上运行的进程数由1增加到10，最大负载增加到141个用户。尝试142/143个用户时都会出现微小错误。

• 2017.12.29 经过刘畅同学和赵奕同学的优化，平均响应时间降至1.4s,较第一次测试的平均响应时间降低61%，最大用户数不变。

2.6 代码规范

我们使用的是npm自带的代码规范审查，包括但不限于：

• 大括号之中的内容和左右大括号之间必须有空格或换行
• 所有引号必须为单引号
• 不允许出现tab
• 每行末尾必须有空格
• 不允许出现声明变量未使用的情况

另外在view.py中，我们对函数实现的功能进行了一个简要的说明，大大提升代码可读性，如图：

2.7 一些反思

• Beta阶段出现的最严重的问题是预计实现的功能太多，而由于临近期末大家时间都很紧，导致最终也只是实现了一部分。当全部功能的实现得不到保证的时候，不同功能之间的优先级就显得很重要，然而PM却没有及时对计划进行调整，实在是缺乏大局观
• 代码管理得不到位，基本上全部后端的实现都堆在几个.py文件里（views.py文件达到了2000行），影响开发效率，而且命名规则也没有统一
• 除了Beta阶段开始时备份过一次数据库，此外再也没有对数据库进行备份

3. 进展情况

3.1 燃尽图

最后一次会议的燃尽图：



这个燃尽图是根据github中issue的关闭情况自动生成的，因此符合开发的实际情况。

由于编译课设比较紧张，而且团队人手又不太充足，团队进展速度时快时慢，最终未能在期限内完成预计的工作，只得暂时放弃一些非核心的功能。

3.2 发布的功能

我们的网站： 北航iCourse课程资源平台

3.2.1 首页

3.2.2 课程搜索页面

3.2.3 课程信息页面

3.2.4 课程资源页面

3.2.5 资源信息面板

3.2.6 课程讨论版

3.2.7 帖子页面

3.2.8 登录面板

3.2.9 个人中心

4. 团队成员在Beta阶段的角色和具体贡献：

4.1 代码贡献

使用如下指令，统计每个人Beta阶段（2017-11-22以后）代码贡献

git log --format='%aN' | sort -u | while read name; do echo -en "$name\t"; git log --since==2017-11-22 --author="$name" --pretty=tformat: --numstat | awk '{ if ($1 >= 0) {add += $1; subs += $2; loc += $1 - $2} } END { printf "added lines: %s, removed lines: %s, total lines: %s\n", add, subs, loc }' -; done

辛德泰（前端）：3139

方科栋（测试）：170

张安澜（后端）：923

赵奕（后端）：3966

刘畅（PM）：3760

使用如下指令，统计全部代码贡献：

git log --format='%aN' | sort -u | while read name; do echo -en "$name\t"; git log --author="$name" --pretty=tformat: --numstat | awk '{ if ($1 < 500) {add += $1; subs += $2; loc += $1 - $2} } END { printf "added lines: %s, removed lines: %s, total lines: %s\n", add, subs, loc }' -; done

辛德泰（前端）：5259

窦鑫泽（前端）：2067

方科栋（测试）：519

张安澜（后端）：2283

赵奕（后端）：5380

刘畅（PM）：5360 + 1351

由于git的代码贡献统计不一定准确，该结果仅供参考。

4.2 最终贡献分

各成员贡献情况。贡献分的计算方式依照事先制定的贡献分分配文档（有一定调整）。

由于又出现了同分的情况，具体分配结果有待调整

分配结果：

姓名	贡献分
方科栋	51
辛德泰	52
刘畅	47
张安澜	40
赵奕	60

5. 存在的问题

2018.1.1

搜索到的结果可能会不全，目前还没有定为到具体原因。