# Music

**Repository Path**: shihywel/Music

## Basic Information

- **Project Name**: Music
- **Description**: https://gitee.com/shihywel/Music.git
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

根据代码分析，这是一个基于Spring Boot + MyBatis Plus的音乐平台系统。以下是项目说明文档：

# Music 音乐平台

一个功能完善的在线音乐播放与管理平台，采用 Spring Boot 框架开发，支持歌曲播放、歌单管理、用户收藏、评论互动等功能。

## 技术栈

- **后端**: Spring Boot 2.x + MyBatis Plus
- **前端**: HTML + CSS + JavaScript (原生)
- **数据库**: MySQL
- **模板引擎**: Thymeleaf

## 项目结构

```
com.music/
├── config/          # 配置类
├── controller/     # 控制器
├── entity/        # 实体类
├── mapper/         # 数据访问层
├── service/       # 业务逻辑接口
│   └── impl/      # 业务逻辑实现
├── request/       # 请求参数
├── result/        # 响应结果
├── utils/         # 工具类
└── vo/            # 视图对象
```

## 核心功能

- **用户系统**: 普通用户注册登录、管理员登录、游客模式
- **音乐管理**: 歌曲上传、编辑、删除、搜索
- **歌单管理**: 创建歌单、添加/移除歌曲
- **收藏功能**: 收藏歌曲、收藏歌单
- **评论系统**: 发表评论、查看评论
- **播放记录**: 记录最近播放
- **首页推荐**: 根据用户行为智能推荐

## 快速开始

### 环境要求

- JDK 1.8+
- Maven 3.0+
- MySQL 5.7+

### 配置数据库

在 `src/main/resources/application.yml` 中配置数据库连接：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/music
    username: root
    password: your_password
```

### 导入数据库

```bash
mysql -u root -p < music.sql
```

### 运行项目

```bash
./mvnw spring-boot:run
```

访问 http://localhost:8080

## 页面功能

| 页面 | 说明 |
|------|------|
| `/` 或 `/index` | 首页（根据登录状态显示不同内容） |
| `/login` | 用户登录 |
| `/register` | 用户注册 |
| `/mainpage` | 主播放页面 |
| `/profile` | 用户资料 |
| `/admin` | 管理后台 |

## API 接口

### 认证

- `POST /auth/guest` - 游客登录
- `GET /auth/me` - 获取当前用户
- `POST /auth/logout` - 退出登录

### 歌曲

- `GET /song/catalog` - 获取歌曲目录
- `GET /song/detail/{id}` - 歌曲详情
- `GET /song/search` - 搜索歌曲
- `POST /song/uploadSong` - 上传歌曲

### 歌单

- `GET /songlist/summaries` - 歌单列表
- `GET /songlist/detail/{id}` - 歌单详情
- `POST /songlist/add` - 创建歌单

### 收藏

- `POST /collect/add` - 添加收藏
- `DELETE /collect/delete/{id}` - 删除收藏
- `GET /collect/collected-songs` - 已收藏歌曲

### 评论

- `POST /comment/addComment` - 添加评论
- `GET /comment/getBySongId/{songId}` - 歌曲评论

## 默认账号

- 管理员: admin / 123456

## 许可证

MIT License