You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
C1/README.md

309 lines
11 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

#学生成绩管理系统
2023年4月22日
刘梦琦 、 马誉航 、 王意伟 、 刘鑫成
## 项目简介
本学生成绩管理系统是为教师提供管理班级成绩的工具,该系统可以实现的对学生的成绩进行增、删、改、查、信息保存和信息导入等基本功能,以及对学生成绩排序和分段的扩展功能,有利于对学生成绩管理。
下载地址https://bdgit.educoder.net/pe3l754au/C1.git
项目开发过程中采用 Kanban看板进行任务管理和分工协作并使用 Git 对程序代码和文档进行版
本管理。任务分工情况如下:
```
------------------------------------------------
| 任务 | 设计 | 开发 | 测试 | 文档 |
| C1-C3 | 王意伟 | 刘鑫成 | 马誉航 | 刘梦琦 |
| C4-C6 | 刘梦琦 | 马誉航 | 王意伟 | 刘鑫成 |
| C7-C9 | 刘鑫成 | 王意伟 | 刘梦琦 | 马誉航 |
| C10-C12| 马誉航 | 刘梦琦 | 刘鑫成 | 王意伟 |
------------------------------------------------
```
每个成员的工作量(百分比):
```
刘梦琦 刘鑫成 王意伟 马誉航
25 25 25 25
```
##关于学生成绩管理系统
本学生成绩管理系统是为教师提供管理班级成绩的工具该系统可以实现的对学生的成绩进行增、删、改、查、信息保存和信息导入等基本功能以及对学生成绩排序和分段的扩展功能有利于对学生成绩管理。利用结构体——定义STU结构体存储学生学号、姓名、各科成绩总成绩和平均成绩利用文件来存储读取数据。
系统的功能性需求:
数据的读取、保存、打印、查询、修改、插入、删除、排序和图表展示。
系统的非功能性需求:
菜单驱动的命令行交互界面。
##需求分析
分析系统的功能需求和界面需求,编制用户手册如下。
###C1: 启动程序
命令行中执行命令 ./app ,系统启动,显示提示信息,然后显示功能菜单,等待用户输入命令。
```
学生成绩管理系统启动
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择:
```
###C2: 显示命令菜单
```
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择:
```
###C3: 退出程序
选择菜单命令 0 ,再输入 y 确认,则退出程序。
```
请选择0
确定要退出吗?(Y/N): y
程序退出
```
###C4: 录入学生信息
选择菜单命令 5 ,提示输入学生学号,若该学生不存在,则继续输入学生名称、名次,添加分数, 并提示完成;若学生学号存在,则提示学生已存在,并结束。
```
请选择5
输入学生学号101
输入学生名:李华
输入排名20
学生 101 已添加
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择5
输入学生学号101
学生已存在 .
```
###C5: 查询学生记录
选择菜单命令 4 ,提示输入学生学号,若该学生存在,则输出学生信息;否则提示学生不存在并结束。
```
请选择4
输入学生学号101
学生学号101
学生名称:李华
学生排名20
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择4
输入学生学号100000000
学生不存在 .
```
###C6: 打印学生成绩列表
选择菜单命令 3 ,打印
```
请选择3
-------------------------------------------------------
| NUMBER | NAME | RANK |
-------------------------------------------------------
| 101 |李华 | 20 |
-------------------------------------------------------
```
###C7: 修改学生成绩
选择菜单命令 6 ,根据提示输入学生学号,若学生成绩存在,则继续输入新的学生姓名和学生成绩,并修改库学生
记录;否则,提示学生不存在并结束。
```
请选择6
输入学生学号101
输入学生姓名:李华
输入学生成绩12
学生 101 已更新
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
| NUMBER | NAME | ON HAND |
| 101 | 李华 | 12 |
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择6
输入学生学号100
学生不存在.
```
###C8: 删除学生记录
选择菜单命令 7 ,根据提示输入学生学号,若学生存在,则删除之;否则提示学生不存在并结束。
```
请选择7
输入学生学号100
学生不存在.
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择7
输入学生学号101
学生 101 已删除
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
| NUMBER | NAME | ON HAND |
```
###C9: 学生记录排序
选择菜单命令 8 ,对学生记录按学生学号从小到大排序。
```
请选择3
| NUMBER | NAME | ON HAND |
| 101 | 李华 | 20 |
| 100 | 李芳 | 10 |
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择8
排序
排序已完成
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
| NUMBER | NAME | ON HAND |
| 100 | 李芳 | 10 |
| 101 | 李华 | 20 |
```
###C10: 读取学生成绩
选择菜单命令 1 ,提示输入文件名,若文件存在,则打开文件读取 CSV 格式保存的所有库存记录;否
则,若文件不存在,则给出错误信息并结束。
假设文件 a.csv 中,以 CSV Comma-Separated Values格式保存了如下记录
则读取记录的过程如下:
```
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 100 | 李芳 | 10 |
| 101 | 李华 | 20 |
-------------------------------------------------------
103,李明,8
104,李娜,12
101,李华,20
102,李美,10
请选择1
读取数据
请输入文件名a.csv
读取 4 记录
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 103 | 李明 | 8 |
| 104 | 李娜 | 12 |
| 101 | 李华 | 20 |
| 102 | 李美 | 10 |
-------------------------------------------------------
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择1
读取数据
请输入文件名a
a: No such file or directory
```
###C11: 将学生成绩保存保存到文件
选择菜单命令 2 ,提示输入文件名,将所有库存记录以 CSV 格式保存到指定的文件中
```
请选择2
保存数据
请输入文件名b.csv
保存 4 记录
```
###C12: 以图表方式显示学生成绩记录
选择菜单命令 9 ,以图表方式显示库存记录
```
请选择9
图表
103 : 李明 | ******** (8)
104 : 李娜 | ************ (12)
101 : 李华 | ******************** (20)
102 : 李美 | ********** (10)
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
```
## 概要设计
系统主要分为用户界面和数据处理两大模块。
用户界面模块包括系统初始化init显示菜单display_menu选择菜单命令
make_choice、确认confirm、退出quit等子模块。
数据处理模块包括读取数据read_data、保存数据save_data、打印数据print_data、查询
数据query_data、添加数据add_data、更新数据update_data、删除数据
delete_data、数据排序sort_data和生成图表make_chart等子模块。其中查询、添加、更
新和删除数据还会用到根据编号查询数据的方法find
上述各模块通过主程序main进行调用系统模块图如下。
![](main.svg)
各模块的主要功能如下:
### main
系统主函数模块,显示菜单,根据用户选择的菜单命令,执行相关操作。
### init
系统初始化。
### display_menu
显示菜单命令。
## 详细设计
针对概要设计
### main
```
Step 1: 初始化
Step 2: 根据用户选择的命令执行对应的操作
Step 2.1: 显示菜单
Step 2.2: 选择菜单命令 c
Step 2.3: if c == CMD_READ then 读取数据
Step 2.4: if c == CMD_SAVE then 保存数据
Step 2.5: if c == CMD_PRINT then 打印数据
Step 2.6:
```
![](main.svg)
### save_data
```
Step 1: 输入文件名
Step 2: 打开文件
Step 3: if 打开文件失败 then 提示打开文件失败并结束
Step 4: 将所有库存记录写入文件
Step 5: 关闭文件
```
![](save_data.svg)
### print_data
```
Step 1: for 0 to num_part-1
Step 2: 打印学生成绩
```
![](print_data.svg)
### query_data
```
Step 1: for 0 to num_part-1 查询
Step 2: 输入查询学号
Step 3: 根据查询结果输出
```
![](query_data.svg)
### add_data
```
Step 1: for 0 to num_part-1 添加
Step 2: 输入添加学号
Step 3: if 成立则结束 else 输入学生名称、名次,添加分数, 并提示完成
```
![](add_data.svg)
### update_data
```
Step 1: for 0 to num_part-1 修改
Step 2: 输入修改学号
Step 3: if 不成立则结束 else 输出学生信息
```
![](update_data.svg)
### delete_data
```
Step 1: for 0 to num_part-1 删除
Step 2: 输入删除学号
Step 3: if 不成立则结束 else 删除
```
![](delete_data.svg)
刘梦琦
通过这次的实验项目,我深刻体会到团队合作的意义,每个人都有自己要完成的任务,在遇到问题时需要队员间的
相互帮助。首先,分配好每个人的任务,其次,在最初开始任务时,我们都比较手足无措,都有对任务的疑问和困惑,通过讨论怎样去做、怎样完成任务进而解决问题,我们对学生系统要实现的功能有了一定了解后,按照模板进行项目推进,最后,每个人都完成了画图和实现部分项目功能的任务。虽然我是项目组长,但是有很多不足和需要改进的地方,遇到问题时在队员的帮助之下完成了相应的任务。一个项目的完成离不开一个团队的团结协作,在进行项目时,需要反复的纠错和改进,从而不断地提升自我。这一次很好的团队体验,让我能够初步地体会到一个团队间的分工协作的重要性,在以后的工作中,必然少不了团队合作,这次项目的完成为以后打下了基础,如果我们再遇到项目时,我们能够较好地知道怎样完成项目。