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

426 lines
13 KiB

2 years ago
# 学生成绩管理系统
2 years ago
2 years ago
2023年4月22日
2 years ago
2 years ago
王凯旋,苏永涛,王德沅,冯国平
2 years ago
## 项目简介
本系统是程序设计与问题求解课程设计项目,实现了库存零件 CSV 格式数据文件的读取和保存以及数据的增删改查CRUD、排序和图表显示等功能。项目采用 C 语言编程实现,在 VS Code 集成开发环境IDE中用 GCC 进行编译。系统采用模块化设计,程序结构清晰,采用菜单驱动的命令行界面,操作便捷,能够用 CSV 格式读取和保存数据,通用性强,能够用图表展示数据,直观清楚。
下载地址https://gitee.com/user-name/inventory
项目开发过程中采用 Kanban看板进行任务管理和分工协作并使用 Git 对程序代码和文档进行版本管理。任务分工情况如下:
2 years ago
| 任务 | 设计 | 开发 | 测试 | 文档 |
| ---------------------------- | ------ | ------ | ------ | ------ |
| C1-C3 菜单驱动的用户界面 | 王凯旋 | 王德沅 | 冯国平 | 苏永涛 |
| C4 添加库存记录 | 王凯旋 | 王德沅 | 冯国平 | 苏永涛 |
| C5查询库存记录 | 冯国平 | 王德沅 | 苏永涛 | 王凯旋 |
| C6打印库存列表 | 王德沅 | 苏永涛 | 冯国平 | 王凯旋 |
2 years ago
| C7修改库存记录 | 苏永涛 | 王德沅 | 王凯旋 | 冯国平 |
2 years ago
| C8删除库存记录 | 冯国平 | 王凯旋 | 苏永涛 | 王德沅 |
2 years ago
| C9库存记录排序 | 王德沅 | 冯国平 | 王凯旋 | 苏永涛 |
2 years ago
| C10从文件中读取库存记录 | 王凯旋 | 苏永涛 | 冯国平 | 王德沅 |
| C11从库存保存到文件 | 苏永涛 | 王德沅 | 王凯旋 | 冯国平 |
| C12以图标方式显示库存记录 | 冯国平 | 苏永涛 | 王德沅 | 王凯旋 |
| 每个成员的工作量(百分比): | | | | |
| 王凯旋 | 王德沅 | 冯国平 | 苏永涛 |
| ------ | ------ | ------ | ------ |
| 25 | 25 | 25 | 25 |
2 years ago
2 years ago
>>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>>
2 years ago
## 关于零件库存管理系统
设计一个库存零件管理系统,要求采用命令行菜单界面进行交互,具备读取、保存、打印、查询、修改、插入、删除和排序等基本功能,能够以表格和图表形式展示数据,采用 CSV 格式保存数据。
系统的功能性需求:
2 years ago
2 years ago
- 数据的读取、保存、打印、查询、修改、插入、删除、排序和图表展示。
系统的非功能性需求:
2 years ago
- 菜单驱动的命令行交互界面。
2 years ago
## 需求分析
分析系统的功能需求和界面需求,编制用户手册如下。
#### C1: 启动程序
命令行中执行命令 `./app`,系统启动,显示提示信息,然后显示功能菜单,等待用户输入命令。
2 years ago
2 years ago
```
库存管理系统启动
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: 添加库存记录
2 years ago
选择菜单命令 `5`,提示输入学号,若该学号不存在,则继续输入姓名、成绩,添加学号,并提示完成;若学号已存在,则提示学号已存在,并结束。
2 years ago
```
请选择5
2 years ago
输入学号2214111035
输入姓名:小王
输入成绩80
学号 2214111035 已添加
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择5
2 years ago
输入学号2214111035
学号已存在.
2 years ago
```
#### C5: 查询库存记录
2 years ago
选择菜单命令 `4`,提示输入学号,若该学号存在,则输出学生信息;否则提示学生不存在并结束。
2 years ago
```
请选择4
2 years ago
输入学号2214111035
学号2214111035
姓名:小王
成绩80
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择4
2 years ago
输入学号2214111035
学生不存在.
2 years ago
```
#### C6: 打印库存列表
选择菜单命令 `3`,打印
```
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
2 years ago
|2214111035|小王 | 80 |
2 years ago
-------------------------------------------------------
```
#### C7: 修改库存记录
2 years ago
选择菜单命令 `6`,根据提示输入学号,若学号存在,则继续输入新学生姓名和成绩,并修改成绩记录;否则,提示该学生不存在并结束。
2 years ago
```
请选择6
2 years ago
输入学号2214111035
输入姓名:小王
输入成绩80
学生 2214111035 已更新
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
2 years ago
|2214111035|小王 | 80 |
2 years ago
-------------------------------------------------------
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择6
2 years ago
输入学号2214111035
该学生不存在.
2 years ago
```
#### C8: 删除库存记录
2 years ago
选择菜单命令 `7`,根据提示输入学号,若该学生存在,则删除之;否则提示该学生不存在并结束。
2 years ago
```
请选择7
2 years ago
输入学号2214111035
该学生不存在.
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择7
2 years ago
输入学号2214111035
学生 2214111035 已删除
2 years ago
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
-------------------------------------------------------
```
#### C9: 库存记录排序
2 years ago
选择菜单命令 `8`,对库存记录按学号从小到大排序。
2 years ago
```
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
2 years ago
|2214111035| 小王 | 80 |
|2214111033| 叠沅 | 90 |
2 years ago
-------------------------------------------------------
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 |
-------------------------------------------------------
2 years ago
|2214111035|小王 | 80 |
|2214111033|叠沅 | 90 |
2 years ago
-------------------------------------------------------
```
#### C10: 从文件中读取库存记录
选择菜单命令 `1`,提示输入文件名,若文件存在,则打开文件读取 CSV 格式保存的所有库存记录;否则,若文件不存在,则给出错误信息并结束。
假设文件 `a.csv` 中,以 CSV Comma-Separated Values格式保存了如下记录
```
2 years ago
2214111035,小王,80
2214111033,叠沅,90
2214111028,小冯,100
1914110817,小苏,100
2 years ago
```
则读取记录的过程如下:
```
请选择1
读取数据
请输入文件名a.csv
读取 4 记录
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
2 years ago
|2214111035 | 小王 | 80|
|2214111033 | 叠沅 | 90|
|2214111028 | 小冯 | 100|
|1914110817 | 小苏 | 100|
2 years ago
-------------------------------------------------------
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
图表
2 years ago
2214111035: 小王 | ******* (80)
2214111033: 叠沅 | *******(90)
2214111028: 小冯 |******** (100)
1914110817 :小苏 | ********** (100)
2 years ago
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进行调用系统模块图如下。
2 years ago
![picture.draw](/picture.drawio.svg)
2 years ago
各模块的主要功能如下:
#### 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 打印数据
2 years ago
Step 2.6:
2 years ago
2 years ago
![picture-main.draw](/picture-main.drawio.svg)
2 years ago
#### save_data
Step 1: 输入文件名
Step 2: 打开文件
Step 3: if 打开文件失败 then 提示打开文件失败并结束
Step 4: 将所有库存记录写入文件
Step 5: 关闭文件
2 years ago
![picture-save.draw](/picture-save.draw.svg)
2 years ago
#### add_data
Step 1: if 数据库满 then 提示数据库满并结束
Step 2: 输入零件编号
Step 3: if 零件已存在 then 提示零件已存在并结束
Step 4: 输入零件名和库存数量
Step 5: 添加新零件到数据
Step 6: 提示添加成功
2 years ago
![picture-add.draw](/picture-add.drawio.svg)
2 years ago
### query_data
Step 1:提示输入学生学号,并输入学号
Step 2for i = 0 to num_parts开始查询
Step 3查询最后一个学生结束
Step 4if未查询到提示学生不存在
Step 5else打印学生信息
2 years ago
![picture.draw](/picture.drawio.svg)
2 years ago
### printf_data
Step 1:打印学生学号和学生姓名
Step 2for i = 1 to num_parts
Step 3:打印学生成绩
2 years ago
![printf_data](/printf.drawio.svg)
2 years ago
2 years ago
#### update_data
Step 1输入学生学号
Step 2查找学生是否已录入
Step 3if 不存在then 直接退出
Step 4else 输出学生信息
2 years ago
![update_data](/.drawio.svg)
2 years ago
#### delete_data
Step 1:输入学生学号
Step 2:判断学号是否存在
Step 3:若存在则将其删除
Step 4:否则提示不存在并结束
2 years ago
![delete](/delete.drawio.svg)
2 years ago
### sort_data
Step 1:对库存记录按学号从小到大排序
2 years ago
Step 2:将按照学生成绩排序,若前面的比后面大,则交换
Step 3每次遍历记录是否交换若没有交换则排序结束
Step 4若成绩相同则按照学号从小到大排序
2 years ago
![sort](/sort.drawio.svg)
2 years ago
### make_chart
Step 1:输入文件名
Step 2:判断其是否存在
Step 3:若存在则打开文件并读取CSV 格式保存的所有库存记录
Step 4:否则给出错误信息并结束
2 years ago
![make_chart](/make_chart.drawio.svg)
2 years ago
=======
2 years ago
### read_data
Step 1:输入文件名
Step 2查看输入的文件名是否和已有的文化相匹配
2 years ago
Step 3若匹配成功则打开文件
Step 4若不成功则返回错误值
Step 5打开后利用循环依次输出文件里各个学生的学号姓名和成绩
Step 6关闭文件
2 years ago
![read](/read_data.drawio.svg)