# raging-cloud

**Repository Path**: mirspectator/raging-cloud

## Basic Information

- **Project Name**: raging-cloud
- **Description**: 基于jdk17和pg数据库实现的的一个微服务，多租户的开发平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Raging Cloud - 微服务开发平台

Raging Cloud 是一个完整的微服务开发平台，采用 Spring Boot + Spring Cloud + Nacos 架构，提供完整的服务治理和配置管理能力。

## 项目结构

```
raging-cloud/
├── raging-cloud-common/          # 公共模块 - 共享公共代码和工具
├── raging-auth/                  # 认证服务
│   ├── raging-auth-api/          # 认证 API 模块
│   ├── raging-auth-common/       # 认证公共模块
│   └── raging-auth-start/        # 认证启动模块
├── raging-gateway/               # API 网关服务
├── raging-user/                  # 用户服务（用户、部门、组织管理）
└── raging-sms/                   # 短信/邮件服务
```

## 主要功能

### 1. **raging-cloud-common** - 公共模块
   - 共享工具类
   - 通用实体和DTO
   - Nacos 集成配置

### 2. **raging-auth** - 认证服务（Port: 9001）
   - 用户认证
   - 权限管理
   - Token 处理

### 3. **raging-gateway** - API 网关（Port: 8080）
   - 请求路由
   - 负载均衡
   - 访问控制

### 4. **raging-user** - 用户服务（Port: 9002）
   - 用户增删改查
   - 部门管理
   - 组织架构管理

### 5. **raging-sms** - 短信/邮件服务（Port: 9003）
   - 邮件收发
   - 短信发送
   - 消息队列集成

## 快速开始

### 前置要求

- Java 11+
- Maven 3.6+
- Nacos 2.x
- MySQL 5.7+ (用于 raging-user 服务)

### 环境配置

1. **启动 Nacos 服务**
   ```bash
   # 从 https://github.com/alibaba/nacos/releases 下载 Nacos
   # 解压后运行
   bin/startup.sh -m standalone  # Linux/Mac
   bin/startup.cmd -m standalone # Windows
   ```
   Nacos 默认访问地址：http://localhost:8848/nacos

2. **创建数据库**
   ```sql
   CREATE DATABASE IF NOT EXISTS raging_user DEFAULT CHARSET utf8mb4;
   ```

3. **配置文件修改**
   - 各个服务的 `application.yml` 需要根据实际环境修改：
     - 数据库连接信息（raging-user）
     - 邮箱配置（raging-sms）
     - Nacos 服务器地址

### 编译项目

```bash
# 进入项目根目录
cd raging-cloud

# 编译整个项目
mvn clean install

# 或编译指定模块
mvn clean install -pl raging-auth/raging-auth-start
```

### 运行服务

```bash
# 方式一：使用 IDE 运行
# 分别在各个 Application 类上点击 Run

# 方式二：使用命令行
cd raging-auth/raging-auth-start
mvn spring-boot:run

# 其他服务类似...
cd raging-gateway
mvn spring-boot:run
```

### 服务访问

| 服务 | 端口 | 说明 |
|------|------|------|
| 网关 | 8080 | /auth/*, /user/*, /sms/* |
| 认证 | 9001 | 认证服务 |
| 用户 | 9002 | 用户管理 |
| 短信 | 9003 | 短信/邮件 |

## API 示例

### 用户服务 API

```bash
# 创建用户
POST /user/users
{
  "username": "user01",
  "password": "password123",
  "email": "user@example.com"
}

# 查询用户
GET /user/users/{id}

# 更新用户
PUT /user/users/{id}

# 删除用户
DELETE /user/users/{id}
```

## 技术栈

- **框架**: Spring Boot 2.7.x + Spring Cloud 2021.x
- **服务治理**: Nacos 2.x
- **网关**: Spring Cloud Gateway
- **数据库**: MySQL + Spring Data JPA
- **邮件**: Spring Mail
- **构建**: Maven

## 开发指南

### 模块依赖关系

- `raging-auth-start` 依赖 `raging-auth-api`, `raging-auth-common`, `raging-cloud-common`
- `raging-gateway` 依赖 `raging-cloud-common`
- `raging-user` 依赖 `raging-cloud-common`
- `raging-sms` 依赖 `raging-cloud-common`

### 代码规范

- 使用 Lombok 减少代码量
- 启用 Discovery Client 用于服务注册发现
- 遵循 RESTful API 设计规范

## 常见问题

### Q: 如何添加新的服务？
A: 参考现有服务结构，在 raging-cloud 下创建新模块，并在父 pom.xml 中添加模块引用。

### Q: 如何集成数据库？
A: 参考 raging-user 模块的 JPA 配置，在 application.yml 中配置数据源。

### Q: 如何添加网关路由？
A: 在 raging-gateway 的 application.yml 中修改 spring.cloud.gateway.routes 配置。

## 许可证

MIT License

## 贡献指南

欢迎提交 PR 和 Issue！

---

**更新日期**: 2026-06-15  
**版本**: 1.0.0-SNAPSHOT