# slavopolis-cloud-initializr **Repository Path**: DoverLee/slavopolis-cloud-initializr ## Basic Information - **Project Name**: slavopolis-cloud-initializr - **Description**: https://github.com/Slavopolis/slavopolis-cloud-initializr.git - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-07 - **Last Updated**: 2026-08-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

基于最新技术栈的现代化微服务脚手架

🚀 让开发者专注于业务实现，释放创新潜能

--- ## 🚀 项目简介 **Slavopolis Cloud** 是一个面向 Java 应用的现代化微服务脚手架项目，基于最新的 **JDK 21** + **Spring Boot 3.5.0** + **Spring Cloud 2025.0.0** 技术栈精心构建。项目涵盖多种业务组件深度封装、基础组件约定、第三方框架集成等，致力于帮助开发者快速搭建项目，将重心聚焦于业务实现。
## ✨ 核心特性

🎯 开箱即用	⚡ 高效开发	🏗️ 架构稳定	🔧 生态完整
深度集成多种业务组件提供完整的微服务解决方案 _{快速启动，立即使用}	核心组件深度封装减少重复代码 _{显著提升开发效率}	遵循最佳实践确保代码质量 _{保证架构稳定性}	无缝集成主流框架构建完整技术生态 _{一站式解决方案}

## 📋 技术栈

🌟 核心框架
	`3.5.0`	核心框架，提供自动配置和快速开发能力
	`2025.0.0`	微服务框架，提供分布式系统解决方案
	`21`	Java 开发工具包，支持最新语言特性

🔧 服务治理
Spring Cloud Gateway	`4.2.0`	API 网关，统一入口管理和路由转发
Spring Cloud LoadBalancer	`4.2.0`	负载均衡，提供客户端负载均衡能力
Spring Cloud OpenFeign	`4.2.0`	服务调用，声明式 HTTP 客户端

⚙️ 配置中心 & 服务发现
	`4.2.0`	配置管理 & 服务注册发现

💾 数据存储
	`8.0+`	关系型数据库，主要业务数据存储
	`7.0+`	缓存数据库，提升系统性能

📨 消息队列 & 监控
	`3.12+`	消息中间件，异步处理和系统解耦
Spring Boot Actuator	`3.5.0`	应用监控，健康检查和指标收集
Micrometer	`1.13.0`	指标收集，多维度性能监控

## 🏗️ 项目架构 ``` slavopolis-cloud/ ├── slavopolis-gateway/ # API 网关服务 ├── slavopolis-auth/ # 认证授权服务 ├── slavopolis-system/ # 系统管理服务 ├── slavopolis-monitor/ # 监控服务 ├── slavopolis-common/ # 公共模块 │ ├── slavopolis-common-core/ # 核心工具类 │ ├── slavopolis-common-web/ # Web 相关组件 │ ├── slavopolis-common-redis/ # Redis 配置 │ └── slavopolis-common-log/ # 日志组件 ├── slavopolis-config/ # 配置文件 └── docs/ # 项目文档 ```
## 🚦 快速开始 ### 📋 环境要求

### 🛠️ 安装步骤

📥 1. 克隆项目

```bash git clone https://github.com/Slavopolis/slavopolis-cloud.git cd slavopolis-cloud ```

🗄️ 2. 数据库初始化

```bash # 创建数据库 mysql -u root -p CREATE DATABASE slavopolis_cloud DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci; # 导入初始化脚本 mysql -u root -p slavopolis_cloud < docs/sql/init.sql ```

⚙️ 3. 配置修改

```bash # 修改配置文件 cp slavopolis-config/application-dev.yml.example slavopolis-config/application-dev.yml # 根据实际环境修改数据库、Redis、RabbitMQ 等配置 ```

🔨 4. 编译项目

```bash mvn clean install -DskipTests ```

🚀 5. 启动服务

```bash # 按顺序启动服务 # 1. 启动网关服务 cd slavopolis-gateway && mvn spring-boot:run # 2. 启动认证服务 cd slavopolis-auth && mvn spring-boot:run # 3. 启动系统服务 cd slavopolis-system && mvn spring-boot:run # 4. 启动监控服务 cd slavopolis-monitor && mvn spring-boot:run ```

### 🐳 Docker 快速部署

```bash # 使用 Docker Compose 一键启动 docker-compose up -d # 查看服务状态 docker-compose ps ```
## 📚 模块说明

模块名称	功能说明
🌐 slavopolis-gateway _{API 网关服务}	主要功能： • 统一入口管理 • 路由规则配置 • 请求限流 • 跨域处理 • 安全认证 • 负载均衡
🔐 slavopolis-auth _{认证授权服务}	主要功能： • 用户登录认证 • JWT Token 管理 • 权限控制 • 角色管理 • OAuth2 集成 • 单点登录
⚙️ slavopolis-system _{系统管理服务}	主要功能： • 用户管理 • 角色权限 • 菜单管理 • 系统配置 • 数据字典 • 组织架构
📊 slavopolis-monitor _监控服务	主要功能： • 应用健康检查 • 性能指标监控 • 日志聚合分析 • 链路追踪 • 告警通知 • 服务拓扑
🔧 slavopolis-common _公共模块	包含模块： • core: 核心工具类、异常处理、常量定义 • web: Web 相关配置、拦截器、过滤器 • redis: Redis 配置、缓存工具 • log: 日志配置、日志切面

## 🔧 配置说明

🗄️ 数据库配置

```yaml spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/slavopolis_cloud?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8 username: your_username password: your_password ```

📮 Redis 配置

```yaml spring: data: redis: host: localhost port: 6379 password: your_password database: 0 ```

🔍 服务发现配置

```yaml spring: cloud: nacos: discovery: server-addr: localhost:8848 service: ${spring.application.name} config: server-addr: localhost:8848 file-extension: yml ```

## 📖 开发指南 ### 📏 代码规范项目遵循 **阿里巴巴 Java 开发手册**，主要规范包括： - 📝 包名使用小写字母，类名使用大驼峰命名 - 🔤 方法名使用小驼峰命名，常量使用大写字母加下划线 - 💬 注释完整，包括类注释、方法注释、参数说明 - ⚠️ 异常处理规范，统一错误码定义 ### 🆕 新增服务

点击查看新增服务步骤

1. **创建服务模块** ```bash mkdir slavopolis-your-service cd slavopolis-your-service ``` 2. **添加 pom.xml** ```xml com.slavopolis slavopolis-cloud 1.0.0 slavopolis-your-service ``` 3. **创建启动类** ```java @SpringBootApplication @EnableDiscoveryClient public class YourServiceApplication { public static void main(String[] args) { SpringApplication.run(YourServiceApplication.class, args); } } ```

### 📝 API 开发规范 - 使用 RESTful API 设计原则 - 统一返回格式 `Result` - 接口版本管理 `/api/v1/` - 完整的参数校验 - Swagger 文档注解
## 🧪 测试

mvn test mvn verify -P integration-test jmeter -n -t docs/test/performance-test.jmx

## 📊 监控运维

Health Check

### 🔍 监控工具

访问 Prometheus

访问 Grafana

管理控制台

## 🤝 贡献指南我们欢迎所有形式的贡献！

### 📋 提交流程 1. 🍴 **Fork** 本仓库 2. 🌿 创建特性分支 (`git checkout -b feature/AmazingFeature`) 3. 💾 提交变更 (`git commit -m 'Add some AmazingFeature'`) 4. 📤 推送分支 (`git push origin feature/AmazingFeature`) 5. 🔄 创建 **Pull Request** ### 🔍 代码审查所有的 PR 都需要经过代码审查才能合并，审查内容包括： - 代码规范性 - 功能完整性 - 测试覆盖率 - 文档完整性
## 📋 Roadmap

🚀 v1.1.0 (计划中)

☐ 支持 Kubernetes 部署
☐ 集成 Spring Cloud Sleuth 链路追踪
☐ 添加 GraphQL 支持
☐ 性能优化

🎯 v1.2.0 (计划中)

☐ 支持多数据源
☐ 集成 Elasticsearch
☐ 添加工作流引擎
☐ 移动端 API 支持

## 🔗 相关链接

## 📄 License

本项目基于 Apache License 2.0 许可证开源

## 🙏 致谢

感谢以下开源项目的支持：

---

🌟 如果这个项目对您有帮助，请给我们一个 Star！

💬 有问题或建议？欢迎提交