# spork-music

**Repository Path**: oyps/spork-music

## Basic Information

- **Project Name**: spork-music
- **Description**: spork-music 音乐库管理网站，歌曲上传、歌单创建、在线播放
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-11-27
- **Last Updated**: 2022-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# spork-music

> 音乐库管理平台 - 客户项目

## 项目信息

- 作者：欧阳鹏
- 开发日期：2022年11月21日

## 功能模块

- 登录注册，支持管理员、注册用户、游客身份
- 歌曲上传、删除、添加到歌单
- 歌单创建、删除
- 音乐库查看所有歌曲
- 根据歌单查看歌曲列表
- 根据情绪查看歌曲列表
- 统计播放次数
- 歌曲播放，支持设置播放列表、播放顺序
- 音乐搜索模块，支持模糊搜索
- 歌曲列表支持“最新”和“热门”排序方式

## 数据库结构

### 歌曲 `spork_music_music`

|          |             |
| -------- | ----------- |
| 歌曲名称 | music_name  |
| 歌曲ID   | music_id    |
| 歌手名称 | artist_name |
| 歌词文本 | lyric       |
| 创建时间 | create_time |
| 文件大小 | file_size   |
| 情绪列表 | moods       |
| 播放次数 | play_count  |


### 歌单 `spork_music_playlist`

|          |               |
| -------- | ------------- |
| 歌单名称 | playlist_name |
| 歌单ID   | playlist_id   |
| 创建者ID | user_id       |
| 封面路径 | cover         |
| 创建时间 | create_time   |


### 歌单中的歌曲 `spork_music_music_in_playlist`

|        |             |
| ------ | ----------- |
| 歌单ID | playlist_id |
| 歌曲ID | music_id    |


### 歌曲评论 `spork_music_comment`

|          |             |
| -------- | ----------- |
| 评论内容 | comment     |
| 歌曲ID   | music_id    |
| 评论时间 | create_time |
| 评论者ID | user_id     |


### 用户 `spork_music_user`

|          |             |
| -------- | ----------- |
| 用户ID   | user_id     |
| 注册时间 | create_time |
| 邮箱     | email       |
| 密码     | password    |

## 开发日志

- 2022年11月21日
  - 完成基本框架
- 2022年11月22日
  - 完成数据表初始化
  - 新增注册接口
  - 新增登录接口
  - 完成前端登录模块
  - 初步完成歌曲上传模块
  - 修复歌曲上传接口
  - 修复细节
- 2022年11月23日
  - 修复歌曲上传接口
  - 新增加载歌曲列表模块，修复细节
  - 完成主页情绪列表显示，优化细节
  - 完成歌单创建模块
  - 完成获取歌单列表接口
  - 完成加载歌单列表
  - 完成前端注册模块
  - 新增关于页
  - 完成删除歌曲模块
  - 完成歌单删除接口
  - 完成前端删除歌单
  - 完成音乐库列表加载
  - 完成主页歌单列表加载
  - 完成音乐搜索模块
  - 开始开发管理员相关验证
  - 新增歌单和情绪两个页面的路由
- 2022年11月24日
  - 完成情绪歌曲列表加载
  - 新增添加到歌单接口
  - 新增添加歌曲到歌单的模态框组件
  - 完成将歌曲添加到歌单模块
  - 完成歌单加载歌曲列表模块
- 2022年11月25日
  - 完成从歌单中移除歌曲模块
  - 歌曲播放模块开发完成
  - 修复播放器
  - 修复全局登录模块
  - 完成获取歌曲信息接口
  - 新增显示歌曲详情，优化细节
  - 修复删除歌单接口
  - 新增播放次数记录模块
  - 清除aplayer输出内容


## 部署流程

1. 将代码上传到网站目录
2. 新建数据库，名称为 `spork_music`
3. 下载[项目数据包](https://github.com/oyps/spork-music/releases/download/2022.11.25/uploads.zip)，解压为 `uploads` 文件夹
4. 将 `uploads/database/spork_music.sql` 导入到数据库
5. 修改 `config.php` 中的 mysql 账号密码

    ```php
    'mysql' => [
        'host' => 'localhost',  // 数据库主机
        'username' => 'root',  // 账号
        'password' => '12345678',  // 密码
        'database' => 'spork_music'  // 数据库名称
    ]
    ```

6. 修改 `config.php` 中的管理员账号

    ```php
    'admin' => [
        'username' => 'admin',  // 账号
        'password' => md5('12345678')  // 密码（注意填写到括号中）
    ]
    ```

7. 访问 `index.php` 即可