# text4
2023年5月21日
董函铄 胡煜男 于博 袁楷昊
## 项目简介
本系统是程序设计与问题求解课程设计项目，是为教师提供管理班级成绩的工具，该系统可以实现的对学生的成绩进行增、删、改、查、信息保存和信息导入等基本功能，以及对学生成绩排序和分段的扩展功能，有利于对学生成绩管理。项目采用 C 语言编程实现，在 VS Code 集成开发环境（ ）
下载地址：
项目开发过程中采用 Kanban（ ） ，
本管理。任务分工情况如下：
| 任务 | 设计 | 开发 | 测试 | 文档 |
|---|---|---|---|---|
| C1-C3 菜单驱动的用户界面 | 董函铄 | 董函铄 | 胡煜男 | 董函铄 |
| C4 添加学生信息及成绩 | 胡煜男 | 胡煜男 | 于博 | 胡煜男 |
| C5: 查询学生信息及成绩 | 于博 | 于博 | 袁楷昊 | 于博 |
| C6: 打印学生信息及成绩 | 袁楷昊 | 袁楷昊 | 董函铄 | 袁楷昊 |
| C7: 修改学生信息及成绩 | 董函铄 | 董函铄 | 于博 | 董函铄 |
| C8: 删除学生信息及成绩 | 胡煜男 | 胡煜男 | 袁楷昊 | 胡煜男|
| C9: 学生信息及成绩记录排序 | 于博 | 于博 | 董函铄 | 于博 |
| C10: 从文件中读取学生信息及成绩记录 | 袁楷昊 | 袁楷昊 | 胡煜男 | 袁楷昊 |
| C11: 将学生信息及成绩保存保存到文件 | 董函铄 | 于博 | 胡煜男 | 董函铄 |
| C12: 以图表方式显示学生信息及成绩 | 董函铄 | 袁楷昊 | 于博 | 胡煜男 |
每个成员的工作量（百分比）：
| 董函铄 | 胡煜男 | 于博 | 袁楷昊 |
|---|---|---|---|
| 30 | 20 | 30 | 20 |
## 关于实现学生成绩管理系统
设计一个学生成绩管理系统，要求采用命令行菜单界面进行交互，具备读取、保存、打印、查询、修改、插入、删除和排序等基本功能，能够以表格和图表形式展示数据，采用 CSV 格式保存数据。
系统的功能性需求：
- 数据的读取、保存、打印、查询、修改、插入、删除、排序和图表展示。
系统的非功能性需求：
- 菜单驱动的命令行交互界面。
## 需求分析
分析系统的功能需求和界面需求，编制用户手册如下。
#### 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` 确认，则退出程序。
```
请选择：
确定要退出吗？(Y/N): y
程序退出
```
#### C4: 添加库存记录
选择菜单命令 `5` ，提示输入学号，若该学生不存在，则继续输入学号、姓名、成绩，添加学号，并提示完成；若学号已存在，则提示学号已存在，并结束。
```
请选择：
输入学号：
输入姓名：小米
输入成绩：
学生 101 已添加
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
输入学号：
学号已存在.
```
#### C5: 查询学生信息及成绩
选择菜单命令 `4` ，提示输入学号，若该学号存在，则输出学号、姓名、成绩；否则提示学生不存在并结束。
```
请选择：
输入学号：
学号：
名字：小米
成绩：
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
输入学号：
学号不存在.
```
#### C6: 打印学生信息及成绩
选择菜单命令 `3` ，打印
```
请选择：
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 101 | 小李 | 80 |
-------------------------------------------------------
```
#### C7: 修改学生信息及成绩
选择菜单命令 `7` ，根据提示输入学号，若学号存在，则继续输入学号、姓名、成绩，并修改库存记录；否则，提示学号不存在并结束。
```
请选择：
输入学号：
输入姓名：小刘
输入成绩：
学生 104 已更新
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 104 | 小刘 | 96 |
-------------------------------------------------------
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
输入学号：
学生不存在.
```
#### C8: 删除库存记录
选择菜单命令 `7` ，根据提示输入学号，若学号存在，则删除之；否则提示学号不存在并结束。
```
请选择：
输入学号：
学号不存在.
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
输学号：
学生 101 已删除
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
-------------------------------------------------------
```
#### C9: 学生信息及成绩排序
选择菜单命令 `8` ，对学生按学号从小到大排序。
```
请选择：
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 101 | 小米 | 80 |
| 100 | 小明 | 70 |
-------------------------------------------------------
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
排序
排序已完成
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 100 | 小明 | 70 |
| 101 | 小米 | 80 |
-------------------------------------------------------
```
#### C10: 从文件中读取学生信息及成绩
选择菜单命令 `1` ，提示输入文件名，若文件存在，则打开文件读取 CSV 格式保存的所有库存记录；否则，若文件不存在，则给出错误信息并结束。
假设文件 `a.csv` 中，以 CSV （ ） ：
```
103,小红,80
104,小光,100
101,小米,80
102,小明,70
```
则读取记录的过程如下：
```
请选择：
读取数据
请输入文件名：
读取 4 记录
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 103 | 小红 | 80 |
| 104 | 小光 | 100 |
| 101 | 小米 | 80 |
| 102 | 小明 | 70 |
-------------------------------------------------------
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择：
读取数据
请输入文件名：
a: No such file or directory
```
#### C11: 将学生信息及成绩保存到文件
选择菜单命令 `2` ，提示输入文件名，将所有库存记录以 CSV 格式保存到指定的文件中。
```
请选择：
保存数据
请输入文件名：
保存 4 记录
```
#### C12: 以图表方式显示学生信息及成绩
选择菜单命令 `9` ，以图表方式显示库存记录。
```
请选择：
图表
103 : 小红 | ** ****** (80)
104 : 小光 | ** ********** (100)
101 : 小米 | ** ****************** (80)
102 : 小明 | ** ******** (70)
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
```
## 概要设计
系统主要分为用户界面和数据处理两大模块。
用户界面模块包括系统初始化（ ） ， （ ） ， （ ） （ ） （ ）
数据处理模块包括读取数据（ ） （ ） （ ） （ ） （ ） （ ） （ ） （ ） （ ） （ ）
上述各模块通过主程序（ ） ，
各模块的主要功能如下：
#### 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: if c == CMD_QUERY then 查询数据
Step 2.7: if c == CMD_ADD then 添加数据
Step 2.8: if c == CMD_UPDATE then 修改数据
Step 2.9: if c == CMD_DELETE then 删除数据
Step 2.10: if c == CMD_SORT then 排序数据
Step 2.11: if c == CMD_MAKE then 显示图表
Step 2.12: if c == CMD_QUIT then 退出
#### read_data
Step 1: 输入文件名
Step 2: 打开文件
Step 3: if 文件为空 then 结束
Step 4: else 读取文件
Step 5: 提示读取并记录
#### save_data
Step 1: 输入文件名
Step 2: 打开文件
Step 3: if 打开文件失败 then 提示打开文件失败并结束
Step 4: 将所有库存记录写入文件
Step 5: 关闭文件
#### print_data
Step 1: 输出学号、姓名、成绩
#### query_data
Step 1: 输入学生学号
Step 2: if学号不存在 then 提示学生不存在并结束
Step 3: else 学号存在 then 输出学号、姓名、成绩
#### add_data
Step 1: if 数据库满 then 提示数据库满并结束
Step 2: 输入学号
Step 3: if 学生已存在 then 提示学生已存在并结束
Step 4: 输入学生名字和成绩
Step 5: 添加学生到数据
Step 6: 提示添加成功
#### update_data
Step 1: 输入学号
Step 2: if 不存在 then 提示学生不存在并结束
Step 3: else 输入学号、姓名、成绩
Step 4: 已更新
#### delete_data
Step 1: 输入学号
Step 2: if 不存在 then 提示学生不存在并结束
Step 3: else 删除学生信息
Step 4: 提示删除成功
#### sort_data
Step 1: 读取文件
Step 2: 进行排序
Step 3: 提示排序已完成
#### make_chart
Step 1: 读取文件
Step 2: 显示图表
#### confirm
Step 1: 输出 确定要退出吗
Step 2: if 确认 then 退出
