C/README.md

#学生成绩管理系统
2023年4月22日
刘梦琦  、 马誉航  、 王意伟  、 刘鑫成
## 项目简介
本学生成绩管理系统是为教师提供管理班级成绩的工具，该系统可以实现的对学生的成绩进行增、删、改、查、信息保存和信息导入等基本功能，以及对学生成绩排序和分段的扩展功能，有利于对学生成绩管理。

下载地址：https://bdgit.educoder.net/pe3l754au/C.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: 输入查询学号
Step 2:  for 0 to num_part-1 查询
Step 3: 根据查询结果输出

![](query_data.svg)
### add_data
### update_data
### delete_data
### sort_data
### make_chart