# Badminton

**Repository Path**: ghostmice/badminton

## Basic Information

- **Project Name**: Badminton
- **Description**: 羽毛球系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 羽毛球比赛报名系统

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Spring Boot 3.2 + Sa-Token + MyBatis-Flex + MySQL 8 |
| 前端 | Vue 3 + Vite + Ant Design Vue + Pinia + Axios |

## 项目结构

```
├── backend/                 # Spring Boot 后端
│   └── src/main/java/com/badminton/
│       ├── common/          # 通用工具、响应体、异常
│       ├── config/          # 配置类
│       ├── controller/      # 控制器
│       ├── entity/          # 实体类
│       ├── mapper/          # MyBatis-Flex Mapper
│       ├── service/         # 业务逻辑
│       └── enums/           # 枚举
├── frontend/                # Vue3 前端
│   └── src/
│       ├── views/user/      # 用户端页面
│       ├── views/admin/     # 管理后台页面
│       ├── api/             # API 接口
│       ├── router/          # 路由
│       └── stores/          # Pinia 状态
└── docs/
    └── database.sql         # 数据库脚本
```

## 角色权限

| 角色 | 编码 | 说明 |
|------|------|------|
| 超级管理员 | SUPER_ADMIN | 平台级管理 |
| 赛事管理员 | EVENT_ADMIN | 赛事创建与管理 |
| 裁判 | REFEREE | 比分录入、检录 |
| 选手 | PLAYER | 报名、个人中心 |

## 快速启动

### 1. 数据库

```bash
mysql -u root -p < docs/database.sql
```

默认管理员：`admin` / `admin123`

### 2. 后端

```bash
cd backend
# 修改 src/main/resources/application.yml 中的数据库连接
mvn spring-boot:run
```

后端地址：http://localhost:8080

### 3. 前端

**开发模式**（热更新，端口 5174）：
```bash
cd frontend
npm install
npm run dev
```

**打包到后端**（输出到 `backend/src/main/resources/static`）：
```bash
cd frontend
npm run build
```

打包后只需启动后端，访问 http://localhost:8080 即可使用完整系统（前后端同源，无需单独起前端）。

开发模式地址：http://localhost:5174

## API 文档

启动后端后访问：http://localhost:8080/doc.html