199 lines
10 KiB
Plaintext
199 lines
10 KiB
Plaintext
/**
|
||
* @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颜色代码的终端（推荐）
|
||
*/ |