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

276 lines
7.7 KiB

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden 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日
赵亚璇,连桢钰,翟梅瑛,刘宇婷
## 项目简介
项目开发过程中采用 Kanban看板进行任务管理和分工协作并使用 Git 对程序代码和文档进行版本管理。任务分工情况如下:
| 任务 | 设计 | 开发 | 测试 | 文档 |
| ---- | ---- | ---- | ---- | ---- |
| C1-C3 菜单驱动的用户界面 | 刘宇婷 | 刘宇婷 | 赵亚璇 | 刘宇婷 |
| C4 添加库存记录 | 连桢钰 | 连桢钰 | 翟梅瑛 | 连桢钰 |
| C5 查询库存记录| 赵亚璇 | 赵亚璇 | 连桢钰 | 赵亚璇 |
| C6 打印库存列表 | 翟梅瑛 | 翟梅瑛 | 刘宇婷 | 翟梅瑛 |
| C7 修改库存记录 | 刘宇婷 |刘宇婷|连桢钰|刘宇婷|
| C8 删除库存记录|连桢钰|连桢钰|赵亚璇|连桢钰|
| C9 库存记录排序|赵亚璇|赵亚璇|翟梅瑛|赵亚璇|
| C10从文件中读取库存记录|翟梅瑛|翟梅瑛|刘宇婷|翟梅瑛|
|C11将库存保存到文件|刘宇婷|赵亚旋|连桢钰|刘宇婷|
|C12以图标方式显示库存记录|刘宇婷|翟梅瑛|赵亚璇|连桢钰|
每个成员的工作量(百分比):
| 连桢钰 | 翟梅瑛 | 赵亚璇 | 刘宇婷|
| ---- | ---- | ---- | ----|
| 25 | 25 | 25 | 25 |
## 关于学生成绩管理系统
本学生成绩管理系统是为教师提供管理班级成绩的工具,该系统可以实现的对学生的成绩进行增,删,改,查,信息保存和信息导入等基本功能,以及对学生成绩排序和分段的扩展功能,有利于对学生成绩管理。设计思想是利用结构体--定义STU结构体存储学生学号姓名各科成绩总成绩和平均成绩利用文件来存储读取数据。
## 需求分析
分析系统的功能需求和界面需求,编制用户手册如下。
#### C1: 启动程序
#### C2: 显示命令菜单
#### C3: 退出程序
#### C4: 添加库存记录
选择菜单命令 `5`,提示输入学生学号,若该学生不存在,则继续输入学号、姓名,成绩,添加学号,并提示完成;若学号已存在,则提示学号已存在,并结束。
```
请选择5
输入学生学号101
输入姓名:小刘
输入成绩90
零件 101 已添加
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择5
输入学生学号101
学号已存在.
```
#### C5: 查询库存记录
选择菜单命令 `4`,提示输入学生学号,若该学生存在,则输出学号,姓名,成绩;否则提示学生不存在并结束。
```
请选择4
输入学生学号101
输入学号101
学号101
名字:小刘
成绩90
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择4
输入学生学号100
学生不存在.
```
#### C6: 打印库存列表
选择菜单命令 `3`,打印
```
请选择3
-------------------------------------------------------
| NUMBER | NAME                             | ON HAND |
-------------------------------------------------------
|    101 | 小刘                          |      90 |
-------------------------------------------------------
```
#### C7: 修改库存记录
#### 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: 库存记录排序
#### C10: 从文件中读取库存记录
选择菜单命令 `1`,提示输入文件名,若文件存在,则打开文件读取 CSV 格式保存的所有库存记录;否则,若文件不存在,则给出错误信息并结束。
假设文件 `a.csv` 中,以 CSV Comma-Separated Values格式保存了如下记录
```
103,小赵,90
104,小翟,95
101,小刘,90
102,小连,100
```
则读取记录的过程如下:
```
请选择1
读取数据
请输入文件名a.csv
读取 4 记录
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
-------------------------------------------------------
| NUMBER | NAME                             | ON HAND |
-------------------------------------------------------
|    103 | 小赵                           |       90 |
|    104 | 小翟                             |      95 |
|    101 | 小刘                             |      90 |
|    102 | 小连                           |      100|
-------------------------------------------------------
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择1
读取数据
请输入文件名a
a: No such file or directory
```
#### C11: 将库存保存保存到文件
#### C12: 以图表方式显示库存记录
## 概要设计
系统主要分为用户界面和数据处理两大模块。
用户界面模块包括系统初始化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)