# PythonMusic

**Repository Path**: qijinliangcom_admin/PythonMusic

## Basic Information

- **Project Name**: PythonMusic
- **Description**: Python音乐管理系统
- **Primary Language**: Swift
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-05-09
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Music Management System

一个现代化、高性能的音乐管理系统，采用前后端分离架构设计。前端采用 React + Ant Design 实现 Apple 风格的极简美学界面，后端基于 FastAPI + SQLAlchemy (Async) 提供高效的异步 API 服务。


![输入图片说明](app/db/%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A120251216-172330@2x.png)

![输入图片说明](app/db/%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A120251216-172339@2x.png)

## ✨ 主要特性

*   **现代化架构**：前后端分离，基于 RESTful API 通信。
*   **极致性能**：后端全异步设计 (FastAPI + Async SQLAlchemy + aiomysql/aiosqlite)，支持高并发。
*   **Apple 风格 UI**：前端采用“强玻璃拟态”与极简设计，提供丝滑的用户体验。
*   **RBAC 权限系统**：完善的角色权限控制（超级管理员、管理员、审核员、普通用户）。
*   **多媒体管理**：支持音乐、歌手、专辑、分类、标签的全方位管理。
*   **文件处理**：支持图片和音频文件的上传与管理，具备智能类型检测。
*   **数据可视化**：仪表盘提供直观的数据统计与图表展示。
*   **安全机制**：JWT 认证、接口限流 (Rate Limiting)、CORS 策略、密码加密存储。

## 🛠 技术栈

### 后端 (Backend)
*   **核心框架**: [FastAPI](https://fastapi.tiangolo.com/) (Python 3.9+)
*   **ORM**: [SQLAlchemy](https://www.sqlalchemy.org/) (AsyncIO 模式)
*   **数据库**: SQLite (开发环境) / MySQL (生产环境支持)
*   **缓存**: Redis (用于缓存热点数据和验证码)
*   **身份认证**: OAuth2 + JWT (JSON Web Tokens)
*   **工具库**: Pydantic (数据校验), Alembic (数据库迁移), SlowAPI (限流)

### 前端 (Frontend)
*   **核心框架**: [React 18](https://react.dev/) + [Vite](https://vitejs.dev/)
*   **UI 组件库**: [Ant Design 5](https://ant.design/)
*   **状态管理**: [Zustand](https://github.com/pmndrs/zustand)
*   **路由管理**: React Router v6
*   **HTTP 客户端**: Axios
*   **语言**: TypeScript

## 📂 项目结构

```
interface/
├── app/                        # 后端核心代码
│   ├── api/                    # API 路由定义
│   ├── core/                   # 核心配置 (Config, Security, Cache, Middleware)
│   ├── crud/                   # 数据库 CRUD 操作
│   ├── db/                     # 数据库连接与会话管理
│   ├── models/                 # SQLAlchemy 数据模型
│   └── schemas/                # Pydantic 数据验证模型
├── frontend/                   # 前端核心代码
│   ├── src/
│   │   ├── api/                # 后端接口封装
│   │   ├── components/         # 公共组件 (CommonUpload, Layout等)
│   │   ├── pages/              # 页面组件 (Login, Dashboard, Music等)
│   │   ├── store/              # 全局状态管理
│   │   └── utils/              # 工具函数
├── main.py                     # 后端启动入口
├── requirements.txt            # Python 依赖
└── README.md                   # 项目文档
```

## 🚀 快速开始

### 环境要求
*   Python 3.9+
*   Node.js 16+
*   Redis (可选，用于缓存和限流功能)

### 1. 后端启动

```bash
# 创建并激活虚拟环境 (推荐)
python3 -m venv venv
source venv/bin/activate  # macOS/Linux
# venv\Scripts\activate   # Windows

# 安装依赖
pip install -r requirements.txt

# 启动服务
# 默认运行在 http://localhost:8000
# 首次启动会自动创建数据库表并初始化管理员账号 (admin / 123456)
python3 -m uvicorn main:app --reload
```

### 2. 前端启动

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
# 默认运行在 http://localhost:5173
npm run dev
```

## 🔑 默认账号

*   **用户名**: `admin`
*   **密码**: `123456`
*   **角色**: Super Admin

## 📝 功能模块说明

1.  **仪表盘 (Dashboard)**: 展示音乐、歌手、专辑总数及播放量 Top 榜单。
2.  **音乐管理**: 支持音乐文件的上传、编辑、上架/下架审核、关联歌手与专辑。
3.  **歌手/专辑管理**: 维护歌手信息及其所属专辑，支持封面上传。
4.  **分类/标签**: 灵活的元数据管理，便于音乐检索。
5.  **用户中心**:
    *   **登录/注册**: 支持账号注册、登录及“忘记密码”找回功能。
    *   **权限控制**: 不同角色拥有不同的后台操作权限。

## 🎨 设计理念

本项目前端设计深受 Apple 官网风格启发，大量运用：
*   **玻璃拟态 (Glassmorphism)**: 半透明背景与模糊效果。
*   **极简主义**: 大量的留白与精致的圆角。
*   **动态交互**: 流畅的过渡动画与响应式布局。

---