# dd-cloud

**Repository Path**: dimples9527/dd-cloud

## Basic Information

- **Project Name**: dd-cloud
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-31
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dimples Cloud (蛋蛋云)

<p align="center">
  <img src="https://img.shields.io/badge/Spring%20Cloud-2023.0.1-blue" alt="Spring Cloud"/>
  <img src="https://img.shields.io/badge/Vue-3.5.13-green" alt="Vue3"/>
  <img src="https://img.shields.io/badge/JDK-17+-orange" alt="JDK17"/>
  <img src="https://img.shields.io/badge/License-Apache%202.0-red" alt="License"/>
</p>

## 项目简介

**Dimples Cloud** 是一个基于 Spring Cloud Alibaba + Vue3 的微服务中后台管理系统，提供完整的认证授权、动态路由、多租户、操作日志等企业级功能。

## 技术栈

### 后端技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| Spring Boot | 3.2.4 | 应用开发框架 |
| Spring Cloud | 2023.0.1 | 微服务框架 |
| Spring Cloud Alibaba | 2023.0.1.0 | 阿里微服务套件 |
| JDK | 17+ | Java 运行环境 |
| MyBatis Plus | 3.5.5 | 持久层框架 |
| Redis (Redisson) | 3.31.0 | 缓存数据库 |
| Nacos | 2.x | 服务注册与配置中心 |
| Sentinel | 1.8.8 | 熔断限流 |
| XXL-JOB | 2.4.1 | 分布式定时任务 |

### 前端技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| Vue | 3.5.13 | 渐进式框架 |
| Vite | 6.0.3 | 构建工具 |
| TypeScript | 5.7.2 | 类型安全 |
| Naive UI | 2.40.3 | Vue3 组件库 |
| Pinia | 2.3.0 | 状态管理 |

## 项目结构

```
dimples-cloud/
├── dimples-cloud/                    # 后端微服务项目
│   ├── dimples-cloud-gateway/        # API 网关 (8080)
│   ├── dimples-cloud-auth/           # 认证授权服务 (9200)
│   ├── dimples-cloud-server/         # 业务服务 (9201)
│   └── ...
└── dimples-cloud-web/                # 前端 Vue3 项目
```

## 核心特性

- 微服务架构（Spring Cloud Alibaba）
- OAuth2 + JWT 认证授权
- 动态路由权限控制
- 完整的国际化支持
- 操作日志自动记录
- 多租户支持
- 文件服务抽象（本地/FTP/MinIO/S3）
- 短信服务抽象（阿里云/华为云/腾讯云）
- 分布式定时任务（XXL-JOB）

## 快速开始

### 环境要求

- JDK 17+
- Node.js >= 18.12.0
- pnpm >= 8.7.0
- Maven 3.8+
- MySQL 8.x / PostgreSQL
- Redis

### 后端启动

```bash
cd dimples-cloud
mvn clean install -DskipTests
```

按顺序启动服务：
1. Nacos (8848)
2. Redis
3. MySQL
4. Gateway (8080)
5. Auth (9200)
6. System (9201)

### 前端启动

```bash
cd dimples-cloud-web
pnpm install
pnpm dev
```

访问 http://localhost:9529

## 服务端口

| 服务 | 端口 | 说明 |
|------|------|------|
| Nacos | 8848 | 服务注册与配置中心 |
| Gateway | 8080 | API 网关 |
| Auth | 9200 | 认证授权服务 |
| System | 9201 | 系统模块服务 |
| XXL-JOB | 9080 | 定时任务调度中心 |
| 前端 | 9529 | Vite 开发服务器 |

## 文档

- 官网：https://dd.dimples.com
- 文档：详见项目内 AGENTS.md

## 贡献

欢迎提交 Issue 和 Pull Request。

## 许可证

[Apache License 2.0](LICENSE)

## 联系方式

- 作者：dimples9527
- 仓库：https://gitee.com/dimples9527/dd-cloud