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/README1.md

448 lines
13 KiB

2 years ago
# 图书管理系统
2023年4月22日
姚震、金雨佳、宋岱瑾、费良荣
## 项目简介
本系统是程序设计与问题求解课程设计项目,实现了库存零件 CSV 格式数据文件的读取和保存以及数据的增删改查CRUD、排序和图表显示等功能。项目采用 C 语言编程实现,在 VS Code 集成开发环境IDE中用 GCC 进行编译。系统采用模块化设计,程序结构清晰,采用菜单驱动的命令行界面,操作便捷,能够用 CSV 格式读取和保存数据,通用性强,能够用图表展示数据,直观清楚。
下载地址https://gitee.com/wangqian12345/students
项目开发过程中采用 Kanban看板进行任务管理和分工协作并使用 Git 对程序代码和文档进行版本管理。任务分工情况如下:
| 任务 | 设计 | 开发 | 测试 | 文档 |
| ---- | ---- | ---- | ---- | ---- |
| C1-C3 菜单驱动的用户界面 | 宋岱瑾 | 宋岱瑾 | 金雨佳 | 宋岱瑾 |
| C4 添加图书记录 | 姚震 | 姚震 | 费良荣 | 姚震 |
| C5 查询图书记录 | 金雨佳 | 金雨佳 | 宋岱瑾 | 金雨佳 |
| C6 打印图书列表 | 金雨佳 | 金雨佳 | 姚震 | 金雨佳 |
| C7 修改图书记录 | 费良荣 | 费良荣 | 宋岱瑾 | 费良荣 |
| C8 删除图书记录 | 姚震 | 姚震 | 费良荣 | 姚震 |
| C9 图书记录排序 | 姚震 | 姚震 | 金雨佳 | 姚震 |
| C10 从文件中读取图书记录 | 费良荣 | 费良荣 | 宋岱瑾 | 费良荣 |
| C11 将图书保存到文件 | 宋岱瑾 | 宋岱瑾 | 费良荣 | 宋岱瑾 |
| C12 以图表方式显示图书记录 | 宋岱瑾 | 宋岱瑾 | 金雨佳. | 宋岱瑾 |
每个成员的工作量(百分比):
| 姚震 | 金雨佳 | 宋岱瑾 | 费良荣 |
| ---- | ---- | ---- | ---- |
| 25 | 25 | 25 | 25 |
## 关于图书管理系统
设计一个图书管理系统,要求采用命令行菜单界面进行交互,具备读取、保存、打印、查询、修改、插入、删除和排序等基本功能,能够以表格和图表形式展示数据,采用 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` 确认,则退出程序。
```
请选择0
确定要退出吗?(Y/N): y
程序退出
```
#### C4: 添加记录
选择菜单命令 `5`,提示输入图书编号,若该图书不存在,则继续输入图书名、图书编号、图书借阅次数,并提示完成;若图书编号已存在,则提示学图书已存在,并结束。
```
请选择5
输入学生学号101
输入学生姓名:李
输入学生成绩80
学生 101 已添加
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择5
输入学生学号101
学生已存在.
```
#### C5: 查询图书记录
选择菜单命令 `4`,提示输入图书编号,若该图书存在,则输出图书信息;否则提示图书不存在并结束。
```
请选择4
输入学生学号101
学生学号101
学生姓名:李
学生成绩80
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择4
输入学生学号100
学生不存在.
```
#### C6: 打印图书列表
选择菜单命令 `3`,打印
```
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 101 | 李 | 80 |
-------------------------------------------------------
```
#### C7: 修改图书记录
选择菜单命令 `6`,根据提示输入图书编号,若图书存在,则继续输入新的图书编号和图书,并修改图书记录;否则,提示图书不存在并结束。
```
请选择6
输入学生学号101
输入学生姓名:张
输入学生成绩90
学生 101 已更新
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 101 | 张 | 90 |
-------------------------------------------------------
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 | 李 | 80 |
| 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 | 李 | 80 |
-------------------------------------------------------
```
#### C10: 从文件中读取图书记录
选择菜单命令 `1`,提示输入文件名,若文件存在,则打开文件读取 CSV 格式保存的所有库存记录;否则,若文件不存在,则给出错误信息并结束。
假设文件 `a.csv` 中,以 CSV Comma-Separated Values格式保存了如下记录
```
103,张,80
104,李,88
101,王,90
102,樊,100
```
则读取记录的过程如下:
```
请选择1
读取数据
请输入文件名a.csv
读取 4 记录
1 读取 | 2 保存 | 3 打印 | 4 查询 | 5 添加
6 修改 | 7 删除 | 8 排序 | 9 图表 | 0 退出
请选择3
-------------------------------------------------------
| NUMBER | NAME | ON HAND |
-------------------------------------------------------
| 103 | 张 | 80 |
| 104 | 李 | 88 |
| 101 | 王 | 90 |
| 102 | 樊 | 100 |
-------------------------------------------------------
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 : 张 | ******** (80)
104 : 李 | ************ (88)
101 : 王 | ******************** (90)
102 : 樊 | ********** (100)
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进行调用系统模块图如下。
![系统模块图](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:
![主程序流程图](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)
### query_data
Step 1:提示输入图书编号,并输入编号
Step 2for i = 0 to num_parts开始查询
Step 3查询最后一个图书结束
Step 4if未查询到提示图书不存在
Step 5else打印图书信息
![查询流程图](images/query_data.drawio.svg)
### printf_data
Step 1:打印图书编号和图书名
Step 2for i = 1 to num_parts
Step 3:打印借阅次数
![打印记录流程图](images/printf_data.drawio.svg)
#### update_data
Step 1输入图书编号
Step 2查找图书是否已录入
Step 3if 不存在then 直接退出
Step 4else 输出图书信息
![修改学生信息](images/update_data.drawio.svg)
#### delete_data
Step 1: 输入图书编号
Step 2: 查找图书所在的位置
Step 3: if 没有该图书then 则输出图书不存在
Step 4: 将查找到的图书后面的依次往前移动信息
Step 5: 将图书总数减一
Step 6: 提示删除成功
![打印记录流程图](images/delete_data.drawio.svg)
#### sort_data
Step 1: 进行冒泡排序
Step 2: 将按图书借阅次数排序,若前面的比后面的大,则交换
Step 3: 每次遍历记录是否交换,若没有交换,则排序结束
Step 4: 若借阅次数相同,则按照编号从小到大排序
![打印记录流程图](images/sort_data.drawio.svg)
#### read_data
Step 1:输入文件名
Step 2查看输入的文件名是否和已有的文化相匹配
Step 3若匹配成功则打开文件
Step 4若不成功则返回错误值
2 years ago
Step 5打开后利用循环依次输出文件里各个图书信息
2 years ago
Step 6关闭文件
2 years ago
![读取流程图](read_data.svg)
2 years ago
#### make_chart
Step 1打印表头
Step 2循环打印图书名和图书编号
Step 3循环套循环打印图表
Step 4打印结束后换行继续循环
Step 5打印成功
2 years ago
![读取流程图](make_chart.svg)