# suno

**Repository Path**: eow/suno

## Basic Information

- **Project Name**: suno
- **Description**: suno中文网站开发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-06-05
- **Last Updated**: 2025-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎵 Suno中文版 - AI音乐生成平台

> 基于人工智能的中文音乐创作平台，支持智能歌词生成、音乐创作和社交分享

## 📋 项目概述

Suno中文版是一个现代化的AI音乐生成平台，专为中文用户设计。平台提供智能音乐创作、歌词生成、音乐分享等功能，支持多种音乐风格和创作模式。

### ✨ 核心功能

- 🎼 **AI音乐生成** - 基于提示词或歌词生成高质量音乐
- 📝 **智能歌词创作** - 中文歌词智能生成，支持多种风格和情感
- 🎵 **音乐参数控制** - BPM、调性、音阶等精细化控制
- 🔍 **音乐搜索** - 多维度搜索和智能推荐
- 👤 **用户系统** - 完整的用户认证和权限管理
- 📁 **文件管理** - 音频文件上传、存储和管理
- 🎯 **中国音乐理论** - 支持五声音阶、宫商角徵羽等传统音乐理论

## 🏗️ 技术架构

### 后端技术栈
- **框架**: Spring Boot 3.2, Spring Security 6
- **数据库**: PostgreSQL 16 + MyBatis Plus
- **缓存**: Redis 7.0
- **消息队列**: RabbitMQ 3.12
- **搜索**: Elasticsearch 8.11
- **认证**: JWT + Spring Security
- **容器化**: Docker + Docker Compose

### 前端技术栈
- **框架**: React 18 + Next.js 14
- **UI组件**: Tailwind CSS + Headless UI
- **状态管理**: Zustand
- **音频处理**: Web Audio API
- **图表**: Recharts

### 架构特点
- 🏢 微服务架构设计
- 🎯 领域驱动设计 (DDD)
- ⚡ 事件驱动架构
- 🔄 CQRS命令查询分离
- 📦 容器化部署
- 🌐 RESTful API设计

## 🚀 快速开始

### 环境要求
- Java 21+
- Maven 3.8+
- Docker & Docker Compose
- Node.js 18+ (前端开发)

### 后端启动

```bash
# 克隆项目
git clone git@gitee.com:adam936936/ai.git
cd ai

# 启动基础服务
cd suno-backend
docker-compose -f docker-compose.dev.yml up -d

# 编译项目
mvn clean compile

# 启动用户服务
cd user-service
mvn spring-boot:run

# 启动音乐服务
cd ../music-service
mvn spring-boot:run
```

### 前端启动

```bash
# 进入前端目录
cd suno-frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

## 📊 项目状态

### ✅ 已完成功能 (90%)
- [x] 用户认证系统 (JWT + Spring Security)
- [x] 音乐生成系统 (BPM控制、调性选择)
- [x] AI歌词生成系统 (智能中文歌词)
- [x] 音乐搜索系统 (多维度搜索)
- [x] 文件存储系统 (音频文件管理)
- [x] 中国音乐理论支持 (五声音阶)
- [x] 音乐参数验证器
- [x] 消息队列系统
- [x] API接口文档 (24个RESTful接口)

### 🚧 开发中功能 (10%)
- [ ] 真实AI模型集成
- [ ] 前端用户界面
- [ ] 社交功能 (关注、分享)
- [ ] 支付系统集成

## 📚 API文档

### 音乐生成 API
```http
POST /api/v1/music/generate
Content-Type: application/json
Authorization: Bearer {token}

{
    "creationType": "PROMPT",
    "content": "创作一首温暖的流行歌曲",
    "style": "POP",
    "bpm": 120,
    "keySignature": "C",
    "timeSignature": "4/4",
    "musicalScale": "MAJOR"
}
```

### 歌词生成 API
```http
POST /api/v1/music/lyrics/generate
Content-Type: application/json

{
    "theme": "爱情",
    "style": "流行",
    "emotionalTone": "ROMANTIC",
    "language": "CHINESE"
}
```

### 文件上传 API
```http
POST /api/v1/files/audio
Content-Type: multipart/form-data

file: [音频文件]
userId: user_123456
```

详细API文档请参考: [API_DOCUMENTATION.md](suno-backend/API_DOCUMENTATION.md)

## 🛠️ 开发环境

### 服务端口
- 用户服务: 8081
- 音乐服务: 8080
- 前端应用: 3000
- MySQL: 3307
- Redis: 6380
- RabbitMQ: 5672 (管理界面: 15672)
- Elasticsearch: 9200

### 开发工具推荐
- **IDE**: IntelliJ IDEA Ultimate
- **数据库**: MySQL Workbench
- **API测试**: Postman
- **容器管理**: Docker Desktop

## 📈 版本历史

### v0.4.0-alpha (2024-12-19)
- ✅ 完成编译错误修复
- ✅ 歌词生成系统完善
- ✅ 枚举类规范化
- ✅ 代码结构优化

### v0.3.0-alpha (2024-12-18)
- ✅ AI歌词生成系统
- ✅ 音乐参数控制优化
- ✅ 文件存储系统完善
- ✅ JWT认证系统集成

### v0.2.0-alpha (2024-12-17)
- ✅ 用户认证系统
- ✅ 音乐搜索功能
- ✅ 消息队列集成
- ✅ 数据库设计完善

### v0.1.0-alpha (2024-12-16)
- ✅ 项目架构搭建
- ✅ 基础音乐生成功能
- ✅ 微服务框架搭建
- ✅ Docker环境配置

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📝 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 联系方式

- **项目地址**: https://gitee.com/adam936936/ai
- **问题反馈**: https://gitee.com/adam936936/ai/issues
- **开发文档**: [DEVELOPMENT_STATUS.md](suno-backend/DEVELOPMENT_STATUS.md)

---

**注意**: 这是一个开发中的项目，部分功能可能还不完善。欢迎提交问题和建议！

🎵 让AI为你创作独特的中文音乐！