成绩管理子系统
该文档是计科1605班软件工程课程设计，成绩管理子系统的开发模块仓库。内容包含：
会议记录
功能分析
从面向的用户分，成绩管理子系统主要面向三类用户，即至少需要满足这三类用户的需求：
- 学生：学生是成绩管理系统的最基本的用户，需要向学生提供：
- 查看课程成绩。成绩信息汇总，并提供打印下载功能。
- 申请成绩复议。
- 提交教师评价与课程评价。
- 教师：教师也是成绩管理系统的重要用户，教师需要使用成绩管理系统：
- 提交学生成绩。
- 打印学生成绩。
- 查看和下载成绩汇总，班级、年级等角度，从而能够对学生成绩有一个更好的把握。
- 管理员或学校领导：这是成绩管理系统的高级用户，需要向其提供：
- 学生成绩的查询界面，需要支持多个维度的查询功能，并支持模糊查询。
- 生成关于学生成绩的各类统计报表功能。包括成绩统计的直方图（包含平均值、中位数、众数等）、学期成绩变化的曲线、学院角度分析、专业角度分析等。
人员分工
开发内容涉及到很多的前端工作，需要设计出比较好用用户体验比较好的界面以及图像展示效果。
- 开发人员：编制代码，构建系统，完成前后端的设计和开发，以及用户交互、图标生成等功能的构建。
- 测试人员：测试代码，单元测试的编写，测试开发人员编制的函数的鲁棒性、健壮性。开发的界面是否美观、交互是否好用。需要撰写详细的测试文档，并及时反馈。
周报书写规则
采用在github上提交issue的方式来作为每周汇报。目的是回顾每周的工作情况,促进交流提升。
格式：
标题： Review-{yyyy\mm\dd(必须为当周周日)}-{姓名}
i.e: Review-2019/03/17-罗登
内容：使用Markdown标记语言编辑自己这周的工作学习内容及下周的安排。
教程：Markdown教程
Markdown编辑可以使用在线的作业部落, 或原生支持Markdown的Atom，或者VS Code，小书匠等工具。
weekly-review 参考：Review-2018/12/16-罗登
Tips：
- 重要的是记录下自己这周做了什么及其心得
- 如果明确安排了任务，可以叙述自己的任务的完成情况；如果没有安排任务，可以叙述平时的学习情况、学习心得，网上见到的比较有趣的东西。
- GitHub的issues是可以评论的, 欢迎大家多多评论别人提交的review
- 点击右上角的
Watch按钮 关注Weekly-review的动态
需求分析规格说明
用例图
学生用例分析
<!DOCTYPE html> <html lang="zh"> <head> <meta charset="utf-8"/> <link rel="shortcut icon" href="https://www.mdeditor.com/images/logos/favicon.ico" type="image/x-icon"/> </head> <body><h1 id="h1-u5B66u751Fu7528u6237u793Au4F8B"><a name="学生用户示例" class="reference-link"></a><span class="header-link octicon octicon-link"></span>学生用户示例</h1><p>前提条件：学生的用户名和账号必须是正确的</p> <h2 id="h2--1-"><a name="用例1：学生通过访问网站，查询某学期成绩，并打印出成绩单" class="reference-link"></a><span class="header-link octicon octicon-link"></span>用例1：学生通过访问网站，查询某学期成绩，并打印出成绩单</h2><p>参与者：学生<br>情境目标：学生查询到自己的成绩信息，打印成绩单 </p><h3 id="h3--"><a name="场景：" class="reference-link"></a><span class="header-link octicon octicon-link"></span>场景：</h3><h4 id="h4-1-"><a name="1、学生访问到该网站，输入用户名，密码，选择学生身份，登录；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>1、学生访问到该网站，输入用户名，密码，选择学生身份，登录；</h4><h4 id="h4-2-"><a name="2、学生选择成绩查询功能；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>2、学生选择成绩查询功能；</h4><h4 id="h4-3-3-"><a name="3、如果学生已经完成教学评价，可以接着该用例往下走；如果未完成，看到提示后，进入用例3，完成教学评价；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>3、如果学生已经完成教学评价，可以接着该用例往下走；如果未完成，看到提示后，进入用例3，完成教学评价；</h4><h4 id="h4-4-"><a name="4、网站中有学期和学年的选择框，有查询和打印两个按钮；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>4、网站中有学期和学年的选择框，有查询和打印两个按钮；</h4><h4 id="h4-5-"><a name="5、学生选择好学期和学年后，点击查询，网站中列出成绩单（课程号，课程名，任课老师，学院，专业，学分，分数，评级，绩点），成绩单中还有本学期总绩点的学分。" class="reference-link"></a><span class="header-link octicon octicon-link"></span>5、学生选择好学期和学年后，点击查询，网站中列出成绩单（课程号，课程名，任课老师，学院，专业，学分，分数，评级，绩点），成绩单中还有本学期总绩点的学分。</h4><h4 id="h4-6-"><a name="6、点击打印，预览后打印出成绩单；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>6、点击打印，预览后打印出成绩单；</h4><h2 id="h2--2-"><a name="用例2：学生通过访问网站，进行成绩复议" class="reference-link"></a><span class="header-link octicon octicon-link"></span>用例2：学生通过访问网站，进行成绩复议</h2><p>参与者：学生<br>情境目标：学生向学校申请成绩复议，并得到回复 </p><h3 id="h3--"><a name="场景：" class="reference-link"></a><span class="header-link octicon octicon-link"></span>场景：</h3><h4 id="h4-1-"><a name="1、学生访问到该网站，输入用户名，密码，选择学生身份，登录；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>1、学生访问到该网站，输入用户名，密码，选择学生身份，登录；</h4><h4 id="h4-2-"><a name="2、学生选择成绩复议功能；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>2、学生选择成绩复议功能；</h4><h4 id="h4-3-"><a name="3、网站中出现几个小功能模块：" class="reference-link"></a><span class="header-link octicon octicon-link"></span>3、网站中出现几个小功能模块：</h4><h5 id="h5--1-"><a name="（1）申请复议：学生将新建一个成绩复议表单，按照表中提示填信息之后，可以提交给学校；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>（1）申请复议：学生将新建一个成绩复议表单，按照表中提示填信息之后，可以提交给学校；</h5><h5 id="h5--2-"><a name="（2）复议回复：学生将再次看到自己收到的复议回复，未读和已读都有标记，学生可以查看和删除；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>（2）复议回复：学生将再次看到自己收到的复议回复，未读和已读都有标记，学生可以查看和删除；</h5><h5 id="h5--3-"><a name="（3）复议草稿箱：学生未提交出去的成绩复议表单将保存在这里；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>（3）复议草稿箱：学生未提交出去的成绩复议表单将保存在这里；</h5><h5 id="h5--4-"><a name="（4）复议记录：学生提交过的复议记录，有日期信息。学生可以查看和删除记录；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>（4）复议记录：学生提交过的复议记录，有日期信息。学生可以查看和删除记录；</h5><h5 id="h5--5-"><a name="（5）垃圾箱：学生删除过的记录和表单都暂时保存在此，可以回收，删除，清空；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>（5）垃圾箱：学生删除过的记录和表单都暂时保存在此，可以回收，删除，清空；</h5><h4 id="h4-4-"><a name="4、学生点击申请复议，填好信息，点击提交，提示成功，申请已经分别交给老师和教务人员。" class="reference-link"></a><span class="header-link octicon octicon-link"></span>4、学生点击申请复议，填好信息，点击提交，提示成功，申请已经分别交给老师和教务人员。</h4><h4 id="h4-5-"><a name="5、一段时间后（这段时间教务人员和老师在交互），学生登录网站，在主页有消息提示，点击进入“复议回复”模块中可以查看。" class="reference-link"></a><span class="header-link octicon octicon-link"></span>5、一段时间后（这段时间教务人员和老师在交互），学生登录网站，在主页有消息提示，点击进入“复议回复”模块中可以查看。</h4><h2 id="h2--3-"><a name="用例3：学生通过网站，对本学期进行教学评价" class="reference-link"></a><span class="header-link octicon octicon-link"></span>用例3：学生通过网站，对本学期进行教学评价</h2><p>参与者：学生<br>情境目标：学生在网站中完成教学评价，评价提交后不可更改 </p><h3 id="h3--"><a name="场景：" class="reference-link"></a><span class="header-link octicon octicon-link"></span>场景：</h3><h4 id="h4-1-"><a name="1、学生访问到该网站，输入用户名，密码，选择学生身份，登录；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>1、学生访问到该网站，输入用户名，密码，选择学生身份，登录；</h4><h4 id="h4-2-"><a name="2、学生选择教学评价功能；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>2、学生选择教学评价功能；</h4><h4 id="h4-3-"><a name="3、网站中条列出本学期的所有课程和老师，已评价的提供查看功能，未评价的点击评价进行问卷评价。" class="reference-link"></a><span class="header-link octicon octicon-link"></span>3、网站中条列出本学期的所有课程和老师，已评价的提供查看功能，未评价的点击评价进行问卷评价。</h4><h4 id="h4-4-"><a name="4、学生点击评价，填写好问卷调查。" class="reference-link"></a><span class="header-link octicon octicon-link"></span>4、学生点击评价，填写好问卷调查。</h4><h4 id="h4-5-"><a name="5、问卷末尾，有确定，重填和提交三个按钮，确定用来固定答案，重填用来清空原来的填写，提交把问卷提交至教务管理人员处。" class="reference-link"></a><span class="header-link octicon octicon-link"></span>5、问卷末尾，有确定，重填和提交三个按钮，确定用来固定答案，重填用来清空原来的填写，提交把问卷提交至教务管理人员处。</h4><h4 id="h4-6-"><a name="6、全部提交完成后，本项完成。" class="reference-link"></a><span class="header-link octicon octicon-link"></span>6、全部提交完成后，本项完成。</h4><h2 id="h2--4-"><a name="用例4：学生通过网站，查看大学成绩总体情况" class="reference-link"></a><span class="header-link octicon octicon-link"></span>用例4：学生通过网站，查看大学成绩总体情况</h2><p>参与者：学生<br>情境目标：学生在网站中完成查看自己的学业情况（已获得学分，总绩点等） </p><h3 id="h3--"><a name="场景：" class="reference-link"></a><span class="header-link octicon octicon-link"></span>场景：</h3><h4 id="h4-1-"><a name="1、学生访问到该网站，输入用户名，密码，选择学生身份，登录；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>1、学生访问到该网站，输入用户名，密码，选择学生身份，登录；</h4><h4 id="h4-2-"><a name="2、学生选择成绩总览功能；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>2、学生选择成绩总览功能；</h4><h4 id="h4-3-"><a name="3、网站前几行有总学分，总绩点，以及大学各类课程所修数量；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>3、网站前几行有总学分，总绩点，以及大学各类课程所修数量；</h4><h4 id="h4-4-"><a name="4、网站中出现几个统计模块，每个模块上显示该模块中课程数量，总学分，模块如下：" class="reference-link"></a><span class="header-link octicon octicon-link"></span>4、网站中出现几个统计模块，每个模块上显示该模块中课程数量，总学分，模块如下：</h4><h5 id="h5--1-2-3-4-"><a name="（1）必修课（2）选修课（3）通识课（4）其他课" class="reference-link"></a><span class="header-link octicon octicon-link"></span>（1）必修课（2）选修课（3）通识课（4）其他课</h5><h4 id="h4--"><a name="点击模块展开相应类别的所有已修课程信息，包含课程名，课程代码，绩点，学分，评级；" class="reference-link"></a><span class="header-link octicon octicon-link"></span>点击模块展开相应类别的所有已修课程信息，包含课程名，课程代码，绩点，学分，评级；</h4><h4 id="h4-5-"><a name="5、点击打印按钮打印出所有模块和模块展开后的信息。" class="reference-link"></a><span class="header-link octicon octicon-link"></span>5、点击打印按钮打印出所有模块和模块展开后的信息。</h4></body> </html>
教师用例分析
教务管理员用例分析
UML类图
View函数列表
| 函数名 | 完成功能 | 传入参数 | 返回值 |
| :---: | :---: | :---: | :---: |
| stu_search_score | 学生查看自己本学期的成绩，包括了考试总分和平时分等成绩明细 |
| stu_view_stat | 学生查看自己成绩的统计信息，包括已修学分和未修学分，成绩走势 |
| stu_proposal | 学生针对某一门课提交成绩复议申请，填写相应的表单。对应的申请会被同时发送到教务管理人员和教师处，需要教师确认同意或者不同意，教务处起到监管的作用|
| stu_print_score | 学生打印自己的个人成绩 |
| stu_comment_tch | 学生对教师教学情况进行评价，填写相应的评教表单 |
| tch_upload_score_xls | 教师通过excel电子表格上传成绩 |
| tch_upload_score_online | 教师在线填写学生成绩 |
| tch_print_score | 教师打印自己教学班级的学生成绩信息 |
| tch_download_score | 教师下载学生成绩用于分析 |
| tch_proposal | 教师向教务处提出修改成绩申请 |
| get_xls_template | 根据教师所选条目，下载对应的填写和上传成绩的电子表格 |
| mg_view_proposal | 教务管理人员查看并且选择通过还是不通过学生和教师提出的修改成绩申请 |
| email_send | 在系统内发送email到对应的人员处，包括教务管理人员，教师，学生等 |
| get_xls_to_instructor | 汇总信息提交给专业辅导员(比如，计算机科学与技术的辅导员，通过调用该函数，获取到对应专业的学生各学科信息，结果需降序排列) |
| cal_stu_gpa | 计算该学生本学期所有成绩加权的综合GPA（通过对应公式加权计算）|
| cal_total_gpa | 计算该学生自入学以来的个学期GPA汇总|
| get_stu_course_score | 获取到该学生某指定一门课程的成绩，传入参数课程名和学号，如果不存在需要抛出对应的异常 |
| get_class_mean | 获取对应教学班级的平均分| class_name|
|
