# ThiefSisProjs

**Repository Path**: ieni/thief-sis-projs

## Basic Information

- **Project Name**: ThiefSisProjs
- **Description**: 偷水姐的个人项目
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-26
- **Last Updated**: 2025-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ThiefSisProjs

## 项目介绍
这是一个集音乐播放、智能推荐等功能于一体的音乐应用项目，采用前后端分离架构设计，提供了完整的音乐播放体验和用户管理功能。

### 代码提供者
24计科专本2班_周兴彬

## 软件架构

### 前端架构
- **技术栈**：Vue 3 + Vite + JavaScript + Element Plus
- **主要功能**：
  - 响应式音乐播放器界面
  - 多页面路由管理（首页、发现页、我的页面、登录/注册）
  - 音乐播放控制（播放、暂停、上一首、下一首）
  - 播放模式切换（顺序播放、单曲循环、随机播放）
  - 音量控制和静音功能
  - 播放进度条控制
  - 用户登录和状态管理
  - 音乐列表展示和选择
  - 响应式布局设计，适配不同设备
- **项目结构**：
  - `ui/src/App.vue`：应用主组件
  - `ui/src/components/PlayerBar.vue`：音乐播放器控制栏组件
  - `ui/src/Views/`：页面视图（Home.vue、Found.vue、Mine.vue、LoginRegister.vue）
  - `ui/src/router/index.js`：路由配置和导航守卫
  - `ui/src/assets/`：静态资源（图片、音乐文件等）
  - `ui/src/utils/auth.js`：用户认证和登录状态管理
  - `ui/src/store/`：状态管理
  - `ui/src/api/`：API接口封装

### 后端架构
- **技术栈**：Java + Spring Boot + Maven + MySQL
- **主要功能**：
  - 音乐数据管理和存储
  - 智能推荐算法实现
  - RESTful API接口服务
  - 用户认证和授权
  - 数据持久化
- **项目结构**：
  - `IntelligentMusic/src/main/`：后端主代码
  - `IntelligentMusic/pom.xml`：Maven依赖配置
  - `IntelligentMusic/sql/`：数据库初始化脚本
  - `IntelligentMusic/logs/`：应用日志

## 安装教程

### 环境要求
- Node.js 16+ (前端)
- Java 8+ (后端)
- Maven 3.6+ (后端)
- MySQL 5.7+ (后端)

### 前端安装与运行
1. 进入前端目录：`cd ui`
2. 安装依赖：`npm install`
3. 启动开发服务器：`npm run dev`（默认端口3005）
4. 构建生产版本：`npm run build`
5. 预览生产版本：`npm run preview`

### 后端安装与运行
1. 进入后端目录：`cd IntelligentMusic`
2. 创建数据库并导入初始化脚本：`sql/intelligent_music.sql`
3. 配置数据库连接（在`application.properties`文件中）
4. 安装依赖并编译：`mvn clean install`
5. 运行应用：`mvn spring-boot:run`（默认端口8080）

## 使用说明

1. **启动服务**：
   - 首先启动后端服务：确保Java后端服务运行在8080端口
   - 然后启动前端应用：运行前端开发服务器

2. **访问应用**：
   - 在浏览器中打开前端应用地址：http://localhost:3005
   - 默认直接进入首页，无需登录即可浏览音乐

3. **功能使用**：
   - **音乐播放**：在首页或发现页点击歌曲，底部播放器会自动切换并播放
   - **播放控制**：使用底部播放器控制栏进行播放、暂停、上一首、下一首操作
   - **播放模式**：点击模式按钮切换顺序播放、单曲循环、随机播放
   - **音量控制**：拖动音量滑块调整音量，或点击静音按钮
   - **进度控制**：拖动进度条调整播放进度
   - **用户登录**：点击"登录"按钮进入登录页面，使用测试账号（user/123456）登录
   - **个人中心**：登录后可访问"我的音乐"页面查看个人信息

4. **测试账号**：
   - 用户名：user
   - 密码：123456

## 项目特点

- **前后端分离**：采用现代前后端分离架构，提高开发效率和系统可维护性
- **响应式设计**：适配不同屏幕尺寸，提供良好的移动端和桌面端体验
- **完整的播放功能**：支持多种播放模式、进度控制、音量调节等
- **用户系统**：实现了用户登录、认证和状态管理
- **智能推荐**：集成智能推荐算法，为用户推荐个性化音乐
- **模块化设计**：代码结构清晰，便于扩展和维护

## 最近更新

- 修复了登录状态保存和路由跳转问题
- 优化了底部播放器布局和功能
- 实现了首页音乐点击自动播放功能
- 改进了用户认证逻辑
- 修复了多种已知bug

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 许可证
本项目采用 MIT 许可证，详情请查看 LICENSE 文件