Serendipity/Stu_scores_system
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
36 Commits 1 Branch 0 Tags
main
T
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE

README.md

学生成绩管理系统

一个功能完整的C语言学生成绩管理系统，支持学生信息管理、成绩统计分析、用户权限控制等功能。采用高度模块化设计，代码结构清晰，易于维护和扩展。

📋 目录

✨ 功能特性

🎯 核心功能

  • 学生信息管理：添加、删除、修改、查询学生信息
  • 成绩管理：支持多门课程成绩录入和管理
  • 数据持久化：CSV格式存储，便于查看和编辑
  • 统计分析：课程分析、成绩分布、排名统计等
  • 用户管理：多用户登录、权限控制

🔧 技术特性

  • 标准化目录结构：v4.1.0版本采用业界标准的include/src目录布局
  • 统一类型管理：v4.0.0版本创建types.h统一管理所有数据结构
  • 全局变量优化：排序参数和统计缓存移至全局作用域，提升性能
  • 高度模块化：v2.2版本完成深度模块化重构，功能模块职责清晰
  • 工具库分离：独立的IO、验证、字符串、文件、数学、系统工具模块
  • 输入验证：完善的数据校验机制
  • 错误处理：友好的错误提示和异常处理
  • 彩色输出：美观的控制台界面
  • 编译优化：支持直接编译，无需生成中间.o文件
  • 跨平台：支持Windows、Linux、macOS

🏗️ 系统架构

学生成绩管理系统 (v4.1.0 标准化目录架构)
├── 用户界面层 (UI Layer)
│   ├── 主菜单 (src/main_menu.c)
│   └── 学生IO操作 (src/student_io.c)
├── 业务逻辑层 (Business Layer)
│   ├── 核心处理器 (src/core_handlers.c)
│   ├── 学生CRUD操作 (src/student_crud.c)
│   ├── 学生搜索 (src/student_search.c)
│   ├── 学生排序 (src/student_sort.c)
│   ├── 统计分析 (src/statistical_analysis.c)
│   └── 用户管理 (src/user_manage.c)
├── 工具库层 (Utility Layer)
│   ├── IO工具 (src/io_utils.c)
│   ├── 验证工具 (src/validation.c)
│   ├── 字符串工具 (src/string_utils.c)
│   ├── 文件工具 (src/file_utils.c)
│   ├── 数学工具 (src/math_utils.c)
│   ├── 系统工具 (src/system_utils.c)
│   └── 安全工具 (src/security_utils.c)
├── 数据访问层 (Data Layer)
│   ├── CSV文件操作
│   └── 数据验证
├── 安装包管理层 (Installer Layer)
│   ├── 安装脚本目录 (installer/)
│   ├── Inno Setup脚本 (installer/installer.iss)
│   ├── NSIS脚本 (installer/installer.nsi)
│   └── 安装包输出 (installer/dist/)
└── 配置层 (Config Layer)
    ├── 头文件目录 (include/) - v4.1.0标准化
    ├── 统一类型定义 (include/types.h)
    ├── 系统配置 (include/config.h)
    └── 全局变量 (include/globals.h)

🚀 安装与编译

环境要求

  • GCC编译器 4.8+
  • C99标准支持
  • 操作系统：Windows/Linux/macOS

编译步骤

  1. 克隆项目
git clone <repository-url>
cd Stu_scores_system
  1. 使用GCC编译
gcc -Wall -Wextra -std=c17 -g -Iinclude -o student_system src/main.c src/core_handlers.c src/file_utils.c src/globals.c src/io_utils.c src/main_menu.c src/math_utils.c src/security_utils.c src/statistical_analysis.c src/string_utils.c src/student_crud.c src/student_io.c src/student_search.c src/student_sort.c src/system_utils.c src/user_manage.c src/validation.c
  1. 使用Makefile编译（v4.0.0优化版）
make

注意: v4.0.0版本在v2.2直接编译模式基础上，进一步优化了类型管理和依赖关系，编译更加高效，并增强了系统安全性。

  1. 运行程序
./student_system.exe    # Windows
./student_system        # Linux/macOS

📖 使用说明

登录系统

系统提供两个默认用户：

  • 管理员：用户名 admin，密码 123456（拥有所有权限）
  • 教师：用户名 teacher，密码 password（基本权限）

主要功能

1. 基本功能管理

  • 添加学生：录入学生基本信息和课程成绩
  • 删除学生：根据学号删除学生记录
  • 修改学生：更新学生信息和成绩
  • 查询学生：按学号或姓名查找学生
  • 显示所有学生：列出所有学生信息
  • 排序功能：按学号、姓名、总分、平均分排序

2. 统计分析功能

  • 课程分析：各科目成绩统计
  • 成绩分布：分数段分布统计
  • 成绩区间：优秀、良好、及格、不及格统计
  • 综合分析：整体成绩概况

3. 管理功能（仅管理员）

  • 用户管理：添加、删除用户
  • 密码修改：修改用户密码
  • 权限控制：管理用户权限级别

📊 数据格式

CSV文件结构

学生数据以CSV格式存储在 data/students.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格式文档

📁 项目结构

Stu_scores_system/ (v4.1.0 标准化目录结构)
├── 📁 data/                   # 数据文件目录
│   ├── students.csv          # 学生数据（CSV格式）
│   └── users.txt            # 用户数据
├── 📁 include/               # 头文件目录
│   ├── config.h             # 系统配置
│   ├── core_handlers.h      # 核心处理器
│   ├── file_utils.h         # 文件操作工具库
│   ├── globals.h            # 全局变量管理
│   ├── io_utils.h           # IO工具库
│   ├── main_menu.h          # 菜单系统
│   ├── math_utils.h         # 数学计算工具库
│   ├── security_utils.h     # 安全工具库
│   ├── statistical_analysis.h # 统计分析功能
│   ├── string_utils.h       # 字符串工具库
│   ├── student_crud.h       # 学生CRUD操作
│   ├── student_io.h         # 学生IO操作
│   ├── student_search.h     # 学生搜索功能
│   ├── student_sort.h       # 学生排序功能
│   ├── system_utils.h       # 系统工具库
│   ├── types.h              # 统一数据类型定义
│   ├── user_manage.h        # 用户管理
│   └── validation.h         # 数据验证工具库
├── 📁 installer/             # 安装包管理目录
│   ├── installer.iss        # Inno Setup安装脚本
│   ├── installer.nsi        # NSIS安装脚本
│   └── 📁 dist/             # 安装包输出目录
│       ├── StudentGradeSystem_Inno_Setup.exe  # Inno Setup安装包
│       └── StudentGradeSystem_NSIS_Setup.exe  # NSIS安装包
├── 📁 src/                   # 源文件目录
│   ├── core_handlers.c      # 核心处理器
│   ├── file_utils.c         # 文件操作工具库
│   ├── globals.c            # 全局变量管理
│   ├── io_utils.c           # IO工具库
│   ├── main.c               # 主程序入口
│   ├── main_menu.c          # 菜单系统
│   ├── math_utils.c         # 数学计算工具库
│   ├── security_utils.c     # 安全工具库
│   ├── statistical_analysis.c # 统计分析功能
│   ├── string_utils.c       # 字符串工具库
│   ├── student_crud.c       # 学生CRUD操作
│   ├── student_io.c         # 学生IO操作
│   ├── student_search.c     # 学生搜索功能
│   ├── student_sort.c       # 学生排序功能
│   ├── system_utils.c       # 系统工具库
│   ├── user_manage.c        # 用户管理
│   └── validation.c         # 数据验证工具库
├── 📁 MD/                    # 文档目录
│   └── CSV_FORMAT.md        # CSV格式说明
├── 📁 TXT/                   # 文本文档目录
│   ├── 系统说明文档.txt       # 系统详细说明
│   ├── 代码统计报告.txt       # 代码统计分析
│   └── 要求.txt             # 需求文档
├── 📄 .gitignore             # Git忽略文件配置
├── 📄 LICENSE                # 许可证文件
├── 📄 Makefile               # 编译配置（v4.1.0优化版）
├── 📄 README.md              # 项目说明文档
└── 📄 student_system.exe     # 编译生成的可执行文件

🛠️ 开发指南

代码规范

  • 使用C99标准
  • 函数命名采用驼峰命名法
  • 变量命名使用有意义的英文单词
  • 每个函数都有详细的注释说明
  • 模块化设计，职责分离

添加新功能

  1. 在 src/ 目录的相应模块文件中添加函数实现
  2. 在 include/ 目录的对应头文件中添加函数声明
  3. 在菜单系统中添加选项
  4. 更新配置文件（如需要）
  5. 使用 make clean && make 重新编译
  6. 编写测试用例

目录结构说明

  • src/：存放所有 .c 源文件，包含函数的具体实现
  • include/：存放所有 .h 头文件，包含函数声明和数据结构定义
  • data/：存放程序运行时的数据文件（CSV、TXT等）
  • MD/：存放Markdown格式的文档文件
  • TXT/：存放文本格式的说明文档

核心数据结构

学生信息结构体

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;

用户信息结构体

typedef struct {
    char username[MAX_USERNAME_LENGTH];     // 用户名
    char password[MAX_PASSWORD_LENGTH];     // 密码
    bool isAdmin;                           // 是否为管理员
} User;

统计分析结构体

// 课程统计信息
typedef struct {
    int studentCount;                       // 学生人数
    float maxScore;                         // 最高分
    float minScore;                         // 最低分
    float totalScore;                       // 总分
    float averageScore;                     // 平均分
    float passRate;                         // 及格率
} CourseStats;

// 分数分布统计
typedef struct {
    int excellent;                          // 优秀(90-100分)
    int good;                               // 良好(80-89分)
    int medium;                             // 中等(70-79分)
    int pass;                               // 及格(60-69分)
    int fail;                               // 不及格(0-59分)
} ScoreDistribution;

// 总体统计信息
typedef struct {
    int totalStudents;                      // 学生总数
    int maleCount;                          // 男生人数
    int femaleCount;                        // 女生人数
    float averageAge;                       // 平均年龄
    float highestAverage;                   // 最高平均分
    float lowestAverage;                    // 最低平均分
    float overallAverageScore;              // 总体平均分
    float standardDeviation;                // 标准差
    int totalCourses;                       // 课程总数
    float averageCoursesPerStudent;         // 人均课程数
} OverallStats;

🔧 配置说明

系统参数（config.h）

#define MAX_STUDENTS 1000           // 最大学生数量
#define MAX_COURSES 10              // 每个学生最多课程数
#define MAX_USERS 50                // 最大用户数量
#define MAX_LOGIN_ATTEMPTS 3        // 最大登录尝试次数

文件路径

#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: 确保源文件在 src/ 目录下，头文件在 include/ 目录下，并检查GCC版本是否支持C17标准。使用 make clean && make 重新编译。

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 文件了解详情。

👥 作者

🙏 致谢

感谢所有为这个项目做出贡献的开发者！

版本: v4.2.0
最后更新: 2025年
状态: 稳定版本

🆕 v4.2.0 更新内容

📁 标准化目录结构

  • 目录重组：将源文件和头文件分别组织到 src/ 和 include/ 目录
  • 编译优化：更新 Makefile 以支持新的目录结构，添加 -Iinclude 编译选项
  • 项目标准化：采用业界标准的C项目目录布局，提升项目专业性
  • 维护性提升：清晰的文件组织结构，便于代码管理和团队协作

🔧 编译系统改进

  • GCC命令更新：编译命令适配新的目录结构，包含完整的编译选项
  • Makefile增强：支持跨平台编译，Windows兼容性改进
  • 文档同步：README.md项目结构图完全更新，反映最新的目录组织
Reference in New Issue View Git Blame Copy Permalink
S
Description
No description provided
Readme 274 KiB
Languages
C 94.5%
NSIS 3.2%
Makefile 1.2%
Inno Setup 1.1%