# cloud-top

**Repository Path**: top-cloud/cloud-top

## Basic Information

- **Project Name**: cloud-top
- **Description**: 云巅智核
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-06-21
- **Last Updated**: 2025-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cloud-top 微服务架构项目

这是一个基于 Spring Cloud Alibaba 的微服务架构项目，包含多个服务模块和统一的 API 网关。该项目旨在提供一个可扩展的基础框架，适用于构建分布式系统。

## 项目结构

- **api-gateway**: API 网关模块，负责路由、过滤和鉴权。
- **common-core**: 公共核心模块，包含通用类和工具类。
- **service-auth**: 认证服务模块，处理用户登录、注册和 JWT 鉴权。
- **service-order**: 订单服务模块。
- **service-product**: 商品服务模块。
- **service-search**: 搜索服务模块。
- **service-user**: 用户服务模块，处理用户信息和权限管理。
- **sql**: 数据库脚本目录。

## 主要功能

- **API 网关**：通过 `OnceTokenGatewayFilterFactory` 和 `RtGlobalFilter` 实现请求过滤和鉴权。
- **路由配置**：使用 `VipRoutePredicateFactory` 动态配置路由规则。
- **认证与授权**：基于 JWT 的用户认证，支持登录、注册和 Token 验证。
- **用户管理**：用户信息的增删改查及权限控制。
- **服务发现**：集成 Nacos 作为服务注册与发现中心。
- **Feign 远程调用**：实现服务间通信。

## 快速开始

### 环境要求

- JDK 1.8 或更高版本
- Maven 3.5 或更高版本
- Nacos Server
- MySQL 5.7 或更高版本

### 安装步骤

1. **克隆项目**

   ```bash
   git clone https://gitee.com/your-repo/skyline.git
   cd skyline
   ```

2. **导入数据库**

   使用 `sql/cloud_top.sql` 文件导入数据库结构和初始数据。

3. **启动 Nacos**

   确保已安装并启动 Nacos Server，用于服务注册与配置管理。

4. **启动各服务模块**

   - **认证服务**

     ```bash
     cd service-auth
     mvn spring-boot:run
     ```

   - **用户服务**

     ```bash
     cd service-user
     mvn spring-boot:run
     ```

   - **订单服务**

     ```bash
     cd service-order
     mvn spring-boot:run
     ```

   - **商品服务**

     ```bash
     cd service-product
     mvn spring-boot:run
     ```

   - **搜索服务**

     ```bash
     cd service-search
     mvn spring-boot:run
     ```

5. **启动 API 网关**

   ```bash
   cd api-gateway
   mvn spring-boot:run
   ```

### 使用说明

- **访问 API 网关**：默认端口为 `8080`，可以通过网关访问各个微服务接口。
- **认证接口**：通过 `/api/auth/login` 接口进行用户登录，获取 JWT Token。
- **服务调用**：在请求头中添加 `Authorization: Bearer <token>` 进行鉴权访问。

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 项目
2. 创建新分支 (`git checkout -b feature/new-feature`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送分支 (`git push origin feature/new-feature`)
5. 创建 Pull Request

## 许可证

该项目使用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。