# pingpong management system

**Repository Path**: lieral/pingpong-management-system

## Basic Information

- **Project Name**: pingpong management system
- **Description**: 软工课设
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-25
- **Last Updated**: 2025-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 乒乓球培训管理系统 - 项目总览

## 项目简介

本项目是一个基于Flask框架开发的乒乓球培训管理系统，旨在帮助乒乓球培训机构管理学员、教练、课程预约等业务。项目采用简化设计，适合学术研究和中小型培训机构使用。

## 文档导航

### 📁 项目结构
- [`app/`](./app/) - Flask应用代码
- [`requirements.txt`](./requirements.txt) - Python依赖包

## 快速开始

### 环境要求
- Python 3.8+
- MySQL 8.0+
- 虚拟环境（推荐）

### 安装步骤

1. **克隆项目**
```bash
cd F:\桌面\乒乓球培训管理系统
```

2. **创建虚拟环境**
```bash
python -m venv venv
venv\Scripts\activate  # Windows
```

3. **安装依赖**
```bash
pip install -r requirements.txt
```

4. **配置数据库**
```bash
# 创建数据库
mysql -u root -p
CREATE DATABASE pingpong_training CHARACTER SET utf8mb4;

# 导入数据
mysql -u root -p pingpong_training < database_simplified.sql
```

5. **更新配置**
编辑 `app/config.py`，确认数据库连接信息正确。

6. **运行应用**
```bash
python run.py
```

访问 http://localhost:5000

## 系统功能概览

### 👥 用户角色
- **超级管理员** - 系统全局管理
- **校区管理员** - 校区业务管理
- **教练员** - 教学服务提供
- **学员** - 培训服务使用

### 🏢 核心功能
- **多校区管理** - 支持多个培训校区
- **用户管理** - 学员和教练注册管理
- **师生双选** - 学员选择教练，教练确认关系
- **课程预约** - 时间段和球台预约
- **费用管理** - 充值、扣费、退款
- **课程评价** - 双向评价系统

## 技术栈

### 后端
- **框架**: Flask 2.2.3
- **ORM**: SQLAlchemy 3.0.3
- **数据库**: MySQL 8.x
- **认证**: Flask-Login
- **表单**: Flask-WTF

### 前端
- **UI框架**: Bootstrap
- **JavaScript**: jQuery
- **模板**: Jinja2

### 开发工具
- **IDE**: PyCharm / VS Code
- **数据库工具**: MySQL Workbench
- **版本控制**: Git

## 核心数据模型

### 主要实体
```
users (用户表)
├── 学员 (student)
├── 教练 (coach)
├── 校区管理员 (campus_admin)
└── 超级管理员 (super_admin)

campuses (校区表)
tables (球台表)
student_coach_relations (师生关系表)
reservations (预约表)
user_accounts (账户表)
transactions (交易表)
evaluations (评价表)
messages (消息表)
```

### 关键业务流程
1. **师生配对**: 学员申请 → 教练审核 → 建立关系
2. **课程预约**: 选择时间 → 教练确认 → 自动扣费 → 预约成功
3. **课程评价**: 课程结束 → 双方评价 → 记录保存

## 权限矩阵

| 功能 | 超级管理员 | 校区管理员 | 教练 | 学员 |
|------|-----------|-----------|------|------|
| 校区管理 | ✅ | ❌ | ❌ | ❌ |
| 用户管理 | ✅ | ✅(本校区) | ❌ | ❌ |
| 教练审核 | ✅ | ✅ | ❌ | ❌ |
| 预约管理 | ✅ | ✅ | ✅(个人) | ✅(个人) |
| 财务管理 | ✅ | ✅ | ✅(查看) | ✅(个人) |