规格说明书文档（团队项目第1组）

版本号：V0.1

 

版本号	修改说明

一、引言

1、项目背景

 “构建之法”于2007年在清华大学首次实践，随后经过在北航、东北师范大学、福州大学、集美大学等三十余所学校的不断迭代与改进，现已形成了一套成熟的软件工程课程教学体系，覆盖了软件工程和编程语言的教学。该教学体系有下面的特点：

·       练习量大, 内容多：除了大量的代码练习，还有大量的博客写作练习。

·       理论和实践相结合：讲现代理论，同时结合体现理论的工具，例如：要求所有代码使用Git和Github进行管理。

·       真实的团队开发：要求使用原型设计工具设计项目，使用团队开发工具管理任务分配，使用燃尽图进行进度管控等等一应俱全。

·       学生助教熟悉课程，能够协助老师，与学生充分互动。

       

        在基于“构建之法”思想的软工课程教学中，在团队项目阶段，主要采用博客和Github方式发布团队作业并对源代码进行管理。教师和助教需要对项目团队管理质量进行度量并给予学生及时反馈和有效指导。当前这些工作都是人工进行，效率较低，步骤和流程较为繁琐，缺乏必要的数据统计与汇总。因此需要一款软件系统支持这项工作的开展。

 

l  项目名称：团队项目度量反馈平台

l  面向用户：高校软工教学团队与学习软工的学生

l  项目开发者：北航软工暑期培训班团队项目1组

二、典型用户与场景

1、典型用户及需求

本系统主要有三类典型用户：

l  软工教学的教师：查看所有项目团队的源代码管理质量以及项目进度管理质量并给予反馈，查看每位学生在项目团队内的贡献情况

l  软工课程的助教：查看自己所负责的项目团队的源代码管理之里昂以及项目进度管理质量并给予反馈，查看所负责项目团队内的每位学生在队内的贡献情况

l  软工课程的学生：查看自己所在项目的源代码管理质量、项目进度管理质量、教师和助教的反馈信息以及参考文献

2、典型场景

（1）软工课教师邹老师

名字	邹老师
性别	男
职业	某高校软工教师
动机	学生的源代码管理质量和进度管理质量实在惨不忍睹，学生太多啦！可不可以自动检测这些项目的源代码管理质量和项目进度管理质量啊！
目的	自动评价学生团队项目度源代码管理质量和项目进度管理质量并根据情况给予反馈和指导
困难	学生数量太多，源代码管理质量和项目进度管理质量评估复杂
典型场景	登陆平台，浏览所有项目团队的源代码管理质量，点击按钮进入某个项目团队的项目管理质量详细分析界面，了解详细情况后填写反馈和指导信息。
典型描述	额……就一次提交？

 

 

（2）软工课助教小夏

名字	小夏
性别	男
职业	某高校软工助教生软工课程助教
动机	减少助教工作量、防止误判、规范化评价标准
目的	让评价有据可依，拿数据说话；促进公平，减少人工认定的误差率；
困难	学生个人情况复杂，评价尺度难以普适性；需要及时更新，紧随项目进展信息低下
典型场景	登录平台，浏览所有项目团队的源代码管理质量，点击按钮进入某个项目团队的项目管理质量详细分析界面。当助教给最终性评价时，需要大量的数据作为支撑，此时需要人工评价。指导信息。
典型描述	这个代码运用了新技术，但是考核里面没有，该如何处理？天的工作是什么鬼？

 

（3）软工课学生小刘

名字	小刘
性别	女
职业	某高校软工课程学生
动机	防止助教个人因素导致评分工作出现偏差，引起学生逆反心理，从而推进课程进程。进度，得到老师的评价和反馈。
目的	使助教评价作业有统一标准，对学生工作负责
困难	学生作业较多，助教工作难以保证评价不受主观因素影响
典型场景	学生对于作业分数有疑问，助教可以根据需要给出评价标准。多少；提交Issue ID，任务内容描述，代码签入ID，博客地址等内容，查看教师评分和反馈，或查看课程相关资料的专栏
典型描述	为什么不能只提交一次！？

 

3、运行环境

网站预计支持火狐浏览器和谷歌浏览器，对IE浏览器，支持IE10以上版本。

 

三、原型设计

 

 四、功能描述及验收标准

测试功能	测试项	输入/操作	检测点	测试功能	完成情况
项目列表页	概要查看	点击	是否跳转至概要页面	进入页面	已完成
	代码评估	点击	是否跳转至代码评估页面	进入页面	已完成
	进度评估	点击	是否跳转至进度评估页面	进入页面	已完成
	项目搜索	输入条件，点击确定	确认是否与搜索条件匹配的项目列表	找到相关列表
质量评估页面	质量评分	查看	是否显示正确数据	数据显示	已完成
	代码修改量	查看	是否显示正确数据	数据显示	已完成
	项目管理质量评价	查看	是否显示正确数据	数据显示	已完成
	反馈	查看	是否显示正确数据	数据显示

 

版本号：V0.1

 

版本号	修改说明