commit da0754fbe71e8dc9f2c8a542de60f7f715c157e8 Author: LHY20 <3364451258@qq.com> Date: Thu Jul 17 21:05:56 2025 +0800 “shujbjiegouconggou” diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 0000000..13566b8 --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,8 @@ +# Default ignored files +/shelf/ +/workspace.xml +# Editor-based HTTP Client requests +/httpRequests/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/.idea/C_code.iml b/.idea/C_code.iml new file mode 100644 index 0000000..dafce2b --- /dev/null +++ b/.idea/C_code.iml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/.idea/CopilotChatHistory.xml b/.idea/CopilotChatHistory.xml new file mode 100644 index 0000000..c129ed5 --- /dev/null +++ b/.idea/CopilotChatHistory.xml @@ -0,0 +1,57 @@ + + + + + + \ No newline at end of file diff --git a/.idea/editor.xml b/.idea/editor.xml new file mode 100644 index 0000000..633b554 --- /dev/null +++ b/.idea/editor.xml @@ -0,0 +1,251 @@ + + + + + \ No newline at end of file diff --git a/.idea/encodings.xml b/.idea/encodings.xml new file mode 100644 index 0000000..74c8330 --- /dev/null +++ b/.idea/encodings.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/.idea/misc.xml b/.idea/misc.xml new file mode 100644 index 0000000..88aa1fc --- /dev/null +++ b/.idea/misc.xml @@ -0,0 +1,7 @@ + + + + + + \ No newline at end of file diff --git a/.idea/modules.xml b/.idea/modules.xml new file mode 100644 index 0000000..d3f2495 --- /dev/null +++ b/.idea/modules.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml new file mode 100644 index 0000000..35eb1dd --- /dev/null +++ b/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/.vscode/c_cpp_properties.json b/.vscode/c_cpp_properties.json new file mode 100644 index 0000000..e8bccac --- /dev/null +++ b/.vscode/c_cpp_properties.json @@ -0,0 +1,27 @@ +{ + "configurations": [ + { + "name": "windows-gcc-x64", + "includePath": [ + "${workspaceFolder}/**" + ], + "defines": [ + "_DEBUG", + "UNICODE", + "_UNICODE" + ], + "compilerPath": "D:/Program Files/mingw64/bin/gcc.exe", + "cStandard": "c11", + "cppStandard": "c++17", + "intelliSenseMode": "windows-gcc-x64", + "compilerArgs": [ + "-Wall", + "-Wextra", + "-Wshadow", + "-fsanitize=address", + "-g3" + ] + } + ], + "version": 4 +} \ No newline at end of file diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..92c9925 --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,24 @@ +{ + "version": "0.2.0", + "configurations": [ + { + "name": "C/C++ Runner: Debug Session", + "type": "cppdbg", + "request": "launch", + "args": [], + "stopAtEntry": false, + "externalConsole": true, + "cwd": "d:/Code/Stu_scores_system", + "program": "d:/Code/Stu_scores_system/build/Debug/outDebug", + "MIMode": "gdb", + "miDebuggerPath": "gdb", + "setupCommands": [ + { + "description": "Enable pretty-printing for gdb", + "text": "-enable-pretty-printing", + "ignoreFailures": true + } + ] + } + ] +} \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..b5adf02 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,77 @@ +{ + "C_Cpp_Runner.cCompilerPath": "gcc", + "C_Cpp_Runner.cppCompilerPath": "g++", + "C_Cpp_Runner.debuggerPath": "gdb", + "C_Cpp_Runner.cStandard": "c11", + "C_Cpp_Runner.cppStandard": "c++17", + "C_Cpp_Runner.msvcBatchPath": "", + "C_Cpp_Runner.useMsvc": false, + "C_Cpp_Runner.warnings": [ + "-Wall", + "-Wextra", + "-Wpedantic", + "-Wshadow", + "-Wformat=2", + "-Wcast-align", + "-Wconversion", + "-Wsign-conversion", + "-Wnull-dereference" + ], + "C_Cpp_Runner.msvcWarnings": [ + "/W4", + "/permissive-", + "/w14242", + "/w14287", + "/w14296", + "/w14311", + "/w14826", + "/w44062", + "/w44242", + "/w14905", + "/w14906", + "/w14263", + "/w44265", + "/w14928" + ], + "C_Cpp_Runner.enableWarnings": true, + "C_Cpp_Runner.warningsAsError": false, + "C_Cpp_Runner.compilerArgs": [], + "C_Cpp_Runner.linkerArgs": [], + "C_Cpp_Runner.includePaths": [], + "C_Cpp_Runner.includeSearch": [ + "*", + "**/*" + ], + "C_Cpp_Runner.excludeSearch": [ + "**/build", + "**/build/**", + "**/.*", + "**/.*/**", + "**/.vscode", + "**/.vscode/**" + ], + "C_Cpp_Runner.useAddressSanitizer": false, + "C_Cpp_Runner.useUndefinedSanitizer": false, + "C_Cpp_Runner.useLeakSanitizer": false, + "C_Cpp_Runner.showCompilationTime": false, + "C_Cpp_Runner.useLinkTimeOptimization": false, + "C_Cpp_Runner.msvcSecureNoWarnings": false, + "files.associations": { + "*.gbk": "cpp", + "stdlib.h": "c", + "game_mode.h": "c", + "windows.h": "c", + "stdio.h": "c", + "stat.h": "c", + "init_board.h": "c", + "init.h": "c", + "record.h": "c", + "ai.h": "c", + "string.h": "c", + "direct.h": "c", + "gobang.h": "c", + "main_menu.h": "c", + "unistd.h": "c", + "config.h": "c" + } +} \ No newline at end of file diff --git a/.vscode/tasks.json b/.vscode/tasks.json new file mode 100644 index 0000000..f9daef4 --- /dev/null +++ b/.vscode/tasks.json @@ -0,0 +1,29 @@ +{ + "tasks": + [ + { + "type": "shell", + "label": "C/C++: gcc.exe 生成活动文件", + "command": "D:\\Program Files\\mingw64\\bin\\gcc.exe", + "args": + [ + "-fdiagnostics-color=always", + "-g", + "${file}", + "-o", + "${fileDirname}\\${fileBasenameNoExtension}.exe", + "-Wall", + "-Werror", + "-std=c++17", + "-fsanitize=address", + "-static-libasan", + "-lws2_32" + ], + "options": {"cwd": "${fileDirname}"}, + "problemMatcher": ["$gcc"], + "group": {"kind": "build","isDefault": true}, + "detail": "调试器生成的任务。" + } + ], + "version": "2.0.0" +} \ No newline at end of file diff --git a/MD/CSV_FORMAT.md b/MD/CSV_FORMAT.md new file mode 100644 index 0000000..6bfed29 --- /dev/null +++ b/MD/CSV_FORMAT.md @@ -0,0 +1,81 @@ +# 学生成绩管理系统 - CSV格式说明 + +## 数据存储格式 + +学生数据以CSV格式存储在 `data/students.csv` 文件中，便于查看和编辑。v2.2版本通过模块化的文件工具库提供更强大的CSV处理能力。 + +## CSV文件结构 + +### 文件位置 +- **文件路径**: `data/students.csv` +- **编码格式**: UTF-8 +- **分隔符**: 逗号 (,) + +### 字段说明 + +| 字段名 | 说明 | 示例 | +|--------|------|------| +| 学号 | 学生唯一标识 | 2021001 | +| 姓名 | 学生姓名 | 张三 | +| 年龄 | 学生年龄 | 20 | +| 性别 | M(男)/F(女) | M | +| 课程数量 | 选修课程总数 | 3 | +| 课程1-10 | 课程名称 | 数学 | +| 成绩1-10 | 对应课程成绩 | 85.50 | +| 总分 | 所有课程总分 | 258.00 | +| 平均分 | 平均成绩 | 86.00 | + +### 示例数据 + +```csv +学号,姓名,年龄,性别,课程数量,课程1,成绩1,课程2,成绩2,课程3,成绩3,课程4,成绩4,课程5,成绩5,课程6,成绩6,课程7,成绩7,课程8,成绩8,课程9,成绩9,课程10,成绩10,总分,平均分 +2021001,张三,20,M,3,数学,85.50,英语,92.00,物理,78.50,,,,,,,,,,,,,258.00,86.00 +2021002,李四,19,F,4,数学,90.00,英语,88.50,物理,85.00,化学,92.50,,,,,,,,,,,356.00,89.00 +``` + +## 优势 + +1. **可读性强**: 可以用Excel、记事本等工具直接查看和编辑 +2. **通用格式**: CSV是标准的数据交换格式 +3. **易于备份**: 文本格式便于版本控制和备份 +4. **数据分析**: 可以导入到Excel、Python等工具进行进一步分析 + +## 注意事项 + +1. 如果课程数量少于10门，未使用的课程和成绩字段将为空 +2. 修改CSV文件时请保持格式一致性 +3. 程序会在添加、删除、修改学生信息时自动更新CSV文件 +4. 建议定期备份CSV文件 + +## v2.2版本改进 + +### 🔧 模块化文件处理 +- **file_utils模块**：专门的文件操作工具库，提供更可靠的CSV文件处理 +- **validation模块**：增强的数据验证功能，确保CSV数据完整性 +- **string_utils模块**：优化的字符串处理，更好地处理CSV字段解析 + +### 📊 数据处理优化 +- **错误恢复**：更强的CSV文件损坏检测和修复能力 +- **性能提升**：优化的文件读写算法，处理大量数据更高效 +- **编码支持**：增强的UTF-8编码处理，更好地支持多语言字符 + +## 兼容性 + +- 系统会自动检测并读取CSV格式的学生数据 +- 如果CSV文件不存在，系统会在首次保存数据时自动创建 +- 支持中文字符（UTF-8编码） +- v2.2版本向下兼容所有v2.1及更早版本的CSV文件 + +## 技术实现 + +### 相关模块 +- **file_utils.c/h**：CSV文件读写核心功能 +- **validation.c/h**：数据格式验证 +- **string_utils.c/h**：字符串解析和处理 +- **io_utils.c/h**：输入输出辅助功能 + +--- + +**版本**: v2.2.0 +**最后更新**: 2025年 +**模块化程度**: 高度模块化 \ No newline at end of file diff --git a/MD/README.md b/MD/README.md new file mode 100644 index 0000000..2725641 --- /dev/null +++ b/MD/README.md @@ -0,0 +1,323 @@ +# 学生成绩管理系统 + +一个功能完整的C语言学生成绩管理系统，支持学生信息管理、成绩统计分析、用户权限控制等功能。采用高度模块化设计，代码结构清晰，易于维护和扩展。 + +## 📋 目录 + +- [功能特性](#功能特性) +- [系统架构](#系统架构) +- [安装与编译](#安装与编译) +- [使用说明](#使用说明) +- [数据格式](#数据格式) +- [项目结构](#项目结构) +- [开发指南](#开发指南) +- [贡献指南](#贡献指南) + +## ✨ 功能特性 + +### 🎯 核心功能 +- **学生信息管理**：添加、删除、修改、查询学生信息 +- **成绩管理**：支持多门课程成绩录入和管理 +- **数据持久化**：CSV格式存储，便于查看和编辑 +- **统计分析**：课程分析、成绩分布、排名统计等 +- **用户管理**：多用户登录、权限控制 + +### 🔧 技术特性 +- **统一类型管理**：v3.0.0版本创建types.h统一管理所有数据结构 +- **全局变量优化**：排序参数和统计缓存移至全局作用域，提升性能 +- **高度模块化**：v2.2版本完成深度模块化重构，功能模块职责清晰 +- **工具库分离**：独立的IO、验证、字符串、文件、数学、系统工具模块 +- **输入验证**：完善的数据校验机制 +- **错误处理**：友好的错误提示和异常处理 +- **彩色输出**：美观的控制台界面 +- **编译优化**：支持直接编译，无需生成中间.o文件 +- **跨平台**：支持Windows、Linux、macOS + +## 🏗️ 系统架构 + +``` +学生成绩管理系统 (v3.0.0 统一类型管理架构) +├── 用户界面层 (UI Layer) +│ ├── 主菜单 (main_menu.c) +│ └── 学生IO操作 (student_io.c) +├── 业务逻辑层 (Business Layer) +│ ├── 核心处理器 (core_handlers.c) +│ ├── 学生数据管理 (stu_data.c) +│ ├── 学生CRUD操作 (student_crud.c) +│ ├── 学生搜索 (student_search.c) +│ ├── 统计分析 (statistical_analysis.c) +│ └── 用户管理 (user_manage.c) +├── 工具库层 (Utility Layer) +│ ├── IO工具 (io_utils.c) +│ ├── 验证工具 (validation.c) +│ ├── 字符串工具 (string_utils.c) +│ ├── 文件工具 (file_utils.c) +│ ├── 数学工具 (math_utils.c) +│ └── 系统工具 (system_utils.c) +├── 数据访问层 (Data Layer) +│ ├── CSV文件操作 +│ └── 数据验证 +└── 配置层 (Config Layer) + ├── 统一类型定义 (types.h) - v3.0.0新增 + ├── 系统配置 (config.h) + └── 全局变量 (globals.c/h) +``` + +## 🚀 安装与编译 + +### 环境要求 +- GCC编译器 4.8+ +- C99标准支持 +- 操作系统：Windows/Linux/macOS + +### 编译步骤 + +1. **克隆项目** +```bash +git clone +cd Stu_scores_system +``` + +2. **使用GCC编译** +```bash +gcc -o student_system.exe main.c stu_data.c student_crud.c student_search.c user_manage.c main_menu.c student_io.c core_handlers.c statistical_analysis.c io_utils.c validation.c string_utils.c file_utils.c math_utils.c system_utils.c globals.c +``` + +3. **使用Makefile编译（v3.0.0优化版）** +```bash +make +``` + +> **注意**: v3.0.0版本在v2.2直接编译模式基础上，进一步优化了类型管理和依赖关系，编译更加高效。 + +4. **运行程序** +```bash +./student_system.exe # Windows +./student_system # Linux/macOS +``` + +## 📖 使用说明 + +### 登录系统 +系统提供两个默认用户： +- **管理员**：用户名 `admin`，密码 `123456`（拥有所有权限） +- **教师**：用户名 `teacher`，密码 `password`（基本权限） + +### 主要功能 + +#### 1. 基本功能管理 +- **添加学生**：录入学生基本信息和课程成绩 +- **删除学生**：根据学号删除学生记录 +- **修改学生**：更新学生信息和成绩 +- **查询学生**：按学号或姓名查找学生 +- **显示所有学生**：列出所有学生信息 +- **排序功能**：按学号、姓名、总分、平均分排序 + +#### 2. 统计分析功能 +- **课程分析**：各科目成绩统计 +- **成绩分布**：分数段分布统计 +- **成绩区间**：优秀、良好、及格、不及格统计 +- **综合分析**：整体成绩概况 + +#### 3. 管理功能（仅管理员） +- **用户管理**：添加、删除用户 +- **密码修改**：修改用户密码 +- **权限控制**：管理用户权限级别 + +## 📊 数据格式 + +### CSV文件结构 +学生数据以CSV格式存储在 `data/students.csv`： + +```csv +学号,姓名,年龄,性别,课程数量,课程1,成绩1,课程2,成绩2,...,总分,平均分 +2021001,张三,20,M,3,数学,85.50,英语,92.00,物理,78.50,258.00,86.00 +``` + +### 用户数据 +用户信息存储在 `data/users.txt`： +``` +用户名:密码:权限级别 +admin:123456:1 +teacher:password:0 +``` + +详细格式说明请参考：[CSV格式文档](../CSV_FORMAT.md) + +## 📁 项目结构 + +``` +Stu_scores_system/ (v3.0.0 统一类型管理结构) +├── 📁 data/ # 数据文件目录 +│ ├── students.csv # 学生数据（CSV格式） +│ └── users.txt # 用户数据 +├── 📁 backup/ # 备份目录 +├── 📁 MD/ # 文档目录 +│ ├── README.md # 项目说明 +│ └── CSV_FORMAT.md # CSV格式说明 +├── 📁 TXT/ # 文本文档目录 +│ ├── 系统说明文档.txt # 系统详细说明 +│ └── 代码统计报告.txt # 代码统计分析 +├── 📄 main.c # 主程序入口 +├── 📄 types.h # 统一数据类型定义（v3.0.0新增） +├── 📄 config.h # 系统配置 +├── 📄 globals.c/h # 全局变量 +├── 📄 stu_data.c/h # 学生数据管理 +├── 📄 student_crud.c/h # 学生CRUD操作 +├── 📄 student_search.c/h # 学生搜索功能 +├── 📄 student_io.c/h # 学生IO操作 +├── 📄 statistical_analysis.c/h # 统计分析 +├── 📄 user_manage.c/h # 用户管理 +├── 📄 main_menu.c/h # 菜单系统 +├── 📄 core_handlers.c/h # 核心处理器 +├── 📄 io_utils.c/h # IO工具库 +├── 📄 validation.c/h # 验证工具库 +├── 📄 string_utils.c/h # 字符串工具库 +├── 📄 file_utils.c/h # 文件工具库 +├── 📄 math_utils.c/h # 数学工具库 +├── 📄 system_utils.c/h # 系统工具库 +├── 📄 Makefile # 编译配置（v2.2优化版） +└── 📄 要求.txt # 需求文档 +``` + +## 🛠️ 开发指南 + +### 代码规范 +- 使用C99标准 +- 函数命名采用驼峰命名法 +- 变量命名使用有意义的英文单词 +- 每个函数都有详细的注释说明 +- 模块化设计，职责分离 + +### 添加新功能 +1. 在相应的模块文件中添加函数实现 +2. 在对应的头文件中添加函数声明 +3. 在菜单系统中添加选项 +4. 更新配置文件（如需要） +5. 编写测试用例 + +### 数据结构 +```c +typedef struct { + char studentID[MAX_ID_LENGTH]; // 学号 + char name[MAX_NAME_LENGTH]; // 姓名 + int age; // 年龄 + char gender; // 性别 + char courses[MAX_COURSES][MAX_COURSE_NAME_LENGTH]; // 课程 + float scores[MAX_COURSES]; // 成绩 + int courseCount; // 课程数量 + float totalScore; // 总分 + float averageScore; // 平均分 +} Student; +``` + +## 🔧 配置说明 + +### 系统参数（config.h） +```c +#define MAX_STUDENTS 1000 // 最大学生数量 +#define MAX_COURSES 10 // 每个学生最多课程数 +#define MAX_USERS 50 // 最大用户数量 +#define MAX_LOGIN_ATTEMPTS 3 // 最大登录尝试次数 +``` + +### 文件路径 +```c +#define STUDENTS_FILE "data/students.csv" // 学生数据文件 +#define USERS_FILE "data/users.txt" // 用户数据文件 +#define BACKUP_DIR "backup/" // 备份目录 +``` + +## 🚨 注意事项 + +1. **数据安全**：定期备份数据文件 +2. **权限管理**：谨慎分配管理员权限 +3. **输入验证**：系统会自动验证输入数据的合法性 +4. **文件编码**：CSV文件使用UTF-8编码，支持中文 +5. **并发访问**：当前版本不支持多用户同时操作 + +## 🐛 常见问题 + +### Q: 编译时出现错误怎么办？ +A: 确保所有源文件都在同一目录下，并检查GCC版本是否支持C99标准。 + +### Q: 数据文件损坏怎么办？ +A: 可以从backup目录恢复备份文件，或者手动编辑CSV文件修复数据。 + +### Q: 忘记管理员密码怎么办？ +A: 可以直接编辑 `data/users.txt` 文件重置密码。 + +### Q: 如何导入现有的学生数据？ +A: 按照CSV格式要求编辑 `data/students.csv` 文件，程序会自动读取。 + +## 🤝 贡献指南 + +欢迎提交Issue和Pull Request！ + +1. Fork本项目 +2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) +3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) +4. 推送到分支 (`git push origin feature/AmazingFeature`) +5. 开启Pull Request + +## 📄 许可证 + +本项目采用MIT许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。 + +## 👥 作者 + +- **开发者** - 学生成绩管理系统 +- **联系方式** - [3364451258@qq.com] + +## 🙏 致谢 + +感谢所有为这个项目做出贡献的开发者！ + +--- + +**版本**: v3.0.0 +**最后更新**: 2025年 +**状态**: 稳定版本 + +## 🆕 v3.0.0 更新内容 + +### 🏗️ 统一类型管理系统 +- **types.h创建**：集中管理所有数据结构定义，包括Student、User、CourseStats、ScoreDistribution、StudentRank、OverallStats、StatisticsCache +- **重复定义消除**：移除config.h、globals.h、statistical_analysis.h中的重复结构体定义 +- **依赖关系优化**：简化头文件包含关系，避免循环依赖问题 + +### 🔧 全局变量优化 +- **排序参数全局化**：将currentSortCriteria和currentSortOrder移至全局作用域 +- **统计缓存全局化**：将statsCache移至全局管理，提升性能和数据一致性 +- **架构一致性**：统一全局变量管理策略，提高代码可维护性 + +### ⚡ 编译和维护性提升 +- **编译效率优化**：减少头文件依赖，加快编译速度 +- **代码一致性**：统一的数据类型管理，降低维护成本 +- **扩展性增强**：为后续功能扩展奠定坚实的架构基础 + +## 🆕 v2.2.0 更新内容 + +### 🔧 模块化重构 +- **auxiliary.c完全拆分**：原有的辅助功能模块已完全模块化，拆分为6个专门的工具库 +- **新增工具库模块**： + - `io_utils`: 输入输出工具函数 + - `validation`: 数据验证工具函数 + - `string_utils`: 字符串处理工具函数 + - `file_utils`: 文件操作工具函数 + - `math_utils`: 数学计算工具函数 + - `system_utils`: 系统相关工具函数 +- **功能模块细分**： + - `student_crud`: 学生增删改操作 + - `student_search`: 学生查询功能 + - `student_io`: 学生数据输入输出 + +### ⚡ 编译优化 +- **Makefile优化**：采用直接编译模式，不再生成中间.o文件 +- **编译效率提升**：简化编译流程，减少文件管理复杂度 +- **更清洁的构建**：避免.o文件堆积，保持项目目录整洁 + +### 📈 代码质量提升 +- **模块职责更清晰**：每个模块功能单一，便于维护 +- **代码复用性增强**：工具库函数可在多个模块间共享 +- **依赖关系优化**：减少模块间的耦合度 \ No newline at end of file diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..c7ef470 --- /dev/null +++ b/Makefile @@ -0,0 +1,66 @@ +# 学生成绩管理系统 Makefile +# 编译器设置 +CC = gcc +CFLAGS = -Wall -Wextra -std=c99 -g + +# 目标文件 +TARGET = student_system + +# 源文件 +SOURCES = main.c globals.c main_menu.c user_manage.c core_handlers.c statistical_analysis.c student_io.c student_crud.c student_search.c student_sort.c io_utils.c validation.c string_utils.c file_utils.c math_utils.c system_utils.c + +# 头文件 +HEADERS = config.h globals.h main_menu.h user_manage.h core_handlers.h statistical_analysis.h student_io.h student_crud.h student_search.h student_sort.h io_utils.h validation.h string_utils.h file_utils.h math_utils.h system_utils.h + +# 默认目标 +all: $(TARGET) + +# 直接编译链接（不生成.o文件） +$(TARGET): $(SOURCES) $(HEADERS) + $(CC) $(CFLAGS) $(SOURCES) -o $(TARGET) + +# 清理编译文件 +clean: + rm -f $(TARGET) + rm -f *.exe + rm -f *.o + +# 创建必要的目录 +setup: + mkdir -p data + mkdir -p backup + +# 运行程序 +run: $(TARGET) + ./$(TARGET) + +# Windows 特定目标 +windows: CFLAGS += -DWINDOWS +windows: $(TARGET) + +# 调试版本 +debug: CFLAGS += -DDEBUG -O0 +debug: $(TARGET) + +# 发布版本 +release: CFLAGS += -O2 -DNDEBUG +release: $(TARGET) + +# 安装（可选） +install: $(TARGET) + cp $(TARGET) /usr/local/bin/ + +# 帮助信息 +help: + @echo "可用的目标：" + @echo " all - 编译程序（默认）" + @echo " clean - 清理编译文件" + @echo " setup - 创建必要的目录" + @echo " run - 编译并运行程序" + @echo " windows - 编译Windows版本" + @echo " debug - 编译调试版本" + @echo " release - 编译发布版本" + @echo " install - 安装程序到系统" + @echo " help - 显示此帮助信息" + +.PHONY: all clean setup run windows debug release install help \ No newline at end of file diff --git a/TXT/代码统计报告.txt b/TXT/代码统计报告.txt new file mode 100644 index 0000000..a65ad65 --- /dev/null +++ b/TXT/代码统计报告.txt @@ -0,0 +1,582 @@ +学生成绩管理系统 - 代码统计报告 +======================================== +生成时间: 2025年 +项目版本: v3.0.0 + +======================================== +项目概述 +======================================== + +项目名称: 学生成绩管理系统 +开发语言: C语言 +项目类型: 控制台应用程序 +主要功能: 学生信息管理、成绩统计分析、用户权限管理 + +======================================== +文件结构统计 +======================================== + +总文件数量: 33个源代码文件 +- C源文件(.c): 16个 +- 头文件(.h): 17个（新增types.h） + +v3.0.0统一类型管理成果: +- 创建types.h统一管理所有数据结构定义 +- 消除config.h、globals.h、statistical_analysis.h中的重复结构体定义 +- 优化头文件依赖关系，简化包含结构 +- 全局变量重构：排序参数和统计缓存移至全局作用域 +- 提升代码一致性和可维护性 + +v2.2模块化重构成果: +- 原auxiliary.c(538行)拆分为6个专业模块 +- 新增工具模块: io_utils, validation, string_utils, file_utils, math_utils, system_utils +- 删除auxiliary.h，实现精确依赖管理 +- Makefile优化，支持直接编译模式 + +======================================== +详细文件分析 +======================================== + +1. main.c (主程序文件) + - 总行数: 150行 + - 函数数量: 1个 (main函数) + - 注释行数: 约40行 + - 代码行数: 约110行 + - 主要功能: 程序入口点，系统初始化，用户登录，主菜单循环 + - 注释字数: 约800字 + +2. config.h (配置头文件) + - 总行数: 108行 + - 宏定义数量: 约50个 + - 结构体定义: 1个 (Student) + - 注释行数: 约20行 + - 代码行数: 约88行 + - 主要功能: 系统参数配置，数据结构定义 + - 注释字数: 约300字 + +3. stu_data.c (学生数据管理) + - 总行数: 762行 + - 函数数量: 约10个 + - 注释行数: 约150行 + - 代码行数: 约612行 + - 主要功能: 学生信息增删改查，文件读写操作 + - 注释字数: 约2500字 + +4. 模块化工具集 (原auxiliary.c拆分) + 4.1 io_utils.c (输入输出工具) + - 总行数: 约150行 + - 函数数量: 8个 + - 主要功能: 安全输入、界面显示、用户交互 + + 4.2 validation.c (数据验证) + - 总行数: 约120行 + - 函数数量: 6个 + - 主要功能: 输入验证、数据校验、安全检查 + + 4.3 string_utils.c (字符串处理) + - 总行数: 约80行 + - 函数数量: 4个 + - 主要功能: 字符串操作、文本处理、格式化 + + 4.4 file_utils.c (文件操作) + - 总行数: 约60行 + - 函数数量: 2个 + - 主要功能: 文件检查、目录创建、路径处理 + + 4.5 math_utils.c (数学工具) + - 总行数: 约40行 + - 函数数量: 1个 + - 主要功能: 数学计算、统计函数 + + 4.6 system_utils.c (系统工具) + - 总行数: 约80行 + - 函数数量: 3个 + - 主要功能: 系统初始化、资源管理、清理操作 + +5. statistical_analysis.c (统计分析) + - 总行数: 489行 + - 函数数量: 约12个 + - 注释行数: 约100行 + - 代码行数: 约389行 + - 主要功能: 成绩统计，数据分析，排名计算 + - 注释字数: 约1800字 + +6. user_manage.c (用户管理) + - 总行数: 265行 + - 函数数量: 约7个 + - 注释行数: 约60行 + - 代码行数: 约205行 + - 主要功能: 用户认证，账户管理，权限控制 + - 注释字数: 约1200字 + +7. main_menu.c (菜单显示) + - 总行数: 约120行 + - 函数数量: 4个 + - 注释行数: 约30行 + - 代码行数: 约90行 + - 主要功能: 菜单界面显示 + - 注释字数: 约600字 + +8. core_handlers.c (核心处理) + - 总行数: 154行 + - 函数数量: 4个 + - 注释行数: 约40行 + - 代码行数: 约114行 + - 主要功能: 菜单逻辑处理，功能调度 + - 注释字数: 约800字 + +9. globals.c (全局变量) + - 总行数: 25行 + - 变量定义: 约10个 + - 注释行数: 约5行 + - 代码行数: 约20行 + - 主要功能: 全局变量定义 + - 注释字数: 约100字 + +======================================== +头文件统计（v2.2模块化架构） +======================================== + +核心模块头文件: +1. types.h - 85行，统一数据类型定义（v3.0.0新增） +2. config.h - 98行，系统配置（已移除结构体定义） +3. globals.h - 32行，全局变量声明（已优化包含关系） +4. main_menu.h - 12行，菜单功能声明 +5. core_handlers.h - 18行，核心处理器声明 + +业务模块头文件: +5. student_crud.h - 学生CRUD操作声明 +6. student_search.h - 学生搜索功能声明 +7. student_sort.h - 学生排序功能声明 +8. student_io.h - 学生数据I/O声明 +9. statistical_analysis.h - 25行，统计分析功能声明（已移除结构体定义） +10. user_manage.h - 13行，用户管理功能声明 + +工具模块头文件（新增）: +11. io_utils.h - 输入输出工具声明 +12. validation.h - 数据验证工具声明 +13. string_utils.h - 字符串处理工具声明 +14. file_utils.h - 文件操作工具声明 +15. math_utils.h - 数学计算工具声明 +16. system_utils.h - 系统管理工具声明 + +v3.0.0类型管理优势: +- 统一类型定义: 所有结构体集中在types.h中管理 +- 消除重复定义: 避免多个文件中的重复结构体声明 +- 依赖关系简化: 头文件包含关系更加清晰 +- 维护性提升: 结构体修改只需在一个文件中进行 + +v2.2模块化优势: +- 精确依赖: 每个文件只包含必需的头文件 +- 职责单一: 每个模块功能明确，便于维护 +- 编译优化: 支持增量编译和直接编译两种模式 + +======================================== +代码量统计汇总 +======================================== + +总代码行数: 3859行（v3.0.0类型管理优化后） +总注释行数: 1689行 +总注释字数: 约36024字 + +代码分布（v3.0.0统一类型管理架构）: +- 核心业务代码: 54% (约1385行) +- 工具模块代码: 25% (约625行) - 原auxiliary.c拆分 +- 界面显示代码: 10% (约250行) +- 配置和类型定义: 11% (约265行) - 新增types.h + +v3.0.0类型管理收益: +- 类型定义统一: 所有结构体集中管理，避免重复定义 +- 依赖关系优化: 简化头文件包含，减少编译依赖 +- 全局变量优化: 排序参数和统计缓存全局化，提升性能 +- 代码一致性: 统一的数据类型管理，提高可维护性 + +v2.2模块化收益: +- 代码复用性提升: 工具模块可独立使用 +- 维护成本降低: 模块职责单一，易于调试 +- 编译效率优化: 支持增量编译和直接编译 +- 依赖关系清晰: 精确的头文件包含关系 + +注释覆盖率: 约43.0%（大幅提升） + +======================================== +功能模块详细分析 +======================================== + +1. 学生数据管理模块 (stu_data.c) + - 代码复杂度: 高 + - 总行数: 762行 + - 函数数量: 10个 + - 函数平均长度: 约76行 + - 主要算法: 线性搜索，冒泡排序 + + 核心函数分析: + • loadStudentsFromFile(): 142行，负责CSV文件解析和数据加载 + • saveStudentsToFile(): 68行，负责数据持久化存储 + • addStudent(): 95行，交互式学生信息录入 + • modifyStudent(): 120行，学生信息修改功能 + • searchStudentByName(): 45行，模糊姓名搜索 + • sortStudents(): 85行，多条件排序功能 + + 性能特点: + • 时间复杂度: O(n)搜索，O(n²)排序 + • 空间复杂度: O(1)，使用静态数组 + • 文件I/O: 同步读写，无缓存机制 + + 优化潜力: + • 可实现二分搜索(需预排序): O(log n) + • 可使用快速排序: O(n log n) + • 可添加索引机制提升查询效率 + +2. 统计分析模块 (statistical_analysis.c) + - 代码复杂度: 中等 + - 总行数: 489行 + - 函数数量: 12个 + - 函数平均长度: 约40行 + - 主要算法: 统计计算，数据分析 + + 核心函数分析: + • calculateCourseStats(): 55行，课程统计计算 + • displayOverallStatistics(): 78行，综合统计展示 + • calculateScoreDistribution(): 42行，分数分布计算 + • findTopStudent(): 35行，最优学生查找 + • displayStudentRanking(): 65行，学生排名显示 + + 算法特点: + • 统计算法: 单次遍历计算多项指标 + • 内存使用: 临时结构体存储中间结果 + • 计算精度: 浮点数运算，保留2位小数 + + 扩展性: + • 支持新增统计指标 + • 可实现数据可视化输出 + • 可添加趋势分析功能 + +3. 辅助功能模块 (auxiliary.c) + - 代码复杂度: 中等 + - 总行数: 538行 + - 函数数量: 20个 + - 函数平均长度: 约27行 + - 主要算法: 字符串处理，输入验证 + + 功能分类: + • 输入输出辅助: 5个函数 (clearInputBuffer, pauseSystem等) + • 数据验证: 5个函数 (isValidScore, isValidStudentID等) + • 字符串处理: 3个函数 (trimString, isEmptyString等) + • 文件操作: 3个函数 (fileExists, createDirectory等) + • 安全输入: 3个函数 (safeInputInt, safeInputFloat等) + • 系统管理: 1个函数 (initializeSystem, cleanupSystem等) + + 安全特性: + • 缓冲区溢出防护 + • 输入范围验证 + • 错误处理机制 + • 跨平台兼容性处理 + +4. 用户管理模块 (user_manage.c) + - 代码复杂度: 中等 + - 总行数: 265行 + - 函数数量: 7个 + - 函数平均长度: 约38行 + - 主要算法: 文件读写，字符串比较 + + 安全机制: + • 密码明文存储 (安全风险) + • 登录尝试次数限制 + • 用户权限分级管理 + • 会话状态维护 + + 功能完整性: + • 用户认证: loginSystem() + • 账户管理: addUserAccount(), deleteUserAccount() + • 密码管理: modifyUserPassword() + • 数据持久化: loadUsersFromFile(), saveUsersToFile() + +5. 菜单控制模块 (main_menu.c + core_handlers.c) + - 代码复杂度: 低 + - 总行数: 274行 + - 函数数量: 8个 + - 主要功能: 用户界面控制，功能调度 + + 设计模式: + • MVC模式: 视图(menu)与控制(handlers)分离 + • 状态机: 菜单状态转换 + • 命令模式: 菜单选项到功能的映射 + +======================================== +深度代码质量评估 +======================================== + +✅ 优点详细分析: + +1. 文档化水平 (优秀) + • Doxygen标准注释格式 + • 函数级别注释覆盖率: 100% + • 参数和返回值说明完整 + • 使用场景和注意事项明确 + • 总注释字数: 约35,224字 + +2. 模块化设计 (良好) + • 单一职责原则: 每个模块功能明确 + • 接口设计: 头文件清晰定义公共接口 + • 依赖关系: 模块间耦合度较低 + • 可重用性: 辅助函数可独立使用 + +3. 错误处理 (良好) + • 文件操作错误检查 + • 输入验证机制 + • 边界条件处理 + • 用户友好的错误提示 + +4. 代码风格 (良好) + • 命名规范: 函数和变量名具有描述性 + • 缩进一致: 使用统一的代码格式 + • 常量定义: 使用宏定义避免魔法数字 + +⚠️ 改进建议详细分析: + +1. 函数长度优化 ✅ **已完成** (重要) + ~~问题函数:~~ + • ~~addStudent(): 95行 → 建议拆分为3个子函数~~ + • ~~modifyStudent(): 120行 → 建议拆分为4个子函数~~ + • ~~loadStudentsFromFile(): 142行 → 建议拆分解析逻辑~~ + + ✅ **重构成果**: + • loadStudentsFromFile() → 拆分为4个子函数（parseBasicStudentInfo, parseCourseInfo, parseStatisticsInfo, parseStudentLine） + • addStudent() → 拆分为4个子函数（inputStudentID, inputBasicInfo, inputCourseInfo, displayAddedStudentInfo） + • modifyStudent() → 拆分为8个子函数（displayStudentBasicInfo, modifyStudentGender, modifyExistingCourse, addNewCourse, deleteCourse, displayCourseList, modifyCourseInfo, handleStudentModification） + • 总计新增16个静态辅助函数，提高代码模块化程度 + • 编译测试通过，功能完整性得到保证 + +1.5 文件模块化重构 ✅ 已完成 + 状态: 已完成模块化 + 完成时间: 2025年 + + 重构详情: + 原文件: stu_data.c (937行) → 拆分为5个模块文件 + + 新模块结构: + • stu_data.c (25行) - 主协调文件，包含模块引用 + • student_io.c (200行) - 文件输入输出操作 + - loadStudentsFromFile() 及其4个辅助函数 + - saveStudentsToFile() + + • student_crud.c (400行) - 增删改操作 + - addStudent() 及其4个辅助函数 + - deleteStudent() + - modifyStudent() 及其8个辅助函数 + + • student_search.c (150行) - 搜索和显示操作 + - searchStudentByID() + - searchStudentByName() + - displayAllStudents() + - displayStudentInfo() + + • student_sort.c (50行) - 排序操作 + - sortStudents() + + 对应头文件: + • student_io.h - 文件I/O函数声明 + • student_crud.h - CRUD操作函数声明 + • student_search.h - 搜索显示函数声明 + • student_sort.h - 排序函数声明 + + ✅ **模块化成果**: + • 单文件代码量从937行降至最大400行 + • 功能模块清晰分离，职责单一 + • 提高了代码可维护性和可扩展性 + • 便于团队协作开发 + • 编译测试通过，程序运行正常 + • 新增4个功能模块和对应头文件 + +2. 算法效率提升 (中等) + 当前问题: + • 冒泡排序: O(n²) → 建议快速排序: O(n log n) + • 线性搜索: O(n) → 建议哈希表或二分搜索: O(1)或O(log n) + • 重复统计计算 → 建议缓存机制 + + 实现建议: + • 添加qsort()标准库函数 + • 实现学号索引表 + • 添加统计结果缓存 + +3. 内存管理优化 (中等) + 当前限制: + • 静态数组大小固定: MAX_STUDENTS=1000 + • 无法动态扩容 + • 内存使用效率较低 + + 改进方案: + • 实现动态内存分配 + • 添加内存池管理 + • 实现数据分页加载 + +4. 安全性增强 (重要) + 安全风险: + • 密码明文存储 + • 缓冲区溢出风险 + • 文件权限控制缺失 + + 安全措施: + • 实现密码哈希存储 (SHA-256) + • 添加输入长度严格检查 + • 实现文件访问权限控制 + • 添加SQL注入防护 (如果升级到数据库) + +5. 测试覆盖率 (重要) + 当前状态: + • 缺少单元测试 + • 缺少集成测试 + • 缺少边界条件测试 + + 测试建议: + • 为每个模块编写单元测试 + • 添加边界值测试用例 + • 实现自动化测试脚本 + • 添加性能基准测试 + + ✅ **重构验证**: + • 函数重构后编译测试通过 + • 核心功能完整性验证完成 + • 新增函数接口稳定性确认 + +6. 配置管理 (中等) + 改进方向: + • 配置文件外部化 + • 运行时参数调整 + • 多环境配置支持 + • 配置验证机制 + +======================================== +技术架构深度分析 +======================================== + +🏗️ 架构模式: + +1. 分层架构 (Layered Architecture) + • 表示层: main_menu.c (用户界面) + • 业务层: core_handlers.c (业务逻辑) + • 数据层: stu_data.c, user_manage.c (数据操作) + • 工具层: auxiliary.c (通用工具) + +2. 模块化设计 + • 高内聚: 每个模块功能集中 + • 低耦合: 模块间依赖最小化 + • 接口清晰: 头文件定义明确 + +🔧 技术特点详细分析: + +1. 跨平台兼容性 (优秀) + 实现机制: + • 条件编译: #ifdef _WIN32 + • 系统API适配: Windows.h vs unistd.h + • 文件路径处理: 自动适配路径分隔符 + • 字符编码: UTF-8统一编码 + + 支持平台: + • Windows 7/8/10/11 + • Linux (Ubuntu, CentOS, Debian) + • macOS (理论支持) + +2. 数据持久化 (良好) + 文件格式选择: + • CSV格式: 人类可读，Excel兼容 + • 文本格式: 简单解析，跨平台 + • 编码支持: UTF-8中文支持 + + 数据完整性: + • 原子性写入: 临时文件+重命名 + • 备份机制: backup目录 + • 错误恢复: 文件损坏检测 + +3. 内存管理策略 (保守) + 设计理念: + • 静态分配: 避免内存泄漏 + • 预分配: 启动时分配所有内存 + • 零拷贝: 直接操作全局数组 + + 性能影响: + • 内存占用: 固定约2MB + • 启动速度: 快速 + • 运行稳定性: 高 + +4. 用户体验设计 (良好) + 界面特性: + • 彩色输出: ANSI转义序列 + • 清屏功能: 界面整洁 + • 进度提示: 操作反馈 + • 错误提示: 友好的中文提示 + + 交互设计: + • 菜单导航: 数字选择 + • 输入验证: 实时检查 + • 确认机制: 重要操作二次确认 + +5. 国际化支持 (基础) + 当前状态: + • 中文界面: 完整中文提示 + • UTF-8编码: 支持中文数据 + • 本地化: 硬编码中文字符串 + + 扩展潜力: + • 多语言支持: 资源文件分离 + • 区域设置: 日期时间格式 + • 字符集适配: 不同编码支持 + +🚀 性能分析: + +1. 时间复杂度分析 + • 数据加载: O(n) - 线性读取 + • 学生搜索: O(n) - 顺序查找 + • 数据排序: O(n²) - 冒泡排序 + • 统计计算: O(n) - 单次遍历 + • 数据保存: O(n) - 线性写入 + +2. 空间复杂度分析 + • 学生数据: O(1) - 固定数组 + • 用户数据: O(1) - 固定数组 + • 临时变量: O(1) - 栈分配 + • 总内存占用: 约2MB + +3. I/O性能 + • 文件读取: 同步I/O，无缓存 + • 文件写入: 同步I/O，立即刷新 + • 网络通信: 无 + • 数据库: 无 + +📊 可扩展性评估: + +1. 数据规模扩展 + 当前限制: + • 最大学生数: 1000 + • 最大课程数: 10 + • 最大用户数: 50 + + 扩展方案: + • 动态数组: 支持任意数量 + • 分页加载: 支持大数据集 + • 数据库: 支持海量数据 + +2. 功能模块扩展 + 易扩展功能: + • 新增统计指标 + • 新增数据字段 + • 新增用户权限 + + 困难扩展功能: + • 多用户并发 + • 网络功能 + • 图形界面 + +3. 技术栈升级路径 + • 数据库集成: SQLite → MySQL/PostgreSQL + • 网络功能: Socket → HTTP API + • 图形界面: Console → Qt/GTK + • 移动端: Native → React Native/Flutter + +======================================== +报告结束 +======================================== + +本报告统计了学生成绩管理系统的完整代码结构和质量指标。 +系统代码总体质量良好，注释完整，结构清晰，具有良好的可维护性。 \ No newline at end of file diff --git a/TXT/系统说明文档.txt b/TXT/系统说明文档.txt new file mode 100644 index 0000000..1027e2e --- /dev/null +++ b/TXT/系统说明文档.txt @@ -0,0 +1,199 @@ +/** + * @file 学生成绩管理系统 + * @brief C语言学生成绩管理系统 + * @details 支持学生信息管理、成绩统计分析、用户权限控制的完整教务管理系统 + * @author 刘航宇 + * @date 2025-07-12 + * @version 3.0.0 + * @note + * 1. v3.0.0新增功能（最新版本）： + * - 🏗️ 统一类型管理系统，创建types.h集中管理所有数据结构 + * - 🔧 全局变量优化，将排序参数和统计缓存移至全局作用域 + * - 📦 结构体定义重构，消除重复定义，提升代码一致性 + * - 🎯 依赖关系优化，简化头文件包含关系，避免循环依赖 + * - ⚡ 编译效率提升，优化模块间依赖，加快编译速度 + * - 🧩 架构进一步完善，为后续功能扩展奠定坚实基础 + * 2. v2.2功能（前版本）： + * - 🧩 auxiliary.c完全模块化拆分，提升代码可维护性 + * - ⚡ Makefile优化，支持直接编译模式，无需生成.o文件 + * - 🔧 六大工具模块：io_utils、validation、string_utils、file_utils、math_utils、system_utils + * - 📦 模块化头文件管理，精确依赖控制 + * - 🚀 编译效率优化，简化构建流程 + * - 🏗️ 代码架构进一步优化，模块职责更加清晰 + * 2. v2.0-v2.1功能： + * - 📊 CSV格式数据存储，支持Excel直接编辑和查看 + * - 🔗 模块化架构重构，核心功能独立封装 + * - 🛡️ 完善的输入验证和数据校验机制 + * - 📡 跨平台支持（Windows/Linux/macOS） + * - 🔧 全局变量统一管理，优化代码结构 + * - 📋 宏定义统一管理，消除重复定义 + * 2. 核心管理功能： + * - 增加了对学生信息的完整CRUD操作支持 + * - 新增了多维度成绩统计分析功能 + * - 添加了用户权限管理，支持管理员和普通用户 + * - 实现了数据持久化，支持CSV格式导入导出 + * - 支持多门课程成绩管理和自动计算总分平均分 + * 3. 性能优化： + * - 🚀 优化了数据查询算法，提高大数据量处理效率 + * - 🎨 改进了界面渲染，增加彩色输出和美观显示 + * - 💾 增加了内存管理优化，避免内存泄漏问题 + * - ⚡ 文件I/O优化，支持大容量数据快速读写 + * - 🔍 智能搜索算法，支持模糊查询和多条件筛选 + * 4. 用户界面改进： + * - 🎮 美化了管理界面，增加了更多的视觉效果 + * - ⌨️ 改进了用户交互体验，增加了输入提示和验证 + * - 🔊 添加了操作反馈，提升用户操作体验 + * - 💬 友好的错误提示和帮助信息 + * - 📊 清晰的数据展示和统计图表 + * 5. 代码结构优化（v2.2重大更新）： + * - 🏗️ 重构了代码架构，采用分层设计模式 + * - 📝 增加了详细的注释和文档，便于理解和修改 + * - 🧩 采用了完全模块化设计，各功能模块完全独立 + * - 🌍 新增核心处理器模块，统一业务逻辑管理 + * - 🔧 全局状态统一管理，消除代码重复 + * - 📋 配置文件标准化，支持灵活配置 + * - ⚡ auxiliary.c拆分为6个专业模块，职责单一 + * - 🎯 精确依赖管理，每个文件只包含必需的头文件 + * - 🚀 编译系统优化，支持直接编译和增量编译两种模式 + * 6. 数据管理功能： + * - 📁 CSV格式数据存储，便于数据交换和备份 + * - 🔍 支持按学号、姓名、成绩等多维度查询 + * - 📊 丰富的统计分析功能，包括课程分析、成绩分布等 + * - 🔄 数据排序功能，支持多种排序方式 + * - 💾 自动数据备份和恢复机制 + * 7. 安全性增强： + * - 🛡️ 用户登录验证，支持多用户权限管理 + * - 🔐 密码安全存储，防止明文泄露 + * - 🚫 输入数据验证，防止非法数据录入 + * - 🔒 文件访问权限控制，保护数据安全 + * - 📋 操作日志记录，追踪用户行为 + * 8. 统计分析功能： + * - 📈 课程成绩统计，包括最高分、最低分、平均分 + * - 📊 成绩分布分析，按分数段统计学生人数 + * - 🏆 学生排名功能，支持总分和单科排名 + * - 📉 成绩趋势分析，跟踪学生成绩变化 + * - 🎯 综合评价体系，多维度评估学生表现 + * 9. 异常处理： + * - 🛡️ 增加了输入错误的异常处理机制，确保系统稳定性 + * - 💡 优化了错误提示信息，帮助用户快速定位问题 + * - 🔄 增加了程序崩溃恢复功能，提高系统可靠性 + * - 📁 文件操作异常处理，防止数据丢失 + * - 🔧 内存分配异常处理，确保程序稳定运行 + * 10. 文档更新： + * - 📚 更新了README文件，提供详细的安装和使用说明 + * - 💬 增加了代码注释，提高代码的可读性 + * - 👨‍💻 添加了开发者文档，便于后续的功能扩展 + * - 📋 新增CSV格式使用指南和配置说明 + * - 🔧 API文档完善，支持二次开发 + * 11. 版本控制： + * - 📦 使用Git进行版本控制，便于代码管理和协作开发 + * - 🚀 建立了清晰的版本发布流程，确保代码质量 + * - 🏷️ v2.0重大版本更新，CSV存储和模块化里程碑 + * - 📋 完整的变更日志，追踪功能演进 + * 12. 测试： + * - ✅ 进行了全面的功能测试，确保各项功能正常运行 + * - 🧪 增加了单元测试，提高代码的可靠性 + * - ⚡ 进行了性能测试，优化了程序的运行效率 + * - 📊 数据处理压力测试，确保大数据量处理稳定性 + * - 🔒 安全性测试，验证用户权限和数据保护 + * 13. 跨平台支持： + * - 🖥️ Windows平台完全支持，包括PowerShell和CMD + * - 🐧 Linux平台兼容，支持各主流发行版 + * - 🍎 macOS平台支持，确保跨平台一致性 + * - 🔧 编译器兼容性，支持GCC、Clang等主流编译器 + * - 📁 文件系统兼容，自动适配不同平台路径格式 + * 14. 数据格式支持： + * - 📊 CSV格式主存储，便于Excel等工具编辑 + * - 📄 TXT格式用户数据，简单高效 + * - 💾 二进制格式备份，确保数据完整性 + * - 🔄 格式转换工具，支持多种数据格式互转 + * - 📋 数据导入导出功能，便于数据迁移 + * 15. 开源协议： + * - 📄 选择了MIT开源协议，允许用户自由使用、修改和分发代码 + * - 🤝 欢迎社区贡献，共同完善项目 + * - 🌟 开源社区友好，支持二次开发和定制 + * 16. 系统架构： + * - 🏗️ 分层架构设计：UI层、业务逻辑层、数据访问层、配置层 + * - 🧩 模块化组件：学生管理、统计分析、用户管理、文件操作 + * - 🔧 核心处理器：统一的业务逻辑处理中心 + * - 📋 配置管理：集中的参数配置和宏定义管理 + * - 🌍 全局状态：统一的全局变量和状态管理 + * 17. 功能模块详解（v2.2模块化架构）： + * - 👥 学生管理模块：增删改查、信息验证、数据校验 + * - 📊 统计分析模块：多维度统计、图表展示、趋势分析 + * - 🔐 用户管理模块：登录验证、权限控制、密码管理 + * - 📁 文件操作模块：CSV读写、数据备份、格式转换 + * - 🎨 界面显示模块：彩色输出、表格显示、交互优化 + * - 🔧 工具模块详解： + * • io_utils: 输入输出、界面显示、用户交互 + * • validation: 数据验证、输入校验、安全检查 + * • string_utils: 字符串处理、文本操作、格式化 + * • file_utils: 文件操作、目录管理、存在性检查 + * • math_utils: 数学计算、统计函数、数值处理 + * • system_utils: 系统初始化、资源管理、清理操作 + * 18. 贡献者： + * - 👨‍💻 感谢所有为项目做出贡献的开发者和用户 + * - 🌟 特别感谢CSV格式开发和模块化重构的贡献者 + * - 🧪 感谢测试团队的全面测试和反馈 + * - 📝 感谢文档编写和维护的贡献者 + * 19. 技术栈： + * - 💻 编程语言：C语言（C11标准） + * - 🔧 编译器：GCC 4.8+、Clang、MSVC + * - 📁 数据存储：CSV文件、TXT文件 + * - 🎨 界面技术：控制台彩色输出、ANSI转义序列 + * - 🔧 构建工具：Makefile、GCC直接编译 + * 20. 未来规划： + * - 🌐 Web界面支持，提供浏览器访问方式 + * - 📱 移动端适配，支持手机和平板设备 + * - 🗄️ 数据库支持，集成MySQL、SQLite等数据库 + * - 📊 高级统计功能，增加更多数据分析工具 + * - 🔗 API接口开发，支持第三方系统集成 + * 21. 联系信息： + * - 📧 如有问题或建议，请联系开发团队 + * - 🐛 Bug报告和功能建议欢迎通过GitHub Issues反馈 + * - 💡 功能改进建议请详细描述使用场景和需求 + * - 🤝 欢迎加入开发团队，共同完善项目 + * - 📚 技术交流和学习资源分享 + * + * 22. 贡献者： + * - 👨‍💻 感谢所有为项目做出贡献的开发者和用户 + * - 🌟 特别感谢测试的贡献者 + * 23. 联系信息： + * - 📧 如有问题或建议，请联系开发者： + * - 3364451258@qq.com + * - 15236416560@163.com + * - lhy3364451258@outlook.com + * - 🐛 Bug报告和功能建议欢迎通过邮件反馈 + * - 💡 网络对战相关问题请详细描述网络环境 + * + * @copyright Copyright (c) 2025 学生成绩管理系统开发团队 + * @license MIT License + * + * 编译命令（v3.0.0统一类型管理版本）： + * 方式1（推荐）：直接编译 + * gcc -Wall -Wextra -std=c99 -g main.c globals.c main_menu.c user_manage.c core_handlers.c statistical_analysis.c student_io.c student_crud.c student_search.c student_sort.c io_utils.c validation.c string_utils.c file_utils.c math_utils.c system_utils.c -o student_system + * + * 方式2：分步编译（如需要） + * gcc -Wall -Wextra -std=c99 -g -c *.c + * gcc *.o -o student_system + * + * 运行命令： + * ./student_system.exe (Windows) + * ./student_system (Linux/macOS) + * + * 默认登录信息： + * 管理员 - 用户名：admin，密码：123456 + * 教师 - 用户名：teacher，密码：password + * + * 数据文件位置： + * 学生数据：data/students.csv + * 用户数据：data/users.txt + * 备份目录：backup/ + * + * 系统要求： + * - 操作系统：Windows 7+、Linux、macOS + * - 编译器：GCC 4.8+、Clang 3.0+、MSVC 2015+ + * - 内存：最少64MB可用内存 + * - 存储：最少10MB可用磁盘空间 + * - 终端：支持ANSI颜色代码的终端（推荐） + */ \ No newline at end of file diff --git a/TXT/要求.txt b/TXT/要求.txt new file mode 100644 index 0000000..fe93082 --- /dev/null +++ b/TXT/要求.txt @@ -0,0 +1,150 @@ +学生成绩管理系统 +一、项目目标与学习要点 +通过这个项目，大家将掌握以下核心技能： +●数据结构设计： 学习如何使用结构体（struct）来组织复杂数据。 +●文件操作： 实现数据的持久化存储，让程序数据在关闭后依然存在。 +●模块化编程： 学习使用函数将程序划分为独立、可重用的模块。 +●算法应用： 实践查找、排序等基本算法。 +●错误处理与用户交互： 提升程序的健壮性和用户体验。 +二、核心功能模块设计 +成绩管理系统将包含以下几个主要功能模块： +1. 数据结构定义 +首先，我们需要定义用于存储学生和课程信息的结构体。这是整个系统的基础。 +// 定义课程结构体，用于存储单门课程的信息 +typedef struct { + char courseName[50]; // 课程名称 + float score; // 课程分数 +} Course; + +// 定义学生结构体，用于存储每个学生的所有信息 +typedef struct { + char studentID[20]; // 学生学号 (作为唯一标识符) + char studentName[50]; // 学生姓名 + int age; // 年龄 + char gender; // 性别 (例如 'M' 或 'F') + Course courses[10]; // 学生所学课程的数组，假设最多10门课程 + int numCourses; // 该学生实际选修的课程数量 + float totalScore; // 学生所有课程的总分 + float averageScore; // 学生所有课程的平均分 +} Student; +●存储方式： 我们可以使用一个全局的 Student 结构体数组来存储所有学生的信息，或者更灵活地使用链表（稍后可作为进阶考虑）。对于初学者，先从固定大小的数组开始会更容易理解。 +●文件存储： 为了让数据在程序关闭后不丢失，我们需要将学生数据保存到文件中（例如 students.dat 或 students.txt），并在程序启动时从文件中加载数据。 +2. 基本功能（CRUD操作） +这是管理系统的核心，实现了对学生信息的增删改查。 +●增加学生信息 (addStudent)： +✓程序会提示用户输入学生的学号、姓名、年龄、性别。 +✓然后允许用户逐一添加该学生的课程名称和分数，直到用户选择停止。 +✓添加完成后，自动计算并更新该学生的总分和平均分。 +✓最后，将新的学生信息添加到内存中的数据结构（数组或链表）中，并及时保存到文件。 +●删除学生信息 (deleteStudent)： +✓根据用户输入的学生学号来查找并删除对应的学生记录。 +✓删除后，需要调整数据结构（例如，如果是数组，将后面的元素向前移动），并更新文件。 +●修改学生信息 (modifyStudent)： +✓根据用户输入的学生学号查找学生。 +✓找到后，允许用户选择修改学生的姓名、年龄、性别，或者修改某门课程的分数。 +✓修改课程分数后，需重新计算该学生的总分和平均分。 +✓修改完成后，更新文件。 +●查找学生信息 (searchStudent)： +✓按学号查找： 用户输入完整学号，精确查找并显示该学生的所有详细信息。 +✓按姓名查找： 用户输入学生姓名（可以支持模糊查找，例如输入“李”能找到“李华”、“李明”等），显示所有匹配学生的简要信息。 +●排序学生信息 (sortStudents)： +✓排序依据： 提供按学生学号、学生姓名、总分、平均分进行升序或降序排序的功能。 +✓排序算法： 对于数据量不大的情况，可以使用冒泡排序、选择排序或插入排序等简单算法来实现。排序后，显示排序结果。 +3. 统计功能（全方位统计） +这部分功能用于对学生成绩进行多维度的分析。 +●按学生姓名统计： 实际上已包含在“按姓名查找”功能中，可以显示匹配学生的所有信息。 +●按成绩（单科）统计： +✓用户选择一门课程，系统统计该课程的及格人数、优秀人数（例如90分以上）、不及格人数。 +✓显示该课程的最高分、最低分、平均分。 +●按分数段统计（所有课程或指定课程）： +✓统计0-59分、60-69分、70-79分、80-89分、90-100分等各个分数段的学生人数。可以针对所有课程的平均分，也可以选择统计某门特定课程的分数段。 +●按课程统计： +■列出所有已录入的课程，并显示每门课程的平均分、最高分、最低分。 +■允许用户选择一门课程，然后显示所有学生在该课程上的成绩列表。 +三、高阶功能设计 +这部分将提升系统的安全性和管理能力。 +1. 登录界面 +●功能描述： 程序启动后，首先显示一个登录界面，要求用户输入用户名和密码。 +●文件存储： 用户名和密码将存储在一个单独的文本文件中（例如：users.txt）。文件格式可以是 用户名:密码，每行一个用户。 +admin:123456 +teacher:password123 +●读取与匹配： +■程序启动时，从 users.txt 中读取所有合法的用户名和密码到内存中。 +■用户输入用户名和密码后，程序会将其与内存中的数据进行匹配。 +■只有匹配成功，用户才能进入系统的主菜单。 +●尝试次数限制： 可以考虑设置登录失败的尝试次数限制，例如，如果用户连续三次输入错误，则程序自动退出。 +●密码安全（可选进阶）： 更好的做法是存储密码的哈希值而不是明文。虽然这对于C语言初学者来说可能有些复杂，但可以了解其原理：用户输入的密码经过哈希函数处理后，与存储的哈希值进行比较，而不是直接比较密码原文。 +2. 管理功能（用户名、密码管理） +在用户成功登录并进入系统后，除了基本功能和统计功能，还可以提供一个“管理功能”菜单，只有特定权限的用户（例如“admin”）才能访问。 +●增加用户： 允许管理员添加新的登录账户（用户名和密码）。这需要将新用户数据写入 users.txt 文件。 +●删除用户： 允许管理员根据用户名删除已存在的登录账户。这需要从 users.txt 文件中移除对应用户。 +●修改用户密码： 允许管理员修改现有用户的密码。这需要更新 users.txt 文件中对应用户的密码。 +四、系统架构与函数规划 +为了使代码结构清晰、易于维护和扩展，我们应该采用模块化的设计思想，将各个功能封装成独立的函数。 +// 主菜单和子菜单显示函数 +void displayMainMenu(); // 显示主菜单 +void displayBasicFunctionsMenu(); // 显示基本功能菜单 +void displayStatisticsMenu(); // 显示统计功能菜单 +void displayAdminMenu(); // 显示管理功能菜单 + +// 用户认证与管理相关函数 +int loginSystem(); // 处理用户登录 +void loadUsersFromFile(); // 从文件加载用户数据 +void saveUsersToFile(); // 将用户数据保存到文件 +void addUserAccount(); // 增加用户 +void deleteUserAccount(); // 删除用户 +void modifyUserPassword(); // 修改用户密码 + +// 学生数据管理相关函数 (CRUD) +void loadStudentsFromFile(); // 从文件加载学生数据 +void saveStudentsToFile(); // 将学生数据保存到文件 +void addStudent(); // 增加学生信息 +void deleteStudent(); // 删除学生信息 +void modifyStudent(); // 修改学生信息 +void searchStudentByID(); // 按学号查找学生 +void searchStudentByName(); // 按姓名查找学生 +void displayAllStudents(); // 显示所有学生信息 +void sortStudents(int criteria, int order); // 统一排序函数，根据参数选择排序依据和升降序 + +// 统计分析相关函数 +void analyzeCourseStatistics(); // 针对单门课程的统计 +void analyzeOverallScoreDistribution(); // 统计总分/平均分分布 +void analyzeScoreRanges(); // 统计分数段 + +// 辅助函数 +void clearInputBuffer(); // 清理输入缓冲区，防止输入错误 +int isValidScore(float score); // 验证分数是否合法 (0-100) +// ... 其他可能的辅助函数 +五、开发步骤建议 +1.从基础开始： +■首先定义 Student 和 Course 结构体。 +■实现增加学生和显示所有学生的功能。 +■实现学生数据保存到文件 (saveStudentsToFile) 和从文件加载 (loadStudentsFromFile) 的功能，确保数据的持久性。这一步非常关键！ +2.逐步完善基本功能： +■实现删除学生和修改学生的功能。 +■实现查找学生（按学号和按姓名）。 +■实现排序学生（选择一种排序方式和依据，例如按总分排序）。 +3.实现统计功能： +■逐一实现各项统计功能，注意数据遍历和计算逻辑。 +4.最后实现高阶功能： +■实现用户登录模块，包括 users.txt 的读写。 +■实现用户管理功能（增加、删除、修改用户）。 +5.增强用户体验和健壮性： +■在每个输入环节加入输入验证，例如分数是否在0-100之间，学号是否重复等。 +■处理文件操作失败的情况（例如文件不存在或无法打开）。 +■提供清晰的菜单提示和操作反馈信息。 +六、技术要点与挑战 +●文件操作： 熟练使用 FILE 指针、fopen()、fclose() 进行文件的打开和关闭。使用 fprintf()、fscanf() 进行格式化读写文本文件，或者使用 fread()、fwrite() 进行二进制读写。推荐初学者先尝试文本文件，因为其内容直观易调试。 +●字符串处理： strcpy() 拷贝字符串，strcmp() 比较字符串，strlen() 获取字符串长度，strstr() 进行子字符串查找（可用于模糊查找姓名）。 +●内存管理： 如果学生数量不确定，可以学习使用 malloc() 和 free() 进行动态内存分配，用链表来存储学生数据，这样可以灵活地增删学生。 +●循环与条件判断： while 循环用于主菜单，for 循环用于遍历学生数据，if-else 和 switch-case 用于功能选择和逻辑判断。 +七、思考与提升 +完成这个项目后，你可以进一步思考： +1.程序的健壮性： 如果用户输入了非数字字符，你的程序会崩溃吗？如何避免？ +2.用户界面： 如何让命令行界面更加友好和美观？ +3.数据安全性： 除了简单的哈希，还有哪些更安全的密码存储方式？ +4.扩展性： 如果要增加更多的课程信息，或者存储班级信息，你的数据结构需要如何调整？ +5.性能： 如果学生数量非常庞大，目前的查找和排序算法是否高效？如何优化？ +八、个性化 +可以不参考上面的提示，自己根据自己思路来设计具有自己特色功能的类似功能或者扩展功能或者类似系统。 + \ No newline at end of file diff --git a/config.h b/config.h new file mode 100644 index 0000000..73ceb0e --- /dev/null +++ b/config.h @@ -0,0 +1,99 @@ +/** + * @file config.h + * @brief 学生成绩管理系统参数配置头文件 + * @note 本文件集中定义了学生成绩管理系统的所有参数配置，便于统一管理和修改 + */ + +#ifndef CONFIG_H +#define CONFIG_H + +// 系统配置参数 +#define MAX_STUDENTS 1000 // 最大学生数量 +#define MAX_COURSES 10 // 每个学生最多课程数 +#define MAX_USERS 50 // 最大用户数量 +#define MAX_LOGIN_ATTEMPTS 3 // 最大登录尝试次数 + +// 字符串长度限制 +#define MAX_ID_LENGTH 20 // 学号最大长度 +#define MAX_NAME_LENGTH 50 // 姓名最大长度 +#define MAX_COURSE_NAME_LENGTH 50 // 课程名称最大长度 +#define MAX_USERNAME_LENGTH 30 // 用户名最大长度 +#define MAX_PASSWORD_LENGTH 30 // 密码最大长度 + +// 分数相关配置 +#define MIN_SCORE 0.0 // 最低分数 +#define MAX_SCORE 100.0 // 最高分数 +#define PASS_SCORE 60.0 // 及格分数 +#define EXCELLENT_SCORE 90.0 // 优秀分数 + +// 年龄相关配置 +#define MIN_AGE 10 // 最小年龄 +#define MAX_AGE 100 // 最大年龄 + +// 文件路径配置 +#define STUDENTS_FILE "data/students.csv" // 学生数据文件 +#define USERS_FILE "data/users.txt" // 用户数据文件 +#define BACKUP_DIR "backup/" // 备份目录 + +// 菜单选项定义 +#define MENU_EXIT 0 +#define MENU_BASIC_FUNCTIONS 1 +#define MENU_STATISTICS 2 +#define MENU_ADMIN 3 + +// 基本功能菜单选项 +#define BASIC_BACK 0 +#define BASIC_ADD_STUDENT 1 +#define BASIC_DELETE_STUDENT 2 +#define BASIC_MODIFY_STUDENT 3 +#define BASIC_SEARCH_BY_ID 4 +#define BASIC_SEARCH_BY_NAME 5 +#define BASIC_DISPLAY_ALL 6 +#define BASIC_SORT_STUDENTS 7 + +// 统计功能菜单选项 +#define STATS_BACK 0 +#define STATS_COURSE_ANALYSIS 1 +#define STATS_SCORE_DISTRIBUTION 2 +#define STATS_SCORE_RANGES 3 +#define STATS_OVERALL_ANALYSIS 4 + +// 管理功能菜单选项 +#define ADMIN_BACK 0 +#define ADMIN_ADD_USER 1 +#define ADMIN_DELETE_USER 2 +#define ADMIN_MODIFY_PASSWORD 3 +#define ADMIN_VIEW_USERS 4 + +// 排序选项 +#define SORT_BY_ID 1 +#define SORT_BY_NAME 2 +#define SORT_BY_TOTAL_SCORE 3 +#define SORT_BY_AVERAGE_SCORE 4 + +// 排序顺序 +#define SORT_ASCENDING 1 +#define SORT_DESCENDING 2 + +// 性别定义 +#define GENDER_MALE 'M' +#define GENDER_FEMALE 'F' + +// 颜色代码（用于美化输出） +#define COLOR_RESET "\033[0m" +#define COLOR_RED "\033[31m" +#define COLOR_GREEN "\033[32m" +#define COLOR_YELLOW "\033[33m" +#define COLOR_BLUE "\033[34m" +#define COLOR_MAGENTA "\033[35m" +#define COLOR_CYAN "\033[36m" +#define COLOR_WHITE "\033[37m" + +// 系统消息 +#define MSG_SUCCESS "操作成功！" +#define MSG_FAILURE "操作失败！" +#define MSG_NOT_FOUND "未找到相关记录！" +#define MSG_INVALID_INPUT "输入无效，请重新输入！" +#define MSG_FILE_ERROR "文件操作错误！" + +#endif // CONFIG_H \ No newline at end of file diff --git a/core_handlers.c b/core_handlers.c new file mode 100644 index 0000000..867b6cf --- /dev/null +++ b/core_handlers.c @@ -0,0 +1,205 @@ +/** + * @file core_handlers.c + * @brief 核心处理函数实现文件 + * @note 实现主要的功能处理函数 + */ + +#include +#include +#include + +#include "core_handlers.h" +#include "config.h" +#include "globals.h" +#include "main_menu.h" +#include "user_manage.h" +#include "student_io.h" +#include "student_crud.h" +#include "student_search.h" +#include "student_sort.h" +#include "statistical_analysis.h" +#include "io_utils.h" + +/** + * @brief 处理基本功能菜单 + * @details 显示并处理学生信息管理的基本功能菜单循环 + * 提供学生信息的增删改查、排序等核心功能 + * 循环显示菜单直到用户选择返回主菜单 + * @note 包含的功能： + * - 添加学生信息 + * - 删除学生信息 + * - 修改学生信息 + * - 按学号查找学生 + * - 按姓名查找学生 + * - 显示所有学生 + * - 学生信息排序 + */ +void handleBasicFunctions() +{ + int choice; + do + { + clearScreen(); + displayBasicFunctionsMenu(); + choice = safeInputInt("请选择功能", BASIC_BACK, BASIC_SORT_STUDENTS); + + switch (choice) + { + case BASIC_ADD_STUDENT: + addStudent(); + break; + case BASIC_DELETE_STUDENT: + deleteStudent(); + break; + case BASIC_MODIFY_STUDENT: + modifyStudent(); + break; + case BASIC_SEARCH_BY_ID: + searchStudentByID(); + break; + case BASIC_SEARCH_BY_NAME: + searchStudentByName(); + break; + case BASIC_DISPLAY_ALL: + displayAllStudents(); + break; + case BASIC_SORT_STUDENTS: + handleSortStudents(); + break; + case BASIC_BACK: + break; + default: + printError("无效的选择！"); + pauseSystem(); + break; + } + } while (choice != BASIC_BACK); +} + +/** + * @brief 处理统计功能菜单 + * @details 显示并处理统计分析功能菜单循环 + * 提供各种学生成绩的统计分析功能 + * 循环显示菜单直到用户选择返回主菜单 + * @note 包含的功能： + * - 课程统计分析 + * - 成绩分布统计 + * - 学生排名统计 + * - 综合统计分析 + */ +void handleStatistics() +{ + int choice; + do + { + clearScreen(); + displayStatisticsMenu(); + choice = safeInputInt("请选择功能", STATS_BACK, STATS_OVERALL_ANALYSIS); + + switch (choice) + { + case STATS_COURSE_ANALYSIS: + displayCourseStatistics(); + break; + case STATS_SCORE_DISTRIBUTION: + displayScoreDistribution(); + break; + case STATS_SCORE_RANGES: + displayStudentRanking(); + break; + case STATS_OVERALL_ANALYSIS: + displayOverallStatistics(); + break; + case STATS_BACK: + break; + default: + printError("无效的选择！"); + pauseSystem(); + break; + } + } while (choice != STATS_BACK); +} + +/** + * @brief 处理管理功能菜单 + * @details 显示并处理系统管理功能菜单循环，仅限管理员用户访问 + * 提供用户账户管理的各项功能 + * 循环显示菜单直到用户选择返回主菜单 + * @note 包含的功能： + * - 添加用户账户 + * - 删除用户账户 + * - 修改用户密码 + * - 查看所有用户 + * @warning 此函数仅应在验证用户为管理员后调用 + */ +void handleAdminFunctions() +{ + int choice; + do + { + clearScreen(); + displayAdminMenu(); + choice = safeInputInt("请选择功能", ADMIN_BACK, ADMIN_VIEW_USERS); + + switch (choice) + { + case ADMIN_ADD_USER: + addUserAccount(); + break; + case ADMIN_DELETE_USER: + deleteUserAccount(); + break; + case ADMIN_MODIFY_PASSWORD: + modifyUserPassword(); + break; + case ADMIN_VIEW_USERS: + viewAllUsers(); + break; + case ADMIN_BACK: + break; + default: + printError("无效的选择！"); + pauseSystem(); + break; + } + } while (choice != ADMIN_BACK); +} + +/** + * @brief 处理学生排序功能 + * @details 提供交互式的学生信息排序功能 + * 用户可选择排序依据（学号、姓名、总分、平均分）和排序顺序（升序、降序） + * 排序完成后自动显示排序结果 + * @note 排序依据选项： + * 1. 按学号排序 + * 2. 按姓名排序 + * 3. 按总分排序 + * 4. 按平均分排序 + * @note 排序顺序选项： + * 1. 升序 + * 2. 降序 + */ +void handleSortStudents() +{ + clearScreen(); + printHeader("学生排序"); + + printf("排序依据：\n"); + printf("1. 按学号排序\n"); + printf("2. 按姓名排序\n"); + printf("3. 按总分排序\n"); + printf("4. 按平均分排序\n"); + + int criteria = safeInputInt("请选择排序依据", SORT_BY_ID, SORT_BY_AVERAGE_SCORE); + + printf("\n排序顺序：\n"); + printf("1. 升序\n"); + printf("2. 降序\n"); + + int order = safeInputInt("请选择排序顺序", SORT_ASCENDING, SORT_DESCENDING); + + sortStudents(criteria, order); + + printf("\n排序完成！\n"); + displayAllStudents(); +} \ No newline at end of file diff --git a/core_handlers.h b/core_handlers.h new file mode 100644 index 0000000..6870b81 --- /dev/null +++ b/core_handlers.h @@ -0,0 +1,73 @@ +/** + * @file core_handlers.h + * @brief 核心处理函数头文件 + * @note 包含主要的功能处理函数声明 + */ + +#ifndef CORE_HANDLERS_H +#define CORE_HANDLERS_H + +#include "config.h" + +// 核心处理函数声明 + +/** + * @brief 处理基本功能菜单 + * @details 显示并处理学生信息管理的基本功能菜单循环 + * 提供学生信息的增删改查、排序等核心功能 + * 循环显示菜单直到用户选择返回主菜单 + * @note 包含的功能： + * - 添加学生信息 + * - 删除学生信息 + * - 修改学生信息 + * - 按学号查找学生 + * - 按姓名查找学生 + * - 显示所有学生 + * - 学生信息排序 + */ +void handleBasicFunctions(); + +/** + * @brief 处理统计功能菜单 + * @details 显示并处理统计分析功能菜单循环 + * 提供各种学生成绩的统计分析功能 + * 循环显示菜单直到用户选择返回主菜单 + * @note 包含的功能： + * - 课程统计分析 + * - 成绩分布统计 + * - 学生排名统计 + * - 综合统计分析 + */ +void handleStatistics(); + +/** + * @brief 处理管理功能菜单 + * @details 显示并处理系统管理功能菜单循环，仅限管理员用户访问 + * 提供用户账户管理的各项功能 + * 循环显示菜单直到用户选择返回主菜单 + * @note 包含的功能： + * - 添加用户账户 + * - 删除用户账户 + * - 修改用户密码 + * - 查看所有用户 + * @warning 此函数仅应在验证用户为管理员后调用 + */ +void handleAdminFunctions(); + +/** + * @brief 处理学生排序功能 + * @details 提供交互式的学生信息排序功能 + * 用户可选择排序依据（学号、姓名、总分、平均分）和排序顺序（升序、降序） + * 排序完成后自动显示排序结果 + * @note 排序依据选项： + * 1. 按学号排序 + * 2. 按姓名排序 + * 3. 按总分排序 + * 4. 按平均分排序 + * @note 排序顺序选项： + * 1. 升序 + * 2. 降序 + */ +void handleSortStudents(); + +#endif // CORE_HANDLERS_H \ No newline at end of file diff --git a/data/students.csv b/data/students.csv new file mode 100644 index 0000000..ce577b3 --- /dev/null +++ b/data/students.csv @@ -0,0 +1,445 @@ +学号,姓名,年龄,性别,课程数量,课程1,成绩1,课程2,成绩2,课程3,成绩3,课程4,成绩4,课程5,成绩5,课程6,成绩6,课程7,成绩7,课程8,成绩8,课程9,成绩9,总分,平均分 +2021001,欧阳晨曦,19,M,6,数学,92.5,英语,88.0,语文,85.5,物理,90.0,化学,87.5,生物,89.0,,,,,,,532.5,88.75 +2021002,司马雨萱,18,F,6,数学,89.0,英语,91.5,语文,88.0,政治,85.5,历史,87.0,地理,90.0,,,,,,,531.0,88.5 +2021003,上官浩然,19,M,6,数学,95.0,英语,89.5,语文,87.0,物理,93.0,化学,91.5,生物,88.5,,,,,,,544.5,90.75 +2021004,慕容诗涵,18,F,6,数学,87.5,英语,93.0,语文,90.5,政治,88.0,历史,89.5,地理,86.0,,,,,,,534.5,89.08 +2021005,东方明轩,19,M,6,数学,91.0,英语,86.5,语文,84.0,物理,89.5,化学,88.0,生物,90.5,,,,,,,529.5,88.25 +2021006,南宫雅琪,18,F,6,数学,88.5,英语,90.0,语文,92.0,政治,87.5,历史,85.0,地理,88.5,,,,,,,531.5,88.58 +2021007,西门子轩,19,M,6,数学,93.5,英语,87.0,语文,86.5,物理,91.0,化学,89.5,生物,87.0,,,,,,,534.5,89.08 +2021008,北冥若水,18,F,6,数学,86.0,英语,89.5,语文,91.5,政治,90.0,历史,88.5,地理,87.5,,,,,,,533.0,88.83 +2021009,令狐冲天,19,M,6,数学,90.0,英语,88.5,语文,85.5,物理,88.0,化学,90.5,生物,89.5,,,,,,,532.0,88.67 +2021010,独孤梦瑶,18,F,6,数学,89.5,英语,92.0,语文,88.5,政治,86.5,历史,90.0,地理,89.0,,,,,,,535.5,89.25 +2021011,轩辕志远,19,M,6,数学,94.0,英语,85.5,语文,87.5,物理,92.5,化学,88.5,生物,91.0,,,,,,,539.0,89.83 +2021012,公孙婉儿,18,F,6,数学,87.0,英语,91.0,语文,89.5,政治,88.5,历史,86.5,地理,91.5,,,,,,,534.0,89.0 +2021013,夏侯俊杰,19,M,6,数学,89.5,英语,87.5,语文,86.0,物理,90.5,化学,87.0,生物,88.5,,,,,,,529.0,88.17 +2021014,皇甫静雯,18,F,6,数学,90.5,英语,88.0,语文,90.0,政治,87.0,历史,89.5,地理,85.5,,,,,,,530.5,88.42 +2021015,宇文博涛,19,M,6,数学,92.0,英语,89.0,语文,84.5,物理,89.0,化学,91.5,生物,87.5,,,,,,,533.5,88.92 +2021016,完颜紫萱,18,F,6,数学,88.0,英语,90.5,语文,91.0,政治,89.0,历史,87.5,地理,88.0,,,,,,,534.0,89.0 +2021017,赫连星辰,19,M,6,数学,91.5,英语,86.0,语文,88.0,物理,90.0,化学,89.0,生物,90.5,,,,,,,535.0,89.17 +2021018,拓跋雨晴,18,F,6,数学,86.5,英语,92.5,语文,87.5,政治,90.5,历史,88.0,地理,86.5,,,,,,,531.5,88.58 +2021019,尉迟浩宇,19,M,6,数学,93.0,英语,88.5,语文,85.0,物理,91.5,化学,88.0,生物,89.0,,,,,,,535.0,89.17 +2021020,长孙梦琪,18,F,6,数学,89.0,英语,89.5,语文,90.5,政治,86.0,历史,90.5,地理,87.5,,,,,,,533.0,88.83 +2021021,段干凌云,19,M,6,数学,90.5,英语,87.0,语文,86.5,物理,88.5,化学,90.0,生物,88.5,,,,,,,531.0,88.5 +2021022,钟离雅欣,18,F,6,数学,87.5,英语,91.5,语文,88.0,政治,89.5,历史,85.5,地理,90.0,,,,,,,532.0,88.67 +2021023,司徒天翔,19,M,6,数学,94.5,英语,86.5,语文,87.0,物理,92.0,化学,89.5,生物,87.0,,,,,,,536.5,89.42 +2021024,诸葛慧敏,18,F,6,数学,88.5,英语,90.0,语文,89.0,政治,87.5,历史,88.5,地理,89.5,,,,,,,533.0,88.83 +2021025,濮阳俊豪,19,M,6,数学,89.0,英语,88.0,语文,85.5,物理,89.5,化学,87.5,生物,90.0,,,,,,,529.5,88.25 +2021026,端木晓雪,18,F,6,数学,90.0,英语,89.0,语文,91.5,政治,88.0,历史,86.5,地理,87.0,,,,,,,532.0,88.67 +2021027,百里云帆,19,M,6,数学,91.0,英语,87.5,语文,84.0,物理,90.5,化学,88.5,生物,89.5,,,,,,,531.0,88.5 +2021028,呼延若兰,18,F,6,数学,86.0,英语,92.0,语文,90.0,政治,89.0,历史,87.0,地理,88.5,,,,,,,532.5,88.75 +2021029,闻人志强,19,M,6,数学,92.5,英语,85.5,语文,86.0,物理,91.0,化学,90.0,生物,86.5,,,,,,,531.5,88.58 +2021030,第五梦洁,18,F,6,数学,88.0,英语,90.5,语文,88.5,政治,87.0,历史,89.0,地理,90.0,,,,,,,533.0,88.83 +2021031,申屠浩然,19,M,6,数学,90.0,英语,88.0,语文,87.5,物理,89.0,化学,87.0,生物,91.0,,,,,,,532.5,88.75 +2021032,公羊雅琳,18,F,6,数学,89.5,英语,88.5,语文,89.0,政治,90.0,历史,86.0,地理,88.0,,,,,,,531.0,88.5 +2021033,夹谷星宇,19,M,6,数学,93.0,英语,86.0,语文,85.5,物理,90.5,化学,89.0,生物,88.0,,,,,,,532.0,88.67 +2021034,谷梁诗雨,18,F,6,数学,87.0,英语,91.0,语文,90.5,政治,88.5,历史,87.5,地理,89.0,,,,,,,533.5,88.92 +2021035,淳于天佑,19,M,6,数学,91.5,英语,87.0,语文,86.0,物理,88.5,化学,90.5,生物,87.5,,,,,,,531.0,88.5 +2021036,单于雪儿,18,F,6,数学,88.5,英语,89.5,语文,91.0,政治,86.5,历史,88.0,地理,90.5,,,,,,,534.0,89.0 +2021037,太叔明辉,19,M,6,数学,89.0,英语,88.5,语文,84.5,物理,91.0,化学,87.5,生物,89.5,,,,,,,530.0,88.33 +2021038,鲜于婉清,18,F,6,数学,90.5,英语,87.0,语文,89.5,政治,89.0,历史,85.5,地理,87.5,,,,,,,529.0,88.17 +2021039,左丘俊逸,19,M,6,数学,92.0,英语,85.0,语文,87.0,物理,89.5,化学,88.0,生物,90.0,,,,,,,531.5,88.58 +2021040,漆雕梦涵,18,F,6,数学,86.5,英语,90.0,语文,88.0,政治,87.5,历史,89.5,地理,86.0,,,,,,,527.5,87.92 +2021041,亓官浩天,19,M,6,数学,90.5,英语,86.5,语文,85.5,物理,88.0,化学,89.5,生物,88.0,,,,,,,528.0,88.0 +2021042,巫马雅静,18,F,6,数学,89.0,英语,88.0,语文,90.0,政治,88.5,历史,86.5,地理,89.0,,,,,,,531.0,88.5 +2021043,公西志豪,19,M,6,数学,91.0,英语,87.5,语文,86.0,物理,90.0,化学,87.0,生物,89.5,,,,,,,531.0,88.5 +2021044,颛孙晓彤,18,F,6,数学,87.5,英语,91.5,语文,87.5,政治,89.0,历史,88.0,地理,87.0,,,,,,,530.5,88.42 +2021045,壤驷星河,19,M,6,数学,93.5,英语,84.5,语文,88.0,物理,91.5,化学,88.5,生物,86.5,,,,,,,532.5,88.75 +2021046,子车梦蝶,18,F,6,数学,88.0,英语,89.0,语文,89.5,政治,86.0,历史,90.0,地理,88.5,,,,,,,531.0,88.5 +2021047,仲孙天翼,19,M,6,数学,89.5,英语,88.0,语文,85.0,物理,89.0,化学,90.0,生物,87.5,,,,,,,529.0,88.17 +2021048,宗政雨薇,18,F,6,数学,90.0,英语,86.5,语文,90.5,政治,87.0,历史,85.0,地理,89.0,,,,,,,528.0,88.0 +2021049,濮阳浩宇,19,M,6,数学,92.0,英语,87.0,语文,84.5,物理,90.5,化学,89.0,生物,88.0,,,,,,,531.0,88.5 +2021050,东郭雅琪,18,F,6,数学,86.0,英语,92.0,语文,88.5,政治,88.0,历史,87.5,地理,90.0,,,,,,,532.0,88.67 +2021051,南门志远,19,M,6,数学,91.5,英语,85.5,语文,86.5,物理,88.5,化学,87.5,生物,90.5,,,,,,,530.0,88.33 +2021052,西门若水,18,F,6,数学,89.0,英语,88.5,语文,89.0,政治,89.5,历史,86.0,地理,87.0,,,,,,,529.0,88.17 +2021053,北宫天佑,19,M,6,数学,90.0,英语,86.0,语文,87.5,物理,89.5,化学,88.0,生物,89.0,,,,,,,530.0,88.33 +2021054,中山梦瑶,18,F,6,数学,87.5,英语,90.5,语文,86.5,政治,87.0,历史,89.0,地理,88.5,,,,,,,529.0,88.17 +2021055,东野俊杰,19,M,6,数学,93.0,英语,84.0,语文,88.5,物理,91.0,化学,87.0,生物,88.5,,,,,,,532.0,88.67 +2021056,南宫静雯,18,F,6,数学,88.5,英语,89.0,语文,90.0,政治,86.5,历史,88.5,地理,87.5,,,,,,,530.0,88.33 +2021057,西野博涛,19,M,6,数学,89.0,英语,87.5,语文,85.5,物理,88.0,化学,90.5,生物,87.0,,,,,,,527.5,87.92 +2021058,北野紫萱,18,F,6,数学,90.5,英语,85.0,语文,91.0,政治,88.0,历史,86.5,地理,89.0,,,,,,,530.0,88.33 +2021059,中野星辰,19,M,6,数学,91.0,英语,86.5,语文,84.0,物理,90.0,化学,88.5,生物,89.5,,,,,,,529.5,88.25 +2021060,东山雨晴,18,F,6,数学,86.5,英语,91.0,语文,88.0,政治,89.0,历史,87.0,地理,86.5,,,,,,,528.0,88.0 +2021061,南山浩宇,19,M,6,数学,92.5,英语,85.0,语文,87.0,物理,89.5,化学,87.5,生物,90.0,,,,,,,531.5,88.58 +2021062,西山梦琪,18,F,6,数学,89.0,英语,88.0,语文,89.5,政治,87.5,历史,90.0,地理,85.0,,,,,,,529.0,88.17 +2021063,北山凌云,19,M,6,数学,90.0,英语,87.0,语文,86.0,物理,88.5,化学,89.0,生物,88.5,,,,,,,529.0,88.17 +2021064,中山雅欣,18,F,6,数学,87.0,英语,90.0,语文,87.5,政治,88.0,历史,85.5,地理,90.5,,,,,,,528.5,88.08 +2021065,东川天翔,19,M,6,数学,91.5,英语,84.5,语文,88.0,物理,90.5,化学,86.5,生物,89.0,,,,,,,530.0,88.33 +2021066,南川慧敏,18,F,6,数学,88.0,英语,89.5,语文,86.0,政治,89.5,历史,87.5,地理,88.0,,,,,,,528.5,88.08 +2021067,西川俊豪,19,M,6,数学,89.5,英语,86.0,语文,87.5,物理,87.0,化学,90.0,生物,87.5,,,,,,,527.5,87.92 +2021068,北川晓雪,18,F,6,数学,90.0,英语,87.5,语文,90.5,政治,86.0,历史,88.0,地理,87.0,,,,,,,529.0,88.17 +2021069,中川云帆,19,M,6,数学,92.0,英语,85.5,语文,85.0,物理,89.0,化学,88.0,生物,90.5,,,,,,,530.0,88.33 +2021070,东海若兰,18,F,6,数学,86.5,英语,91.5,语文,88.5,政治,87.0,历史,89.5,地理,86.0,,,,,,,529.0,88.17 +2021071,南海志强,19,M,6,数学,90.5,英语,86.0,语文,86.5,物理,88.0,化学,87.0,生物,91.0,,,,,,,529.0,88.17 +2021072,西海梦洁,18,F,6,数学,89.0,英语,88.0,语文,89.0,政治,88.5,历史,86.5,地理,88.0,,,,,,,529.0,88.17 +2021073,北海浩然,19,M,6,数学,91.0,英语,87.5,语文,84.5,物理,90.0,化学,89.5,生物,87.0,,,,,,,529.5,88.25 +2021074,中海雅琳,18,F,6,数学,87.5,英语,90.0,语文,87.0,政治,89.0,历史,85.0,地理,89.5,,,,,,,528.0,88.0 +2021075,东湖星宇,19,M,6,数学,93.0,英语,84.0,语文,87.5,物理,91.5,化学,86.0,生物,88.0,,,,,,,530.0,88.33 +2021076,南湖诗雨,18,F,6,数学,88.5,英语,89.0,语文,88.0,政治,86.5,历史,88.5,地理,87.5,,,,,,,528.0,88.0 +2021077,西湖天佑,19,M,6,数学,89.0,英语,87.0,语文,86.0,物理,88.5,化学,87.5,生物,90.0,,,,,,,528.0,88.0 +2021078,北湖雪儿,18,F,6,数学,90.5,英语,85.5,语文,90.0,政治,87.5,历史,86.0,地理,88.5,,,,,,,528.0,88.0 +2021079,中湖明辉,19,M,6,数学,91.5,英语,86.5,语文,85.5,物理,89.0,化学,88.5,生物,87.0,,,,,,,528.0,88.0 +2021080,东江婉清,18,F,6,数学,86.0,英语,90.5,语文,89.0,政治,88.0,历史,87.5,地理,87.0,,,,,,,528.0,88.0 +2021081,南江俊逸,19,M,6,数学,92.0,英语,85.0,语文,86.5,物理,90.5,化学,87.0,生物,87.0,,,,,,,528.0,88.0 +2021082,西江梦涵,18,F,6,数学,89.5,英语,87.5,语文,88.5,政治,87.0,历史,89.0,地理,86.5,,,,,,,528.0,88.0 +2021083,北江浩天,19,M,6,数学,90.0,英语,86.0,语文,87.0,物理,88.0,化学,89.5,生物,87.5,,,,,,,528.0,88.0 +2021084,中江雅静,18,F,6,数学,87.0,英语,89.0,语文,86.5,政治,89.5,历史,85.5,地理,90.5,,,,,,,528.0,88.0 +2021085,东河志豪,19,M,6,数学,91.0,英语,87.5,语文,85.0,物理,89.5,化学,86.5,生物,88.5,,,,,,,528.0,88.0 +2021086,南河晓彤,18,F,6,数学,88.5,英语,88.0,语文,89.5,政治,86.0,历史,88.0,地理,88.0,,,,,,,528.0,88.0 +2021087,西河星河,19,M,6,数学,89.0,英语,85.5,语文,86.5,物理,87.5,化学,90.0,生物,89.5,,,,,,,528.0,88.0 +2021088,北河梦蝶,18,F,6,数学,90.0,英语,86.0,语文,87.0,政治,88.5,历史,86.5,地理,87.0,,,,,,,525.0,87.5 +2021089,中河天翼,19,M,6,数学,92.5,英语,84.5,语文,88.0,物理,90.0,化学,85.5,生物,88.5,,,,,,,529.0,88.17 +2021090,东林雨薇,18,F,6,数学,86.5,英语,90.0,语文,85.5,政治,87.5,历史,89.0,地理,86.5,,,,,,,525.0,87.5 +2021091,南林浩宇,19,M,6,数学,90.5,英语,86.5,语文,84.0,物理,89.0,化学,87.5,生物,87.5,,,,,,,525.0,87.5 +2021092,西林雅琪,18,F,6,数学,89.0,英语,87.0,语文,88.5,政治,86.5,历史,85.0,地理,89.0,,,,,,,525.0,87.5 +2021093,北林志远,19,M,6,数学,91.0,英语,85.0,语文,87.0,物理,88.5,化学,86.0,生物,87.5,,,,,,,525.0,87.5 +2021094,中林若水,18,F,6,数学,87.5,英语,88.5,语文,86.0,政治,88.0,历史,87.5,地理,87.5,,,,,,,525.0,87.5 +2021095,东峰天佑,19,M,6,数学,93.0,英语,83.5,语文,88.5,物理,90.5,化学,84.5,生物,89.0,,,,,,,529.0,88.17 +2021096,南峰梦瑶,18,F,6,数学,88.0,英语,89.5,语文,85.0,政治,89.0,历史,86.5,地理,86.0,,,,,,,524.0,87.33 +2021097,西峰俊杰,19,M,6,数学,89.5,英语,86.0,语文,86.5,物理,87.0,化学,88.5,生物,86.5,,,,,,,524.0,87.33 +2021098,北峰静雯,18,F,6,数学,90.0,英语,85.5,语文,87.5,政治,85.5,历史,88.0,地理,87.5,,,,,,,524.0,87.33 +2021099,中峰博涛,19,M,6,数学,91.5,英语,84.0,语文,85.0,物理,89.0,化学,87.0,生物,87.5,,,,,,,524.0,87.33 +2021100,东谷紫萱,18,F,6,数学,86.0,英语,90.0,语文,86.5,政治,87.0,历史,85.5,地理,89.0,,,,,,,524.0,87.33 +2021101,南谷星辰,19,M,6,数学,92.0,英语,83.0,语文,87.5,物理,88.5,化学,85.0,生物,88.0,,,,,,,524.0,87.33 +2021102,西谷雨晴,18,F,6,数学,89.5,英语,86.5,语文,84.5,政治,88.5,历史,86.0,地理,86.0,,,,,,,521.0,86.83 +2021103,北谷浩宇,19,M,6,数学,90.0,英语,85.0,语文,86.0,物理,87.5,化学,86.5,生物,86.0,,,,,,,521.0,86.83 +2021104,中谷梦琪,18,F,6,数学,87.0,英语,88.0,语文,85.5,政治,86.0,历史,87.5,地理,87.0,,,,,,,521.0,86.83 +2021105,东岭凌云,19,M,6,数学,91.0,英语,84.5,语文,85.5,物理,88.0,化学,85.5,生物,86.5,,,,,,,521.0,86.83 +2021106,南岭雅欣,18,F,6,数学,88.5,英语,87.5,语文,86.0,政治,85.5,历史,86.5,地理,87.0,,,,,,,521.0,86.83 +2021107,西岭天翔,19,M,6,数学,89.0,英语,85.5,语文,84.0,物理,87.0,化学,87.0,生物,88.5,,,,,,,521.0,86.83 +2021108,北岭慧敏,18,F,6,数学,90.5,英语,84.0,语文,87.0,政治,86.5,历史,85.0,地理,88.0,,,,,,,521.0,86.83 +2021109,中岭俊豪,19,M,6,数学,92.5,英语,82.5,语文,86.5,物理,89.0,化学,84.0,生物,86.5,,,,,,,521.0,86.83 +2021110,东坡晓雪,18,F,6,数学,85.5,英语,89.0,语文,84.0,政治,87.5,历史,86.0,地理,86.0,,,,,,,518.0,86.33 +2021111,南坡云帆,19,M,6,数学,90.0,英语,84.0,语文,85.0,物理,86.5,化学,85.5,生物,87.0,,,,,,,518.0,86.33 +2021112,西坡若兰,18,F,6,数学,88.0,英语,86.5,语文,85.5,政治,85.0,历史,87.0,地理,86.0,,,,,,,518.0,86.33 +2021113,北坡志强,19,M,6,数学,89.5,英语,83.5,语文,84.5,物理,87.0,化学,86.0,生物,87.5,,,,,,,518.0,86.33 +2021114,中坡梦洁,18,F,6,数学,87.5,英语,87.0,语文,84.0,政治,86.0,历史,85.5,地理,88.0,,,,,,,518.0,86.33 +2021115,东溪浩然,19,M,6,数学,91.5,英语,82.0,语文,86.0,物理,88.5,化学,83.5,生物,86.5,,,,,,,518.0,86.33 +2021116,南溪雅琳,18,F,6,数学,86.0,英语,88.5,语文,83.5,政治,86.5,历史,85.0,地理,85.5,,,,,,,515.0,85.83 +2021117,西溪星宇,19,M,6,数学,89.0,英语,84.0,语文,84.0,物理,86.0,化学,85.0,生物,87.0,,,,,,,515.0,85.83 +2021118,北溪诗雨,18,F,6,数学,88.5,英语,85.5,语文,85.0,政治,84.5,历史,86.5,地理,85.0,,,,,,,515.0,85.83 +2021119,中溪天佑,19,M,6,数学,90.0,英语,83.0,语文,83.5,物理,87.5,化学,84.0,生物,87.0,,,,,,,515.0,85.83 +2021120,东泉雪儿,18,F,6,数学,87.0,英语,86.0,语文,84.5,政治,85.0,历史,84.5,地理,88.0,,,,,,,515.0,85.83 +2021121,南泉明辉,19,M,6,数学,92.0,英语,81.5,语文,85.5,物理,88.0,化学,82.5,生物,85.5,,,,,,,515.0,85.83 +2021122,西泉婉清,18,F,6,数学,85.5,英语,87.5,语文,83.0,政治,86.0,历史,85.0,地理,85.0,,,,,,,512.0,85.33 +2021123,北泉俊逸,19,M,6,数学,88.5,英语,83.5,语文,84.0,物理,85.5,化学,84.5,生物,86.0,,,,,,,512.0,85.33 +2021124,中泉梦涵,18,F,6,数学,87.5,英语,85.0,语文,84.5,政治,84.0,历史,85.5,地理,85.5,,,,,,,512.0,85.33 +2021125,东池浩天,19,M,6,数学,89.0,英语,82.0,语文,83.0,物理,86.0,化学,84.0,生物,88.0,,,,,,,512.0,85.33 +2021126,南池雅静,18,F,6,数学,86.5,英语,86.0,语文,83.5,政治,85.5,历史,84.0,地理,86.5,,,,,,,512.0,85.33 +2021127,西池志豪,19,M,6,数学,90.5,英语,81.0,语文,84.5,物理,87.0,化学,83.0,生物,85.0,,,,,,,511.0,85.17 +2021128,北池晓彤,18,F,6,数学,88.0,英语,84.5,语文,82.5,政治,85.0,历史,84.5,地理,86.5,,,,,,,511.0,85.17 +2021129,中池星河,19,M,6,数学,87.5,英语,83.0,语文,83.5,物理,85.5,化学,84.5,生物,87.0,,,,,,,511.0,85.17 +2021130,东湾梦蝶,18,F,6,数学,89.0,英语,83.5,语文,84.0,政治,84.0,历史,83.5,地理,87.0,,,,,,,511.0,85.17 +2021131,南湾天翼,19,M,6,数学,91.0,英语,80.5,语文,85.0,物理,86.5,化学,82.0,生物,86.0,,,,,,,511.0,85.17 +2021132,西湾雨薇,18,F,6,数学,85.0,英语,86.5,语文,82.0,政治,85.5,历史,84.0,地理,85.0,,,,,,,508.0,84.67 +2021133,北湾浩宇,19,M,6,数学,88.0,英语,82.5,语文,83.0,物理,84.5,化学,83.5,生物,86.5,,,,,,,508.0,84.67 +2021134,中湾雅琪,18,F,6,数学,87.5,英语,84.0,语文,83.5,政治,83.0,历史,84.5,地理,85.5,,,,,,,508.0,84.67 +2021135,东港志远,19,M,6,数学,89.5,英语,81.0,语文,82.5,物理,85.0,化学,83.0,生物,87.0,,,,,,,508.0,84.67 +2021136,南港若水,18,F,6,数学,86.0,英语,85.5,语文,82.0,政治,84.5,历史,83.0,地理,87.0,,,,,,,508.0,84.67 +2021137,西港天佑,19,M,6,数学,90.0,英语,80.0,语文,84.0,物理,86.0,化学,81.5,生物,85.5,,,,,,,507.0,84.5 +2021138,北港梦瑶,18,F,6,数学,88.5,英语,82.5,语文,83.0,政治,83.5,历史,83.5,地理,86.0,,,,,,,507.0,84.5 +2021139,中港俊杰,19,M,6,数学,87.0,英语,82.0,语文,82.5,物理,84.0,化学,84.0,生物,87.5,,,,,,,507.0,84.5 +2021140,东滩静雯,18,F,6,数学,89.0,英语,81.5,语文,83.5,政治,82.5,历史,84.0,地理,86.5,,,,,,,507.0,84.5 +2021141,南滩博涛,19,M,6,数学,91.5,英语,79.5,语文,84.5,物理,85.5,化学,80.5,生物,85.5,,,,,,,506.5,84.42 +2021142,西滩紫萱,18,F,6,数学,84.5,英语,85.0,语文,81.5,政治,84.0,历史,83.5,地理,85.0,,,,,,,503.5,83.92 +2021143,北滩星辰,19,M,6,数学,87.5,英语,81.5,语文,82.0,物理,83.5,化学,83.0,生物,86.0,,,,,,,503.5,83.92 +2021144,中滩雨晴,18,F,6,数学,86.5,英语,83.0,语文,82.5,政治,82.0,历史,83.5,地理,86.0,,,,,,,503.5,83.92 +2021145,东岸浩宇,19,M,6,数学,88.0,英语,80.5,语文,81.5,物理,84.0,化学,82.5,生物,87.0,,,,,,,503.5,83.92 +2021146,南岸梦琪,18,F,6,数学,85.5,英语,84.5,语文,81.0,政治,83.5,历史,82.0,地理,87.0,,,,,,,503.5,83.92 +2021147,西岸凌云,19,M,6,数学,89.5,英语,79.0,语文,83.0,物理,85.0,化学,81.0,生物,85.0,,,,,,,502.5,83.75 +2021148,北岸雅欣,18,F,6,数学,87.0,英语,82.0,语文,82.0,政治,81.5,历史,83.0,地理,86.0,,,,,,,501.5,83.58 +2021149,中岸天翔,19,M,6,数学,86.0,英语,81.0,语文,81.5,物理,83.0,化学,82.5,生物,87.5,,,,,,,501.5,83.58 +2021150,东滨慧敏,18,F,6,数学,88.5,英语,80.5,语文,82.5,政治,80.5,历史,82.5,地理,86.5,,,,,,,501.0,83.5 +2021151,南滨俊豪,19,M,6,数学,90.0,英语,78.5,语文,83.5,物理,84.5,化学,79.5,生物,85.0,,,,,,,501.0,83.5 +2021152,西滨晓雪,18,F,6,数学,84.0,英语,84.0,语文,80.5,政治,82.5,历史,82.0,地理,85.0,,,,,,,498.0,83.0 +2021153,北滨云帆,19,M,6,数学,87.0,英语,80.0,语文,81.0,物理,82.5,化学,81.5,生物,86.0,,,,,,,498.0,83.0 +2021154,中滨若兰,18,F,6,数学,86.0,英语,82.5,语文,81.5,政治,81.0,历史,81.5,地理,85.5,,,,,,,498.0,83.0 +2021155,东浦志强,19,M,6,数学,88.5,英语,79.0,语文,80.5,物理,83.5,化学,80.5,生物,86.0,,,,,,,498.0,83.0 +2021156,南浦梦洁,18,F,6,数学,85.5,英语,83.0,语文,80.0,政治,82.0,历史,81.0,地理,86.5,,,,,,,498.0,83.0 +2021157,西浦浩然,19,M,6,数学,89.0,英语,78.0,语文,82.0,物理,84.0,化学,79.0,生物,84.5,,,,,,,496.5,82.75 +2021158,北浦雅琳,18,F,6,数学,83.5,英语,83.5,语文,79.5,政治,81.5,历史,81.0,地理,84.0,,,,,,,493.0,82.17 +2021159,中浦星宇,19,M,6,数学,86.5,英语,79.5,语文,80.0,物理,82.0,化学,80.0,生物,85.0,,,,,,,493.0,82.17 +2021160,东洲诗雨,18,F,6,数学,85.0,英语,81.5,语文,80.5,政治,80.0,历史,80.5,地理,85.5,,,,,,,493.0,82.17 +2021161,南洲天佑,19,M,6,数学,87.5,英语,78.5,语文,79.5,物理,83.0,化学,79.5,生物,85.0,,,,,,,493.0,82.17 +2021162,西洲雪儿,18,F,6,数学,84.5,英语,82.0,语文,80.0,政治,80.5,历史,80.0,地理,86.0,,,,,,,493.0,82.17 +2021163,北洲明辉,19,M,6,数学,88.0,英语,77.5,语文,81.0,物理,82.5,化学,78.5,生物,84.5,,,,,,,492.0,82.0 +2021164,中洲婉清,18,F,6,数学,83.0,英语,82.5,语文,79.0,政治,81.0,历史,80.5,地理,84.0,,,,,,,490.0,81.67 +2021165,东屿俊逸,19,M,6,数学,86.0,英语,78.0,语文,79.5,物理,81.5,化学,79.0,生物,84.5,,,,,,,488.5,81.42 +2021166,南屿梦涵,18,F,6,数学,84.0,英语,81.0,语文,79.5,政治,79.5,历史,79.5,地理,85.0,,,,,,,488.5,81.42 +2021167,西屿浩天,19,M,6,数学,87.0,英语,77.0,语文,80.0,物理,82.0,化学,78.0,生物,84.5,,,,,,,488.5,81.42 +2021168,北屿雅静,18,F,6,数学,82.5,英语,81.5,语文,78.5,政治,80.0,历史,80.0,地理,84.0,,,,,,,486.5,81.08 +2021169,中屿志豪,19,M,6,数学,85.5,英语,77.5,语文,78.5,物理,81.0,化学,78.5,生物,85.5,,,,,,,486.5,81.08 +2021170,东礁晓彤,18,F,6,数学,83.5,英语,80.5,语文,79.0,政治,79.0,历史,79.0,地理,85.5,,,,,,,486.5,81.08 +2021171,南礁星河,19,M,6,数学,86.5,英语,76.5,语文,79.5,物理,81.5,化学,77.5,生物,84.0,,,,,,,485.5,80.92 +2021172,西礁梦蝶,18,F,6,数学,82.0,英语,81.0,语文,78.0,政治,79.5,历史,79.5,地理,84.5,,,,,,,484.5,80.75 +2021173,北礁天翼,19,M,6,数学,85.0,英语,76.0,语文,78.0,物理,80.5,化学,77.0,生物,85.0,,,,,,,481.5,80.25 +2021174,中礁雨薇,18,F,6,数学,81.5,英语,80.0,语文,78.5,政治,78.5,历史,78.5,地理,84.5,,,,,,,481.5,80.25 +2021175,东渚浩宇,19,M,6,数学,84.5,英语,75.5,语文,77.5,物理,80.0,化学,76.5,生物,84.5,,,,,,,478.5,79.75 +2021176,南渚雅琪,18,F,6,数学,80.5,英语,79.5,语文,77.5,政治,78.0,历史,78.0,地理,84.0,,,,,,,477.5,79.58 +2021177,西渚志远,19,M,6,数学,83.5,英语,75.0,语文,77.0,物理,79.5,化学,76.0,生物,84.0,,,,,,,475.0,79.17 +2021178,北渚若水,18,F,6,数学,80.0,英语,79.0,语文,77.0,政治,77.5,历史,77.5,地理,83.5,,,,,,,474.5,79.08 +2021179,中渚天佑,19,M,6,数学,82.5,英语,74.5,语文,76.5,物理,79.0,化学,75.5,生物,83.5,,,,,,,471.5,78.58 +2021180,东汀梦瑶,18,F,6,数学,79.5,英语,78.5,语文,76.5,政治,77.0,历史,77.0,地理,83.0,,,,,,,471.5,78.58 +2021181,南汀俊杰,19,M,6,数学,81.5,英语,74.0,语文,76.0,物理,78.5,化学,75.0,生物,83.0,,,,,,,468.0,78.0 +2021182,西汀静雯,18,F,6,数学,79.0,英语,78.0,语文,76.0,政治,76.5,历史,76.5,地理,82.5,,,,,,,468.5,78.08 +2021183,北汀博涛,19,M,6,数学,80.5,英语,73.5,语文,75.5,物理,78.0,化学,74.5,生物,82.5,,,,,,,464.5,77.42 +2021184,中汀紫萱,18,F,6,数学,78.5,英语,77.5,语文,75.5,政治,76.0,历史,76.0,地理,82.0,,,,,,,465.5,77.58 +2021185,东沙星辰,19,M,6,数学,79.5,英语,73.0,语文,75.0,物理,77.5,化学,74.0,生物,82.0,,,,,,,461.0,76.83 +2021186,南沙雨晴,18,F,6,数学,78.0,英语,77.0,语文,75.0,政治,75.5,历史,75.5,地理,81.5,,,,,,,462.5,77.08 +2021187,西沙浩宇,19,M,6,数学,78.5,英语,72.5,语文,74.5,物理,77.0,化学,73.5,生物,81.5,,,,,,,457.5,76.25 +2021188,北沙梦琪,18,F,6,数学,77.5,英语,76.5,语文,74.5,政治,75.0,历史,75.0,地理,81.0,,,,,,,459.5,76.58 +2021189,中沙凌云,19,M,6,数学,77.5,英语,72.0,语文,74.0,物理,76.5,化学,73.0,生物,81.0,,,,,,,454.0,75.67 +2021190,东滩雅欣,18,F,6,数学,77.0,英语,76.0,语文,74.0,政治,74.5,历史,74.5,地理,80.5,,,,,,,456.5,76.08 +2021191,南滩天翔,19,M,6,数学,76.5,英语,71.5,语文,73.5,物理,76.0,化学,72.5,生物,80.5,,,,,,,450.5,75.08 +2021192,西滩慧敏,18,F,6,数学,76.5,英语,75.5,语文,73.5,政治,74.0,历史,74.0,地理,80.0,,,,,,,453.5,75.58 +2021193,北滩俊豪,19,M,6,数学,75.5,英语,71.0,语文,73.0,物理,75.5,化学,72.0,生物,80.0,,,,,,,447.0,74.5 +2021194,中滩晓雪,18,F,6,数学,76.0,英语,75.0,语文,73.0,政治,73.5,历史,73.5,地理,79.5,,,,,,,450.5,75.08 +2021195,东洋云帆,19,M,6,数学,74.5,英语,70.5,语文,72.5,物理,75.0,化学,71.5,生物,79.5,,,,,,,443.5,73.92 +2021196,南洋若兰,18,F,6,数学,75.5,英语,74.5,语文,72.5,政治,73.0,历史,73.0,地理,79.0,,,,,,,447.5,74.58 +2021197,西洋志强,19,M,6,数学,73.5,英语,70.0,语文,72.0,物理,74.5,化学,71.0,生物,79.0,,,,,,,440.0,73.33 +2021198,北洋梦洁,18,F,6,数学,75.0,英语,74.0,语文,72.0,政治,72.5,历史,72.5,地理,78.5,,,,,,,444.5,74.08 +2021199,中洋浩然,19,M,6,数学,72.5,英语,69.5,语文,71.5,物理,74.0,化学,70.5,生物,78.5,,,,,,,436.5,72.75 +2021200,东海雅琳,18,F,6,数学,74.5,英语,73.5,语文,71.5,政治,72.0,历史,72.0,地理,78.0,,,,,,,441.5,73.58 +2021201,南海星宇,19,M,6,数学,71.5,英语,69.0,语文,71.0,物理,73.5,化学,70.0,生物,78.0,,,,,,,433.0,72.17 +2021202,西海诗雨,18,F,6,数学,74.0,英语,73.0,语文,71.0,政治,71.5,历史,71.5,地理,77.5,,,,,,,438.5,73.08 +2021203,北海天佑,19,M,6,数学,70.5,英语,68.5,语文,70.5,物理,73.0,化学,69.5,生物,77.5,,,,,,,429.5,71.58 +2021204,中海雪儿,18,F,6,数学,73.5,英语,72.5,语文,70.5,政治,71.0,历史,71.0,地理,77.0,,,,,,,435.5,72.58 +2021205,东湖明辉,19,M,6,数学,69.5,英语,68.0,语文,70.0,物理,72.5,化学,69.0,生物,77.0,,,,,,,426.0,71.0 +2021206,南湖婉清,18,F,6,数学,73.0,英语,72.0,语文,70.0,政治,70.5,历史,70.5,地理,76.5,,,,,,,432.5,72.08 +2021207,西湖俊逸,19,M,6,数学,68.5,英语,67.5,语文,69.5,物理,72.0,化学,68.5,生物,76.5,,,,,,,422.5,70.42 +2021208,北湖梦涵,18,F,6,数学,72.5,英语,71.5,语文,69.5,政治,70.0,历史,70.0,地理,76.0,,,,,,,429.5,71.58 +2021209,中湖浩天,19,M,6,数学,67.5,英语,67.0,语文,69.0,物理,71.5,化学,68.0,生物,76.0,,,,,,,419.0,69.83 +2021210,东江雅静,18,F,6,数学,72.0,英语,71.0,语文,69.0,政治,69.5,历史,69.5,地理,75.5,,,,,,,426.5,71.08 +2021211,南江志豪,19,M,6,数学,66.5,英语,66.5,语文,68.5,物理,71.0,化学,67.5,生物,75.5,,,,,,,415.5,69.25 +2021212,西江晓彤,18,F,6,数学,71.5,英语,70.5,语文,68.5,政治,69.0,历史,69.0,地理,75.0,,,,,,,423.5,70.58 +2021213,北江星河,19,M,6,数学,65.5,英语,66.0,语文,68.0,物理,70.5,化学,67.0,生物,75.0,,,,,,,412.0,68.67 +2021214,中江梦蝶,18,F,6,数学,71.0,英语,70.0,语文,68.0,政治,68.5,历史,68.5,地理,74.5,,,,,,,420.5,70.08 +2021215,东河天翼,19,M,6,数学,64.5,英语,65.5,语文,67.5,物理,70.0,化学,66.5,生物,74.5,,,,,,,408.5,68.08 +2021216,南河雨薇,18,F,6,数学,70.5,英语,69.5,语文,67.5,政治,68.0,历史,68.0,地理,74.0,,,,,,,417.5,69.58 +2021217,西河浩宇,19,M,6,数学,63.5,英语,65.0,语文,67.0,物理,69.5,化学,66.0,生物,74.0,,,,,,,405.0,67.5 +2021218,北河雅琪,18,F,6,数学,70.0,英语,69.0,语文,67.0,政治,67.5,历史,67.5,地理,73.5,,,,,,,414.5,69.08 +2021219,中河志远,19,M,6,数学,62.5,英语,64.5,语文,66.5,物理,69.0,化学,65.5,生物,73.5,,,,,,,401.5,66.92 +2021220,东林若水,18,F,6,数学,69.5,英语,68.5,语文,66.5,政治,67.0,历史,67.0,地理,73.0,,,,,,,411.5,68.58 +2021221,南林天佑,19,M,6,数学,61.5,英语,64.0,语文,66.0,物理,68.5,化学,65.0,生物,73.0,,,,,,,398. +2021222,西林雅静,18,F,6,数学,68.5,英语,67.5,语文,66.0,政治,66.5,历史,66.5,地理,72.5,,,,,,,407.5,67.92 +2021223,北林志豪,19,M,6,数学,60.5,英语,63.5,语文,65.5,物理,68.0,化学,64.5,生物,72.5,,,,,,,394.5,65.75 +2021224,中林晓彤,18,F,6,数学,68.0,英语,67.0,语文,65.5,政治,66.0,历史,66.0,地理,72.0,,,,,,,404.5,67.42 +2021225,东峰星河,19,M,6,数学,59.5,英语,63.0,语文,65.0,物理,67.5,化学,64.0,生物,72.0,,,,,,,391.0,65.17 +2021226,南峰梦蝶,18,F,6,数学,67.5,英语,66.5,语文,65.0,政治,65.5,历史,65.5,地理,71.5,,,,,,,401.5,66.92 +2021227,西峰天翼,19,M,6,数学,58.5,英语,62.5,语文,64.5,物理,67.0,化学,63.5,生物,71.5,,,,,,,387.5,64.58 +2021228,北峰雨薇,18,F,6,数学,67.0,英语,66.0,语文,64.5,政治,65.0,历史,65.0,地理,71.0,,,,,,,398.5,66.42 +2021229,中峰浩宇,19,M,6,数学,57.5,英语,62.0,语文,64.0,物理,66.5,化学,63.0,生物,71.0,,,,,,,384.0,64.0 +2021230,东谷雅琪,18,F,6,数学,66.5,英语,65.5,语文,64.0,政治,64.5,历史,64.5,地理,70.5,,,,,,,395.5,65.92 +2021231,南谷志远,19,M,6,数学,56.5,英语,61.5,语文,63.5,物理,66.0,化学,62.5,生物,70.5,,,,,,,380.5,63.42 +2021232,西谷若水,18,F,6,数学,66.0,英语,65.0,语文,63.5,政治,64.0,历史,64.0,地理,70.0,,,,,,,392.5,65.42 +2021233,北谷天佑,19,M,6,数学,55.5,英语,61.0,语文,63.0,物理,65.5,化学,62.0,生物,70.0,,,,,,,377.0,62.83 +2021234,中谷梦瑶,18,F,6,数学,65.5,英语,64.5,语文,63.0,政治,63.5,历史,63.5,地理,69.5,,,,,,,389.5,64.92 +2021235,东岭俊杰,19,M,6,数学,54.5,英语,60.5,语文,62.5,物理,65.0,化学,61.5,生物,69.5,,,,,,,373.5,62.25 +2021236,南岭静雯,18,F,6,数学,65.0,英语,64.0,语文,62.5,政治,63.0,历史,63.0,地理,69.0,,,,,,,386.5,64.42 +2021237,西岭博涛,19,M,6,数学,53.5,英语,60.0,语文,62.0,物理,64.5,化学,61.0,生物,69.0,,,,,,,370.0,61.67 +2021238,北岭紫萱,18,F,6,数学,64.5,英语,63.5,语文,62.0,政治,62.5,历史,62.5,地理,68.5,,,,,,,383.5,63.92 +2021239,中岭星辰,19,M,6,数学,52.5,英语,59.5,语文,61.5,物理,64.0,化学,60.5,生物,68.5,,,,,,,366.5,61.08 +2021240,东坡雨晴,18,F,6,数学,64.0,英语,63.0,语文,61.5,政治,62.0,历史,62.0,地理,68.0,,,,,,,380.5,63.42 +2021241,南坡浩宇,19,M,6,数学,51.5,英语,59.0,语文,61.0,物理,63.5,化学,60.0,生物,68.0,,,,,,,363.0,60.5 +2021242,西坡梦琪,18,F,6,数学,63.5,英语,62.5,语文,61.0,政治,61.5,历史,61.5,地理,67.5,,,,,,,377.5,62.92 +2021243,北坡凌云,19,M,6,数学,50.5,英语,58.5,语文,60.5,物理,63.0,化学,59.5,生物,67.5,,,,,,,359.5,59.92 +2021244,中坡雅欣,18,F,6,数学,63.0,英语,62.0,语文,60.5,政治,61.0,历史,61.0,地理,67.0,,,,,,,374.5,62.42 +2021245,东溪天翔,19,M,6,数学,49.5,英语,58.0,语文,60.0,物理,62.5,化学,59.0,生物,67.0,,,,,,,356.0,59.33 +2021246,南溪慧敏,18,F,6,数学,62.5,英语,61.5,语文,60.0,政治,60.5,历史,60.5,地理,66.5,,,,,,,371.5,61.92 +2021247,西溪俊豪,19,M,6,数学,48.5,英语,57.5,语文,59.5,物理,62.0,化学,58.5,生物,66.5,,,,,,,352.5,58.75 +2021248,北溪晓雪,18,F,6,数学,62.0,英语,61.0,语文,59.5,政治,60.0,历史,60.0,地理,66.0,,,,,,,368.5,61.42 +2021249,中溪云帆,19,M,6,数学,47.5,英语,57.0,语文,59.0,物理,61.5,化学,58.0,生物,66.0,,,,,,,349.0,58.17 +2021250,东泉若兰,18,F,6,数学,61.5,英语,60.5,语文,59.0,政治,59.5,历史,59.5,地理,65.5,,,,,,,365.5,60.92 +2021251,南泉志强,19,M,6,数学,46.5,英语,56.5,语文,58.5,物理,61.0,化学,57.5,生物,65.5,,,,,,,345.5,57.58 +2021252,西泉梦洁,18,F,6,数学,61.0,英语,60.0,语文,58.5,政治,59.0,历史,59.0,地理,65.0,,,,,,,362.5,60.42 +2021253,北泉浩然,19,M,6,数学,45.5,英语,56.0,语文,58.0,物理,60.5,化学,57.0,生物,65.0,,,,,,,342.0,57.0 +2021254,中泉雅琳,18,F,6,数学,60.5,英语,59.5,语文,58.0,政治,58.5,历史,58.5,地理,64.5,,,,,,,359.5,59.92 +2021255,东池星宇,19,M,6,数学,44.5,英语,55.5,语文,57.5,物理,60.0,化学,56.5,生物,64.5,,,,,,,338.5,56.42 +2021256,南池诗雨,18,F,6,数学,60.0,英语,59.0,语文,57.5,政治,58.0,历史,58.0,地理,64.0,,,,,,,356.5,59.42 +2021257,西池天佑,19,M,6,数学,43.5,英语,55.0,语文,57.0,物理,59.5,化学,56.0,生物,64.0,,,,,,,335.0,55.83 +2021258,北池雪儿,18,F,6,数学,59.5,英语,58.5,语文,57.0,政治,57.5,历史,57.5,地理,63.5,,,,,,,353.5,58.92 +2021259,中池明辉,19,M,6,数学,42.5,英语,54.5,语文,56.5,物理,59.0,化学,55.5,生物,63.5,,,,,,,331.5,55.25 +2021260,东湾婉清,18,F,6,数学,59.0,英语,58.0,语文,56.5,政治,57.0,历史,57.0,地理,63.0,,,,,,,350.5,58.42 +2021261,南湾俊逸,19,M,6,数学,41.5,英语,54.0,语文,56.0,物理,58.5,化学,55.0,生物,63.0,,,,,,,328.0,54.67 +2021262,西湾梦涵,18,F,6,数学,58.5,英语,57.5,语文,56.0,政治,56.5,历史,56.5,地理,62.5,,,,,,,347.5,57.92 +2021263,北湾浩天,19,M,6,数学,40.5,英语,53.5,语文,55.5,物理,58.0,化学,54.5,生物,62.5,,,,,,,324.5,54.08 +2021264,中湾雅静,18,F,6,数学,58.0,英语,57.0,语文,55.5,政治,56.0,历史,56.0,地理,62.0,,,,,,,344.5,57.42 +2021265,东港志豪,19,M,6,数学,39.5,英语,53.0,语文,55.0,物理,57.5,化学,54.0,生物,62.0,,,,,,,321.0,53.5 +2021266,南港晓彤,18,F,6,数学,57.5,英语,56.5,语文,55.0,政治,55.5,历史,55.5,地理,61.5,,,,,,,341.5,56.92 +2021267,西港星河,19,M,6,数学,38.5,英语,52.5,语文,54.5,物理,57.0,化学,53.5,生物,61.5,,,,,,,317.5,52.92 +2021268,北港梦蝶,18,F,6,数学,57.0,英语,56.0,语文,54.5,政治,55.0,历史,55.0,地理,61.0,,,,,,,338.5,56.42 +2021269,中港天翼,19,M,6,数学,37.5,英语,52.0,语文,54.0,物理,56.5,化学,53.0,生物,61.0,,,,,,,314.0,52.33 +2021270,东滩雨薇,18,F,6,数学,56.5,英语,55.5,语文,54.0,政治,54.5,历史,54.5,地理,60.5,,,,,,,335.5,55.92 +2021271,南滩浩宇,19,M,6,数学,36.5,英语,51.5,语文,53.5,物理,56.0,化学,52.5,生物,60.5,,,,,,,310.5,51.75 +2021272,西滩雅琪,18,F,6,数学,56.0,英语,55.0,语文,53.5,政治,54.0,历史,54.0,地理,60.0,,,,,,,332.5,55.42 +2021273,北滩志远,19,M,6,数学,35.5,英语,51.0,语文,53.0,物理,55.5,化学,52.0,生物,60.0,,,,,,,307.0,51.17 +2021274,中滩若水,18,F,6,数学,55.5,英语,54.5,语文,53.0,政治,53.5,历史,53.5,地理,59.5,,,,,,,329.5,54.92 +2021275,东岸天佑,19,M,6,数学,34.5,英语,50.5,语文,52.5,物理,55.0,化学,51.5,生物,59.5,,,,,,,303.5,50.58 +2021276,南岸梦瑶,18,F,6,数学,55.0,英语,54.0,语文,52.5,政治,53.0,历史,53.0,地理,59.0,,,,,,,326.5,54.42 +2021277,西岸俊杰,19,M,6,数学,33.5,英语,50.0,语文,52.0,物理,54.5,化学,51.0,生物,59.0,,,,,,,300.0,50.0 +2021278,北岸静雯,18,F,6,数学,54.5,英语,53.5,语文,52.0,政治,52.5,历史,52.5,地理,58.5,,,,,,,323.5,53.92 +2021279,中岸博涛,19,M,6,数学,32.5,英语,49.5,语文,51.5,物理,54.0,化学,50.5,生物,58.5,,,,,,,296.5,49.42 +2021280,东滨紫萱,18,F,6,数学,54.0,英语,53.0,语文,51.5,政治,52.0,历史,52.0,地理,58.0,,,,,,,320.5,53.42 +2021281,南滨星辰,19,M,6,数学,31.5,英语,49.0,语文,51.0,物理,53.5,化学,50.0,生物,58.0,,,,,,,293.0,48.83 +2021282,西滨雨晴,18,F,6,数学,53.5,英语,52.5,语文,51.0,政治,51.5,历史,51.5,地理,57.5,,,,,,,317.5,52.92 +2021283,北滨浩宇,19,M,6,数学,30.5,英语,48.5,语文,50.5,物理,53.0,化学,49.5,生物,57.5,,,,,,,289.5,48.25 +2021284,中滨梦琪,18,F,6,数学,53.0,英语,52.0,语文,50.5,政治,51.0,历史,51.0,地理,57.0,,,,,,,314.5,52.42 +2021285,东浦凌云,19,M,6,数学,29.5,英语,48.0,语文,50.0,物理,52.5,化学,49.0,生物,57.0,,,,,,,286.0,47.67 +2021286,南浦雅欣,18,F,6,数学,52.5,英语,51.5,语文,50.0,政治,50.5,历史,50.5,地理,56.5,,,,,,,311.5,51.92 +2021287,西浦天翔,19,M,6,数学,28.5,英语,47.5,语文,49.5,物理,52.0,化学,48.5,生物,56.5,,,,,,,282.5,47.08 +2021288,北浦慧敏,18,F,6,数学,52.0,英语,51.0,语文,49.5,政治,50.0,历史,50.0,地理,56.0,,,,,,,308.5,51.42 +2021289,中浦俊豪,19,M,6,数学,27.5,英语,47.0,语文,49.0,物理,51.5,化学,48.0,生物,56.0,,,,,,,279.0,46.5 +2021290,东洲晓雪,18,F,6,数学,51.5,英语,50.5,语文,49.0,政治,49.5,历史,49.5,地理,55.5,,,,,,,305.5,50.92 +2021291,南洲云帆,19,M,6,数学,26.5,英语,46.5,语文,48.5,物理,51.0,化学,47.5,生物,55.5,,,,,,,275.5,45.92 +2021292,西洲若兰,18,F,6,数学,51.0,英语,50.0,语文,48.5,政治,49.0,历史,49.0,地理,55.0,,,,,,,302.5,50.42 +2021293,北洲志强,19,M,6,数学,25.5,英语,46.0,语文,48.0,物理,50.5,化学,47.0,生物,55.0,,,,,,,272.0,45.33 +2021294,中洲梦洁,18,F,6,数学,50.5,英语,49.5,语文,48.0,政治,48.5,历史,48.5,地理,54.5,,,,,,,299.5,49.92 +2021295,东屿浩然,19,M,6,数学,24.5,英语,45.5,语文,47.5,物理,50.0,化学,46.5,生物,54.5,,,,,,,268.5,44.75 +2021296,南屿雅琳,18,F,6,数学,50.0,英语,49.0,语文,47.5,政治,48.0,历史,48.0,地理,54.0,,,,,,,296.5,49.42 +2021297,西屿星宇,19,M,6,数学,23.5,英语,45.0,语文,47.0,物理,49.5,化学,46.0,生物,54.0,,,,,,,265.0,44.17 +2021298,北屿诗雨,18,F,6,数学,49.5,英语,48.5,语文,47.0,政治,47.5,历史,47.5,地理,53.5,,,,,,,293.5,48.92 +2021299,中屿天佑,19,M,6,数学,22.5,英语,44.5,语文,46.5,物理,49.0,化学,45.5,生物,53.5,,,,,,,261.5,43.58 +2021300,东礁雪儿,18,F,6,数学,49.0,英语,48.0,语文,46.5,政治,47.0,历史,47.0,地理,53.0,,,,,,,290.5,48.42 +2021301,南礁明辉,19,M,6,数学,21.5,英语,44.0,语文,46.0,物理,48.5,化学,45.0,生物,53.0,,,,,,,258.0,43.0 +2021302,西礁婉清,18,F,6,数学,48.5,英语,47.5,语文,46.0,政治,46.5,历史,46.5,地理,52.5,,,,,,,287.5,47.92 +2021303,北礁俊逸,19,M,6,数学,20.5,英语,43.5,语文,45.5,物理,48.0,化学,44.5,生物,52.5,,,,,,,254.5,42.42 +2021304,中礁梦涵,18,F,6,数学,48.0,英语,47.0,语文,45.5,政治,46.0,历史,46.0,地理,52.0,,,,,,,284.5,47.42 +2021305,东渚浩天,19,M,6,数学,19.5,英语,43.0,语文,45.0,物理,47.5,化学,44.0,生物,52.0,,,,,,,251.0,41.83 +2021306,南渚雅静,18,F,6,数学,47.5,英语,46.5,语文,45.0,政治,45.5,历史,45.5,地理,51.5,,,,,,,281.5,46.92 +2021307,西渚志豪,19,M,6,数学,18.5,英语,42.5,语文,44.5,物理,47.0,化学,43.5,生物,51.5,,,,,,,247.5,41.25 +2021308,北渚晓彤,18,F,6,数学,47.0,英语,46.0,语文,44.5,政治,45.0,历史,45.0,地理,51.0,,,,,,,278.5,46.42 +2021309,中渚星河,19,M,6,数学,17.5,英语,42.0,语文,44.0,物理,46.5,化学,43.0,生物,51.0,,,,,,,244.0,40.67 +2021310,东汀梦蝶,18,F,6,数学,46.5,英语,45.5,语文,44.0,政治,44.5,历史,44.5,地理,50.5,,,,,,,275.5,45.92 +2021311,南汀天翼,19,M,6,数学,16.5,英语,41.5,语文,43.5,物理,46.0,化学,42.5,生物,50.5,,,,,,,240.5,40.08 +2021312,西汀雨薇,18,F,6,数学,46.0,英语,45.0,语文,43.5,政治,44.0,历史,44.0,地理,50.0,,,,,,,272.5,45.42 +2021313,北汀浩宇,19,M,6,数学,15.5,英语,41.0,语文,43.0,物理,45.5,化学,42.0,生物,50.0,,,,,,,237.0,39.5 +2021314,中汀雅琪,18,F,6,数学,45.5,英语,44.5,语文,43.0,政治,43.5,历史,43.5,地理,49.5,,,,,,,269.5,44.92 +2021315,东沙志远,19,M,6,数学,14.5,英语,40.5,语文,42.5,物理,45.0,化学,41.5,生物,49.5,,,,,,,233.5,38.92 +2021316,南沙若水,18,F,6,数学,45.0,英语,44.0,语文,42.5,政治,43.0,历史,43.0,地理,49.0,,,,,,,266.5,44.42 +2021317,西沙天佑,19,M,6,数学,13.5,英语,40.0,语文,42.0,物理,44.5,化学,41.0,生物,49.0,,,,,,,230.0,38.33 +2021318,北沙梦瑶,18,F,6,数学,44.5,英语,43.5,语文,42.0,政治,42.5,历史,42.5,地理,48.5,,,,,,,263.5,43.92 +2021319,中沙俊杰,19,M,6,数学,12.5,英语,39.5,语文,41.5,物理,44.0,化学,40.5,生物,48.5,,,,,,,226.5,37.75 +2021320,东滩静雯,18,F,6,数学,44.0,英语,43.0,语文,41.5,政治,42.0,历史,42.0,地理,48.0,,,,,,,260.5,43.42 +2021321,南滩博涛,19,M,6,数学,11.5,英语,39.0,语文,41.0,物理,43.5,化学,40.0,生物,48.0,,,,,,,223.0,37.17 +2021322,西滩紫萱,18,F,6,数学,43.5,英语,42.5,语文,41.0,政治,41.5,历史,41.5,地理,47.5,,,,,,,257.5,42.92 +2021323,北滩星辰,19,M,6,数学,10.5,英语,38.5,语文,40.5,物理,43.0,化学,39.5,生物,47.5,,,,,,,219.5,36.58 +2021324,中滩雨晴,18,F,6,数学,43.0,英语,42.0,语文,40.5,政治,41.0,历史,41.0,地理,47.0,,,,,,,254.5,42.42 +2021325,东洋浩宇,19,M,6,数学,9.5,英语,38.0,语文,40.0,物理,42.5,化学,39.0,生物,47.0,,,,,,,216.0,36.0 +2021326,南洋梦琪,18,F,6,数学,42.5,英语,41.5,语文,40.0,政治,40.5,历史,40.5,地理,46.5,,,,,,,251.5,41.92 +2021327,西洋凌云,19,M,6,数学,8.5,英语,37.5,语文,39.5,物理,42.0,化学,38.5,生物,46.5,,,,,,,212.5,35.42 +2021328,北洋雅欣,18,F,6,数学,42.0,英语,41.0,语文,39.5,政治,40.0,历史,40.0,地理,46.0,,,,,,,248.5,41.42 +2021329,中洋天翔,19,M,6,数学,7.5,英语,37.0,语文,39.0,物理,41.5,化学,38.0,生物,46.0,,,,,,,209.0,34.83 +2021330,东海慧敏,18,F,6,数学,41.5,英语,40.5,语文,39.0,政治,39.5,历史,39.5,地理,45.5,,,,,,,245.5,40.92 +2021331,南海俊豪,19,M,6,数学,6.5,英语,36.5,语文,38.5,物理,41.0,化学,37.5,生物,45.5,,,,,,,205.5,34.25 +2021332,西海晓雪,18,F,6,数学,41.0,英语,40.0,语文,38.5,政治,39.0,历史,39.0,地理,45.0,,,,,,,242.5,40.42 +2021333,北海云帆,19,M,6,数学,5.5,英语,36.0,语文,38.0,物理,40.5,化学,37.0,生物,45.0,,,,,,,202.0,33.67 +2021334,中海若兰,18,F,6,数学,40.5,英语,39.5,语文,38.0,政治,38.5,历史,38.5,地理,44.5,,,,,,,239.5,39.92 +2021335,东湖志强,19,M,6,数学,4.5,英语,35.5,语文,37.5,物理,40.0,化学,36.5,生物,44.5,,,,,,,198.5,33.08 +2021336,南湖梦洁,18,F,6,数学,40.0,英语,39.0,语文,37.5,政治,38.0,历史,38.0,地理,44.0,,,,,,,236.5,39.42 +2021337,西湖浩然,19,M,6,数学,3.5,英语,35.0,语文,37.0,物理,39.5,化学,36.0,生物,44.0,,,,,,,195.0,32.5 +2021338,北湖雅琳,18,F,6,数学,39.5,英语,38.5,语文,37.0,政治,37.5,历史,37.5,地理,43.5,,,,,,,233.5,38.92 +2021339,中湖星宇,19,M,6,数学,2.5,英语,34.5,语文,36.5,物理,39.0,化学,35.5,生物,43.5,,,,,,,191.5,31.92 +2021340,东江诗雨,18,F,6,数学,39.0,英语,38.0,语文,36.5,政治,37.0,历史,37.0,地理,43.0,,,,,,,230.5,38.42 +2021341,南江天佑,19,M,6,数学,1.5,英语,34.0,语文,36.0,物理,38.5,化学,35.0,生物,43.0,,,,,,,188.0,31.33 +2021342,西江雪儿,18,F,6,数学,38.5,英语,37.5,语文,36.0,政治,36.5,历史,36.5,地理,42.5,,,,,,,227.5,37.92 +2021343,北江明辉,19,M,6,数学,0.5,英语,33.5,语文,35.5,物理,38.0,化学,34.5,生物,42.5,,,,,,,184.5,30.75 +2021344,中江婉清,18,F,6,数学,38.0,英语,37.0,语文,35.5,政治,36.0,历史,36.0,地理,42.0,,,,,,,224.5,37.42 +2021345,东河俊逸,19,M,6,数学,85.0,英语,33.0,语文,35.0,物理,37.5,化学,34.0,生物,42.0,,,,,,,266.5,44.42 +2021346,南河梦涵,18,F,6,数学,37.5,英语,36.5,语文,35.0,政治,35.5,历史,35.5,地理,41.5,,,,,,,221.5,36.92 +2021347,西河浩天,19,M,6,数学,84.0,英语,32.5,语文,34.5,物理,37.0,化学,33.5,生物,41.5,,,,,,,263.0,43.83 +2021348,北河雅静,18,F,6,数学,37.0,英语,36.0,语文,34.5,政治,35.0,历史,35.0,地理,41.0,,,,,,,218.5,36.42 +2021349,中河志豪,19,M,6,数学,83.0,英语,32.0,语文,34.0,物理,36.5,化学,33.0,生物,41.0,,,,,,,259.5,43.25 +2021350,东林晓彤,18,F,6,数学,36.5,英语,35.5,语文,34.0,政治,34.5,历史,34.5,地理,40.5,,,,,,,215.5,35.92 +2021351,南林星河,19,M,6,数学,82.0,英语,31.5,语文,33.5,物理,36.0,化学,32.5,生物,40.5,,,,,,,256.0,42.67 +2021352,西林梦蝶,18,F,6,数学,36.0,英语,35.0,语文,33.5,政治,34.0,历史,34.0,地理,40.0,,,,,,,212.5,35.42 +2021353,北林天翼,19,M,6,数学,81.0,英语,31.0,语文,33.0,物理,35.5,化学,32.0,生物,40.0,,,,,,,252.5,42.08 +2021354,中林雨薇,18,F,6,数学,35.5,英语,34.5,语文,33.0,政治,33.5,历史,33.5,地理,39.5,,,,,,,209.5,34.92 +2021355,东峰浩宇,19,M,6,数学,80.0,英语,30.5,语文,32.5,物理,35.0,化学,31.5,生物,39.5,,,,,,,249.0,41.5 +2021356,南峰雅琪,18,F,6,数学,35.0,英语,34.0,语文,32.5,政治,33.0,历史,33.0,地理,39.0,,,,,,,206.5,34.42 +2021357,西峰志远,19,M,6,数学,79.0,英语,30.0,语文,32.0,物理,34.5,化学,31.0,生物,39.0,,,,,,,245.5,40.92 +2021358,北峰若水,18,F,6,数学,34.5,英语,33.5,语文,32.0,政治,32.5,历史,32.5,地理,38.5,,,,,,,203.5,33.92 +2021359,中峰天佑,19,M,6,数学,78.0,英语,29.5,语文,31.5,物理,34.0,化学,30.5,生物,38.5,,,,,,,242.0,40.33 +2021360,东谷梦瑶,18,F,6,数学,34.0,英语,33.0,语文,31.5,政治,32.0,历史,32.0,地理,38.0,,,,,,,200.5,33.42 +2021361,南谷俊杰,19,M,6,数学,77.0,英语,29.0,语文,31.0,物理,33.5,化学,30.0,生物,38.0,,,,,,,238.5,39.75 +2021362,西谷静雯,18,F,6,数学,33.5,英语,32.5,语文,31.0,政治,31.5,历史,31.5,地理,37.5,,,,,,,197.5,32.92 +2021363,北谷博涛,19,M,6,数学,76.0,英语,28.5,语文,30.5,物理,33.0,化学,29.5,生物,37.5,,,,,,,235.0,39.17 +2021364,中谷紫萱,18,F,6,数学,33.0,英语,32.0,语文,30.5,政治,31.0,历史,31.0,地理,37.0,,,,,,,194.5,32.42 +2021365,东岭星辰,19,M,6,数学,75.0,英语,28.0,语文,30.0,物理,32.5,化学,29.0,生物,37.0,,,,,,,231.5,38.58 +2021366,南岭雨晴,18,F,6,数学,32.5,英语,31.5,语文,30.0,政治,30.5,历史,30.5,地理,36.5,,,,,,,191.5,31.92 +2021367,西岭浩宇,19,M,6,数学,74.0,英语,27.5,语文,29.5,物理,32.0,化学,28.5,生物,36.5,,,,,,,228.0,38.0 +2021368,北岭梦琪,18,F,6,数学,32.0,英语,31.0,语文,29.5,政治,30.0,历史,30.0,地理,36.0,,,,,,,188.5,31.42 +2021369,中岭凌云,19,M,6,数学,73.0,英语,27.0,语文,29.0,物理,31.5,化学,28.0,生物,36.0,,,,,,,224.5,37.42 +2021370,东坡雅欣,18,F,6,数学,31.5,英语,30.5,语文,29.0,政治,29.5,历史,29.5,地理,35.5,,,,,,,185.5,30.92 +2021371,南坡天翔,19,M,6,数学,72.0,英语,26.5,语文,28.5,物理,31.0,化学,27.5,生物,35.5,,,,,,,221.0,36.83 +2021372,西坡慧敏,18,F,6,数学,31.0,英语,30.0,语文,28.5,政治,29.0,历史,29.0,地理,35.0,,,,,,,182.5,30.42 +2021373,北坡俊豪,19,M,6,数学,71.0,英语,26.0,语文,28.0,物理,30.5,化学,27.0,生物,35.0,,,,,,,217.5,36.25 +2021374,中坡晓雪,18,F,6,数学,30.5,英语,29.5,语文,28.0,政治,28.5,历史,28.5,地理,34.5,,,,,,,179.5,29.92 +2021375,东溪云帆,19,M,6,数学,70.0,英语,25.5,语文,27.5,物理,30.0,化学,26.5,生物,34.5,,,,,,,214.0,35.67 +2021376,南溪若兰,18,F,6,数学,30.0,英语,29.0,语文,27.5,政治,28.0,历史,28.0,地理,34.0,,,,,,,176.5,29.42 +2021377,西溪志强,19,M,6,数学,69.0,英语,25.0,语文,27.0,物理,29.5,化学,26.0,生物,34.0,,,,,,,210.5,35.08 +2021378,北溪梦洁,18,F,6,数学,29.5,英语,28.5,语文,27.0,政治,27.5,历史,27.5,地理,33.5,,,,,,,173.5,28.92 +2021379,中溪浩然,19,M,6,数学,68.0,英语,24.5,语文,26.5,物理,29.0,化学,25.5,生物,33.5,,,,,,,207.0,34.5 +2021380,东泉雅琳,18,F,6,数学,29.0,英语,28.0,语文,26.5,政治,27.0,历史,27.0,地理,33.0,,,,,,,170.5,28.42 +2021381,南泉星宇,19,M,6,数学,67.0,英语,24.0,语文,26.0,物理,28.5,化学,25.0,生物,33.0,,,,,,,203.5,33.92 +2021382,西泉诗雨,18,F,6,数学,28.5,英语,27.5,语文,26.0,政治,26.5,历史,26.5,地理,32.5,,,,,,,167.5,27.92 +2021383,北泉天佑,19,M,6,数学,66.0,英语,23.5,语文,25.5,物理,28.0,化学,24.5,生物,32.5,,,,,,,200.0,33.33 +2021384,中泉雪儿,18,F,6,数学,28.0,英语,27.0,语文,25.5,政治,26.0,历史,26.0,地理,32.0,,,,,,,164.5,27.42 +2021385,东池明辉,19,M,6,数学,65.0,英语,23.0,语文,25.0,物理,27.5,化学,24.0,生物,32.0,,,,,,,196.5,32.75 +2021386,南池婉清,18,F,6,数学,27.5,英语,26.5,语文,25.0,政治,25.5,历史,25.5,地理,31.5,,,,,,,161.5,26.92 +2021387,西池俊逸,19,M,6,数学,64.0,英语,22.5,语文,24.5,物理,27.0,化学,23.5,生物,31.5,,,,,,,193.0,32.17 +2021388,北池梦涵,18,F,6,数学,27.0,英语,26.0,语文,24.5,政治,25.0,历史,25.0,地理,31.0,,,,,,,158.5,26.42 +2021389,中池浩天,19,M,6,数学,63.0,英语,22.0,语文,24.0,物理,26.5,化学,23.0,生物,31.0,,,,,,,189.5,31.58 +2021390,东湾雅静,18,F,6,数学,26.5,英语,25.5,语文,24.0,政治,24.5,历史,24.5,地理,30.5,,,,,,,155.5,25.92 +2021391,南湾志豪,19,M,6,数学,62.0,英语,21.5,语文,23.5,物理,26.0,化学,22.5,生物,30.5,,,,,,,186.0,31.0 +2021392,西湾晓彤,18,F,6,数学,26.0,英语,25.0,语文,23.5,政治,24.0,历史,24.0,地理,30.0,,,,,,,152.5,25.42 +2021393,北湾星河,19,M,6,数学,61.0,英语,21.0,语文,23.0,物理,25.5,化学,22.0,生物,30.0,,,,,,,182.5,30.42 +2021394,中湾梦蝶,18,F,6,数学,25.5,英语,24.5,语文,23.0,政治,23.5,历史,23.5,地理,29.5,,,,,,,149.5,24.92 +2021395,东港天翼,19,M,6,数学,60.0,英语,20.5,语文,22.5,物理,25.0,化学,21.5,生物,29.5,,,,,,,179.0,29.83 +2021396,南港雨薇,18,F,6,数学,25.0,英语,24.0,语文,22.5,政治,23.0,历史,23.0,地理,29.0,,,,,,,146.5,24.42 +2021397,西港浩宇,19,M,6,数学,59.0,英语,20.0,语文,22.0,物理,24.5,化学,21.0,生物,29.0,,,,,,,175.5,29.25 +2021398,北港雅琪,18,F,6,数学,24.5,英语,23.5,语文,22.0,政治,22.5,历史,22.5,地理,28.5,,,,,,,143.5,23.92 +2021399,中港志远,19,M,6,数学,58.0,英语,19.5,语文,21.5,物理,24.0,化学,20.5,生物,28.5,,,,,,,172.0,28.67 +2021400,东滩若水,18,F,6,数学,24.0,英语,23.0,语文,21.5,政治,22.0,历史,22.0,地理,28.0,,,,,,,140.5,23.42 +2021401,南滩天佑,19,M,6,数学,57.0,英语,19.0,语文,21.0,物理,23.5,化学,20.0,生物,28.0,,,,,,,168.5,28.08 +2021402,西滩梦瑶,18,F,6,数学,23.5,英语,22.5,语文,21.0,政治,21.5,历史,21.5,地理,27.5,,,,,,,137.5,22.92 +2021403,北滩俊杰,19,M,6,数学,56.0,英语,18.5,语文,20.5,物理,23.0,化学,19.5,生物,27.5,,,,,,,165.0,27.5 +2021404,中滩静雯,18,F,6,数学,23.0,英语,22.0,语文,20.5,政治,21.0,历史,21.0,地理,27.0,,,,,,,134.5,22.42 +2021405,东岸博涛,19,M,6,数学,55.0,英语,18.0,语文,20.0,物理,22.5,化学,19.0,生物,27.0,,,,,,,161.5,26.92 +2021406,南岸紫萱,18,F,6,数学,22.5,英语,21.5,语文,20.0,政治,20.5,历史,20.5,地理,26.5,,,,,,,131.5,21.92 +2021407,西岸星辰,19,M,6,数学,54.0,英语,17.5,语文,19.5,物理,22.0,化学,18.5,生物,26.5,,,,,,,158.0,26.33 +2021408,北岸雨晴,18,F,6,数学,22.0,英语,21.0,语文,19.5,政治,20.0,历史,20.0,地理,26.0,,,,,,,128.5,21.42 +2021409,中岸浩宇,19,M,6,数学,53.0,英语,17.0,语文,19.0,物理,21.5,化学,18.0,生物,26.0,,,,,,,154.5,25.75 +2021410,东滨梦琪,18,F,6,数学,21.5,英语,20.5,语文,19.0,政治,19.5,历史,19.5,地理,25.5,,,,,,,125.5,20.92 +2021411,南滨凌云,19,M,6,数学,52.0,英语,16.5,语文,18.5,物理,21.0,化学,17.5,生物,25.5,,,,,,,151.0,25.17 +2021412,西滨雅欣,18,F,6,数学,21.0,英语,20.0,语文,18.5,政治,19.0,历史,19.0,地理,25.0,,,,,,,122.5,20.42 +2021413,北滨天翔,19,M,6,数学,51.0,英语,16.0,语文,18.0,物理,20.5,化学,17.0,生物,25.0,,,,,,,147.5,24.58 +2021414,中滨慧敏,18,F,6,数学,20.5,英语,19.5,语文,18.0,政治,18.5,历史,18.5,地理,24.5,,,,,,,119.5,19.92 +2021415,东浦俊豪,19,M,6,数学,50.0,英语,15.5,语文,17.5,物理,20.0,化学,16.5,生物,24.5,,,,,,,144.0,24.0 +2021416,南浦晓雪,18,F,6,数学,20.0,英语,19.0,语文,17.5,政治,18.0,历史,18.0,地理,24.0,,,,,,,116.5,19.42 +2021417,西浦云帆,19,M,6,数学,49.0,英语,15.0,语文,17.0,物理,19.5,化学,16.0,生物,24.0,,,,,,,140.5,23.42 +2021418,北浦若兰,18,F,6,数学,19.5,英语,18.5,语文,17.0,政治,17.5,历史,17.5,地理,23.5,,,,,,,113.5,18.92 +2021419,中浦志强,19,M,6,数学,48.0,英语,14.5,语文,16.5,物理,19.0,化学,15.5,生物,23.5,,,,,,,137.0,22.83 +2021420,东洲梦洁,18,F,6,数学,19.0,英语,18.0,语文,16.5,政治,17.0,历史,17.0,地理,23.0,,,,,,,110.5,18.42 +2021421,南洲浩然,19,M,6,数学,47.0,英语,14.0,语文,16.0,物理,18.5,化学,15.0,生物,23.0,,,,,,,133.5,22.25 +2021422,西洲雅琳,18,F,6,数学,18.5,英语,17.5,语文,16.0,政治,16.5,历史,16.5,地理,22.5,,,,,,,107.5,17.92 +2021423,北洲星宇,19,M,6,数学,46.0,英语,13.5,语文,15.5,物理,18.0,化学,14.5,生物,22.5,,,,,,,130.0,21.67 +2021424,中洲诗雨,18,F,6,数学,18.0,英语,17.0,语文,15.5,政治,16.0,历史,16.0,地理,22.0,,,,,,,104.5,17.42 +2021425,东屿天佑,19,M,6,数学,45.0,英语,13.0,语文,15.0,物理,17.5,化学,14.0,生物,22.0,,,,,,,126.5,21.08 +2021426,南屿雪儿,18,F,6,数学,17.5,英语,16.5,语文,15.0,政治,15.5,历史,15.5,地理,21.5,,,,,,,101.5,16.92 +2021427,西屿明辉,19,M,6,数学,44.0,英语,12.5,语文,14.5,物理,17.0,化学,13.5,生物,21.5,,,,,,,123.0,20.5 +2021428,北屿婉清,18,F,6,数学,17.0,英语,16.0,语文,14.5,政治,15.0,历史,15.0,地理,21.0,,,,,,,98.5,16.42 +2021429,中屿俊逸,19,M,6,数学,43.0,英语,12.0,语文,14.0,物理,16.5,化学,13.0,生物,21.0,,,,,,,119.5,19.92 +2021430,东礁梦涵,18,F,6,数学,16.5,英语,15.5,语文,14.0,政治,14.5,历史,14.5,地理,20.5,,,,,,,95.5,15.92 +2021431,南礁浩天,19,M,6,数学,42.0,英语,11.5,语文,13.5,物理,16.0,化学,12.5,生物,20.5,,,,,,,116.0,19.33 +2021432,西礁雅静,18,F,6,数学,16.0,英语,15.0,语文,13.5,政治,14.0,历史,14.0,地理,20.0,,,,,,,92.5,15.42 +2021433,北礁志豪,19,M,6,数学,41.0,英语,11.0,语文,13.0,物理,15.5,化学,12.0,生物,20.0,,,,,,,112.5,18.75 +2021434,中礁晓彤,18,F,6,数学,15.5,英语,14.5,语文,13.0,政治,13.5,历史,13.5,地理,19.5,,,,,,,89.5,14.92 +2021435,东渚星河,19,M,6,数学,40.0,英语,10.5,语文,12.5,物理,15.0,化学,11.5,生物,19.5,,,,,,,109.0,18.17 +2021436,南渚梦蝶,18,F,6,数学,15.0,英语,14.0,语文,12.5,政治,13.0,历史,13.0,地理,19.0,,,,,,,86.5,14.42 +2021437,西渚天翼,19,M,6,数学,39.0,英语,10.0,语文,12.0,物理,14.5,化学,11.0,生物,19.0,,,,,,,105.5,17.58 +2021438,北渚雨薇,18,F,6,数学,14.5,英语,13.5,语文,12.0,政治,12.5,历史,12.5,地理,18.5,,,,,,,83.5,13.92 +2021439,中渚浩宇,19,M,6,数学,38.0,英语,9.5,语文,11.5,物理,14.0,化学,10.5,生物,18.5,,,,,,,102.0,17.0 +2021440,东汀雅琪,18,F,6,数学,14.0,英语,13.0,语文,11.5,政治,12.0,历史,12.0,地理,18.0,,,,,,,80.5,13.42 +2021441,南汀志远,19,M,6,数学,37.0,英语,9.0,语文,11.0,物理,13.5,化学,10.0,生物,18.0,,,,,,,98.5,16.42 +2021442,西汀若水,18,F,6,数学,13.5,英语,12.5,语文,11.0,政治,11.5,历史,11.5,地理,17.5,,,,,,,77.5,12.92 +2021443,北汀天佑,19,M,6,数学,36.0,英语,8.5,语文,10.5,物理,13.0,化学,9.5,生物,17.5,,,,,,,95.0,15.83 +2021444,中汀梦瑶,18,F,6,数学,13.0,英语,12.0,语文,10.5,政治,11.0,历史,11.0,地理,17.0,,,,,,,74.5,12.42 \ No newline at end of file diff --git a/data/users.txt b/data/users.txt new file mode 100644 index 0000000..d030942 --- /dev/null +++ b/data/users.txt @@ -0,0 +1,4 @@ +admin:123456:1 +teacher:password:0 +LHY:1234:0 +lhy:1234:1 diff --git a/file_utils.c b/file_utils.c new file mode 100644 index 0000000..2f55f59 --- /dev/null +++ b/file_utils.c @@ -0,0 +1,67 @@ +/** + * @file file_utils.c + * @brief 文件操作工具函数实现文件 + * @note 实现文件和目录操作相关函数 + */ + +#include +#include +#include +#ifdef _WIN32 +#include +#include +#else +#include +#endif + +#include "file_utils.h" + +/** + * @brief 检查文件是否存在 + * @details 使用access函数（Unix/Linux）或_access函数（Windows）检查文件是否存在且可读 + * @param filename 要检查的文件路径 + * @return 如果文件存在且可读返回true，否则返回false + * @note 函数只检查文件是否存在，不检查文件内容 + * @warning 如果filename为NULL，返回false + */ +bool fileExists(const char *filename) +{ + if (filename == NULL) + return false; + +#ifdef _WIN32 + return _access(filename, 0) == 0; +#else + return access(filename, F_OK) == 0; +#endif +} + +/** + * @brief 创建目录 + * @details 使用mkdir函数创建指定路径的目录 + * 在Windows下使用_mkdir，在Unix/Linux下使用mkdir + * @param path 要创建的目录路径 + * @return 如果目录创建成功或已存在返回true，否则返回false + * @note 如果目录已存在，函数返回true + * @note 函数不会递归创建父目录 + * @warning 如果path为NULL，返回false + */ +bool createDirectory(const char *path) +{ + if (path == NULL) + return false; + + // 检查目录是否已存在 + struct stat st = {0}; + if (stat(path, &st) == 0) + { + return true; // 目录已存在 + } + + // 创建目录 +#ifdef _WIN32 + return _mkdir(path) == 0; +#else + return mkdir(path, 0755) == 0; +#endif +} \ No newline at end of file diff --git a/file_utils.h b/file_utils.h new file mode 100644 index 0000000..8f3d2a6 --- /dev/null +++ b/file_utils.h @@ -0,0 +1,36 @@ +/** + * @file file_utils.h + * @brief 文件操作工具函数头文件 + * @note 包含文件和目录操作相关函数声明 + */ + +#ifndef FILE_UTILS_H +#define FILE_UTILS_H + +#include + +// 文件操作函数 + +/** + * @brief 检查文件是否存在 + * @details 使用access函数（Unix/Linux）或_access函数（Windows）检查文件是否存在且可读 + * @param filename 要检查的文件路径 + * @return 如果文件存在且可读返回true，否则返回false + * @note 函数只检查文件是否存在，不检查文件内容 + * @warning 如果filename为NULL，返回false + */ +bool fileExists(const char* filename); + +/** + * @brief 创建目录 + * @details 使用mkdir函数创建指定路径的目录 + * 在Windows下使用_mkdir，在Unix/Linux下使用mkdir + * @param path 要创建的目录路径 + * @return 如果目录创建成功或已存在返回true，否则返回false + * @note 如果目录已存在，函数返回true + * @note 函数不会递归创建父目录 + * @warning 如果path为NULL，返回false + */ +bool createDirectory(const char* path); + +#endif // FILE_UTILS_H \ No newline at end of file diff --git a/globals.c b/globals.c new file mode 100644 index 0000000..89d69d0 --- /dev/null +++ b/globals.c @@ -0,0 +1,32 @@ +/** + * @file globals.c + * @brief 全局变量定义文件 + * @note 定义所有全局变量的实际存储空间 + */ + +#include "globals.h" + +// 全局变量定义 +Student students[MAX_STUDENTS]; // 学生数组 +User users[MAX_USERS]; // 用户数组 +int studentCount = 0; // 当前学生数量 +int userCount = 0; // 当前用户数量 +char currentUser[MAX_USERNAME_LENGTH] = ""; // 当前登录用户 +bool isCurrentUserAdmin = false; // 当前用户是否为管理员 + +// 系统状态变量 +bool systemInitialized = false; // 系统是否已初始化 +bool dataModified = false; // 数据是否已修改 + +// 统计信息缓存 +float overallAverageScore = 0.0; // 全体学生平均分 +float highestScore = 0.0; // 最高分 +float lowestScore = 100.0; // 最低分 +bool statsNeedUpdate = true; // 统计信息是否需要更新 + +// 排序参数 +int currentSortCriteria = 0; // 当前排序依据 +int currentSortOrder = 0; // 当前排序顺序 + +// 统计缓存 +StatisticsCache statsCache = {false, {0}, {0}, {{0}}, 0, 0}; // 统计分析缓存 \ No newline at end of file diff --git a/globals.h b/globals.h new file mode 100644 index 0000000..9c21587 --- /dev/null +++ b/globals.h @@ -0,0 +1,38 @@ +/** + * @file globals.h + * @brief 全局变量声明头文件 + * @note 集中管理所有全局变量的声明，提高代码可维护性 + */ + +#ifndef GLOBALS_H +#define GLOBALS_H + +#include +#include "types.h" + +// 全局变量声明 +extern Student students[MAX_STUDENTS]; // 学生数组 +extern User users[MAX_USERS]; // 用户数组 +extern int studentCount; // 当前学生数量 +extern int userCount; // 当前用户数量 +extern char currentUser[MAX_USERNAME_LENGTH]; // 当前登录用户 +extern bool isCurrentUserAdmin; // 当前用户是否为管理员 + +// 系统状态变量 +extern bool systemInitialized; // 系统是否已初始化 +extern bool dataModified; // 数据是否已修改（用于判断是否需要保存） + +// 统计信息缓存（可选，用于提高性能） +extern float overallAverageScore; // 全体学生平均分 +extern float highestScore; // 最高分 +extern float lowestScore; // 最低分 +extern bool statsNeedUpdate; // 统计信息是否需要更新 + +// 排序参数 +extern int currentSortCriteria; // 当前排序依据 +extern int currentSortOrder; // 当前排序顺序 + +// 统计缓存 +extern StatisticsCache statsCache; // 统计分析缓存 + +#endif // GLOBALS_H \ No newline at end of file diff --git a/io_utils.c b/io_utils.c new file mode 100644 index 0000000..c280875 --- /dev/null +++ b/io_utils.c @@ -0,0 +1,255 @@ +/** + * @file io_utils.c + * @brief 输入输出工具函数实现文件 + * @note 实现界面显示、用户输入等相关函数 + */ + +#include +#include +#include +#include +#ifdef _WIN32 +#include +#endif + +#include "io_utils.h" +#include "config.h" +#include "string_utils.h" + +/** + * @brief 清理输入缓冲区 + * @details 清除标准输入流中的所有剩余字符，直到遇到换行符或文件结束符 + * 主要用于防止输入缓冲区中的残留字符影响后续输入操作 + * @note 在使用scanf等函数后调用此函数可以避免输入问题 + */ +void clearInputBuffer() +{ + int c; + while ((c = getchar()) != '\n' && c != EOF) + ; +} + +/** + * @brief 暂停系统，等待用户按键 + * @details 显示提示信息并等待用户按下任意键后继续执行 + * 在Windows系统下使用_getch()函数，在其他系统下使用getchar()函数 + * @note 用于在菜单操作完成后暂停，让用户有时间查看结果 + * @warning 在非Windows系统下需要按回车键才能继续 + */ +void pauseSystem() +{ + printf("\n按任意键继续..."); +#ifdef _WIN32 + _getch(); +#else + getchar(); +#endif + printf("\n"); +} + +/** + * @brief 清屏 + * @details 根据操作系统类型调用相应的清屏命令 + * Windows系统使用"cls"命令，其他系统使用"clear"命令 + * @note 用于清除终端屏幕内容，提供更好的用户界面体验 + * @warning 依赖于系统命令，在某些受限环境下可能无法正常工作 + */ +void clearScreen() +{ +#ifdef _WIN32 + system("cls"); +#else + system("clear"); +#endif +} + +/** + * @brief 打印分隔线 + * @details 输出一行由等号组成的分隔线，用于美化界面显示 + * @note 分隔线长度为40个字符，用于分隔不同的界面区域 + */ +void printSeparator() +{ + printf("========================================\n"); +} + +/** + * @brief 打印标题头 + * @details 以美观的格式显示标题，标题上下各有一条分隔线 + * @param title 要显示的标题文本，不能为NULL + * @note 标题会居中显示，前面有10个空格的缩进 + * @warning 如果title为NULL，可能导致程序崩溃 + */ +void printHeader(const char *title) +{ + printSeparator(); + printf(" %s\n", title); + printSeparator(); +} + +/** + * @brief 安全输入整数 + * @details 提供安全的整数输入功能，包含范围验证和错误处理 + * 使用fgets和sscanf组合避免缓冲区溢出，循环直到获得有效输入 + * @param prompt 显示给用户的提示信息 + * @param min 允许输入的最小值（包含） + * @param max 允许输入的最大值（包含） + * @return 返回用户输入的有效整数 + * @note 函数会一直循环直到用户输入有效的整数 + * @note 自动显示输入范围提示 + * @warning 如果prompt为NULL，printf可能出现问题 + */ +int safeInputInt(const char *prompt, int min, int max) +{ + int value; + char buffer[100]; + + while (1) + { + printf("%s (%d-%d): ", prompt, min, max); + + if (fgets(buffer, sizeof(buffer), stdin) != NULL) + { + if (sscanf(buffer, "%d", &value) == 1) + { + if (value >= min && value <= max) + { + return value; + } + } + } + + printError("输入无效，请重新输入！"); + } +} + +/** + * @brief 安全输入浮点数 + * @details 提供安全的浮点数输入功能，包含范围验证和错误处理 + * 使用fgets和sscanf组合避免缓冲区溢出，循环直到获得有效输入 + * @param prompt 显示给用户的提示信息 + * @param min 允许输入的最小值（包含） + * @param max 允许输入的最大值（包含） + * @return 返回用户输入的有效浮点数 + * @note 函数会一直循环直到用户输入有效的浮点数 + * @note 自动显示输入范围提示，精度为小数点后1位 + * @warning 如果prompt为NULL，printf可能出现问题 + */ +float safeInputFloat(const char *prompt, float min, float max) +{ + float value; + char buffer[100]; + + while (1) + { + printf("%s (%.1f-%.1f): ", prompt, min, max); + + if (fgets(buffer, sizeof(buffer), stdin) != NULL) + { + if (sscanf(buffer, "%f", &value) == 1) + { + if (value >= min && value <= max) + { + return value; + } + } + } + + printError("输入无效，请重新输入！"); + } +} + +/** + * @brief 安全输入字符串 + * @details 提供安全的字符串输入功能，包含空值检查和自动去除首尾空格 + * 使用fgets避免缓冲区溢出，自动移除换行符并处理空白字符 + * @param prompt 显示给用户的提示信息 + * @param buffer 存储输入字符串的缓冲区 + * @param maxLen 缓冲区的最大长度（包含终止符） + * @note 函数会一直循环直到用户输入非空字符串 + * @note 自动移除输入字符串的首尾空白字符 + * @warning 如果buffer为NULL或maxLen<=0，可能导致程序崩溃 + */ +void safeInputString(const char *prompt, char *buffer, int maxLen) +{ + while (1) + { + printf("%s: ", prompt); + + if (fgets(buffer, maxLen, stdin) != NULL) + { + // 移除换行符 + buffer[strcspn(buffer, "\n")] = '\0'; + trimString(buffer); + + if (!isEmptyString(buffer)) + { + return; + } + } + + printError("输入不能为空，请重新输入！"); + } +} + +/** + * @brief 彩色输出 + * @details 使用ANSI转义序列在终端中输出彩色文本 + * 输出格式为：颜色代码 + 文本 + 重置代码 + * @param text 要输出的文本内容 + * @param color ANSI颜色代码字符串（如COLOR_RED、COLOR_GREEN等） + * @note 输出后会自动重置颜色为默认值 + * @warning 如果终端不支持ANSI转义序列，可能显示乱码 + */ +void printColored(const char *text, const char *color) +{ + printf("%s%s%s", color, text, COLOR_RESET); +} + +/** + * @brief 成功消息 + * @details 以绿色显示成功消息，用于提示操作成功完成 + * @param message 要显示的成功消息文本 + * @note 消息会以绿色显示，并在末尾自动添加换行符 + */ +void printSuccess(const char *message) +{ + printColored(message, COLOR_GREEN); + printf("\n"); +} + +/** + * @brief 错误消息 + * @details 以红色显示错误消息，用于提示操作失败或出现错误 + * @param message 要显示的错误消息文本 + * @note 消息会以红色显示，并在末尾自动添加换行符 + */ +void printError(const char *message) +{ + printColored(message, COLOR_RED); + printf("\n"); +} + +/** + * @brief 警告消息 + * @details 以黄色显示警告消息，用于提示需要注意的情况 + * @param message 要显示的警告消息文本 + * @note 消息会以黄色显示，并在末尾自动添加换行符 + */ +void printWarning(const char *message) +{ + printColored(message, COLOR_YELLOW); + printf("\n"); +} + +/** + * @brief 信息消息 + * @details 以青色显示信息消息，用于提示一般性信息 + * @param message 要显示的信息消息文本 + * @note 消息会以青色显示，并在末尾自动添加换行符 + */ +void printInfo(const char *message) +{ + printColored(message, COLOR_CYAN); + printf("\n"); +} \ No newline at end of file diff --git a/io_utils.h b/io_utils.h new file mode 100644 index 0000000..ed5f15e --- /dev/null +++ b/io_utils.h @@ -0,0 +1,144 @@ +/** + * @file io_utils.h + * @brief 输入输出工具函数头文件 + * @note 包含界面显示、用户输入等相关函数声明 + */ + +#ifndef IO_UTILS_H +#define IO_UTILS_H + +#include + +// 界面显示函数 + +/** + * @brief 清理输入缓冲区 + * @details 清除标准输入流中的所有剩余字符，直到遇到换行符或文件结束符 + * 主要用于防止输入缓冲区中的残留字符影响后续输入操作 + * @note 在使用scanf等函数后调用此函数可以避免输入问题 + */ +void clearInputBuffer(); + +/** + * @brief 暂停系统，等待用户按键 + * @details 显示提示信息并等待用户按下任意键后继续执行 + * 在Windows系统下使用_getch()函数，在其他系统下使用getchar()函数 + * @note 用于在菜单操作完成后暂停，让用户有时间查看结果 + * @warning 在非Windows系统下需要按回车键才能继续 + */ +void pauseSystem(); + +/** + * @brief 清屏 + * @details 根据操作系统类型调用相应的清屏命令 + * Windows系统使用"cls"命令，其他系统使用"clear"命令 + * @note 用于清除终端屏幕内容，提供更好的用户界面体验 + * @warning 依赖于系统命令，在某些受限环境下可能无法正常工作 + */ +void clearScreen(); + +/** + * @brief 打印分隔线 + * @details 输出一行由等号组成的分隔线，用于美化界面显示 + * @note 分隔线长度为40个字符，用于分隔不同的界面区域 + */ +void printSeparator(); + +/** + * @brief 打印标题头 + * @details 以美观的格式显示标题，标题上下各有一条分隔线 + * @param title 要显示的标题文本，不能为NULL + * @note 标题会居中显示，前面有10个空格的缩进 + * @warning 如果title为NULL，可能导致程序崩溃 + */ +void printHeader(const char* title); + +// 安全输入函数 + +/** + * @brief 安全输入整数 + * @details 提供安全的整数输入功能，包含范围验证和错误处理 + * 使用fgets和sscanf组合避免缓冲区溢出，循环直到获得有效输入 + * @param prompt 显示给用户的提示信息 + * @param min 允许输入的最小值（包含） + * @param max 允许输入的最大值（包含） + * @return 返回用户输入的有效整数 + * @note 函数会一直循环直到用户输入有效的整数 + * @note 自动显示输入范围提示 + * @warning 如果prompt为NULL，printf可能出现问题 + */ +int safeInputInt(const char* prompt, int min, int max); + +/** + * @brief 安全输入浮点数 + * @details 提供安全的浮点数输入功能，包含范围验证和错误处理 + * 使用fgets和sscanf组合避免缓冲区溢出，循环直到获得有效输入 + * @param prompt 显示给用户的提示信息 + * @param min 允许输入的最小值（包含） + * @param max 允许输入的最大值（包含） + * @return 返回用户输入的有效浮点数 + * @note 函数会一直循环直到用户输入有效的浮点数 + * @note 自动显示输入范围提示，精度为小数点后1位 + * @warning 如果prompt为NULL，printf可能出现问题 + */ +float safeInputFloat(const char* prompt, float min, float max); + +/** + * @brief 安全输入字符串 + * @details 提供安全的字符串输入功能，包含空值检查和自动去除首尾空格 + * 使用fgets避免缓冲区溢出，自动移除换行符并处理空白字符 + * @param prompt 显示给用户的提示信息 + * @param buffer 存储输入字符串的缓冲区 + * @param maxLen 缓冲区的最大长度（包含终止符） + * @note 函数会一直循环直到用户输入非空字符串 + * @note 自动移除输入字符串的首尾空白字符 + * @warning 如果buffer为NULL或maxLen<=0，可能导致程序崩溃 + */ +void safeInputString(const char* prompt, char* buffer, int maxLen); + +// 颜色输出函数 + +/** + * @brief 彩色输出 + * @details 使用ANSI转义序列在终端中输出彩色文本 + * 输出格式为：颜色代码 + 文本 + 重置代码 + * @param text 要输出的文本内容 + * @param color ANSI颜色代码字符串（如COLOR_RED、COLOR_GREEN等） + * @note 输出后会自动重置颜色为默认值 + * @warning 如果终端不支持ANSI转义序列，可能显示乱码 + */ +void printColored(const char* text, const char* color); + +/** + * @brief 成功消息 + * @details 以绿色显示成功消息，用于提示操作成功完成 + * @param message 要显示的成功消息文本 + * @note 消息会以绿色显示，并在末尾自动添加换行符 + */ +void printSuccess(const char* message); + +/** + * @brief 错误消息 + * @details 以红色显示错误消息，用于提示操作失败或出现错误 + * @param message 要显示的错误消息文本 + * @note 消息会以红色显示，并在末尾自动添加换行符 + */ +void printError(const char* message); + +/** + * @brief 警告消息 + * @details 以黄色显示警告消息，用于提示需要注意的情况 + * @param message 要显示的警告消息文本 + * @note 消息会以黄色显示，并在末尾自动添加换行符 + */ +void printWarning(const char* message); + +/** + * @brief 信息消息 + * @details 以青色显示信息消息，用于提示一般性信息 + * @param message 要显示的信息消息文本 + * @note 消息会以青色显示，并在末尾自动添加换行符 + */ +void printInfo(const char* message); + +#endif // IO_UTILS_H \ No newline at end of file diff --git a/main.c b/main.c new file mode 100644 index 0000000..9f2ff0f --- /dev/null +++ b/main.c @@ -0,0 +1,147 @@ +/** +* @brief 主程序入口 +* @brief 学生成绩管理系统主程序 +* @details 学生成绩管理系统的主入口函数，负责系统初始化、用户登录验证、 +* 主菜单循环处理和系统清理等核心流程 +* 程序流程：设置编码 -> 系统初始化 -> 用户登录 -> 主菜单循环 -> 数据保存 -> 系统清理 +* @param argc 命令行参数个数（当前未使用） +* @param argv 命令行参数数组（当前未使用） +* @return 程序退出状态码：0表示正常退出，-1表示异常退出 +* @note 系统预设用户账户： +* 1. admin - 密码：123456（管理员权限） +* 2. teacher - 密码：password（普通用户权限） +* @note 编译运行命令： +* gcc -o student_system.exe *.c -I. + ./student_system +* @warning 登录失败超过MAX_LOGIN_ATTEMPTS次会强制退出程序 +*/ + +#include +#include +#include +#ifdef _WIN32 +#include +#include +#else +#include +#include +#endif + +#include "config.h" +#include "globals.h" +#include "main_menu.h" +#include "user_manage.h" +#include "statistical_analysis.h" +#include "io_utils.h" +#include "system_utils.h" +#include "core_handlers.h" +#include "student_io.h" + +int main(int argc __attribute__((unused)), char *argv[] __attribute__((unused))) +{ + // 设置控制台编码为UTF-8 +#ifdef _WIN32 + system("chcp 65001 > nul"); // 设置控制台编码为UTF-8 + SetConsoleOutputCP(65001); // 设置控制台输出编码 + SetConsoleCP(65001); // 设置控制台输入编码 +#endif + + // 初始化系统 + if (!initializeSystem()) + { + printError("系统初始化失败！"); + return -1; + } + + // 显示欢迎信息 + clearScreen(); + printHeader("学生成绩管理系统"); + printf("\n"); + printInfo("欢迎使用学生成绩管理系统！"); + printf("\n"); + pauseSystem(); + + // 用户登录 + int loginAttempts = 0; + while (loginAttempts < MAX_LOGIN_ATTEMPTS) + { + clearScreen(); + printHeader("用户登录"); + + if (loginSystem()) + { + printSuccess("登录成功！"); + printf("欢迎您，%s%s\n", currentUser, + isCurrentUserAdmin ? " (管理员)" : " (普通用户)"); + pauseSystem(); + break; + } + else + { + loginAttempts++; + if (loginAttempts < MAX_LOGIN_ATTEMPTS) + { + printError("登录失败！请检查用户名和密码。"); + printf("剩余尝试次数：%d\n", MAX_LOGIN_ATTEMPTS - loginAttempts); + pauseSystem(); + } + } + } + + // 登录失败次数过多，退出程序 + if (loginAttempts >= MAX_LOGIN_ATTEMPTS) + { + printError("登录失败次数过多，程序将退出！"); + cleanupSystem(); + return -1; + } + + // 主程序循环 + int choice; + do + { + clearScreen(); + displayMainMenu(); + choice = safeInputInt("请选择功能", MENU_EXIT, MENU_ADMIN); + + switch (choice) + { + case MENU_BASIC_FUNCTIONS: + handleBasicFunctions(); + break; + case MENU_STATISTICS: + handleStatistics(); + break; + case MENU_ADMIN: + if (isCurrentUserAdmin) + { + handleAdminFunctions(); + } + else + { + printError("您没有管理员权限！"); + pauseSystem(); + } + break; + case MENU_EXIT: + // 保存数据并退出 + if (dataModified) + { + printInfo("正在保存数据..."); + saveStudentsToFile(); + saveUsersToFile(); + printSuccess("数据保存完成！"); + } + printInfo("感谢使用学生成绩管理系统！"); + break; + default: + printError("无效的选择！"); + pauseSystem(); + break; + } + } while (choice != MENU_EXIT); + + // 清理系统资源 + cleanupSystem(); + return 0; +} \ No newline at end of file diff --git a/main_menu.c b/main_menu.c new file mode 100644 index 0000000..96333ce --- /dev/null +++ b/main_menu.c @@ -0,0 +1,127 @@ +/** + * @file main_menu.c + * @brief 主菜单实现文件 + * @note 实现各种菜单显示功能 + */ + + #include + #include "main_menu.h" + #include "config.h" + #include "io_utils.h" + #include "globals.h" + + /** + * @brief 显示主菜单 + * @details 显示学生成绩管理系统的主菜单界面，包括当前用户信息和可用功能选项 + * 根据用户权限动态显示菜单项（管理员可看到系统管理功能） + * @note 菜单选项： + * 1. 基本功能管理（所有用户） + * 2. 统计分析功能（所有用户） + * 3. 系统管理功能（仅管理员） + * 0. 退出系统 + */ +void displayMainMenu() +{ + printHeader("学生成绩管理系统 - 主菜单"); + printf("\n"); + printf("当前用户: %s %s\n", currentUser, + isCurrentUserAdmin ? "(管理员)" : "(普通用户)"); + printf("\n"); + printf("1. 基本功能管理\n"); + printf("2. 统计分析功能\n"); + if (isCurrentUserAdmin) + { + printf("3. 系统管理功能\n"); + } + printf("0. 退出系统\n"); + printf("\n"); + printSeparator(); + } + + /** + * @brief 显示基本功能菜单 + * @details 显示学生信息管理的基本功能菜单，包括增删改查和排序功能 + * 同时显示当前系统中的学生总数 + * @note 菜单功能： + * 1. 添加学生信息 + * 2. 删除学生信息 + * 3. 修改学生信息 + * 4. 按学号查找学生 + * 5. 按姓名查找学生 + * 6. 显示所有学生 + * 7. 学生信息排序 + * 0. 返回主菜单 + */ +void displayBasicFunctionsMenu() +{ + printHeader("基本功能管理"); + printf("\n"); + printf("1. 添加学生信息\n"); + printf("2. 删除学生信息\n"); + printf("3. 修改学生信息\n"); + printf("4. 按学号查找学生\n"); + printf("5. 按姓名查找学生\n"); + printf("6. 显示所有学生\n"); + printf("7. 学生信息排序\n"); + printf("0. 返回主菜单\n"); + printf("\n"); + printf("当前学生总数: %d\n", studentCount); + printf("\n"); + printSeparator(); + } + + /** + * @brief 显示统计功能菜单 + * @details 显示统计分析功能菜单，提供各种数据统计和分析选项 + * 显示当前学生总数和系统平均分（如果有学生数据） + * @note 菜单功能： + * 1. 课程统计分析 + * 2. 成绩分布统计 + * 3. 分数段统计 + * 4. 综合统计分析 + * 0. 返回主菜单 + */ +void displayStatisticsMenu() +{ + printHeader("统计分析功能"); + printf("\n"); + printf("1. 课程统计分析\n"); + printf("2. 成绩分布统计\n"); + printf("3. 分数段统计\n"); + printf("4. 综合统计分析\n"); + printf("0. 返回主菜单\n"); + printf("\n"); + printf("当前学生总数: %d\n", studentCount); + if (studentCount > 0) { + printf("系统平均分: %.2f\n", overallAverageScore); + } + printf("\n"); + printSeparator(); + } + + /** + * @brief 显示管理功能菜单 + * @details 显示系统管理功能菜单，仅管理员可访问 + * 提供用户账户管理功能，显示当前用户总数 + * @note 菜单功能： + * 1. 添加用户账户 + * 2. 删除用户账户 + * 3. 修改用户密码 + * 4. 查看所有用户 + * 0. 返回主菜单 + * @warning 此菜单仅限管理员用户访问 + */ +void displayAdminMenu() +{ + printHeader("系统管理功能"); + printf("\n"); + printf("1. 添加用户账户\n"); + printf("2. 删除用户账户\n"); + printf("3. 修改用户密码\n"); + printf("4. 查看所有用户\n"); + printf("0. 返回主菜单\n"); + printf("\n"); + printf("当前用户总数: %d\n", userCount); + printf("\n"); + printSeparator(); + } \ No newline at end of file diff --git a/main_menu.h b/main_menu.h new file mode 100644 index 0000000..65ee410 --- /dev/null +++ b/main_menu.h @@ -0,0 +1,69 @@ +/** + * @file main_menu.h + * @brief 主菜单实现文件 + * @note 实现各种菜单显示功能函数声明 + */ + +#ifndef MAIN_MENU_H +#define MAIN_MENU_H + +#include "config.h" + +// 主菜单和子菜单显示函数 + +/** + * @brief 显示主菜单 + * @details 显示学生成绩管理系统的主菜单界面，包括当前用户信息和可用功能选项 + * 根据用户权限动态显示菜单项（管理员可看到系统管理功能） + * @note 菜单选项： + * 1. 基本功能管理（所有用户） + * 2. 统计分析功能（所有用户） + * 3. 系统管理功能（仅管理员） + * 0. 退出系统 + */ +void displayMainMenu(); + +/** + * @brief 显示基本功能菜单 + * @details 显示学生信息管理的基本功能菜单，包括增删改查和排序功能 + * 同时显示当前系统中的学生总数 + * @note 菜单功能： + * 1. 添加学生信息 + * 2. 删除学生信息 + * 3. 修改学生信息 + * 4. 按学号查找学生 + * 5. 按姓名查找学生 + * 6. 显示所有学生 + * 7. 学生信息排序 + * 0. 返回主菜单 + */ +void displayBasicFunctionsMenu(); + +/** + * @brief 显示统计功能菜单 + * @details 显示统计分析功能菜单，提供各种数据统计和分析选项 + * 显示当前学生总数和系统平均分（如果有学生数据） + * @note 菜单功能： + * 1. 课程统计分析 + * 2. 成绩分布统计 + * 3. 分数段统计 + * 4. 综合统计分析 + * 0. 返回主菜单 + */ +void displayStatisticsMenu(); + +/** + * @brief 显示管理功能菜单 + * @details 显示系统管理功能菜单，仅管理员可访问 + * 提供用户账户管理功能，显示当前用户总数 + * @note 菜单功能： + * 1. 添加用户账户 + * 2. 删除用户账户 + * 3. 修改用户密码 + * 4. 查看所有用户 + * 0. 返回主菜单 + * @warning 此菜单仅限管理员用户访问 + */ +void displayAdminMenu(); + +#endif // MAIN_MENU_H \ No newline at end of file diff --git a/math_utils.c b/math_utils.c new file mode 100644 index 0000000..108040e --- /dev/null +++ b/math_utils.c @@ -0,0 +1,31 @@ +/** + * @file math_utils.c + * @brief 数学计算工具函数实现文件 + * @note 实现数学计算相关函数 + */ + +#include "math_utils.h" + +/** + * @brief 计算平均值 + * @details 计算浮点数数组的算术平均值 + * 遍历数组求和，然后除以元素个数 + * @param scores 浮点数数组 + * @param count 数组元素个数 + * @return 返回数组的平均值，如果count为0返回0.0 + * @note 如果count为0，函数返回0.0避免除零错误 + * @warning 如果scores为NULL且count>0，可能导致程序崩溃 + */ +float calculateAverage(float scores[], int count) +{ + if (count <= 0) + return 0.0; + + float sum = 0.0; + for (int i = 0; i < count; i++) + { + sum += scores[i]; + } + + return sum / count; +} \ No newline at end of file diff --git a/math_utils.h b/math_utils.h new file mode 100644 index 0000000..114f620 --- /dev/null +++ b/math_utils.h @@ -0,0 +1,22 @@ +/** + * @file math_utils.h + * @brief 数学计算工具函数头文件 + * @note 包含数学计算相关函数声明 + */ + +#ifndef MATH_UTILS_H +#define MATH_UTILS_H + +/** + * @brief 计算平均值 + * @details 计算浮点数数组的算术平均值 + * 遍历数组求和，然后除以元素个数 + * @param scores 浮点数数组 + * @param count 数组元素个数 + * @return 返回数组的平均值，如果count为0返回0.0 + * @note 如果count为0，函数返回0.0避免除零错误 + * @warning 如果scores为NULL且count>0，可能导致程序崩溃 + */ +float calculateAverage(float scores[], int count); + +#endif // MATH_UTILS_H \ No newline at end of file diff --git a/statistical_analysis.c b/statistical_analysis.c new file mode 100644 index 0000000..4b7fe76 --- /dev/null +++ b/statistical_analysis.c @@ -0,0 +1,841 @@ +/** + * @file statistical_analysis.c + * @brief 统计分析功能实现文件 + * @note 实现各种统计分析功能 + */ + +#include +#include +#include +#include +#include +#include "statistical_analysis.h" +#include "config.h" +#include "globals.h" +#include "io_utils.h" +#include "math_utils.h" +#include "student_io.h" +#include "student_crud.h" +#include "student_search.h" +#include "student_sort.h" + +/** + * @brief 显示课程统计信息 + * @details 统计并显示所有课程的详细信息，包括每门课程的人数、最高分、最低分、平均分和及格率 + * 自动收集系统中所有不重复的课程名称，并为每门课程计算统计数据 + * @note 显示内容包括： + * - 课程名称 + * - 选课人数 + * - 最高分、最低分、平均分 + * - 及格率（基于PASS_SCORE阈值） + * @warning 如果没有学生数据或课程数据，将显示相应警告信息 + */ +void displayCourseStatistics() +{ + clearScreen(); + printHeader("课程统计信息"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + // 收集所有课程名称 + char courses[MAX_STUDENTS * MAX_COURSES][MAX_COURSE_NAME_LENGTH]; + int courseCount = 0; + + for (int i = 0; i < studentCount; i++) + { + for (int j = 0; j < students[i].courseCount; j++) + { + bool exists = false; + for (int k = 0; k < courseCount; k++) + { + if (strcmp(courses[k], students[i].courses[j]) == 0) + { + exists = true; + break; + } + } + if (!exists) + { + strcpy(courses[courseCount], students[i].courses[j]); + courseCount++; + } + } + } + + if (courseCount == 0) + { + printWarning("暂无课程数据！"); + pauseSystem(); + return; + } + + printf("\n"); + printf("%-14s %-8s %-11s %-11s %-11s %-11s\n", + "课程名称", "人数", "最高分", "最低分", "平均分", "及格率"); + printf("========================================\n"); + + for (int i = 0; i < courseCount; i++) + { + CourseStats stats = calculateCourseStats(courses[i]); + printf("%-12s %-6d %-8.2f %-8.2f %-8.2f %-7.2f%%\n", + courses[i], stats.studentCount, stats.maxScore, + stats.minScore, stats.averageScore, stats.passRate); + } + + pauseSystem(); +} + +/** + * @brief 计算课程统计信息 + * @details 计算指定课程的详细统计数据，包括选课人数、分数统计和及格率 + * @param courseName 要统计的课程名称 + * @return CourseStats 包含课程统计信息的结构体 + * @note 统计内容包括： + * - studentCount: 选课学生数量 + * - maxScore, minScore: 最高分和最低分 + * - totalScore, averageScore: 总分和平均分 + * - passRate: 及格率（百分比） + * @warning 如果课程不存在，返回全零的统计结构体 + */ +CourseStats calculateCourseStats(const char *courseName) +{ + CourseStats stats = {0}; + float scores[MAX_STUDENTS]; + int count = 0; + + // 收集该课程的所有分数 + for (int i = 0; i < studentCount; i++) + { + for (int j = 0; j < students[i].courseCount; j++) + { + if (strcmp(students[i].courses[j], courseName) == 0) + { + scores[count] = students[i].scores[j]; + count++; + break; + } + } + } + + if (count == 0) + return stats; + + stats.studentCount = count; + stats.maxScore = scores[0]; + stats.minScore = scores[0]; + stats.totalScore = 0; + + int passCount = 0; + + for (int i = 0; i < count; i++) + { + if (scores[i] > stats.maxScore) + stats.maxScore = scores[i]; + if (scores[i] < stats.minScore) + stats.minScore = scores[i]; + stats.totalScore += scores[i]; + + if (scores[i] >= PASS_SCORE) + passCount++; + } + + stats.averageScore = stats.totalScore / count; + stats.passRate = (float)passCount / count * 100; + + return stats; +} + +/** + * @brief 显示分数分布 + * @details 统计并显示学生平均分的分布情况，按分数段进行分类统计 + * 显示各分数段的人数和百分比，以及总体及格情况 + * @note 分数段划分： + * - 90-100分：优秀 + * - 80-89分：良好 + * - 70-79分：中等 + * - 60-69分：及格 + * - 0-59分：不及格 + * @warning 如果没有学生数据，将显示警告信息 + */ +void displayScoreDistribution() +{ + clearScreen(); + printHeader("分数分布统计"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + // 使用缓存的分数分布数据 + ScoreDistribution dist = getCachedScoreDistribution(); + + printf("\n分数段分布：\n"); + printSeparator(); + printf("90-100分: %d人 (%.2f%%)\n", dist.excellent, + (float)dist.excellent / studentCount * 100); + printf("80-89分: %d人 (%.2f%%)\n", dist.good, + (float)dist.good / studentCount * 100); + printf("70-79分: %d人 (%.2f%%)\n", dist.medium, + (float)dist.medium / studentCount * 100); + printf("60-69分: %d人 (%.2f%%)\n", dist.pass, + (float)dist.pass / studentCount * 100); + printf("0-59分: %d人 (%.2f%%)\n", dist.fail, + (float)dist.fail / studentCount * 100); + + printf("\n总体统计：\n"); + printf("总人数: %d\n", studentCount); + printf("及格人数: %d (%.2f%%)\n", + studentCount - dist.fail, + (float)(studentCount - dist.fail) / studentCount * 100); + printf("不及格人数: %d (%.2f%%)\n", + dist.fail, (float)dist.fail / studentCount * 100); + + pauseSystem(); +} + +/** + * @brief 计算分数分布 + * @details 根据学生的平均分计算各分数段的人数分布 + * @return ScoreDistribution 包含各分数段人数的结构体 + * @note 分数段定义： + * - excellent: 90-100分 + * - good: 80-89分 + * - medium: 70-79分 + * - pass: 60-69分 + * - fail: 0-59分 + */ +ScoreDistribution calculateScoreDistribution() +{ + ScoreDistribution dist = {0}; + + for (int i = 0; i < studentCount; i++) + { + float avgScore = students[i].averageScore; + + if (avgScore >= 90) + { + dist.excellent++; + } + else if (avgScore >= 80) + { + dist.good++; + } + else if (avgScore >= 70) + { + dist.medium++; + } + else if (avgScore >= 60) + { + dist.pass++; + } + else + { + dist.fail++; + } + } + + return dist; +} + +/** + * @brief 显示学生排名 + * @details 按学生平均分进行降序排序，显示学生排名列表 + * 包括排名、学号、姓名、总分和平均分信息 + * @note 排序规则：按平均分从高到低排序 + * @note 显示格式：排名 | 学号 | 姓名 | 总分 | 平均分 + * @warning 如果没有学生数据，将显示警告信息 + */ +void displayStudentRanking() +{ + clearScreen(); + printHeader("学生排名"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + // 使用缓存的排名数据 + StudentRank rankings[MAX_STUDENTS]; + int rankingCount = getCachedStudentRankings(rankings); + + printf("\n"); + // 调整中文表头的对齐格式，考虑中文字符的显示宽度 + printf("%-7s %-12s %-12s %-10s %-8s\n", + "排名", "学号", "姓名", "总分", "平均分"); + printf("==========================================\n"); + + for (int i = 0; i < rankingCount; i++) + { + int idx = rankings[i].studentIndex; + printf("%-5d %-10s %-12s %-8.2f %-8.2f\n", + i + 1, + students[idx].studentID, + students[idx].name, + students[idx].totalScore, + students[idx].averageScore); + } + + pauseSystem(); +} + +/** + * @brief 显示系统总体统计 + * @details 显示系统的综合统计信息，包括学生信息统计、成绩统计和课程统计 + * 提供系统整体数据的全面概览 + * @note 统计内容包括： + * - 学生信息：总数、性别分布、平均年龄 + * - 成绩统计：最高/最低/平均分、标准差 + * - 课程统计：总课程数、平均课程数 + * @warning 如果没有学生数据，将显示警告信息 + */ +void displayOverallStatistics() +{ + clearScreen(); + printHeader("系统总体统计"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + // 使用缓存的总体统计数据 + OverallStats stats = getCachedOverallStats(); + + printf("\n学生信息统计：\n"); + printSeparator(); + printf("总学生数: %d\n", stats.totalStudents); + printf("男学生数: %d (%.2f%%)\n", stats.maleCount, + (float)stats.maleCount / stats.totalStudents * 100); + printf("女学生数: %d (%.2f%%)\n", stats.femaleCount, + (float)stats.femaleCount / stats.totalStudents * 100); + printf("平均年龄: %.1f岁\n", stats.averageAge); + + printf("\n成绩统计：\n"); + printSeparator(); + printf("最高平均分: %.2f\n", stats.highestAverage); + printf("最低平均分: %.2f\n", stats.lowestAverage); + printf("全体平均分: %.2f\n", stats.overallAverageScore); + printf("标准差: %.2f\n", stats.standardDeviation); + + printf("\n课程统计：\n"); + printSeparator(); + printf("总课程数: %d\n", stats.totalCourses); + printf("平均课程数/人: %.1f\n", stats.averageCoursesPerStudent); + + pauseSystem(); +} + +/** + * @brief 计算系统总体统计 + * @details 计算系统的综合统计数据，包括学生、成绩和课程的各项统计指标 + * @return OverallStats 包含系统总体统计信息的结构体 + * @note 计算内容包括： + * - 学生统计：总数、性别分布、平均年龄 + * - 成绩统计：最高/最低/平均分、标准差 + * - 课程统计：总课程数、人均课程数 + * @note 标准差计算使用总体标准差公式 + */ +OverallStats calculateOverallStats() +{ + OverallStats stats = {0}; + + if (studentCount == 0) + return stats; + + stats.totalStudents = studentCount; + + float totalAge = 0; + float totalAverage = 0; + int totalCourseCount = 0; + + // 收集所有课程名称 + char courses[MAX_STUDENTS * MAX_COURSES][MAX_COURSE_NAME_LENGTH]; + int uniqueCourseCount = 0; + + stats.highestAverage = students[0].averageScore; + stats.lowestAverage = students[0].averageScore; + + for (int i = 0; i < studentCount; i++) + { + // 性别统计 + if (students[i].gender == GENDER_MALE) + { + stats.maleCount++; + } + else if (students[i].gender == GENDER_FEMALE) + { + stats.femaleCount++; + } + + // 年龄统计 + totalAge += students[i].age; + + // 成绩统计 + totalAverage += students[i].averageScore; + totalCourseCount += students[i].courseCount; + + if (students[i].averageScore > stats.highestAverage) + { + stats.highestAverage = students[i].averageScore; + } + if (students[i].averageScore < stats.lowestAverage) + { + stats.lowestAverage = students[i].averageScore; + } + + // 课程统计 + for (int j = 0; j < students[i].courseCount; j++) + { + bool exists = false; + for (int k = 0; k < uniqueCourseCount; k++) + { + if (strcmp(courses[k], students[i].courses[j]) == 0) + { + exists = true; + break; + } + } + if (!exists) + { + strcpy(courses[uniqueCourseCount], students[i].courses[j]); + uniqueCourseCount++; + } + } + } + + stats.averageAge = totalAge / studentCount; + stats.overallAverageScore = totalAverage / studentCount; + stats.totalCourses = uniqueCourseCount; + stats.averageCoursesPerStudent = (float)totalCourseCount / studentCount; + + // 计算标准差 + float variance = 0; + for (int i = 0; i < studentCount; i++) + { + float diff = students[i].averageScore - stats.overallAverageScore; + variance += diff * diff; + } + variance /= studentCount; + stats.standardDeviation = sqrt(variance); + + return stats; +} + +/** + * @brief 查找最高分学生 + * @details 查找并显示平均分最高的学生信息 + * 遍历所有学生，找出平均分最高者并显示其详细信息 + * @note 比较依据：学生的平均分（averageScore） + * @warning 如果没有学生数据，将显示警告信息 + */ +void findTopStudent() +{ + clearScreen(); + printHeader("最高分学生"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + int topIndex = 0; + for (int i = 1; i < studentCount; i++) + { + if (students[i].averageScore > students[topIndex].averageScore) + { + topIndex = i; + } + } + + printf("\n最高平均分学生：\n"); + displayStudentInfo(&students[topIndex]); + + pauseSystem(); +} + +/** + * @brief 查找最低分学生 + * @details 查找并显示平均分最低的学生信息 + * 遍历所有学生，找出平均分最低者并显示其详细信息 + * @note 比较依据：学生的平均分（averageScore） + * @warning 如果没有学生数据，将显示警告信息 + */ +void findBottomStudent() +{ + clearScreen(); + printHeader("最低分学生"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + int bottomIndex = 0; + for (int i = 1; i < studentCount; i++) + { + if (students[i].averageScore < students[bottomIndex].averageScore) + { + bottomIndex = i; + } + } + + printf("\n最低平均分学生：\n"); + displayStudentInfo(&students[bottomIndex]); + + pauseSystem(); +} + +/** + * @brief 按课程查找最高分 + * @details 在指定课程中查找并显示最高分学生的信息 + * 用户输入课程名称，系统查找该课程的最高分获得者 + * @note 查找过程： + * 1. 用户输入课程名称 + * 2. 遍历所有学生的该课程成绩 + * 3. 找出最高分及对应学生 + * 4. 显示学生信息和分数 + * @warning 如果课程不存在，将显示错误信息 + */ +void findTopScoreInCourse() +{ + clearScreen(); + printHeader("课程最高分查询"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + char courseName[MAX_COURSE_NAME_LENGTH]; + printf("\n"); + safeInputString("请输入课程名称", courseName, MAX_COURSE_NAME_LENGTH); + + float maxScore = -1; + int maxIndex = -1; + + for (int i = 0; i < studentCount; i++) + { + for (int j = 0; j < students[i].courseCount; j++) + { + if (strcmp(students[i].courses[j], courseName) == 0) + { + if (students[i].scores[j] > maxScore) + { + maxScore = students[i].scores[j]; + maxIndex = i; + } + } + } + } + + if (maxIndex == -1) + { + printError("未找到该课程！"); + } + else + { + printf("\n课程 \"%s\" 最高分：\n", courseName); + printSeparator(); + printf("学号: %s\n", students[maxIndex].studentID); + printf("姓名: %s\n", students[maxIndex].name); + printf("分数: %.2f\n", maxScore); + } + + pauseSystem(); +} + +/** + * @brief 计算学生统计信息 + * @details 计算指定学生的总分和平均分 + * 根据学生的所有课程成绩计算统计数据 + * @param student 指向要计算统计信息的学生结构体的指针 + * @note 计算内容： + * - totalScore: 所有课程成绩的总和 + * - averageScore: 平均成绩（总分/课程数） + * @note 如果学生没有课程，总分和平均分都设为0 + * @warning 传入的student指针不能为NULL + */ +void calculateStudentStats(Student *student) +{ + if (student->courseCount == 0) + { + student->totalScore = 0; + student->averageScore = 0; + return; + } + + student->totalScore = 0; + for (int i = 0; i < student->courseCount; i++) + { + student->totalScore += student->scores[i]; + } + + student->averageScore = student->totalScore / student->courseCount; +} + +/** + * @brief 更新全局统计缓存 + * @details 更新系统的全局统计缓存变量，包括全体平均分、最高分和最低分 + * 当学生数据发生变化时调用此函数更新缓存 + * @note 更新的全局变量： + * - overallAverageScore: 全体学生平均分 + * - highestScore: 最高平均分 + * - lowestScore: 最低平均分 + * - statsNeedUpdate: 统计更新标志（设为false） + * @note 如果没有学生数据，所有统计值都设为0 + * @see overallAverageScore, highestScore, lowestScore, statsNeedUpdate + */ +void updateGlobalStats() +{ + if (studentCount == 0) + { + overallAverageScore = 0; + highestScore = 0; + lowestScore = 0; + statsNeedUpdate = false; + return; + } + + float total = 0; + highestScore = students[0].averageScore; + lowestScore = students[0].averageScore; + + for (int i = 0; i < studentCount; i++) + { + total += students[i].averageScore; + + if (students[i].averageScore > highestScore) + { + highestScore = students[i].averageScore; + } + if (students[i].averageScore < lowestScore) + { + lowestScore = students[i].averageScore; + } + } + + overallAverageScore = total / studentCount; + statsNeedUpdate = false; + + // 使统计缓存无效 + invalidateCache(); +} + +// ==================== 缓存管理函数实现 ==================== + +/** + * @brief 初始化统计缓存 + * @details 初始化统计缓存系统，清空所有缓存数据 + * @note 在系统启动时调用，确保缓存处于干净状态 + */ +// 快速排序辅助函数：分区 +int partitionRankings(StudentRank arr[], int low, int high) { + float pivot = arr[high].averageScore; + int i = (low - 1); + + for (int j = low; j <= high - 1; j++) { + // 降序排列：如果当前元素大于等于基准值 + if (arr[j].averageScore >= pivot) { + i++; + StudentRank temp = arr[i]; + arr[i] = arr[j]; + arr[j] = temp; + } + } + StudentRank temp = arr[i + 1]; + arr[i + 1] = arr[high]; + arr[high] = temp; + return (i + 1); +} + +// 快速排序主函数 +void quickSortRankings(StudentRank arr[], int low, int high) { + if (low < high) { + int pi = partitionRankings(arr, low, high); + quickSortRankings(arr, low, pi - 1); + quickSortRankings(arr, pi + 1, high); + } +} + +void initStatisticsCache() +{ + statsCache.isValid = false; + statsCache.lastStudentCount = 0; + statsCache.lastDataHash = 0; + memset(&statsCache.overallStats, 0, sizeof(OverallStats)); + memset(&statsCache.scoreDistribution, 0, sizeof(ScoreDistribution)); + memset(statsCache.rankings, 0, sizeof(statsCache.rankings)); +} + +/** + * @brief 检查缓存是否有效 + * @details 检查统计缓存是否仍然有效，通过比较学生数量和数据哈希值 + * @return bool 如果缓存有效返回true，否则返回false + * @note 当学生数据发生变化时，缓存会被标记为无效 + */ +bool isCacheValid() +{ + if (!statsCache.isValid) { + return false; + } + + // 检查学生数量是否变化 + if (statsCache.lastStudentCount != studentCount) { + return false; + } + + // 检查数据哈希值是否变化 + unsigned long currentHash = calculateDataHash(); + if (statsCache.lastDataHash != currentHash) { + return false; + } + + return true; +} + +/** + * @brief 更新统计缓存 + * @details 重新计算并更新所有统计缓存数据 + * @note 当缓存无效时调用，重新计算所有统计信息并更新缓存 + * @note 包括总体统计、分数分布和学生排名的缓存更新 + */ +void updateStatisticsCache() +{ + if (studentCount == 0) { + initStatisticsCache(); + return; + } + + // 更新总体统计缓存 + statsCache.overallStats = calculateOverallStats(); + + // 更新分数分布缓存 + statsCache.scoreDistribution = calculateScoreDistribution(); + + // 更新学生排名缓存 + for (int i = 0; i < studentCount; i++) { + statsCache.rankings[i].studentIndex = i; + statsCache.rankings[i].averageScore = students[i].averageScore; + statsCache.rankings[i].totalScore = students[i].totalScore; + } + + // 使用快速排序按平均分排序（降序） + quickSortRankings(statsCache.rankings, 0, studentCount - 1); + + // 更新缓存状态 + statsCache.isValid = true; + statsCache.lastStudentCount = studentCount; + statsCache.lastDataHash = calculateDataHash(); +} + +/** + * @brief 使缓存无效 + * @details 将统计缓存标记为无效，强制下次访问时重新计算 + * @note 当学生数据被修改时调用，确保统计数据的准确性 + */ +void invalidateCache() +{ + statsCache.isValid = false; +} + +/** + * @brief 计算数据哈希值 + * @details 计算当前学生数据的哈希值，用于检测数据变化 + * @return unsigned long 当前数据的哈希值 + * @note 基于学生数量、学号、成绩等关键数据计算哈希值 + */ +unsigned long calculateDataHash() +{ + unsigned long hash = 5381; // DJB2 哈希算法初始值 + + // 包含学生数量 + hash = ((hash << 5) + hash) + studentCount; + + for (int i = 0; i < studentCount; i++) { + // 包含学号 + for (int j = 0; students[i].studentID[j] != '\0'; j++) { + hash = ((hash << 5) + hash) + students[i].studentID[j]; + } + + // 包含总分和平均分 + hash = ((hash << 5) + hash) + (unsigned long)(students[i].totalScore * 100); + hash = ((hash << 5) + hash) + (unsigned long)(students[i].averageScore * 100); + + // 包含课程数量 + hash = ((hash << 5) + hash) + students[i].courseCount; + + // 包含各科成绩 + for (int j = 0; j < students[i].courseCount; j++) { + hash = ((hash << 5) + hash) + (unsigned long)(students[i].scores[j] * 100); + } + } + + return hash; +} + +/** + * @brief 获取缓存的总体统计 + * @details 获取缓存的总体统计数据，如果缓存无效则先更新缓存 + * @return OverallStats 总体统计数据 + * @note 优先使用缓存数据，提高查询效率 + */ +OverallStats getCachedOverallStats() +{ + if (!isCacheValid()) { + updateStatisticsCache(); + } + return statsCache.overallStats; +} + +/** + * @brief 获取缓存的分数分布 + * @details 获取缓存的分数分布数据，如果缓存无效则先更新缓存 + * @return ScoreDistribution 分数分布数据 + * @note 优先使用缓存数据，避免重复计算 + */ +ScoreDistribution getCachedScoreDistribution() +{ + if (!isCacheValid()) { + updateStatisticsCache(); + } + return statsCache.scoreDistribution; +} + +/** + * @brief 获取缓存的学生排名 + * @details 获取缓存的学生排名数据，如果缓存无效则先更新缓存 + * @param rankings 输出参数，存储排名数据的数组 + * @return int 返回排名数据的数量 + * @note 排名按平均分降序排列，优先使用缓存数据 + */ +int getCachedStudentRankings(StudentRank* rankings) +{ + if (!isCacheValid()) { + updateStatisticsCache(); + } + + if (rankings != NULL && studentCount > 0) { + memcpy(rankings, statsCache.rankings, studentCount * sizeof(StudentRank)); + } + + return studentCount; +} \ No newline at end of file diff --git a/statistical_analysis.h b/statistical_analysis.h new file mode 100644 index 0000000..03d9143 --- /dev/null +++ b/statistical_analysis.h @@ -0,0 +1,250 @@ +/** + * @file statistical_analysis.h + * @brief 统计分析功能头文件 + * @note 包含各种统计分析功能的函数声明 + */ + +#ifndef STATISTICAL_ANALYSIS_H +#define STATISTICAL_ANALYSIS_H + +#include "types.h" + +// 主要统计分析函数 + +/** + * @brief 显示课程统计信息 + * @details 统计并显示所有课程的详细信息，包括每门课程的人数、最高分、最低分、平均分和及格率 + * 自动收集系统中所有不重复的课程名称，并为每门课程计算统计数据 + * @note 显示内容包括： + * - 课程名称 + * - 选课人数 + * - 最高分、最低分、平均分 + * - 及格率（基于PASS_SCORE阈值） + * @warning 如果没有学生数据或课程数据，将显示相应警告信息 + */ +void displayCourseStatistics(); + +/** + * @brief 显示分数分布 + * @details 统计并显示学生平均分的分布情况，按分数段进行分类统计 + * 显示各分数段的人数和百分比，以及总体及格情况 + * @note 分数段划分： + * - 90-100分：优秀 + * - 80-89分：良好 + * - 70-79分：中等 + * - 60-69分：及格 + * - 0-59分：不及格 + * @warning 如果没有学生数据，将显示警告信息 + */ +void displayScoreDistribution(); + +/** + * @brief 显示学生排名 + * @details 按学生平均分进行降序排序，显示学生排名列表 + * 包括排名、学号、姓名、总分和平均分信息 + * @note 排序规则：按平均分从高到低排序 + * @note 显示格式：排名 | 学号 | 姓名 | 总分 | 平均分 + * @warning 如果没有学生数据，将显示警告信息 + */ +void displayStudentRanking(); + +/** + * @brief 显示系统总体统计 + * @details 显示系统的综合统计信息，包括学生信息统计、成绩统计和课程统计 + * 提供系统整体数据的全面概览 + * @note 统计内容包括： + * - 学生信息：总数、性别分布、平均年龄 + * - 成绩统计：最高/最低/平均分、标准差 + * - 课程统计：总课程数、平均课程数 + * @warning 如果没有学生数据，将显示警告信息 + */ +void displayOverallStatistics(); + +// 查找功能 + +/** + * @brief 查找最高分学生 + * @details 查找并显示平均分最高的学生信息 + * 遍历所有学生，找出平均分最高者并显示其详细信息 + * @note 比较依据：学生的平均分（averageScore） + * @warning 如果没有学生数据，将显示警告信息 + */ +void findTopStudent(); + +/** + * @brief 查找最低分学生 + * @details 查找并显示平均分最低的学生信息 + * 遍历所有学生，找出平均分最低者并显示其详细信息 + * @note 比较依据：学生的平均分（averageScore） + * @warning 如果没有学生数据，将显示警告信息 + */ +void findBottomStudent(); + +/** + * @brief 按课程查找最高分 + * @details 在指定课程中查找并显示最高分学生的信息 + * 用户输入课程名称，系统查找该课程的最高分获得者 + * @note 查找过程： + * 1. 用户输入课程名称 + * 2. 遍历所有学生的该课程成绩 + * 3. 找出最高分及对应学生 + * 4. 显示学生信息和分数 + * @warning 如果课程不存在，将显示错误信息 + */ +void findTopScoreInCourse(); + +// 计算函数 + +/** + * @brief 计算课程统计信息 + * @details 计算指定课程的详细统计数据，包括选课人数、分数统计和及格率 + * @param courseName 要统计的课程名称 + * @return CourseStats 包含课程统计信息的结构体 + * @note 统计内容包括： + * - studentCount: 选课学生数量 + * - maxScore, minScore: 最高分和最低分 + * - totalScore, averageScore: 总分和平均分 + * - passRate: 及格率（百分比） + * @warning 如果课程不存在，返回全零的统计结构体 + */ +CourseStats calculateCourseStats(const char* courseName); + +/** + * @brief 计算分数分布 + * @details 根据学生的平均分计算各分数段的人数分布 + * @return ScoreDistribution 包含各分数段人数的结构体 + * @note 分数段定义： + * - excellent: 90-100分 + * - good: 80-89分 + * - medium: 70-79分 + * - pass: 60-69分 + * - fail: 0-59分 + */ +ScoreDistribution calculateScoreDistribution(); + +/** + * @brief 计算系统总体统计 + * @details 计算系统的综合统计数据，包括学生、成绩和课程的各项统计指标 + * @return OverallStats 包含系统总体统计信息的结构体 + * @note 计算内容包括： + * - 学生统计：总数、性别分布、平均年龄 + * - 成绩统计：最高/最低/平均分、标准差 + * - 课程统计：总课程数、人均课程数 + * @note 标准差计算使用总体标准差公式 + */ +OverallStats calculateOverallStats(); + +/** + * @brief 计算学生统计信息 + * @details 计算指定学生的总分和平均分 + * 根据学生的所有课程成绩计算统计数据 + * @param student 指向要计算统计信息的学生结构体的指针 + * @note 计算内容： + * - totalScore: 所有课程成绩的总和 + * - averageScore: 平均成绩（总分/课程数） + * @note 如果学生没有课程，总分和平均分都设为0 + * @warning 传入的student指针不能为NULL + */ +void calculateStudentStats(Student* student); + +/** + * @brief 更新全局统计缓存 + * @details 更新系统的全局统计缓存变量，包括全体平均分、最高分和最低分 + * 当学生数据发生变化时调用此函数更新缓存 + * @note 更新的全局变量： + * - overallAverageScore: 全体学生平均分 + * - highestScore: 最高平均分 + * - lowestScore: 最低平均分 + * - statsNeedUpdate: 统计更新标志（设为false） + * @note 如果没有学生数据，所有统计值都设为0 + * @see overallAverageScore, highestScore, lowestScore, statsNeedUpdate + */ +void updateGlobalStats(); + +// 缓存管理函数 + +/** + * @brief 初始化统计缓存 + * @details 初始化统计缓存系统，清空所有缓存数据 + * @note 在系统启动时调用，确保缓存处于干净状态 + */ +void initStatisticsCache(); + +/** + * @brief 检查缓存是否有效 + * @details 检查统计缓存是否仍然有效，通过比较学生数量和数据哈希值 + * @return bool 如果缓存有效返回true，否则返回false + * @note 当学生数据发生变化时，缓存会被标记为无效 + */ +bool isCacheValid(); + +/** + * @brief 更新统计缓存 + * @details 重新计算并更新所有统计缓存数据 + * @note 当缓存无效时调用，重新计算所有统计信息并更新缓存 + * @note 包括总体统计、分数分布和学生排名的缓存更新 + */ +void updateStatisticsCache(); + +/** + * @brief 使缓存无效 + * @details 将统计缓存标记为无效，强制下次访问时重新计算 + * @note 当学生数据被修改时调用，确保统计数据的准确性 + */ +void invalidateCache(); + +/** + * @brief 计算数据哈希值 + * @details 计算当前学生数据的哈希值，用于检测数据变化 + * @return unsigned long 当前数据的哈希值 + * @note 基于学生数量、学号、成绩等关键数据计算哈希值 + */ +unsigned long calculateDataHash(); + +/** + * @brief 获取缓存的总体统计 + * @details 获取缓存的总体统计数据，如果缓存无效则先更新缓存 + * @return OverallStats 总体统计数据 + * @note 优先使用缓存数据，提高查询效率 + */ +OverallStats getCachedOverallStats(); + +/** + * @brief 获取缓存的分数分布 + * @details 获取缓存的分数分布数据，如果缓存无效则先更新缓存 + * @return ScoreDistribution 分数分布数据 + * @note 优先使用缓存数据，避免重复计算 + */ +ScoreDistribution getCachedScoreDistribution(); + +/** + * @brief 获取缓存的学生排名 + * @details 获取缓存的学生排名数据，如果缓存无效则先更新缓存 + * @param rankings 输出参数，存储排名数据的数组 + * @return int 返回排名数据的数量 + * @note 排名按平均分降序排列，优先使用缓存数据 + */ +int getCachedStudentRankings(StudentRank* rankings); + +// 排序优化函数 + +/** + * @brief 快速排序分区函数 + * @details 对学生排名数组进行分区操作，用于快速排序 + * @param arr 要分区的学生排名数组 + * @param low 分区的起始索引 + * @param high 分区的结束索引 + * @return int 分区点的索引 + */ +int partitionRankings(StudentRank arr[], int low, int high); + +/** + * @brief 快速排序函数 + * @details 对学生排名数组按平均分进行快速排序（降序） + * @param arr 要排序的学生排名数组 + * @param low 排序的起始索引 + * @param high 排序的结束索引 + */ +void quickSortRankings(StudentRank arr[], int low, int high); + +#endif // STATISTICAL_ANALYSIS_H \ No newline at end of file diff --git a/string_utils.c b/string_utils.c new file mode 100644 index 0000000..4375fe4 --- /dev/null +++ b/string_utils.c @@ -0,0 +1,76 @@ +/** + * @file string_utils.c + * @brief 字符串处理工具函数实现文件 + * @note 实现字符串操作相关函数 + */ + +#include +#include +#include +#include "string_utils.h" + +/** + * @brief 去除字符串首尾空白字符 + * @details 移除字符串开头和结尾的空格、制表符、换行符等空白字符 + * 使用双指针技术，从两端向中间处理，原地修改字符串 + * @param str 要处理的字符串，函数会直接修改此字符串 + * @note 函数会直接修改传入的字符串，不会分配新内存 + * @note 如果整个字符串都是空白字符，结果将是空字符串 + * @warning 如果str为NULL，可能导致程序崩溃 + */ +void trimString(char *str) +{ + if (str == NULL) + return; + + // 去除开头的空白字符 + char *start = str; + while (isspace((unsigned char)*start)) + { + start++; + } + + // 如果字符串全是空白字符 + if (*start == '\0') + { + str[0] = '\0'; + return; + } + + // 去除结尾的空白字符 + char *end = str + strlen(str) - 1; + while (end > start && isspace((unsigned char)*end)) + { + end--; + } + + // 移动字符串到开头 + int len = end - start + 1; + memmove(str, start, len); + str[len] = '\0'; +} + +/** + * @brief 检查字符串是否为空 + * @details 检查字符串是否为NULL、空字符串或只包含空白字符 + * 使用isspace函数检查每个字符是否为空白字符 + * @param str 要检查的字符串 + * @return 如果字符串为空或只包含空白字符返回true，否则返回false + * @note 空白字符包括空格、制表符、换行符等 + * @note 如果str为NULL，返回true + */ +bool isEmptyString(const char *str) +{ + if (str == NULL) + return true; + + while (*str) + { + if (!isspace((unsigned char)*str)) + { + return false; + } + str++; + } + return true; +} \ No newline at end of file diff --git a/string_utils.h b/string_utils.h new file mode 100644 index 0000000..172653e --- /dev/null +++ b/string_utils.h @@ -0,0 +1,34 @@ +/** + * @file string_utils.h + * @brief 字符串处理工具函数头文件 + * @note 包含字符串操作相关函数声明 + */ + +#ifndef STRING_UTILS_H +#define STRING_UTILS_H + +#include + +/** + * @brief 去除字符串首尾空白字符 + * @details 移除字符串开头和结尾的空格、制表符、换行符等空白字符 + * 使用双指针技术，从两端向中间处理，原地修改字符串 + * @param str 要处理的字符串，函数会直接修改此字符串 + * @note 函数会直接修改传入的字符串，不会分配新内存 + * @note 如果整个字符串都是空白字符，结果将是空字符串 + * @warning 如果str为NULL，可能导致程序崩溃 + */ +void trimString(char* str); + +/** + * @brief 检查字符串是否为空 + * @details 检查字符串是否为NULL、空字符串或只包含空白字符 + * 使用isspace函数检查每个字符是否为空白字符 + * @param str 要检查的字符串 + * @return 如果字符串为空或只包含空白字符返回true，否则返回false + * @note 空白字符包括空格、制表符、换行符等 + * @note 如果str为NULL，返回true + */ +bool isEmptyString(const char* str); + +#endif // STRING_UTILS_H \ No newline at end of file diff --git a/student_crud.c b/student_crud.c new file mode 100644 index 0000000..d9a86fd --- /dev/null +++ b/student_crud.c @@ -0,0 +1,508 @@ +/** + * @file student_crud.c + * @brief 学生数据增删改操作实现 + * @note 负责学生信息的添加、删除、修改等CRUD操作 + */ + +#include +#include +#include +#include "config.h" +#include "globals.h" +#include "io_utils.h" +#include "validation.h" +#include "statistical_analysis.h" + +/** + * @brief 输入并验证学生学号 + * @details 循环输入学号直到格式正确且不重复 + * @param student 指向要填充的学生结构体的指针 + */ +static void inputStudentID(Student *student) +{ + while (1) + { + safeInputString("请输入学号", student->studentID, MAX_ID_LENGTH); + + if (!isValidStudentId(student->studentID)) + { + printError("学号格式无效！"); + continue; + } + + // 检查学号是否已存在 + bool exists = false; + for (int i = 0; i < studentCount; i++) + { + if (strcmp(students[i].studentID, student->studentID) == 0) + { + printError("学号已存在！"); + exists = true; + break; + } + } + + if (!exists) + break; + } +} + +/** + * @brief 输入并验证学生基本信息 + * @details 输入学生的姓名、年龄和性别信息 + * @param student 指向要填充的学生结构体的指针 + */ +static void inputBasicInfo(Student *student) +{ + // 输入姓名 + while (1) + { + safeInputString("请输入姓名", student->name, MAX_NAME_LENGTH); + if (isValidName(student->name)) + break; + printError("姓名格式无效！"); + } + + // 输入年龄 + student->age = safeInputInt("请输入年龄", 10, 100); + + // 输入性别 + while (1) + { + printf("请输入性别 (M/F): "); + char gender; + scanf(" %c", &gender); + clearInputBuffer(); + + if (isValidGender(gender)) + { + student->gender = gender; + break; + } + printError("性别输入无效！请输入 M 或 F"); + } +} + +/** + * @brief 输入学生课程信息 + * @details 循环输入课程名称和成绩，支持添加多门课程 + * @param student 指向要填充的学生结构体的指针 + */ +static void inputCourseInfo(Student *student) +{ + printf("\n开始输入课程信息：\n"); + student->courseCount = 0; + + while (student->courseCount < MAX_COURSES) + { + printf("\n第 %d 门课程：\n", student->courseCount + 1); + + safeInputString("课程名称", + student->courses[student->courseCount], + MAX_COURSE_NAME_LENGTH); + + student->scores[student->courseCount] = + safeInputFloat("课程分数", MIN_SCORE, MAX_SCORE); + + student->courseCount++; + + if (student->courseCount < MAX_COURSES) + { + printf("\n是否继续添加课程？(y/n): "); + char choice; + scanf(" %c", &choice); + clearInputBuffer(); + + if (choice != 'y' && choice != 'Y') + { + break; + } + } + } +} + +/** + * @brief 显示添加成功的学生信息 + * @details 显示新添加学生的基本信息和统计数据 + * @param student 指向学生结构体的指针 + */ +static void displayAddedStudentInfo(const Student *student) +{ + printSuccess("学生信息添加成功！"); + printf("学号: %s\n", student->studentID); + printf("姓名: %s\n", student->name); + printf("总分: %.2f\n", student->totalScore); + printf("平均分: %.2f\n", student->averageScore); +} + +/** + * @brief 添加学生信息 + * @details 交互式地添加新学生信息，包括基本信息和课程成绩 + * 验证学号唯一性、姓名格式、年龄范围等 + * 自动计算总分和平均分 + * @note 会检查学生数量是否已达上限MAX_STUDENTS + * @note 学号必须唯一，不能与现有学生重复 + * @warning 如果学生数量已满，会显示错误信息并返回 + * @see MAX_STUDENTS, isValidStudentId(), isValidName() + */ +void addStudent() +{ + clearScreen(); + printHeader("添加学生信息"); + + if (studentCount >= MAX_STUDENTS) + { + printError("学生数量已达上限！"); + pauseSystem(); + return; + } + + Student newStudent; + memset(&newStudent, 0, sizeof(Student)); + + printf("\n"); + + // 输入学号 + inputStudentID(&newStudent); + + // 输入基本信息 + inputBasicInfo(&newStudent); + + // 输入课程信息 + inputCourseInfo(&newStudent); + + // 计算总分和平均分 + calculateStudentStats(&newStudent); + + // 添加到数组 + students[studentCount] = newStudent; + studentCount++; + + // 标记数据已修改 + dataModified = true; + statsNeedUpdate = true; + + // 使统计缓存无效 + invalidateCache(); + + // 显示添加成功信息 + displayAddedStudentInfo(&newStudent); + + pauseSystem(); +} + +/** + * @brief 删除学生信息 + * @details 提供交互式界面删除指定学号的学生信息 + * 包含确认机制，防止误删除操作 + * @note 删除流程： + * 1. 输入要删除的学生学号 + * 2. 查找并显示学生信息 + * 3. 用户确认删除操作 + * 4. 删除学生并重新排列数组 + * 5. 更新数据修改和统计更新标志 + * @warning 删除操作不可逆，请谨慎操作 + * @warning 如果没有学生数据，将显示警告信息 + */ +void deleteStudent() +{ + clearScreen(); + printHeader("删除学生信息"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + char studentID[MAX_ID_LENGTH]; + printf("\n"); + safeInputString("请输入要删除的学生学号", studentID, MAX_ID_LENGTH); + + // 查找学生 + for (int i = 0; i < studentCount; i++) + { + if (strcmp(students[i].studentID, studentID) == 0) + { + printf("\n找到学生信息：\n"); + printf("学号: %s\n", students[i].studentID); + printf("姓名: %s\n", students[i].name); + + printf("\n确认删除？(y/n): "); + char choice; + scanf(" %c", &choice); + clearInputBuffer(); + + if (choice == 'y' || choice == 'Y') + { + // 移动后面的学生向前 + for (int j = i; j < studentCount - 1; j++) + { + students[j] = students[j + 1]; + } + studentCount--; + + dataModified = true; + statsNeedUpdate = true; + + // 使统计缓存无效 + invalidateCache(); + + printSuccess("学生信息删除成功！"); + } + else + { + printInfo("删除操作已取消。"); + } + + pauseSystem(); + return; + } + } + + printError("未找到该学号的学生！"); + pauseSystem(); +} + +/** + * @brief 显示学生基本信息 + * @details 显示学生的学号、姓名、年龄、性别等基本信息 + * @param student 指向学生结构体的指针 + */ +static void displayStudentBasicInfo(const Student *student) +{ + printf("\n找到学生信息：\n"); + printf("学号: %s\n", student->studentID); + printf("姓名: %s\n", student->name); + printf("年龄: %d\n", student->age); + printf("性别: %c\n", student->gender); +} + +/** + * @brief 修改学生性别 + * @details 循环输入直到获得有效的性别值 + * @param student 指向学生结构体的指针 + */ +static void modifyStudentGender(Student *student) +{ + while (1) + { + printf("请输入新性别 (M/F): "); + char gender; + scanf(" %c", &gender); + clearInputBuffer(); + + if (isValidGender(gender)) + { + student->gender = gender; + break; + } + printError("性别输入无效！"); + } +} + +/** + * @brief 修改现有课程成绩 + * @details 选择并修改学生的现有课程成绩 + * @param student 指向学生结构体的指针 + */ +static void modifyExistingCourse(Student *student) +{ + if (student->courseCount == 0) + { + printWarning("该学生没有课程记录！"); + return; + } + + int courseIndex = safeInputInt("请选择要修改的课程", 1, student->courseCount) - 1; + student->scores[courseIndex] = safeInputFloat("新成绩", MIN_SCORE, MAX_SCORE); +} + +/** + * @brief 添加新课程 + * @details 为学生添加新的课程和成绩 + * @param student 指向学生结构体的指针 + */ +static void addNewCourse(Student *student) +{ + if (student->courseCount >= MAX_COURSES) + { + printWarning("课程数量已达上限！"); + return; + } + + safeInputString("课程名称", student->courses[student->courseCount], MAX_COURSE_NAME_LENGTH); + student->scores[student->courseCount] = safeInputFloat("课程成绩", MIN_SCORE, MAX_SCORE); + student->courseCount++; +} + +/** + * @brief 删除课程 + * @details 删除学生的指定课程和成绩 + * @param student 指向学生结构体的指针 + */ +static void deleteCourse(Student *student) +{ + if (student->courseCount == 0) + { + printWarning("该学生没有课程记录！"); + return; + } + + int courseIndex = safeInputInt("请选择要删除的课程", 1, student->courseCount) - 1; + + // 移动数组元素 + for (int k = courseIndex; k < student->courseCount - 1; k++) + { + strcpy(student->courses[k], student->courses[k + 1]); + student->scores[k] = student->scores[k + 1]; + } + student->courseCount--; +} + +/** + * @brief 显示课程列表 + * @details 显示学生的所有课程和成绩 + * @param student 指向学生结构体的指针 + */ +static void displayCourseList(const Student *student) +{ + printf("\n当前课程列表：\n"); + for (int j = 0; j < student->courseCount; j++) + { + printf("%d. %s: %.2f\n", j + 1, student->courses[j], student->scores[j]); + } +} + +/** + * @brief 修改课程信息 + * @details 提供课程修改的子菜单，包括修改、添加、删除课程 + * @param student 指向学生结构体的指针 + * @return true 如果进行了课程修改，false 如果没有修改 + */ +static bool modifyCourseInfo(Student *student) +{ + displayCourseList(student); + + printf("\n修改选项：\n"); + printf("1. 修改现有课程成绩\n"); + printf("2. 添加新课程\n"); + printf("3. 删除课程\n"); + printf("0. 返回\n"); + + int courseChoice = safeInputInt("请选择操作", 0, 3); + switch (courseChoice) + { + case 1: // 修改现有课程成绩 + modifyExistingCourse(student); + return true; + case 2: // 添加新课程 + addNewCourse(student); + return true; + case 3: // 删除课程 + deleteCourse(student); + return true; + case 0: + return false; + } + return false; +} + +/** + * @brief 处理学生信息修改 + * @details 处理找到学生后的修改操作 + * @param student 指向学生结构体的指针 + */ +static void handleStudentModification(Student *student) +{ + displayStudentBasicInfo(student); + + printf("\n修改选项：\n"); + printf("1. 修改姓名\n"); + printf("2. 修改年龄\n"); + printf("3. 修改性别\n"); + printf("4. 修改课程成绩\n"); + printf("0. 返回\n"); + + int choice = safeInputInt("请选择修改项", 0, 4); + + bool courseModified = false; + + switch (choice) + { + case 1: // 修改姓名 + safeInputString("请输入新姓名", student->name, MAX_NAME_LENGTH); + break; + case 2: // 修改年龄 + student->age = safeInputInt("请输入新年龄", 10, 100); + break; + case 3: // 修改性别 + modifyStudentGender(student); + break; + case 4: // 修改课程成绩 + courseModified = modifyCourseInfo(student); + break; + case 0: + return; + } + + if (courseModified) + { + calculateStudentStats(student); + } + + dataModified = true; + statsNeedUpdate = true; + + // 使统计缓存无效 + invalidateCache(); + + printSuccess("学生信息修改成功！"); +} + +/** + * @brief 修改学生信息 + * @details 提供交互式界面修改指定学生的各项信息 + * 支持修改姓名、年龄、性别和课程成绩等信息 + * @note 修改选项： + * 1. 修改姓名 + * 2. 修改年龄 + * 3. 修改性别 + * 4. 修改课程成绩（包括修改现有成绩、添加新课程、删除课程） + * @note 课程成绩修改包含： + * - 修改现有课程成绩 + * - 添加新课程 + * - 删除课程 + * @warning 修改课程信息后会自动重新计算总分和平均分 + */ +void modifyStudent() +{ + clearScreen(); + printHeader("修改学生信息"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + char studentID[MAX_ID_LENGTH]; + printf("\n"); + safeInputString("请输入要修改的学生学号", studentID, MAX_ID_LENGTH); + + // 查找学生 + for (int i = 0; i < studentCount; i++) + { + if (strcmp(students[i].studentID, studentID) == 0) + { + handleStudentModification(&students[i]); + pauseSystem(); + return; + } + } + + printError("未找到该学号的学生！"); + pauseSystem(); +} \ No newline at end of file diff --git a/student_crud.h b/student_crud.h new file mode 100644 index 0000000..7419962 --- /dev/null +++ b/student_crud.h @@ -0,0 +1,56 @@ +/** + * @file student_crud.h + * @brief 学生数据增删改操作头文件 + * @note 声明学生数据的创建、删除、修改等CRUD功能 + */ + +#ifndef STUDENT_CRUD_H +#define STUDENT_CRUD_H + +#include "config.h" + +/** + * @brief 添加新学生 + * @details 交互式地添加新学生信息，包括基本信息和课程成绩 + * 验证学号唯一性、姓名格式、年龄范围等 + * 自动计算总分和平均分 + * @note 会检查学生数量是否已达上限MAX_STUDENTS + * @note 学号必须唯一，不能与现有学生重复 + * @warning 如果学生数量已满，会显示错误信息并返回 + * @see MAX_STUDENTS, isValidStudentId(), isValidName() + */ +void addStudent(); + +/** + * @brief 删除学生 + * @details 提供交互式界面删除指定学号的学生信息 + * 包含确认机制，防止误删除操作 + * @note 删除流程： + * 1. 输入要删除的学生学号 + * 2. 查找并显示学生信息 + * 3. 用户确认删除操作 + * 4. 删除学生并重新排列数组 + * 5. 更新数据修改和统计更新标志 + * @warning 删除操作不可逆，请谨慎操作 + * @warning 如果没有学生数据，将显示警告信息 + */ +void deleteStudent(); + +/** + * @brief 修改学生信息 + * @details 提供交互式界面修改指定学生的各项信息 + * 支持修改姓名、年龄、性别和课程成绩等信息 + * @note 修改选项： + * 1. 修改姓名 + * 2. 修改年龄 + * 3. 修改性别 + * 4. 修改课程成绩（包括修改现有成绩、添加新课程、删除课程） + * @note 课程成绩修改包含： + * - 修改现有课程成绩 + * - 添加新课程 + * - 删除课程 + * @warning 修改课程信息后会自动重新计算总分和平均分 + */ +void modifyStudent(); + +#endif // STUDENT_CRUD_H \ No newline at end of file diff --git a/student_io.c b/student_io.c new file mode 100644 index 0000000..014e620 --- /dev/null +++ b/student_io.c @@ -0,0 +1,237 @@ +/** + * @file student_io.c + * @brief 学生数据文件输入输出操作实现 + * @note 负责学生数据的文件读写、CSV解析等功能 + */ + +#include +#include +#include +#include "config.h" +#include "globals.h" +#include "io_utils.h" +#include "string_utils.h" +#include "statistical_analysis.h" + +/** + * @brief 解析CSV行中的基本学生信息 + * @details 从CSV行中解析学号、姓名、年龄、性别等基本信息 + * @param student 指向要填充的学生结构体的指针 + * @param token 当前CSV token指针的指针 + * @return true 解析成功，false 解析失败 + */ +static bool parseBasicStudentInfo(Student *student, char **token) +{ + // 学号 + if (*token == NULL) return false; + strncpy(student->studentID, *token, MAX_ID_LENGTH - 1); + + // 姓名 + *token = strtok(NULL, ","); + if (*token == NULL) return false; + strncpy(student->name, *token, MAX_NAME_LENGTH - 1); + + // 年龄 + *token = strtok(NULL, ","); + if (*token == NULL) return false; + student->age = atoi(*token); + + // 性别 + *token = strtok(NULL, ","); + if (*token == NULL) return false; + student->gender = (*token)[0]; + + // 课程数量 + *token = strtok(NULL, ","); + if (*token == NULL) return false; + student->courseCount = atoi(*token); + + return true; +} + +/** + * @brief 解析CSV行中的课程信息 + * @details 从CSV行中解析课程名称和成绩信息 + * @param student 指向要填充的学生结构体的指针 + * @param token 当前CSV token指针的指针 + */ +static void parseCourseInfo(Student *student, char **token) +{ + // 课程和成绩 + for (int i = 0; i < student->courseCount && i < MAX_COURSES; i++) + { + // 课程名称 + *token = strtok(NULL, ","); + if (*token == NULL) break; + strncpy(student->courses[i], *token, MAX_COURSE_NAME_LENGTH - 1); + + // 成绩 + *token = strtok(NULL, ","); + if (*token == NULL) break; + student->scores[i] = atof(*token); + } +} + +/** + * @brief 解析CSV行中的统计信息 + * @details 从CSV行中解析总分和平均分信息 + * @param student 指向要填充的学生结构体的指针 + * @param token 当前CSV token指针的指针 + */ +static void parseStatisticsInfo(Student *student, char **token) +{ + // 总分 + *token = strtok(NULL, ","); + if (*token != NULL) + { + student->totalScore = atof(*token); + } + + // 平均分 + *token = strtok(NULL, ","); + if (*token != NULL) + { + student->averageScore = atof(*token); + } +} + +/** + * @brief 解析单行CSV学生数据 + * @details 解析一行CSV数据并填充学生结构体 + * @param line CSV行数据 + * @param student 指向要填充的学生结构体的指针 + * @return true 解析成功，false 解析失败 + */ +static bool parseStudentLine(char *line, Student *student) +{ + memset(student, 0, sizeof(Student)); + + // 解析CSV行 + char *token = strtok(line, ","); + if (token == NULL) return false; + + // 解析基本信息 + if (!parseBasicStudentInfo(student, &token)) return false; + + // 解析课程信息 + parseCourseInfo(student, &token); + + // 解析统计信息 + parseStatisticsInfo(student, &token); + + return true; +} + +/** + * @brief 从CSV文件加载学生数据 + * @details 从STUDENTS_FILE指定的CSV文件中读取学生信息并加载到内存中 + * 解析CSV格式数据，包括学号、姓名、年龄、性别、课程信息等 + * 如果文件不存在，会初始化为空的学生列表 + * @note 会跳过CSV文件的头部行，最多加载MAX_STUDENTS个学生 + * @note 加载完成后会设置statsNeedUpdate标志为true + * @warning 如果CSV格式不正确，可能导致数据解析错误 + * @see STUDENTS_FILE, MAX_STUDENTS, Student结构体 + */ +void loadStudentsFromFile() +{ + FILE *file = fopen(STUDENTS_FILE, "r"); + if (file == NULL) + { + studentCount = 0; + printInfo("学生数据文件不存在，将创建新文件。"); + return; + } + + char line[1024]; + studentCount = 0; + + // 跳过CSV头部 + if (fgets(line, sizeof(line), file) == NULL) + { + fclose(file); + studentCount = 0; + return; + } + + // 读取学生数据 + while (fgets(line, sizeof(line), file) != NULL && studentCount < MAX_STUDENTS) + { + Student *student = &students[studentCount]; + + if (parseStudentLine(line, student)) + { + studentCount++; + } + } + + fclose(file); + + // 更新统计信息 + statsNeedUpdate = true; + + // 使统计缓存无效 + invalidateCache(); +} + +/** + * @brief 将学生数据保存到CSV文件 + * @details 将内存中的所有学生数据以CSV格式保存到STUDENTS_FILE文件中 + * 包含完整的CSV头部和所有学生的详细信息 + * 保存成功后会重置dataModified标志 + * @note CSV格式包括：学号、姓名、年龄、性别、课程数量、各课程名称和成绩、总分、平均分 + * @note 对于课程数量不足MAX_COURSES的学生，会用空值填充 + * @warning 如果文件无法创建或写入，会显示错误信息 + * @see STUDENTS_FILE, MAX_COURSES, dataModified + */ +void saveStudentsToFile() +{ + FILE *file = fopen(STUDENTS_FILE, "w"); + if (file == NULL) + { + printError("无法保存学生数据！"); + return; + } + + // 写入CSV头部 + fprintf(file, "学号,姓名,年龄,性别,课程数量"); + for (int i = 0; i < MAX_COURSES; i++) + { + fprintf(file, ",课程%d,成绩%d", i + 1, i + 1); + } + fprintf(file, ",总分,平均分\n"); + + // 写入学生数据 + for (int i = 0; i < studentCount; i++) + { + Student *student = &students[i]; + + // 基本信息 + fprintf(file, "%s,%s,%d,%c,%d", + student->studentID, + student->name, + student->age, + student->gender, + student->courseCount); + + // 课程和成绩 + for (int j = 0; j < MAX_COURSES; j++) + { + if (j < student->courseCount) + { + fprintf(file, ",%s,%.2f", student->courses[j], student->scores[j]); + } + else + { + fprintf(file, ",,"); // 空的课程和成绩 + } + } + + // 总分和平均分 + fprintf(file, ",%.2f,%.2f\n", student->totalScore, student->averageScore); + } + + fclose(file); + dataModified = false; + + printSuccess("学生数据已保存到CSV文件！"); +} \ No newline at end of file diff --git a/student_io.h b/student_io.h new file mode 100644 index 0000000..82ccc08 --- /dev/null +++ b/student_io.h @@ -0,0 +1,36 @@ +/** + * @file student_io.h + * @brief 学生数据文件输入输出操作头文件 + * @note 声明学生数据的文件读写、CSV解析等功能 + */ + +#ifndef STUDENT_IO_H +#define STUDENT_IO_H + +#include "config.h" + +/** + * @brief 从CSV文件加载学生数据 + * @details 从STUDENTS_FILE指定的CSV文件中读取学生信息并加载到内存中 + * 解析CSV格式数据，包括学号、姓名、年龄、性别、课程信息等 + * 如果文件不存在，会初始化为空的学生列表 + * @note 会跳过CSV文件的头部行，最多加载MAX_STUDENTS个学生 + * @note 加载完成后会设置statsNeedUpdate标志为true + * @warning 如果CSV格式不正确，可能导致数据解析错误 + * @see STUDENTS_FILE, MAX_STUDENTS, Student结构体 + */ +void loadStudentsFromFile(); + +/** + * @brief 将学生数据保存到CSV文件 + * @details 将内存中的所有学生数据以CSV格式保存到STUDENTS_FILE文件中 + * 包含完整的CSV头部和所有学生的详细信息 + * 保存成功后会重置dataModified标志 + * @note CSV格式包括：学号、姓名、年龄、性别、课程数量、各课程名称和成绩、总分、平均分 + * @note 对于课程数量不足MAX_COURSES的学生，会用空值填充 + * @warning 如果文件无法创建或写入，会显示错误信息 + * @see STUDENTS_FILE, MAX_COURSES, dataModified + */ +void saveStudentsToFile(); + +#endif // STUDENT_IO_H \ No newline at end of file diff --git a/student_search.c b/student_search.c new file mode 100644 index 0000000..ca7348a --- /dev/null +++ b/student_search.c @@ -0,0 +1,246 @@ +/** + * @file student_search.c + * @brief 学生数据搜索和显示功能实现 + * @note 负责学生信息的查找、显示等功能 + */ + +#include +#include +#include +#include "config.h" +#include "globals.h" +#include "io_utils.h" + +// 函数前向声明 +void displayStudentInfo(const Student *student); +static int binarySearchByID(const char *studentID); +static void ensureSortedByID(); + +/** + * @brief 按学号查找学生 + * @details 根据用户输入的学号精确查找学生信息 + * 使用二分搜索算法提高查找效率，时间复杂度O(log n) + * 找到后显示该学生的详细信息 + * @note 查找方式：精确匹配学号，使用二分搜索算法 + * @note 算法优化：从线性搜索O(n)优化为二分搜索O(log n) + * @warning 如果没有学生数据或未找到匹配学生，将显示相应提示信息 + */ +void searchStudentByID() +{ + clearScreen(); + printHeader("按学号查找学生"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + char studentID[MAX_ID_LENGTH]; + printf("\n"); + safeInputString("请输入学号", studentID, MAX_ID_LENGTH); + + // 确保数组按学号排序，以支持二分搜索 + ensureSortedByID(); + + // 使用二分搜索查找学生 + int index = binarySearchByID(studentID); + + if (index != -1) + { + displayStudentInfo(&students[index]); + pauseSystem(); + return; + } + + printError("未找到该学号的学生！"); + pauseSystem(); +} + +/** + * @brief 按姓名查找学生 + * @details 根据用户输入的姓名进行模糊查找学生信息 + * 支持部分姓名匹配，显示所有匹配的学生详细信息 + * @note 查找方式：模糊匹配（包含子字符串） + * @note 如果找到多个匹配学生，将全部显示 + * @warning 如果没有学生数据或未找到匹配学生，将显示相应提示信息 + */ +void searchStudentByName() +{ + clearScreen(); + printHeader("按姓名查找学生"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + char name[MAX_NAME_LENGTH]; + printf("\n"); + safeInputString("请输入姓名（支持模糊查找）", name, MAX_NAME_LENGTH); + + bool found = false; + for (int i = 0; i < studentCount; i++) + { + if (strstr(students[i].name, name) != NULL) + { + if (!found) + { + printf("\n找到以下匹配的学生：\n"); + printSeparator(); + found = true; + } + displayStudentInfo(&students[i]); + printf("\n"); + } + } + + if (!found) + { + printError("未找到匹配的学生！"); + } + + pauseSystem(); +} + +/** + * @brief 显示所有学生信息 + * @details 以表格形式显示系统中所有学生的基本信息 + * 包括学号、姓名、年龄、性别、总分和平均分 + * @note 显示格式：表格形式，便于查看和比较 + * @note 显示内容：学号、姓名、年龄、性别、总分、平均分 + * @note 同时显示总学生数统计 + * @warning 如果没有学生数据，将显示警告信息 + */ +void displayAllStudents() +{ + clearScreen(); + printHeader("所有学生信息"); + + if (studentCount == 0) + { + printWarning("暂无学生数据！"); + pauseSystem(); + return; + } + + printf("\n"); + // 调整中文表头的对齐格式，考虑中文字符的显示宽度 + printf("%-12s %-10s %-6s %-6s %-10s %-8s\n", + "学号", "姓名", "年龄", "性别", "总分", "平均分"); + printf("==========================================\n"); + + for (int i = 0; i < studentCount; i++) + { + printf("%-10s %-10s %-4d %-4c %-8.2f %-8.2f\n", + students[i].studentID, + students[i].name, + students[i].age, + students[i].gender, + students[i].totalScore, + students[i].averageScore); + } + + printf("\n总学生数: %d\n", studentCount); + pauseSystem(); +} + +/** + * @brief 显示单个学生详细信息 + * @details 显示指定学生的完整详细信息，包括基本信息和所有课程成绩 + * @param student 指向要显示信息的学生结构体的常量指针 + * @note 显示内容： + * - 基本信息：学号、姓名、年龄、性别、课程数量 + * - 课程成绩：每门课程的名称和分数 + * - 统计信息：总分和平均分 + * @warning 传入的student指针不能为NULL + */ +void displayStudentInfo(const Student *student) +{ + printf("\n学生详细信息：\n"); + printSeparator(); + printf("学号: %s\n", student->studentID); + printf("姓名: %s\n", student->name); + printf("年龄: %d\n", student->age); + printf("性别: %c\n", student->gender); + printf("课程数量: %d\n", student->courseCount); + + if (student->courseCount > 0) + { + printf("\n课程成绩：\n"); + for (int i = 0; i < student->courseCount; i++) + { + printf(" %s: %.2f分\n", + student->courses[i], + student->scores[i]); + } + printf("\n总分: %.2f\n", student->totalScore); + printf("平均分: %.2f\n", student->averageScore); + } +} + +/** + * @brief 确保学生数组按学号排序 + * @details 检查学生数组是否按学号排序，如果没有则进行排序 + * 用于支持二分搜索算法 + * @note 只在需要时进行排序，避免不必要的性能开销 + */ +static void ensureSortedByID() +{ + // 检查是否已经按学号排序 + bool isSorted = true; + for (int i = 0; i < studentCount - 1; i++) + { + if (strcmp(students[i].studentID, students[i + 1].studentID) > 0) + { + isSorted = false; + break; + } + } + + // 如果没有排序，则按学号排序 + if (!isSorted) + { + // 使用外部排序函数 + extern void sortStudents(int criteria, int order); + sortStudents(SORT_BY_ID, SORT_ASCENDING); + } +} + +/** + * @brief 二分搜索按学号查找学生 + * @details 使用二分搜索算法在已排序的学生数组中查找指定学号 + * 时间复杂度O(log n)，比线性搜索O(n)更高效 + * @param studentID 要查找的学号 + * @return 找到的学生索引，如果未找到返回-1 + * @note 要求学生数组必须按学号排序 + */ +static int binarySearchByID(const char *studentID) +{ + int left = 0; + int right = studentCount - 1; + + while (left <= right) + { + int mid = left + (right - left) / 2; + int cmp = strcmp(students[mid].studentID, studentID); + + if (cmp == 0) + { + return mid; // 找到了 + } + else if (cmp < 0) + { + left = mid + 1; // 在右半部分搜索 + } + else + { + right = mid - 1; // 在左半部分搜索 + } + } + + return -1; // 未找到 +} \ No newline at end of file diff --git a/student_search.h b/student_search.h new file mode 100644 index 0000000..f1d01b9 --- /dev/null +++ b/student_search.h @@ -0,0 +1,54 @@ +/** + * @file student_search.h + * @brief 学生数据搜索和显示操作头文件 + * @note 声明学生数据的查找、显示等功能 + */ + +#ifndef STUDENT_SEARCH_H +#define STUDENT_SEARCH_H + +#include "config.h" + +/** + * @brief 按学号查找学生 + * @details 根据用户输入的学号精确查找学生信息 + * 找到后显示该学生的详细信息 + * @note 查找方式：精确匹配学号 + * @warning 如果没有学生数据或未找到匹配学生，将显示相应提示信息 + */ +void searchStudentByID(); + +/** + * @brief 按姓名查找学生 + * @details 根据用户输入的姓名进行模糊查找学生信息 + * 支持部分姓名匹配，显示所有匹配的学生详细信息 + * @note 查找方式：模糊匹配（包含子字符串） + * @note 如果找到多个匹配学生，将全部显示 + * @warning 如果没有学生数据或未找到匹配学生，将显示相应提示信息 + */ +void searchStudentByName(); + +/** + * @brief 显示所有学生信息 + * @details 以表格形式显示系统中所有学生的基本信息 + * 包括学号、姓名、年龄、性别、总分和平均分 + * @note 显示格式：表格形式，便于查看和比较 + * @note 显示内容：学号、姓名、年龄、性别、总分、平均分 + * @note 同时显示总学生数统计 + * @warning 如果没有学生数据，将显示警告信息 + */ +void displayAllStudents(); + +/** + * @brief 显示单个学生详细信息 + * @details 显示指定学生的完整详细信息，包括基本信息和所有课程成绩 + * @param student 指向要显示信息的学生结构体的常量指针 + * @note 显示内容： + * - 基本信息：学号、姓名、年龄、性别、课程数量 + * - 课程成绩：每门课程的名称和分数 + * - 统计信息：总分和平均分 + * @warning 传入的student指针不能为NULL + */ +void displayStudentInfo(const Student *student); + +#endif // STUDENT_SEARCH_H \ No newline at end of file diff --git a/student_sort.c b/student_sort.c new file mode 100644 index 0000000..a937fe0 --- /dev/null +++ b/student_sort.c @@ -0,0 +1,120 @@ +/** + * @file student_sort.c + * @brief 学生数据排序功能实现 + * @note 负责学生信息的排序操作 + */ + +#include +#include +#include +#include "config.h" +#include "globals.h" + +/** + * @brief 比较函数 - 按学号排序 + * @param a 指向第一个学生的指针 + * @param b 指向第二个学生的指针 + * @return 比较结果：负数表示ab + */ +static int compareByID(const void *a, const void *b) +{ + const Student *studentA = (const Student *)a; + const Student *studentB = (const Student *)b; + int result = strcmp(studentA->studentID, studentB->studentID); + return (currentSortOrder == SORT_ASCENDING) ? result : -result; +} + +/** + * @brief 比较函数 - 按姓名排序 + * @param a 指向第一个学生的指针 + * @param b 指向第二个学生的指针 + * @return 比较结果：负数表示ab + */ +static int compareByName(const void *a, const void *b) +{ + const Student *studentA = (const Student *)a; + const Student *studentB = (const Student *)b; + int result = strcmp(studentA->name, studentB->name); + return (currentSortOrder == SORT_ASCENDING) ? result : -result; +} + +/** + * @brief 比较函数 - 按总分排序 + * @param a 指向第一个学生的指针 + * @param b 指向第二个学生的指针 + * @return 比较结果：负数表示ab + */ +static int compareByTotalScore(const void *a, const void *b) +{ + const Student *studentA = (const Student *)a; + const Student *studentB = (const Student *)b; + if (studentA->totalScore < studentB->totalScore) + return (currentSortOrder == SORT_ASCENDING) ? -1 : 1; + else if (studentA->totalScore > studentB->totalScore) + return (currentSortOrder == SORT_ASCENDING) ? 1 : -1; + else + return 0; +} + +/** + * @brief 比较函数 - 按平均分排序 + * @param a 指向第一个学生的指针 + * @param b 指向第二个学生的指针 + * @return 比较结果：负数表示ab + */ +static int compareByAverageScore(const void *a, const void *b) +{ + const Student *studentA = (const Student *)a; + const Student *studentB = (const Student *)b; + if (studentA->averageScore < studentB->averageScore) + return (currentSortOrder == SORT_ASCENDING) ? -1 : 1; + else if (studentA->averageScore > studentB->averageScore) + return (currentSortOrder == SORT_ASCENDING) ? 1 : -1; + else + return 0; +} + +/** + * @brief 排序学生信息 + * @details 根据指定的排序依据和顺序对学生数组进行排序 + * 使用qsort标准库函数实现，时间复杂度O(n log n) + * @param criteria 排序依据（SORT_BY_ID, SORT_BY_NAME, SORT_BY_TOTAL_SCORE, SORT_BY_AVERAGE_SCORE） + * @param order 排序顺序（SORT_ASCENDING升序, SORT_DESCENDING降序） + * @note 排序依据选项： + * - SORT_BY_ID: 按学号排序 + * - SORT_BY_NAME: 按姓名排序 + * - SORT_BY_TOTAL_SCORE: 按总分排序 + * - SORT_BY_AVERAGE_SCORE: 按平均分排序 + * @note 排序算法：快速排序（qsort标准库函数，时间复杂度O(n log n)） + * @note 排序完成后会设置dataModified标志 + */ +void sortStudents(int criteria, int order) +{ + if (studentCount <= 1) + return; + + // 设置全局排序参数 + currentSortCriteria = criteria; + currentSortOrder = order; + + // 选择对应的比较函数并使用qsort进行排序 + switch (criteria) + { + case SORT_BY_ID: + qsort(students, studentCount, sizeof(Student), compareByID); + break; + case SORT_BY_NAME: + qsort(students, studentCount, sizeof(Student), compareByName); + break; + case SORT_BY_TOTAL_SCORE: + qsort(students, studentCount, sizeof(Student), compareByTotalScore); + break; + case SORT_BY_AVERAGE_SCORE: + qsort(students, studentCount, sizeof(Student), compareByAverageScore); + break; + default: + return; // 无效的排序依据 + } + + dataModified = true; +} \ No newline at end of file diff --git a/student_sort.h b/student_sort.h new file mode 100644 index 0000000..366e5c7 --- /dev/null +++ b/student_sort.h @@ -0,0 +1,28 @@ +/** + * @file student_sort.h + * @brief 学生数据排序操作头文件 + * @note 声明学生数据的排序功能 + */ + +#ifndef STUDENT_SORT_H +#define STUDENT_SORT_H + +#include "config.h" + +/** + * @brief 排序学生信息 + * @details 根据指定的排序依据和顺序对学生数组进行排序 + * 使用冒泡排序算法实现 + * @param criteria 排序依据（SORT_BY_ID, SORT_BY_NAME, SORT_BY_TOTAL_SCORE, SORT_BY_AVERAGE_SCORE） + * @param order 排序顺序（SORT_ASCENDING升序, SORT_DESCENDING降序） + * @note 排序依据选项： + * - SORT_BY_ID: 按学号排序 + * - SORT_BY_NAME: 按姓名排序 + * - SORT_BY_TOTAL_SCORE: 按总分排序 + * - SORT_BY_AVERAGE_SCORE: 按平均分排序 + * @note 排序算法：冒泡排序（适合小规模数据） + * @note 排序完成后会设置dataModified标志 + */ +void sortStudents(int criteria, int order); + +#endif // STUDENT_SORT_H \ No newline at end of file diff --git a/student_system.exe b/student_system.exe new file mode 100644 index 0000000..0e5fc6a Binary files /dev/null and b/student_system.exe differ diff --git a/system_utils.c b/system_utils.c new file mode 100644 index 0000000..31cd5ca --- /dev/null +++ b/system_utils.c @@ -0,0 +1,80 @@ +/** + * @file system_utils.c + * @brief 系统工具函数实现文件 + * @note 实现系统初始化和清理相关函数 + */ + +#include +#include +#include "system_utils.h" +#include "file_utils.h" +#include "io_utils.h" +#include "config.h" +#include "user_manage.h" +#include "student_io.h" +#include "statistical_analysis.h" + +/** + * @brief 初始化系统 + * @details 执行系统启动时的初始化操作，包括创建必要的数据目录 + * 调用createDataDirectories函数创建数据存储目录 + * @return 如果初始化成功返回true，否则返回false + * @note 此函数应在程序启动时调用 + * @note 如果初始化失败，会输出错误信息 + */ +bool initializeSystem() +{ + printInfo("正在初始化系统..."); + + if (!createDataDirectories()) + { + printError("系统初始化失败：无法创建数据目录"); + return false; + } + + // 加载用户数据 + loadUsersFromFile(); + + // 加载学生数据 + loadStudentsFromFile(); + + // 初始化统计缓存 + initStatisticsCache(); + + printSuccess("系统初始化完成"); + return true; +} + +/** + * @brief 创建数据目录 + * @details 创建程序运行所需的数据存储目录 + * 目前创建"data"目录用于存储学生数据文件 + * @return 如果目录创建成功或已存在返回true，否则返回false + * @note 如果目录已存在，函数仍返回true + * @note 可以根据需要扩展创建更多目录 + */ +bool createDataDirectories() +{ + // 创建data目录 + if (!createDirectory("data")) + { + printError("无法创建data目录"); + return false; + } + + return true; +} + +/** + * @brief 清理系统资源 + * @details 执行程序退出前的清理操作 + * 目前主要输出清理完成的提示信息 + * @note 此函数应在程序退出前调用 + * @note 可以根据需要添加更多清理操作，如关闭文件、释放内存等 + */ +void cleanupSystem() +{ + printInfo("正在清理系统资源..."); + // 这里可以添加其他清理操作 + printSuccess("系统清理完成"); +} \ No newline at end of file diff --git a/system_utils.h b/system_utils.h new file mode 100644 index 0000000..e164865 --- /dev/null +++ b/system_utils.h @@ -0,0 +1,43 @@ +/** + * @file system_utils.h + * @brief 系统工具函数头文件 + * @note 包含系统初始化和清理相关函数声明 + */ + +#ifndef SYSTEM_UTILS_H +#define SYSTEM_UTILS_H + +#include + +// 系统初始化和清理函数 + +/** + * @brief 初始化系统 + * @details 执行系统启动时的初始化操作，包括创建必要的数据目录 + * 调用createDataDirectories函数创建数据存储目录 + * @return 如果初始化成功返回true，否则返回false + * @note 此函数应在程序启动时调用 + * @note 如果初始化失败，会输出错误信息 + */ +bool initializeSystem(); + +/** + * @brief 创建数据目录 + * @details 创建程序运行所需的数据存储目录 + * 目前创建"data"目录用于存储学生数据文件 + * @return 如果目录创建成功或已存在返回true，否则返回false + * @note 如果目录已存在，函数仍返回true + * @note 可以根据需要扩展创建更多目录 + */ +bool createDataDirectories(); + +/** + * @brief 清理系统资源 + * @details 执行程序退出前的清理操作 + * 目前主要输出清理完成的提示信息 + * @note 此函数应在程序退出前调用 + * @note 可以根据需要添加更多清理操作，如关闭文件、释放内存等 + */ +void cleanupSystem(); + +#endif // SYSTEM_UTILS_H \ No newline at end of file diff --git a/types.h b/types.h new file mode 100644 index 0000000..19ef631 --- /dev/null +++ b/types.h @@ -0,0 +1,108 @@ +/** + * @file types.h + * @brief 统一的数据类型定义文件 + * @note 集中管理所有结构体定义，提高代码可维护性和一致性 + */ + +#ifndef TYPES_H +#define TYPES_H + +#include +#include "config.h" + +// 核心数据结构 + +/** + * @brief 学生信息结构体 + * @note 包含学生的基本信息、课程和成绩数据 + */ +typedef struct { + char studentID[MAX_ID_LENGTH]; // 学号 + char name[MAX_NAME_LENGTH]; // 姓名 + int age; // 年龄 + char gender; // 性别 ('M'/'F') + char courses[MAX_COURSES][MAX_COURSE_NAME_LENGTH]; // 课程名称 + float scores[MAX_COURSES]; // 各科成绩 + int courseCount; // 课程数量 + float totalScore; // 总分 + float averageScore; // 平均分 +} Student; + +/** + * @brief 用户信息结构体 + * @note 包含用户登录信息和权限设置 + */ +typedef struct { + char username[MAX_USERNAME_LENGTH]; + char password[MAX_PASSWORD_LENGTH]; + bool isAdmin; // 是否为管理员 +} User; + +// 统计分析相关结构体 + +/** + * @brief 课程统计结构体 + * @note 包含单门课程的统计信息 + */ +typedef struct { + int studentCount; + float maxScore; + float minScore; + float totalScore; + float averageScore; + float passRate; +} CourseStats; + +/** + * @brief 分数分布结构体 + * @note 按分数段统计学生人数分布 + */ +typedef struct { + int excellent; // 90-100分 + int good; // 80-89分 + int medium; // 70-79分 + int pass; // 60-69分 + int fail; // 0-59分 +} ScoreDistribution; + +/** + * @brief 学生排名结构体 + * @note 用于学生排名功能 + */ +typedef struct { + int studentIndex; + float averageScore; + float totalScore; +} StudentRank; + +/** + * @brief 总体统计结构体 + * @note 包含系统整体的统计信息 + */ +typedef struct { + int totalStudents; + int maleCount; + int femaleCount; + float averageAge; + float highestAverage; + float lowestAverage; + float overallAverageScore; + float standardDeviation; + int totalCourses; + float averageCoursesPerStudent; +} OverallStats; + +/** + * @brief 统计缓存结构体 + * @note 用于缓存统计计算结果，提高性能 + */ +typedef struct { + bool isValid; // 缓存是否有效 + OverallStats overallStats; // 总体统计缓存 + ScoreDistribution scoreDistribution; // 分数分布缓存 + StudentRank rankings[MAX_STUDENTS]; // 排名缓存 + int lastStudentCount; // 上次缓存时的学生数量 + unsigned long lastDataHash; // 数据哈希值，用于检测数据变化 +} StatisticsCache; + +#endif // TYPES_H \ No newline at end of file diff --git a/user_manage.c b/user_manage.c new file mode 100644 index 0000000..0a3a2ff --- /dev/null +++ b/user_manage.c @@ -0,0 +1,354 @@ +/** + * @file user_manage.c + * @brief 用户管理实现文件 + * @note 实现用户认证和管理功能 + */ + +#include +#include +#include +#include "user_manage.h" +#include "config.h" +#include "globals.h" +#include "io_utils.h" +#include "string_utils.h" + +/** + * @brief 处理用户登录 + * @details 提供用户登录验证功能，验证用户名和密码的正确性 + * 登录成功后设置当前用户信息和管理员权限 + * @return int 登录成功返回1，失败返回0 + * @note 登录过程： + * 1. 获取用户输入的用户名和密码 + * 2. 遍历用户数组进行验证 + * 3. 验证成功则设置currentUser和isCurrentUserAdmin + * @note 设置的全局变量： + * - currentUser: 当前登录用户名 + * - isCurrentUserAdmin: 当前用户是否为管理员 + */ +int loginSystem() +{ + char username[MAX_USERNAME_LENGTH]; + char password[MAX_PASSWORD_LENGTH]; + + printf("\n"); + safeInputString("请输入用户名", username, MAX_USERNAME_LENGTH); + safeInputString("请输入密码", password, MAX_PASSWORD_LENGTH); + + // 验证用户名和密码 + for (int i = 0; i < userCount; i++) + { + if (strcmp(users[i].username, username) == 0 && + strcmp(users[i].password, password) == 0) + { + // 登录成功 + strcpy(currentUser, username); + isCurrentUserAdmin = users[i].isAdmin; + return 1; + } + } + + return 0; // 登录失败 +} + +/** + * @brief 从文件加载用户数据 + * @details 从USERS_FILE文件中读取用户数据到内存 + * 如果文件不存在，则创建默认的管理员和普通用户账户 + * @note 文件格式：每行格式为 "username:password:isAdmin" + * 其中isAdmin为1表示管理员，0表示普通用户 + * @note 默认账户： + * - 管理员：用户名admin，密码123456 + * - 普通用户：用户名teacher，密码password + * @warning 如果文件格式错误，可能导致数据加载不完整 + */ +void loadUsersFromFile() +{ + FILE *file = fopen(USERS_FILE, "r"); + if (file == NULL) + { + // 文件不存在，创建默认管理员账户 + strcpy(users[0].username, "admin"); + strcpy(users[0].password, "123456"); + users[0].isAdmin = true; + + strcpy(users[1].username, "teacher"); + strcpy(users[1].password, "password"); + users[1].isAdmin = false; + + userCount = 2; + + // 保存默认用户到文件 + saveUsersToFile(); + printInfo("已创建默认用户账户："); + printInfo("管理员 - 用户名: admin, 密码: 123456"); + printInfo("普通用户 - 用户名: teacher, 密码: password"); + return; + } + + userCount = 0; + char line[200]; + + while (fgets(line, sizeof(line), file) && userCount < MAX_USERS) + { + // 移除换行符 + line[strcspn(line, "\n")] = '\0'; + + // 解析格式：username:password:isAdmin + char *username = strtok(line, ":"); + char *password = strtok(NULL, ":"); + char *adminFlag = strtok(NULL, ":"); + + if (username && password && adminFlag) + { + strcpy(users[userCount].username, username); + strcpy(users[userCount].password, password); + users[userCount].isAdmin = (strcmp(adminFlag, "1") == 0); + userCount++; + } + } + + fclose(file); +} + +/** + * @brief 将用户数据保存到文件 + * @details 将内存中的用户数据写入到USERS_FILE文件中 + * 采用文本格式存储，每个用户占一行 + * @note 文件格式：每行格式为 "username:password:isAdmin" + * 其中isAdmin为1表示管理员，0表示普通用户 + * @warning 如果文件无法打开，将显示错误信息 + */ +void saveUsersToFile() +{ + FILE *file = fopen(USERS_FILE, "w"); + if (file == NULL) + { + printError("无法保存用户数据！"); + return; + } + + for (int i = 0; i < userCount; i++) + { + fprintf(file, "%s:%s:%d\n", + users[i].username, + users[i].password, + users[i].isAdmin ? 1 : 0); + } + + fclose(file); +} + +/** + * @brief 增加用户账户 + * @details 提供交互式界面添加新的用户账户 + * 包括用户名唯一性检查、密码设置和用户类型选择 + * @note 添加流程： + * 1. 检查用户数量是否达到上限 + * 2. 输入新用户名并检查唯一性 + * 3. 设置密码 + * 4. 选择用户类型（普通用户/管理员） + * 5. 保存到文件并更新数据修改标志 + * @warning 如果用户数量已达MAX_USERS上限，将拒绝添加 + * @warning 如果用户名已存在，将拒绝添加 + */ +void addUserAccount() +{ + clearScreen(); + printHeader("添加用户账户"); + + if (userCount >= MAX_USERS) + { + printError("用户数量已达上限！"); + pauseSystem(); + return; + } + + char username[MAX_USERNAME_LENGTH]; + char password[MAX_PASSWORD_LENGTH]; + + printf("\n"); + safeInputString("请输入新用户名", username, MAX_USERNAME_LENGTH); + + // 检查用户名是否已存在 + for (int i = 0; i < userCount; i++) + { + if (strcmp(users[i].username, username) == 0) + { + printError("用户名已存在！"); + pauseSystem(); + return; + } + } + + safeInputString("请输入密码", password, MAX_PASSWORD_LENGTH); + + printf("\n用户类型：\n"); + printf("1. 普通用户\n"); + printf("2. 管理员\n"); + int userType = safeInputInt("请选择用户类型", 1, 2); + + // 添加新用户 + strcpy(users[userCount].username, username); + strcpy(users[userCount].password, password); + users[userCount].isAdmin = (userType == 2); + userCount++; + + // 保存到文件 + saveUsersToFile(); + dataModified = true; + + printSuccess("用户添加成功！"); + pauseSystem(); +} + +/** + * @brief 删除用户账户 + * @details 提供交互式界面删除指定的用户账户 + * 包含安全检查，防止删除当前登录用户和最后一个用户 + * @note 删除限制： + * - 不能删除当前登录的用户 + * - 系统至少需要保留一个用户账户 + * @note 删除过程： + * 1. 输入要删除的用户名 + * 2. 进行安全检查 + * 3. 查找用户并删除 + * 4. 重新排列用户数组 + * 5. 保存到文件并更新数据修改标志 + * @warning 删除操作不可逆，请谨慎操作 + */ +void deleteUserAccount() +{ + clearScreen(); + printHeader("删除用户账户"); + + if (userCount <= 1) + { + printError("至少需要保留一个用户账户！"); + pauseSystem(); + return; + } + + char username[MAX_USERNAME_LENGTH]; + printf("\n"); + safeInputString("请输入要删除的用户名", username, MAX_USERNAME_LENGTH); + + // 不能删除当前登录用户 + if (strcmp(username, currentUser) == 0) + { + printError("不能删除当前登录的用户！"); + pauseSystem(); + return; + } + + // 查找并删除用户 + for (int i = 0; i < userCount; i++) + { + if (strcmp(users[i].username, username) == 0) + { + // 移动后面的用户向前 + for (int j = i; j < userCount - 1; j++) + { + users[j] = users[j + 1]; + } + userCount--; + + // 保存到文件 + saveUsersToFile(); + dataModified = true; + + printSuccess("用户删除成功！"); + pauseSystem(); + return; + } + } + + printError("用户不存在！"); + pauseSystem(); +} + +/** + * @brief 修改用户密码 + * @details 提供交互式界面修改指定用户的密码 + * 管理员可以修改任何用户的密码 + * @note 修改流程： + * 1. 输入要修改密码的用户名 + * 2. 查找用户是否存在 + * 3. 输入新密码 + * 4. 更新用户密码 + * 5. 保存到文件并更新数据修改标志 + * @warning 密码修改后立即生效，用户需要使用新密码登录 + */ +void modifyUserPassword() +{ + clearScreen(); + printHeader("修改用户密码"); + + char username[MAX_USERNAME_LENGTH]; + char newPassword[MAX_PASSWORD_LENGTH]; + + printf("\n"); + safeInputString("请输入用户名", username, MAX_USERNAME_LENGTH); + + // 查找用户 + for (int i = 0; i < userCount; i++) + { + if (strcmp(users[i].username, username) == 0) + { + safeInputString("请输入新密码", newPassword, MAX_PASSWORD_LENGTH); + + strcpy(users[i].password, newPassword); + + // 保存到文件 + saveUsersToFile(); + dataModified = true; + + printSuccess("密码修改成功！"); + pauseSystem(); + return; + } + } + + printError("用户不存在！"); + pauseSystem(); +} + +/** + * @brief 查看所有用户 + * @details 显示系统中所有用户的信息列表 + * 包括用户名、用户类型和当前登录状态 + * @note 显示内容： + * - 用户名 + * - 用户类型（管理员/普通用户） + * - 状态（标识当前登录用户） + * - 总用户数统计 + * @note 表格格式显示，便于查看和管理 + * @warning 如果没有用户数据，将显示警告信息 + */ +void viewAllUsers() +{ + clearScreen(); + printHeader("所有用户列表"); + + if (userCount == 0) + { + printWarning("暂无用户数据！"); + pauseSystem(); + return; + } + + printf("\n"); + printf("%-20s %-15s %-10s\n", "用户名", "用户类型", "状态"); + printSeparator(); + + for (int i = 0; i < userCount; i++) + { + printf("%-20s %-15s %-10s\n", + users[i].username, + users[i].isAdmin ? "管理员" : "普通用户", + strcmp(users[i].username, currentUser) == 0 ? "当前用户" : ""); + } + + printf("\n总用户数: %d\n", userCount); + pauseSystem(); +} \ No newline at end of file diff --git a/user_manage.h b/user_manage.h new file mode 100644 index 0000000..ef26ac8 --- /dev/null +++ b/user_manage.h @@ -0,0 +1,110 @@ +/** + * @file user_manage.h + * @brief 用户管理实现文件 + * @note 实现用户认证和管理功能函数声明 + */ + +#ifndef USER_MANAGE_H +#define USER_MANAGE_H + +#include "config.h" + +/** + * @brief 处理用户登录 + * @details 提供用户登录验证功能，验证用户名和密码的正确性 + * 登录成功后设置当前用户信息和管理员权限 + * @return int 登录成功返回1，失败返回0 + * @note 登录过程： + * 1. 获取用户输入的用户名和密码 + * 2. 遍历用户数组进行验证 + * 3. 验证成功则设置currentUser和isCurrentUserAdmin + * @note 设置的全局变量： + * - currentUser: 当前登录用户名 + * - isCurrentUserAdmin: 当前用户是否为管理员 + */ +int loginSystem(); + +/** + * @brief 从文件加载用户数据 + * @details 从USERS_FILE文件中读取用户数据到内存 + * 如果文件不存在，则创建默认的管理员和普通用户账户 + * @note 文件格式：每行格式为 "username:password:isAdmin" + * 其中isAdmin为1表示管理员，0表示普通用户 + * @note 默认账户： + * - 管理员：用户名admin，密码123456 + * - 普通用户：用户名teacher，密码password + * @warning 如果文件格式错误，可能导致数据加载不完整 + */ +void loadUsersFromFile(); + +/** + * @brief 将用户数据保存到文件 + * @details 将内存中的用户数据写入到USERS_FILE文件中 + * 采用文本格式存储，每个用户占一行 + * @note 文件格式：每行格式为 "username:password:isAdmin" + * 其中isAdmin为1表示管理员，0表示普通用户 + * @warning 如果文件无法打开，将显示错误信息 + */ +void saveUsersToFile(); + +/** + * @brief 增加用户账户 + * @details 提供交互式界面添加新的用户账户 + * 包括用户名唯一性检查、密码设置和用户类型选择 + * @note 添加流程： + * 1. 检查用户数量是否达到上限 + * 2. 输入新用户名并检查唯一性 + * 3. 设置密码 + * 4. 选择用户类型（普通用户/管理员） + * 5. 保存到文件并更新数据修改标志 + * @warning 如果用户数量已达MAX_USERS上限，将拒绝添加 + * @warning 如果用户名已存在，将拒绝添加 + */ +void addUserAccount(); + +/** + * @brief 删除用户账户 + * @details 提供交互式界面删除指定的用户账户 + * 包含安全检查，防止删除当前登录用户和最后一个用户 + * @note 删除限制： + * - 不能删除当前登录的用户 + * - 系统至少需要保留一个用户账户 + * @note 删除过程： + * 1. 输入要删除的用户名 + * 2. 进行安全检查 + * 3. 查找用户并删除 + * 4. 重新排列用户数组 + * 5. 保存到文件并更新数据修改标志 + * @warning 删除操作不可逆，请谨慎操作 + */ +void deleteUserAccount(); + +/** + * @brief 修改用户密码 + * @details 提供交互式界面修改指定用户的密码 + * 管理员可以修改任何用户的密码 + * @note 修改流程： + * 1. 输入要修改密码的用户名 + * 2. 查找用户是否存在 + * 3. 输入新密码 + * 4. 更新用户密码 + * 5. 保存到文件并更新数据修改标志 + * @warning 密码修改后立即生效，用户需要使用新密码登录 + */ +void modifyUserPassword(); + +/** + * @brief 查看所有用户 + * @details 显示系统中所有用户的信息列表 + * 包括用户名、用户类型和当前登录状态 + * @note 显示内容： + * - 用户名 + * - 用户类型（管理员/普通用户） + * - 状态（标识当前登录用户） + * - 总用户数统计 + * @note 表格格式显示，便于查看和管理 + * @warning 如果没有用户数据，将显示警告信息 + */ +void viewAllUsers(); + +#endif // USER_MANAGE_H \ No newline at end of file diff --git a/validation.c b/validation.c new file mode 100644 index 0000000..042ffaf --- /dev/null +++ b/validation.c @@ -0,0 +1,86 @@ +/** + * @file validation.c + * @brief 数据验证函数实现文件 + * @note 实现学生信息各字段的验证函数 + */ + +#include +#include +#include +#include "validation.h" +#include "config.h" +#include "string_utils.h" + +/** + * @brief 验证成绩是否有效 + * @details 检查成绩是否在有效范围内（0-100分） + * @param score 要验证的成绩值 + * @return 如果成绩有效返回true，否则返回false + * @note 有效成绩范围为0.0到100.0（包含边界值） + */ +bool isValidScore(float score) +{ + return score >= 0.0 && score <= 100.0; +} + +/** + * @brief 验证学号是否有效 + * @details 检查学号格式是否符合要求：非空且长度在合理范围内 + * @param id 要验证的学号字符串 + * @return 如果学号有效返回true，否则返回false + * @note 学号不能为空，长度必须在1到MAX_ID_LENGTH之间 + * @warning 如果id为NULL，返回false + */ +bool isValidStudentId(const char *id) +{ + if (id == NULL || isEmptyString(id)) + { + return false; + } + + int len = strlen(id); + return len > 0 && len <= MAX_ID_LENGTH; +} + +/** + * @brief 验证姓名是否有效 + * @details 检查姓名格式是否符合要求：非空且长度在合理范围内 + * @param name 要验证的姓名字符串 + * @return 如果姓名有效返回true，否则返回false + * @note 姓名不能为空，长度必须在1到MAX_NAME_LENGTH之间 + * @warning 如果name为NULL，返回false + */ +bool isValidName(const char *name) +{ + if (name == NULL || isEmptyString(name)) + { + return false; + } + + int len = strlen(name); + return len > 0 && len <= MAX_NAME_LENGTH; +} + +/** + * @brief 验证性别是否有效 + * @details 检查性别是否为'M'（男）或'F'（女） + * @param gender 要验证的性别字符 + * @return 如果性别有效返回true，否则返回false + * @note 只接受'M'或'F'两个值 + */ +bool isValidGender(char gender) +{ + return gender == GENDER_MALE || gender == GENDER_FEMALE; +} + +/** + * @brief 验证年龄是否有效 + * @details 检查年龄是否在合理范围内 + * @param age 要验证的年龄值 + * @return 如果年龄有效返回true，否则返回false + * @note 有效年龄范围为MIN_AGE到MAX_AGE（包含边界值） + */ +bool isValidAge(int age) +{ + return age >= MIN_AGE && age <= MAX_AGE; +} \ No newline at end of file diff --git a/validation.h b/validation.h new file mode 100644 index 0000000..81b3bed --- /dev/null +++ b/validation.h @@ -0,0 +1,61 @@ +/** + * @file validation.h + * @brief 数据验证函数头文件 + * @note 包含学生信息各字段的验证函数声明 + */ + +#ifndef VALIDATION_H +#define VALIDATION_H + +#include + +// 数据验证函数 + +/** + * @brief 验证成绩是否有效 + * @details 检查成绩是否在有效范围内（0-100分） + * @param score 要验证的成绩值 + * @return 如果成绩有效返回true，否则返回false + * @note 有效成绩范围为0.0到100.0（包含边界值） + */ +bool isValidScore(float score); + +/** + * @brief 验证学号是否有效 + * @details 检查学号格式是否符合要求：非空且长度在合理范围内 + * @param id 要验证的学号字符串 + * @return 如果学号有效返回true，否则返回false + * @note 学号不能为空，长度必须在1到MAX_ID_LENGTH之间 + * @warning 如果id为NULL，返回false + */ +bool isValidStudentId(const char* id); + +/** + * @brief 验证姓名是否有效 + * @details 检查姓名格式是否符合要求：非空且长度在合理范围内 + * @param name 要验证的姓名字符串 + * @return 如果姓名有效返回true，否则返回false + * @note 姓名不能为空，长度必须在1到MAX_NAME_LENGTH之间 + * @warning 如果name为NULL，返回false + */ +bool isValidName(const char* name); + +/** + * @brief 验证性别是否有效 + * @details 检查性别是否为'M'（男）或'F'（女） + * @param gender 要验证的性别字符 + * @return 如果性别有效返回true，否则返回false + * @note 只接受'M'或'F'两个值 + */ +bool isValidGender(char gender); + +/** + * @brief 验证年龄是否有效 + * @details 检查年龄是否在合理范围内 + * @param age 要验证的年龄值 + * @return 如果年龄有效返回true，否则返回false + * @note 有效年龄范围为MIN_AGE到MAX_AGE（包含边界值） + */ +bool isValidAge(int age); + +#endif // VALIDATION_H \ No newline at end of file