# 学生成绩管理系统

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: 查询库存记录





#### C6: 打印库存列表



#### 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: 从文件中读取库存记录



#### 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)