# zeratul-cloud

**Repository Path**: wlkken/zeratul-cloud

## Basic Information

- **Project Name**: zeratul-cloud
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-17
- **Last Updated**: 2025-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zeratul-cloud

基于 Spring Cloud Alibaba 的微服务架构基础组件，提供统一的解决方案，包括认证、网关、缓存、事件总线、i18n、日志、验证、策略模式等功能。

## 项目结构

- **zeratul-ability**: 微服务能力模块，包含认证（auth）和服务网关（gateway）。
- **zeratul-business**: 业务模块，包含多个业务服务（demo1、demo2、demo等）。
- **zeratul-commons**: 公共组件模块，包含缓存、核心工具、Dubbo、事件、Feign、国际化、JSON、锁、日志、邮件、MyBatis、线程池、Redis、Sa-Token、策略模式、追踪等通用功能。
- **zeratul-project**: 项目基础模块，包含基础应用和不同类型的服务器配置。

## 功能特性

- **认证与权限控制**: 使用 Sa-Token 实现统一的认证和权限管理。
- **服务网关**: 提供统一的 API 入口，支持日志记录、跨域处理、身份验证等。
- **缓存支持**: 提供本地缓存（Guava、Caffeine）和分布式缓存（Redis）支持。
- **事件总线**: 支持本地事件和 Redis 消息事件的发布与订阅。
- **国际化支持**: 支持多语言配置，可从本地文件或 Nacos 获取语言资源。
- **日志记录**: 提供统一的日志记录和请求日志追踪。
- **参数验证**: 提供基于注解的参数验证，支持 SpEL 表达式。
- **策略模式**: 支持基于条件的策略选择，简化业务逻辑分支。
- **线程池管理**: 提供多种线程池配置，支持虚拟线程。
- **分布式锁**: 提供基于 Redisson 的分布式锁实现。
- **MyBatis 增强**: 提供分页、SQL 日志记录、自动填充等功能。
- **Feign 客户端**: 提供统一的 Feign 请求拦截和上下文传递。
- **响应处理**: 统一的响应格式封装，支持 Trace ID 传递。

## 使用技术栈

- Spring Boot
- Spring Cloud Alibaba
- Dubbo
- Sa-Token
- Redis
- MyBatis Plus
- Feign
- Nacos
- Redisson
- Caffeine
- Guava

## 快速开始

1. **启动 Nacos**: 确保 Nacos 服务已启动，用于配置中心和服务注册发现。
2. **启动 Redis**: 确保 Redis 服务已启动，用于缓存和分布式锁。
3. **启动微服务**: 分别启动 `zeratul-auth` 和 `zeratul-gateway`，以及其他业务服务。
4. **访问 API**: 通过网关访问各个服务的 API 接口。

## 文档与支持

- 更详细的文档请参考项目中的各个模块说明。
- 如需帮助，请提交 Issue 或联系项目维护者。