更新项目文档到v4.2.0版本

- 更新README.md项目结构
- 更新代码统计报告.txt版本信息
- 更新CSV_FORMAT.md格式说明
- 同步所有文档到v4.2.0版本
This commit is contained in:
2025-10-08 00:40:42 +08:00
parent 1cabe49e32
commit 79bf7cc8d0
3 changed files with 8 additions and 64 deletions
+1 -1
View File
@@ -82,6 +82,6 @@
--- ---
**版本**: v4.0.0 **版本**: v4.2.0
**最后更新**: 2025年 **最后更新**: 2025年
**模块化程度**: 高度模块化 **模块化程度**: 高度模块化
+2 -58
View File
@@ -365,11 +365,11 @@ A: 按照CSV格式要求编辑 `data/students.csv` 文件,程序会自动读
--- ---
**版本**: v4.1.0 **版本**: v4.2.0
**最后更新**: 2025年 **最后更新**: 2025年
**状态**: 稳定版本 **状态**: 稳定版本
## 🆕 v4.1.0 更新内容 ## 🆕 v4.2.0 更新内容
### 📁 标准化目录结构 ### 📁 标准化目录结构
- **目录重组**:将源文件和头文件分别组织到 `src/``include/` 目录 - **目录重组**:将源文件和头文件分别组织到 `src/``include/` 目录
@@ -381,59 +381,3 @@ A: 按照CSV格式要求编辑 `data/students.csv` 文件,程序会自动读
- **GCC命令更新**:编译命令适配新的目录结构,包含完整的编译选项 - **GCC命令更新**:编译命令适配新的目录结构,包含完整的编译选项
- **Makefile增强**:支持跨平台编译,Windows兼容性改进 - **Makefile增强**:支持跨平台编译,Windows兼容性改进
- **文档同步**:README.md项目结构图完全更新,反映最新的目录组织 - **文档同步**:README.md项目结构图完全更新,反映最新的目录组织
## 🆕 v4.0.0 更新内容
### 🔒 安全性增强
- **密码安全**:实现SHA-256哈希算法,替代明文密码存储
- **缓冲区保护**:修复所有缓冲区溢出风险,替换不安全函数
- **输入验证**:加强所有用户输入的验证和边界检查
- **内存安全**:添加安全内存清除功能,防止敏感数据残留
### 🛡️ 新增安全模块
- **security_utils.c/h**:完整的密码哈希和安全工具库
- **增强验证函数**:课程名称、用户名、密码强度、索引边界检查
- **安全输入处理**:所有输入点添加格式验证和循环检查
## 🆕 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文件堆积,保持项目目录整洁
### 📈 代码质量提升
- **模块职责更清晰**:每个模块功能单一,便于维护
- **代码复用性增强**:工具库函数可在多个模块间共享
- **依赖关系优化**:减少模块间的耦合度
+4 -4
View File
@@ -1,7 +1,7 @@
学生成绩管理系统 - 代码统计报告 学生成绩管理系统 - 代码统计报告
======================================== ========================================
生成时间: 2025年10月7日 生成时间: 2025年10月7日
项目版本: v4.1.0 项目版本: v4.2.0
======================================== ========================================
项目概述 项目概述
@@ -151,7 +151,7 @@ v2.2模块化重构成果:
- 文件位置: src/目录(v4.1.0目录重组) - 文件位置: src/目录(v4.1.0目录重组)
======================================== ========================================
头文件统计(v4.1.0目录重组架构) 头文件统计(v4.2.0目录重组架构)
======================================== ========================================
核心模块头文件(include/目录): 核心模块头文件(include/目录):
@@ -193,11 +193,11 @@ v2.2模块化优势:
代码量统计汇总 代码量统计汇总
======================================== ========================================
总代码行数: 4233行(v4.1.0目录标准化+安装包管理) 总代码行数: 4233行(v4.2.0目录标准化+安装包管理)
总注释行数: 1820行 总注释行数: 1820行
总注释字数: 约39200字 总注释字数: 约39200字
代码分布(v4.1.0标准化架构+安装包管理): 代码分布(v4.2.0标准化架构+安装包管理):
- 核心业务代码: 50% (约2116行) - 核心业务代码: 50% (约2116行)
- 工具模块代码: 26% (约1100行) - 原auxiliary.c拆分+新增security_utils.c - 工具模块代码: 26% (约1100行) - 原auxiliary.c拆分+新增security_utils.c
- 安全模块代码: 5% (约212行) - v4.0.0新增security_utils.c/h - 安全模块代码: 5% (约212行) - v4.0.0新增security_utils.c/h