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.
test--/README.md

413 lines
12 KiB

2 years ago
# 学生成绩管理系统
2023年4月22日
赵亚璇,连桢钰,翟梅瑛,刘宇婷
## 项目简介
项目开发过程中采用 Kanban看板进行任务管理和分工协作并使用 Git 对程序代码和文档进行版本管理。任务分工情况如下:
| 任务 | 设计 | 开发 | 测试 | 文档 |
| ---- | ---- | ---- | ---- | ---- |
| C1-C3 菜单驱动的用户界面 | 刘宇婷 | 刘宇婷 | 赵亚璇 | 刘宇婷 |
| C4 添加库存记录 | 连桢钰 | 连桢钰 | 翟梅瑛 | 连桢钰 |
| C5 查询库存记录| 赵亚璇 | 赵亚璇 | 连桢钰 | 赵亚璇 |
| C6 打印库存列表 | 翟梅瑛 | 翟梅瑛 | 刘宇婷 | 翟梅瑛 |
| C7 修改库存记录 | 刘宇婷 |刘宇婷|连桢钰|刘宇婷|
| C8 删除库存记录|连桢钰|连桢钰|赵亚璇|连桢钰|
| C9 库存记录排序|赵亚璇|赵亚璇|翟梅瑛|赵亚璇|
| C10从文件中读取库存记录|翟梅瑛|翟梅瑛|刘宇婷|翟梅瑛|
|C11将库存保存到文件|刘宇婷|赵亚旋|连桢钰|刘宇婷|
|C12以图标方式显示库存记录|刘宇婷|翟梅瑛|赵亚璇|连桢钰|
每个成员的工作量(百分比):
| 连桢钰 | 翟梅瑛 | 赵亚璇 | 刘宇婷|
| ---- | ---- | ---- | ----|
| 25 | 25 | 25 | 25 |
## 关于学生成绩管理系统
本学生成绩管理系统是为教师提供管理班级成绩的工具,该系统可以实现的对学生的成绩进行增,删,改,查,信息保存和信息导入等基本功能,以及对学生成绩排序和分段的扩展功能,有利于对学生成绩管理。设计思想是利用结构体--定义STU结构体存储学生学号姓名各科成绩总成绩和平均成绩利用文件来存储读取数据。
## 需求分析
分析系统的功能需求和界面需求,编制用户手册如下。
#### C1: 启动程序
2 years ago
命令行中执行命令 `./app`,系统启动,显示提示信息,然后显示功能菜单,等待用户输入命令。
```
库存管理系统启动
2 years ago
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
2 years ago
2 years ago
请选择:
```
2 years ago
#### C2: 显示命令菜单
2 years ago
```
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
2 years ago
2 years ago
请选择:
```
2 years ago
#### C3: 退出程序
2 years ago
选择菜单命令 `0`,再输入 `y` 确认,则退出程序。
2 years ago
2 years ago
```
请选择0
确定要退出吗?(Y/N): y
程序退出
```
2 years ago
#### C4: 添加库存记录
2 years ago
选择菜单命令 `5`,提示输入零件编号,若该零件不存在,则继续输入零件名称、库存数量,添加零件,并提示完成;若零件编号已存在,则提示零件已存在,并结束。
```
请选择5
输入零件编号101
输入零件名:电脑
输入库存数20
零件 101 已添加
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择5
输入零件编号101
零件已存在.
```
2 years ago
2 years ago
#### C5: 查询库存记录
2 years ago
选择菜单命令 `4`,提示输入学生学号,若该学生存在,则输出学号,姓名,成绩;否则提示学生不存在并结束。
2 years ago
2 years ago
```
请选择4
输入学生学号101
输入学号101
学号101
名字:小刘
成绩90
2 years ago
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
2 years ago
2 years ago
请选择4
输入学生学号100
学生不存在.
```
2 years ago
#### C6: 打印库存列表
2 years ago
选择菜单命令 `3`,打印
```
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 101 | 电脑 | 20 |
-------------------------------------------------------
```
2 years ago
2 years ago
#### C7: 修改库存记录
2 years ago
选择菜单命令 `6`,根据提示输入零件编号,若零件存在,则继续输入新的零件名和库存数量,并修改库存记录;否则,提示零件不存在并结束。
```
2 years ago
请选择6
2 years ago
输入零件编号101
输入零件名:笔记本电脑
输入库存数12
零件 101 已更新
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
2 years ago
2 years ago
请选择3
-------------------------------------------------------
2 years ago
| NUMBER | NAME | ON HAND |
2 years ago
-------------------------------------------------------
2 years ago
| 101 | 笔记本电脑 | 12 |
2 years ago
-------------------------------------------------------
2 years ago
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
2 years ago
2 years ago
请选择6
2 years ago
输入零件编号100
零件不存在.
```
2 years ago
#### C8: 删除库存记录
2 years ago
选择菜单命令 `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 |
-------------------------------------------------------
-------------------------------------------------------
```
2 years ago
#### C9: 库存记录排序
2 years ago
选择菜单命令 `8`,对库存记录按学生学号从小到大排序。
```
请选择3
-------------------------------------------------------
| NUMBER | NAME                             | ON HAND |
-------------------------------------------------------
|    101 | 小连                            |      100 |
|    100 | 小刘                            |      90 |
-------------------------------------------------------
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 | 小刘                           |      90 |
|    101 | 小连                             |      100 |
-------------------------------------------------------
```
2 years ago
2 years ago
选择菜单命令 `8`,对库存记录按学生学号从小到大排序。
2 years ago
2 years ago
```
2 years ago
请选择3
-------------------------------------------------------
| NUMBER | NAME                             | ON HAND |
-------------------------------------------------------
2 years ago
|    101 | 小连                            |      100 |
|    100 | 小刘                            |      90 |
2 years ago
-------------------------------------------------------
2 years ago
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
2 years ago
2 years ago
请选择8
排序
排序已完成
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
-------------------------------------------------------
| NUMBER | NAME                             | ON HAND |
-------------------------------------------------------
2 years ago
|    100 | 小刘                           |      90 |
|    101 | 小连                             |      100 |
2 years ago
-------------------------------------------------------
```
2 years ago
#### C10: 从文件中读取库存记录
2 years ago
2 years ago
选择菜单命令 `1`,提示输入文件名,若文件存在,则打开文件读取 CSV 格式保存的所有库存记录;否则,若文件不存在,则给出错误信息并结束。
假设文件 `a.csv` 中,以 CSV Comma-Separated Values格式保存了如下记录
```
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
```
2 years ago
#### C11: 将库存保存保存到文件
2 years ago
选择菜单命令 `2`,提示输入文件名,将所有库存记录以 CSV 格式保存到指定的文件中。
```
2 years ago
请选择2
保存数据
请输入文件名b.csv
保存 4 记录
2 years ago
2 years ago
```
2 years ago
2 years ago
#### C12: 以图表方式显示库存记录
选择菜单命令 `9`,以图表方式显示库存记录。
2 years ago
2 years ago
```
2 years ago
请选择9
图表
2 years ago
103 : 显示器 | ******** (8)
104 : 手机 | ************ (12)
101 : 电脑 | ******************** (20)
102 : 打印机 | ********** (10)
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
2 years ago
2 years ago
```
2 years ago
## 概要设计
系统主要分为用户界面和数据处理两大模块。
用户界面模块包括系统初始化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进行调用系统模块图如下。
![系统模块图](images/module.drawio.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: 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 退出
![主程序流程图](images/main.drawio.svg)
#### save_data
Step 1: 输入文件名
Step 2: 打开文件
Step 3: if 打开文件失败 then 提示打开文件失败并结束
Step 4: 将所有库存记录写入文件
Step 5: 关闭文件
![保存数据流程图](images/save_data.drawio.svg)
#### add_data
Step 1: if 数据库满 then 提示数据库满并结束
Step 2: 输入零件编号
Step 3: if 零件已存在 then 提示零件已存在并结束
Step 4: 输入零件名和库存数量
Step 5: 添加新零件到数据
Step 6: 提示添加成功
![添加库存记录流程图](images/add_data.drawio.svg)
2 years ago