# mp3-tag-editor-backend

**Repository Path**: phchen0769/mp3-tag-editor-backend

## Basic Information

- **Project Name**: mp3-tag-editor-backend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MP3 Tag Editor - Backend

在线 MP3 标签编辑器后端服务，基于 Django REST Framework 构建。

## 技术栈

- Python 3.10+
- Django 5.0
- Django REST Framework
- Simple JWT (认证)
- Mutagen (音频标签读写)
- SQLite (开发环境)

## 功能

### 用户系统（复用 DATACENTER 架构）
- JWT Token 认证（登录/刷新/验证）
- 用户注册（邮箱验证码）
- 用户管理（CRUD）
- 角色管理（CRUD + 权限分配）
- 权限管理（CRUD + 路由关联）
- 路由/菜单管理（CRUD + 树形结构）
- 动态菜单（基于角色→权限→路由）

### MP3 标签编辑
- 音频文件上传（支持 MP3/FLAC/OGG/M4A/WAV）
- ID3 标签读取（标题/艺术家/专辑/封面等）
- ID3 标签写入
- 封面图片处理
- 处理后的文件下载

## 快速开始

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

# 2. 数据库迁移
python manage.py makemigrations user tag
python manage.py migrate

# 3. 初始化种子数据（管理员/角色/权限）
python seed_data.py

# 4. 启动服务
python manage.py runserver 0.0.0.0:8000
```

## 默认账户

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | admin123 |
| 演示用户 | demo | demo123 |

## API 文档

启动后访问: http://localhost:8000/docs

## 项目结构

```
mp3-tag-editor-backend/
├── manage.py
├── seed_data.py          # 种子数据
├── requirements.txt
├── mp3tag_editor/        # Django 项目配置
│   ├── settings.py
│   └── urls.py
├── apps/
│   ├── user/             # 用户/角色/权限/路由
│   │   ├── models.py     # UserProfile, Role, Permission, Router
│   │   ├── serializers.py
│   │   ├── views.py      # UserViewSet, RoleViewSet, etc.
│   │   └── urls.py
│   └── tag/              # 音频标签编辑
│       ├── models.py     # AudioFile
│       ├── views.py      # TagReadView, TagWriteView
│       └── urls.py
└── utils/
    ├── authentication.py  # JWT + Bearer 认证
    ├── permission.py      # 自定义权限
    ├── renderer.py        # 统一响应格式
    ├── pagination.py      # 全局分页
    └── custom_exception.py # 异常处理
```