# sporterManagerSystem

**Repository Path**: codehosting/sporter-manager-system

## Basic Information

- **Project Name**: sporterManagerSystem
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-04
- **Last Updated**: 2026-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 运动员成绩管理与分析系统

## 项目简介

本项目是一个基于Python的**运动员成绩管理与分析系统**，专门为运训25-3班体能测试设计。系统采用CSV文件存储数据，提供完整的数据管理功能，包括数据录入、显示、统计、查询、删除等核心功能，以及数据排序、可视化、导出等扩展功能。

## 功能特性

### 核心功能
- ✅ **数据录入**：支持连续录入运动员信息
- ✅ **数据显示**：表格形式展示所有数据
- ✅ **数据统计**：计算总人数、平均成绩、及格率等
- ✅ **数据查询**：支持按姓名或项目查询
- ✅ **数据删除**：根据学号删除指定记录

### 扩展功能
- ✅ **数据排序**：按成绩或姓名排序，可保存结果
- ✅ **数据可视化**：使用matplotlib生成统计图表
- ✅ **数据导出**：将统计结果导出为TXT文件
- ✅ **异常处理**：完善的错误处理和用户提示

## 系统要求

### 最低要求
- Python 3.7+
- 操作系统：Windows 10/11, macOS 10.15+, Linux Ubuntu 18.04+
- 内存：128MB以上
- 存储空间：50KB以上

### 推荐配置
- Python 3.9+
- 内存：512MB以上
- 存储空间：100MB以上（用于数据增长）

## 快速开始

### 1. 环境准备

确保已安装Python 3.7+版本：
```bash
# 检查Python版本
python --version
# 或
python3 --version
```

### 2. 下载项目

将项目文件下载到本地目录：
```bash
# 项目文件结构
sporterManageSystem/
├── main.py              # 主程序文件
├── athletes.csv          # 数据文件（自动创建）
├── README.md            # 本文档
├── 环境要求.md           # 详细环境要求
├── 设计报告.md           # 系统设计文档
├── check_environment.py # 环境检查工具
└── requirements.txt     # 依赖库列表
```

### 3. 环境检查

运行环境检查脚本：
```bash
python check_environment.py
# 或
python3 check_environment.py
```

### 4. 运行系统

启动主程序：
```bash
python main.py
# 或
python3 main.py
```

## 使用指南

### 主菜单功能

系统启动后显示以下菜单选项：
```
========================================
        运动员成绩管理与分析系统
========================================
1. 录入运动员数据
2. 显示所有数据
3. 统计分析数据
4. 查询运动员信息
5. 删除运动员数据
6. 数据排序
7. 数据可视化
8. 导出统计结果
0. 退出系统
========================================
```

### 数据录入格式

录入数据时请按以下格式输入：
- **学号**：10位数字（如2025030101）
- **姓名**：2-4个中文字符
- **性别**：男/女
- **项目**：引体向上、1000米跑、仰卧起坐、立定跳远、50米跑
- **成绩**：数字格式（如18、265、42、2.6、7.9）
- **日期**：YYYY-MM-DD格式（如2024-10-15）

### 及格标准

各项目及格标准如下：
- **引体向上**：≥8个及格，≥15个优秀
- **1000米跑**：≤270秒及格，≤210秒优秀
- **仰卧起坐**：≥35个/分钟及格，≥50个/分钟优秀
- **立定跳远**：≥2.0米及格，≥2.5米优秀
- **50米跑**：≤8.5秒及格，≤7.0秒优秀

## 扩展功能安装

### 数据可视化功能

如需使用数据可视化功能，请安装matplotlib：
```bash
pip install matplotlib

# 使用国内镜像加速安装
pip install matplotlib -i https://pypi.tuna.tsinghua.edu.cn/simple/
```

### 完整功能安装

安装所有可选依赖：
```bash
pip install -r requirements.txt
```

## 项目结构

```
sporterManageSystem/
├── main.py                    # 主程序文件（827行）
├── athletes.csv               # 数据文件（预置10条测试数据）
├── README.md                  # 项目说明文档
├── 环境要求.md                 # 环境配置文档
├── 设计报告.md                 # 系统设计文档
├── check_environment.py       # 环境检查工具
├── requirements.txt           # 依赖库列表
└── statistics_report_*.txt   # 导出的统计报告
```

## 数据文件格式

### CSV文件结构
```csv
学号,姓名,性别,项目,成绩,日期
2025030101,东方明,男,引体向上,18,2024-10-15
2025030102,西门庆,男,引体向上,12,2024-10-15
2025030103,南宫雪,女,引体向上,6,2024-10-16
```

### 预置测试数据
系统包含10条预置的运训25-3班体能测试数据，覆盖5个体测项目。

## 故障排除

### 常见问题

1. **Python命令未找到**
   ```bash
   # 使用python3命令
   python3 main.py
   ```

2. **中文显示乱码**
   - 程序已内置UTF-8编码处理
   - 确保终端支持UTF-8编码

3. **权限错误**
   ```bash
   # 确保对项目目录有读写权限
   chmod +x main.py
   ```

4. **matplotlib安装失败**
   ```bash
   # 更新pip后重试
   pip install --upgrade pip
   pip install matplotlib
   ```

### 技术支持

- **开发者**：学号_姓名
- **班级**：运训25-3班
- **项目类型**：体能测试管理系统
- **完成日期**：2026年1月4日

## 开发说明

### 技术栈
- **编程语言**：Python 3.7+
- **数据存储**：CSV文件格式
- **数据处理**：标准库（os, csv, datetime）
- **数据可视化**：matplotlib（可选）
- **编码格式**：UTF-8

### 代码规范
- 遵循PEP 8编码规范
- 完善的注释和文档
- 模块化函数设计
- 异常处理机制

## 更新日志

### v1.0 (2026-01-04)
- ✅ 完成所有核心功能开发
- ✅ 实现数据可视化扩展功能
- ✅ 完善异常处理机制
- ✅ 创建完整文档体系
- ✅ 预置测试数据

## 许可证

本项目仅供教学使用，遵循MIT许可证。

---

**开始使用**：运行 `python main.py` 启动系统！

**获取帮助**：查看 `环境要求.md` 和 `设计报告.md` 获取详细信息。