四则运算系统：分析和设计
分析与设计
PS：由于分析和设计都整合在一个文档里，所以这次的作业就直接以一个文档的形式交出来的。
目 录
0. 文档介绍
0.1 文档目的
0.2 文档范围
0.3 读者对象
1. 产品介绍
1.1 产品简介
1.2 产品范围
1.3 产品面向的用户群体
1.4 产品中的角色
1.5 产品的要求和优势
2. 具体需求说明
2.1 用户界面
2.2 用例图
2.3 类图
2.4 顺序图
2.5 功能性需求分类
3. 应用技术
4. 编码规范
5. 需求规格书变更记录表
0. 文档介绍
0.1 文档目的
主要是将四则运算的开发设计及开发需求进行介绍。
0.2 文档范围
对软件项目不熟悉的人员也可以通过阅读文档了解该软件的功能。
总体上属于发技术人员使用的文档。
0.3 读者对象
无软件工程基础的客户。
开发技术人员以及具备计算机相关知识的专业人员。
1. 产品介绍
1.1 产品简介
信息技术迅猛发展，使人们的工作方式、学习方式和生活方式受到了前所未有的冲击，网络凭借其信息存储容量大，表现形式多样化，高度共享、扩展性以及交流的实时性和便利性等独特的优势，在教育领域中得到了广泛的应用，为学校教育教学提供了丰富的资源。小学生四则运算软件的开发无疑对小学数学的教学方式带来了极大的便利，使得教师、学生、学生家长三方可以紧密联系，教师可以随时随地对学生对知识的掌握程度进行了解，减少了办公环境的束缚；学生可以较为自由地完成作业练习、随堂测试等，并且系统自动生成错题集，供学生复习使用，学生可对错题集进行增删操作；学生家长可以时刻紧密关注自己孩子的学习情况；并且用网络代替纸质材料，极大程度上保护了环境，无疑这将是一个百利而无一弊的革命性产品，本产品的开发势在必行。
1.2 产品范围
产品用于小学的学校的数学教学中。用于锻炼小学生的计算能力。
1.3 产品面向的用户群体
本产品主要面向小学教师、小学生以及学生家长，可以给小学教师提供一个及时了解自身教学质量、学生对知识掌握情况的平台，可以给小学生提供一个自我检测的平台，可以给学生家长一个对自己孩子学习情况进行深入了解的平台，并且三方用户均可在软件中以私信方式进行家校互联。
1.4 产品中的角色
|
角色名称 |
职责描述 |
|
教师 |
组建班级、布置在线测试题、布置在线作业题、文件上传、与学生和家长在线交流； |
|
学生 |
完成在线测试题、作业题、文件下载、使用和错题集、与教师进行在线交流 |
|
学生家长 |
查看学生作业完成情况、测试情况、文件下载、与教师进行在线交流 |
1.5 产品的要求和优势
·用户管理要求：
任何系统都不是完美的，都需要进行管理，本软件设置三种身份的用户，分别是教师用户、学生用户、学生家长用户，教师用户通过教师帐号登录后可以管理本班级用户，可以对上传信息等内容进行维护，可以查看自己组建班级的所有信息。
·本产品的优势：
自动生成的四则运算式子，加上自动计算、查重功能可以快速生成题目，省去繁琐的计算题出题过程。
2 具体需求说明
2.1 用户界面
这里使用了墨刀创建原型：
墨刀链接：https://modao.cc/app/71nZ2fyF1PzOBB8nkY7nyFq4tzqU7Zm
2.2 用例图&用例规约
用例US1：组建班级
范围: 四则运算课堂平台
级别: 用户目标
主要参与者: 老师、学生
涉众及其关注点:
- 老师：灵活地建立需要的班级；闲杂人等不能加入班级。
- 学生：灵活、正确地加入班级。
前置条件：以老师身份登录账号
后置条件：暂无
基本流：
1. 老师建立一个班级，建立班级的同时生成一个独一无二的邀请码。
2. 学生通过邀请码申请进入班级。
3. 老师通过申请。
4. 加入班级成功。
扩展流：
1a. 老师设置了不需要审核进入班级。
1. 学生通过邀请码进入班级。
2. 学生成功进入班级。
2a. 学生输入的申请码错误。
1. 加入失败，提示重新输入。
3a. 老师拒绝了加入申请。
1. 学生加入班级失败。
特殊需求：
暂无
用例UC2：在线测试
范围: 四则运算课堂平台
级别: 用户目标
主要参与者: 老师、学生
涉众及其关注点:
-老师：能够发布限时的测试，拥有一个友善的题目编辑系统协助出题。
- 学生：可以及时地收到测试发布信息，参与测试，答题界面友好。
- 题目编辑系统：供给各种出题方案，例如自定义编辑、题库、自动生成等。可以满足老师出题的需求，让老师有效率地完成繁琐的出题工作。
前置条件：老师已经建立好班级，并且已经拥有学生。并且题目编辑系统完善。
后置条件：
基本流：
1. 老师通过题目编辑系统完成出题工作。
2. 老师发布测试，并设定最晚完成时间和答题时间等相关限制条件。
3. 学生进入答题，在规定的时间内提交测试。
4. 测试根据老师的设定统计完分数之后，保存下来。
5. 测试中的错题自动保存到学生的错题集。
扩展流：
3a. 学生没有在规定时间内进入答题。
1. 显示该测试未提交，统分时分数为0
3b. 学生没有在答题时间结束之前提交。
1. 在时间结束时强制提交。
4a. 老师可以手动更改批改结果。
1. 结果提交后，保存。
特殊需求：
用例UC3：在线聊天
范围: 四则运算聊天平台
级别: 用户目标
主要参与者: 老师、学生、家长
涉众及其关注点:
- 老师：老师可以跟自己班级的学生、学生对应的家长聊天
- 学生：学生可以跟所在班级的老师、同学聊天
- 家长：可以跟孩子所在班级的老师聊天
前置条件：
后置条件：
基本流：
1. 打开联系人页面，寻找合适的聊天对象。
2. 进入聊天窗口进行聊天。
扩展流：
特殊需求：
用例UC4：文件上传下载系统
范围: 四则运算课堂平台
级别: 子功能级别
主要参与者: 老师、学生、家长
涉众及其关注点:
- 老师：老师可以上传资料和作业文件
- 学生：学生可以下载作业相关文件和老师上传的资料；可以上传作业
- 家长：家长可以下载学生作业、资料到本地
前置条件：
后置条件：
基本流：
1. 选择上传（下载）的文件。
2. 上传（下载）成功。
扩展流：
特殊需求：
用例UC5：查看作业提交情况/测试成绩
范围: 四则运算课堂平台
级别: 用户目标
主要参与者: 老师、学生、家长
涉众及其关注点:
- 老师：老师可以查看本班学生的测试、作业相关的情况
- 学生：学生可以查看自己的测试成绩、作业批改情况
- 家长：家长可以查看自己的孩子的测试、作业
前置条件：
后置条件：
基本流：
1. 学生完成测试或者提交作业。
2. 老师批改完成后，学生家长老师都可以查看测试结果；查看作业提交情况。
扩展流：
特殊需求：
2.3 类图
2.4 顺序图
2.5 功能性需求分析
|
功能类别 |
子功能 |
|
用户管理 |
注册管理 登录管理 ... |
|
私信系统管理 |
登录管理 私信记录管理 … |
|
文件系统管理 |
用户管理 用户身份管理 班级管理 文件上传 文件下载 |
|
测试题系统管理 |
用户身份管理 查重 正误检测及评分管理 |
|
作业系统管理 |
用户身份管理 正误检测及评分管理 |
|
班级管理 |
用户身份管理 班级邀请码管理 用户管理 |
|
错题集系统（仅学生可用） |
用户管理 增删查操作 |
3 应用技术
产品形成手机网页的形式，采用前后端分离的结构。
实现选用的技术：前端暂时使用和html5.
后端使用springMVC
数据库使用mysql
与数据库交互使用mybatis
4 编码规范
（1） 命名风格：
a) 类名使用 UpperCamelCase 风格，必须遵从驼峰形式。
b) 方法名、参数名、成员变量、局部变量都统一使用 lowerCamelCase 风格，必须遵从驼峰形式。
c) 常量命名全部大写，单词间用下划线隔开，力求语义表达完整清楚，不要嫌名字长。
d) 为了达到代码自解释的目标，任何自定义编程元素在命名时，使用尽量完整的单词组合来表达其意。
（2） 代码格式：
a) 大括号的使用约定。如果是大括号内为空，则简洁地写成{}即可，不需要换行。
b) 左小括号和字符之间不出现空格；同样，右小括号和字符之间也不出现空格。
c) 注释的双斜线与注释内容之间有且仅有一个空格。
d) 方法参数在定义和传入时，多个参数逗号后边必须加空格。
e) 重要的地方要加入注释。
5 需求规格书变更记录表
变更历史
|
序号 |
变更内容 |
变更页 |
变更类别 |
变更者 |
|
1 |
|
|
|
|
|
2 |
|
|
|
|
|
3 |
|
|
|
|
|
4 |
|
|
|
|
|
5 |
|
|
|
|
|
6 |
|
|
|
|
|
7 |
|
|
|
|
|
8 |
|
|
|
|
|
9 |
|
|
|
|
分工：
池江洁：原型设计
林正扬：需求文本
谢锦鸿：用例图&用例规约
费鸿玺：类图
林金德：顺序图
