<p align="center"><img src="./readme/images/new-logo.png" height="300" width="400" alt="logo"/></p>
<h2 align="center">简洁优雅 · 稳定高效 | 宁静致远 · 精益求精 </h2>
<p align="center">“一套代码、两种架构，可以灵活切换微服务和单体两种架构”的企业级微服务系统</p>

---

<p align="center">
    <a href="https://spring.io/projects/spring-boot" target="_blank"><img src="https://img.shields.io/badge/Spring%20Boot-4.1.0-blue.svg?logo=springboot" alt="Spring Boot 4.1.0"></a>
    <a href="https://spring.io/projects/spring-cloud" target="_blank"><img src="https://img.shields.io/badge/Spring%20Cloud-2025.1.2-blue.svg?logo=springboot" alt="Spring Cloud 2025.1.2"></a>
    <a href="https://github.com/alibaba/spring-cloud-alibaba" target="_blank"><img src="https://img.shields.io/badge/Spring%20Cloud%20Alibaba-2025.1.0.0-blue.svg?logo=alibabadotcom" alt="Spring Cloud Alibaba 2025.1.0.0"></a>
    <a href="https://github.com/Tencent/spring-cloud-tencent" target="_blank"><img src="https://img.shields.io/badge/Spring%20Cloud%20Tencent-2.1.2.0--2025.0.2-blue.svg?logo=qq" alt="Spring Cloud Tencent 2.1.2.0-2025.0.2"></a>
    <a href="https://nacos.io/docs/latest/overview/" target="_blank"><img src="https://img.shields.io/badge/Nacos-3.2.2-brightgreen.svg?logo=alibabadotcom" alt="Nacos 3.2.2"></a>
</p>
<p align="center">
    <a href="https://my.oschina.net/pointerv" target="_blank"><img src="https://img.shields.io/badge/Author-%E7%A0%81%E5%8C%A0%E5%90%9B-orange" alt="码匠君"></a>
    <a href="./LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-blue.svg?logo=apache" alt="License Apache 2.0"></a>
    <a href="https://bell-sw.com/pages/downloads/#downloads" target="_blank"><img src="https://img.shields.io/badge/JDK-25%2B-green.svg?logo=openjdk" alt="Java 25"></a>
    <a href="https://github.com/dante-compass/dante-engine" target="_blank"><img src="https://img.shields.io/badge/Version-4.1.0.0-red.svg?logo=spring" alt="Version 4.1.0.0"></a>
    <a href="https://github.com/dromara/dante-cloud" target="_blank"><img src="https://img.shields.io/badge/Dante%20Cloud-4.1.0.0-red.svg?logo=spring" alt="Dante Cloud 4.1.0.0"></a>
    <a href="https://github.com/dante-compass/thingsbrain" target="_blank"><img src="https://img.shields.io/badge/ThingsBrain-4.1.0.0-red.svg?logo=spring" alt="ThingsBrain 4.1.0.0"></a>
    <a href="https://github.com/dante-compass/dante-cloud-ui" target="_blank"><img src="https://img.shields.io/badge/Dante%20Cloud%20UI-4.1.0.0-blue.svg?logo=quasar&logoColor=%23050A14" alt="Dante Cloud UI 4.1.0.0"></a>
    <a href="https://github.com/dante-compass/herodotus-cloud-ui-vuetify" target="_blank"><img src="https://img.shields.io/badge/Dante%20Cloud%20UI(New)-4.1.0.0-blue.svg?logo=vuetify&logoColor=%231867C0" alt="Dante Cloud UI(New) 4.1.0.0"></a>
    <a href="https://github.com/dante-compass/dante-engine"><img src="https://img.shields.io/github/stars/dante-compass/dante-engine.svg?label=Github%20Stars" alt="Github star"></a>
    <a href="https://github.com/dante-compass/dante-engine"><img src="https://img.shields.io/github/forks/dante-compass/dante-engine.svg?label=Github%20Forks" alt="Github fork"></a>
    <a href="https://gitee.com/dante-compass/dante-engine"><img src="https://gitee.com/dante-compass/dante-engine/badge/star.svg?theme=dark" alt="Gitee star"></a>
    <a href="https://gitee.com/dante-compass/dante-engine"><img src="https://gitee.com/dante-compass/dante-engine/badge/fork.svg?theme=dark" alt="Gitee fork"></a>
    <a href='https://atomgit.com/dante-compass/dante-engine'><img src='https://atomgit.com/dante-compass/dante-engine/star/badge.svg' alt='Atomgit star'></a>
    <a href="https://www.herodotus.cn"><img src="https://visitor-badge.laobi.icu/badge?page_id=dante-cloud&title=Total%20Visits" alt="Total Visits"></a>
    <a href="https://deepwiki.com/dante-compass/dante-engine" target="_blank"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
</p>
<p align="center">
    <a href="https://github.com/dante-compass/dante-engine">Github 仓库</a> &nbsp; | &nbsp;
    <a href="https://gitee.com/dante-compass/dante-engine">Gitee 仓库</a> &nbsp; | &nbsp;
    <a href="https://atomgit.com/dante-compass/dante-engine">Atomgit 仓库</a> &nbsp; | &nbsp;
    <a href="https://www.herodotus.cn">在线文档</a>
</p>

---

## 重要声明

1. 自 **v4.0.5.0** 版本起，Dante Cloud 核心库 Dante Engine 子项目全面开放。
2. 自 **v4.0.5.1** 版本起，为了提升维护效率，Dante Cloud 企业版和开源版前端合并，新版本前端（Vuetify 版）源代码也全面开放。

> 注意：新版前端（Vuetify 版）与旧版前端（Quasar 版）共享模块，开发时需要以（Vuetify 版）为主，详情参见：[前端【共享模块】](https://www.herodotus.cn/get-started/install/frontend.html#_5-%E5%85%B1%E4%BA%AB%E6%A8%A1%E5%9D%97)

## 项目介绍

Dante Engine 为 Dante Cloud 微服务项目核心组件库，是 Dante Cloud 项目核心内容。单独提取一个工程，一方面便于多项目共享代码，提升代码维护的便捷性；另一方面，Dante Engine 已经提前编译完成并发布中央仓库，可以极大地提升 Dante Cloud 主工程的编译效率。

# [一]、项目地址

## 1. Dante Cloud 主工程

- **Gitee**：[https://gitee.com/dromara/dante-cloud](https://gitee.com/dromara/dante-cloud)
- **Github**：[https://github.com/dromara/dante-cloud](https://github.com/dromara/dante-cloud)
- **AtomGit**：[https://atomgit.com/dromara/dante-cloud](https://atomgit.com/dromara/dante-cloud)

## 2. Dante Engine 核心组件库

- **Gitee**：[https://gitee.com/dante-compass/dante-engine](https://gitee.com/dante-compass/dante-engine)
- **Github**：[https://github.com/dante-compass/dante-engine](https://github.com/dante-compass/dante-engine)
- **AtomGit**：[https://atomgit.com/dante-compass/dante-engine](https://atomgit.com/dante-compass/dante-engine)

## 3. UI 前端工程（旧版）

- **Gitee**：[https://gitee.com/dante-compass/dante-cloud-ui](https://gitee.com/dante-compass/dante-cloud-ui)
- **Github**：[https://github.com/dante-compass/dante-cloud-ui](https://github.com/dante-compass/dante-cloud-ui)
- **AtomGit**：[https://atomgit.com/dante-compass/dante-cloud-ui](https://atomgit.com/dante-compass/dante-cloud-ui)

## 4. UI 前端工程（新版）

- **Gitee**：[https://gitee.com/dante-compass/herodotus-cloud-ui-vuetify](https://gitee.com/dante-compass/herodotus-cloud-ui-vuetify)
- **Github**：[https://github.com/dante-compass/herodotus-cloud-ui-vuetify](https://github.com/dante-compass/herodotus-cloud-ui-vuetify)

## 5. ThingsBrain 基于 Dante Cloud 的物联网平台（加速开发中...）

- **Gitee**：[https://gitee.com/dante-compass/thingsbrain](https://gitee.com/dante-compass/thingsbrain)
- **Github**：[https://github.com/dante-compass/thingsbrain](https://github.com/dante-compass/thingsbrain)

# [二]、开源协议

## 1. 协议声明

自 **v3.3.6.0** 版本起，Dante Cloud 以及 Dante Engine 子项目开源协议 **【永久】** 变更为为 Apache License Version 2.0。可用于个人学习、毕设，允许商业使用，禁止二次开源。严禁搬运至 CSDN 下载等平台进行售卖。

## 2. 补充条款

使用时务必遵守以下补充条款。

- 不得将本软件应用于危害国家安全、荣誉和利益的行为，不能以任何形式用于非法为目的的行为。
- 在延伸的代码中（修改现有源代码衍生的代码中）需要带有原来代码中的协议、版权声明和其他原作者 规定需要包含的说明（请尊重原作者的著作权，不要删除或修改文件中的Copyright和@author信息） 更不要，全局替换源代码中的 Dante Cloud、Herodotus 或 码匠君 等字样，否则你将违反本协议条款承担责任。
- 您若套用本软件的一些代码或功能参考，请保留源文件中的版权和作者，需要在您的软件介绍明显位置 说明出处，举例：本软件基于 Dante Cloud 微服务架构或 Dante Engine，并附带链接：<https://www.herodotus.cn>
- 任何基于本软件而产生的一切法律纠纷和责任，均与作者无关。
- 如果你对本软件有改进，希望可以贡献给我们，双向奔赴互相成就才是王道。
- 本项目已申请软件著作权，请尊重开源。

如果您确实需要删除作者或版权信息，需要争得作者同意及授权。或者在 [【使用公司及组织】](https://gitee.com/dromara/dante-cloud/issues/ICAOHG) 下进行登记，经作者整理登记信息形成表格后，可视为正式授权。

# [三]、工程结构

```shell
dante-engine
├── dante-assistant -- 辅助功能模块
├    ├── dante-assistant-access -- 第三方登录接入辅助功能模块
├    ├── dante-assistant-captcha -- 验证码辅助功能模块
├    └── dante-assistant-oss -- AWS SDK V2 对象存储辅助功能模
├── dante-cache -- 缓存功能模块
├    ├── dante-cache-caffeine -- Caffeine 缓存功能封装模块
├    ├── dante-cache-commons -- 缓存通用代码模块
├    ├── dante-cache-jetcache -- JetCache 缓存功能封装模块
├    └── dante-cache-redis -- Redis 缓存功能封装模块
├── dante-data -- 数据访问模块
├    ├── dante-data-commons -- 数据访问通用代码模块
├    ├── dante-data-jpa -- 以 JPA 作为数据访问层的通用代码模块
├    ├── dante-data-mongodb -- 以 MongoDB 作为数据访问层的通用代码模块
├    └── dante-data-rest -- 关联数据访问层的REST开发通用代码模块
├── dante-dependencies -- 工程 Bom 定义，统一管理工程模块
├── dante-framework -- Dante Cloud 框架核心基础模块
├    ├── dante-autoconfigure -- 基础自动配置模块
├    ├── dante-core -- 核心定义模块
├    ├── dante-hibernate -- Hibernate 扩展模块
├    ├── dante-security -- Security 相关基础代码模块
├    ├── dante-spring -- SpringBoot 相关基础代码模块
├    └── dante-web -- Web 服务 相关基础代码模块
├── dante-logic -- 系统内置功能业务逻辑模块
├    ├── dante-logic-identity -- 身份认证功能业务逻辑模块
├    ├── dante-logic-message -- 系统消息业务逻辑模块
├    └── dante-logic-upms -- UPMS 业务逻辑模块
├── dante-message -- 消息模块
├    ├── dante-message-autoconfigure -- 消息自动配置模块
├    ├── dante-message-commons -- 消息通用代码模块
├    ├── dante-message-emqx -- Emqx 封装模块
├    └── dante-message-servlet-websocket -- 基于 Servlet 环境下的 Websocket 功能封装模块
├── dante-nosql -- 消息模块
├    └── dante-nosql-influxdb3 -- 时序数据 InfluxDB3 封装模块
├── dante-oauth2 -- OAuth2 认证模块
├    ├── dante-authentication-autoconfigure -- OAuth2 授权服务器基础内容自动配置模块
├    ├── dante-authorization-autoconfigure -- OAuth2 资源服务器基础内容自动配置模块
├    ├── dante-oauth2-authentication -- Spring Authorization Server 授权服务器核心功能封装模块
├    ├── dante-oauth2-authorization -- Spring Authorization Server 资源服务器核心功能封装模块
├    ├── dante-oauth2-commons -- OAuth2 共性通用代码模块
├    └── dante-oauth2-extension -- Spring Authorization Server 功能扩展模块
├── dante-persistence -- 数据存储层模块
├    ├── dante-persistence-commons -- 数据存储通用代码模块
├    ├── dante-persistence-sas-autoconfigure -- SAS 核心数据访问层模块自动配置
├    ├── dante-persistence-sas-jpa -- 以 JPA 作为 SAS 核心数据访问层代码实现模块
├    ├── dante-persistence-sys-autoconfigure -- 系统审计数据访问层模块自动配置
├    └── dante-persistence-sys-jpa -- 以 JPA 作为系统审计数据访问层代码实现模块
├── dante-rest -- 系统内置功能 REST 接口模块
├    ├── dante-rest-oss -- 对象存储功能 REST 接口模块
├    ├── dante-rest-identity -- 身份认证功能 REST 接口模块
├    ├── dante-rest-message -- 消息功能 REST 接口模块
├    └── dante-rest-upms -- UPMS 功能 REST 接口模块
├── dante-starter -- Starters
├    ├── cache-spring-boot-starter -- 缓存自动配置 Starter
├    ├── captcha-spring-boot-starter -- 验证码自动配置 Starter
├    ├── data-mongodb-spring-boot-starter -- MongoDB 数据访问层自动配置 Starter
├    ├── data-rdbms-spring-boot-starter -- 关系型数据库数据访问层自动配置 Starter
├    ├── facility-alibaba-spring-boot-starter -- 面向 Spring Cloud Alibaba 的微服务基础设施适配 Starter
├    ├── facility-gateway-spring-boot-starter -- Alibaba Sentinel 在 Gateway 环境下基础设施适配 Starter
├    ├── facility-kafka-spring-boot-starter -- 基于 Kafka 的消息事件自动配置 Starter
├    ├── facility-tencent-spring-boot-starter -- 面向 Spring Cloud Tencent 的微服务基础设施适配模块 Starter
├    ├── fegin-client-spring-boot-starter -- Feign 客户端自动配置 Starter
├    ├── logging-spring-boot-starter -- 日志收集和聚合自动配置 Starter
├    ├── nosql-spring-boot-starter -- NoSQL 自动配置 Starter
├    ├── oss-spring-boot-starter -- 基于 AWS SDK V2 对象存储自动配置 Starter
├    ├── reactive-container-spring-boot-starter -- Reactive 容器基础配置自动配置 Starter
├    ├── servlet-container-spring-boot-starter -- 基于 JPA 的多租户自动配置 Starter
├    ├── servlet-message-spring-boot-starter -- Servlet 环境消息模块自动配置 Starter
├    ├── tenant-spring-boot-starter -- 基于 JPA 的多租户自动配置 Starter
├    ├── web-spring-boot-starter -- Web 微服务通用 Starter
├    └── webmvc-spring-boot-starter -- WebMvc 类型应用自动配置 Starter
└──  readme -- README 相关素材放置目录
```

# [四]、版本分支

## 1. 版本号说明

本系统版本号，分为四段。

- 第一段和第二段，与 Spring Boot 版本对应，根据采用的 Spring Boot 版本变更。例如，当前采用 Spring Boot 2.4.6 版本，那么就以
  2.4.X.X 开头
- 第三段，表示系统功能的变化
- 第四段，表示系统功能维护及优化情况

## 2. 分支说明

|          分支名称          | 对应 Spring 生态版本                          | 对应 JDK 版本 | 用途             | 现状                                                          |
|:----------------------:|-----------------------------------------|-----------|----------------|-------------------------------------------------------------|
|         master         | Spring Boot 4.0 和 Spring Cloud 2025.1.X | JDK 25    | 主要发布分支         | 推荐使用代码分支                                                    |
|        develop         | Spring Boot 4.0 和 Spring Cloud 2025.1.X | JDK 25    | Development 分支 | 新功能、ISSUE 均以此分支作为开发，发布后会 PR 至 master 分支                     |
|         3.5.X          | Spring Boot 3.5 和 Spring Cloud 2025.0.X | JDK 17    | 历史版本，停止维护      | 基于 Spring Boot 3.5 时代开发的代码分支，稳定可用                           |
|         3.4.X          | Spring Boot 3.4 和 Spring Cloud 2024.0.X | JDK 17    | 历史版本，停止维护      | 基于 Spring Boot 3.4 时代开发的代码分支，稳定可用，不再维护                      |
|      3.2.X-3.3.X       | Spring Boot 3.3 和 Spring Cloud 2023.0.X | JDK 17    | 历史版本，停止维护      | 基于 Spring Boot 3.3 时代开发的代码分支，稳定可用，不再维护                      |
|         3.1.X          | Spring Boot 3.1 和 Spring Cloud 2022.0.X | JDK 17    | 历史版本，停止维护      | 基于 Spring Boot 3.1 时代开发的代码分支，稳定可用，不再维护                      |
|         2.7.X          | Spring Boot 2.7 和 Spring Cloud 2021.0.X | JDK 8     | 历史版本，停止维护      | 基于 Spring Boot 2.7 时代开发的代码分支，稳定可用，不再维护                      |
| spring-security-oauth2 | Spring Boot 2.6 和 Spring Cloud 2021.0.X | JDK 8     | 历史代码，不再维护      | 基于原 Spring Security OAuth2 实现的微服务，稳定可用，因相关组件均不在维护，所以该版本不再维护 |


# [五]、安全测试

Dante Cloud 已通过由第三方进行的软件出厂安全测试。详情参见：[安全测试](https://www.herodotus.cn/guide/security/compliance.html)

# [六]、安全测试

1. 在 Gitee fork 项目到自己的 repo
2. 把 fork 过去的项目也就是你的项目 clone 到你的本地
3. 修改代码（记得一定要修改 develop 分支）
4. commit 代码，push 到自己的库（develop 分支）
5. 登录 Gitee 在你首页可以看到一个 pull request 按钮，点击它，填写一些说明信息，然后提交即可。
6. 等待维护者合并

# [七]、鸣谢

## 赞助人列表

| 序号 |                    赞助人                     |    赞助时间    | 序号 |                      赞助人                       |    赞助时间    | 序号 |                   赞助人                    |    赞助时间    |
|:--:|:------------------------------------------:|:----------:|:--:|:----------------------------------------------:|:----------:|:--:|:----------------------------------------:|:----------:|
| 1  |                   ご沉默菋噵                    | 2021-10-25 | 2  |    [偷土豆的人](https://gitee.com/dongzongyang)     | 2021-11-24 | 3  |    [lorron](https://gitee.com/lorron)    | 2022-04-04 |
| 4  |                    在云端                     | 2022-12-26 | 5  |        [西晽](https://gitee.com/syllvin)         | 2022-12-27 | 6  | [p911gt3rs](https://gitee.com/p911gt3rs) | 2023-01-03 |
| 7  |     [jacsty](https://gitee.com/jacsty)     | 2023-01-31 | 8  |  [hubert_rust](https://gitee.com/hubert_rust)  | 2023-03-16 | 9  |   [Zkey Z](https://gitee.com/zkeyzvip)   | 2023-03-18 |
| 10 |      [志国欧巴](https://gitee.com/zzgf16)      | 2023-03-27 | 11 |  [michael](https://gitee.com/yiminyangguang)   | 2023-04-07 | 12 |  [大叔丨小巷](https://gitee.com/yushui_wang)  | 2023-04-11 |
| 13 |   [sun_left](https://gitee.com/sun_left)   | 2023-04-19 | 14 | [time、sand](https://gitee.com/tzy15680905763)  | 2023-07-06 | 15 |   [印第安老斑鸠](https://gitee.com/deadncut)   | 2023-09-09 |
| 16 |                    一阵风                     | 2023-12-10 | 17 |                      Jack                      | 2024-03-01 | 18 | [onehelper](https://gitee.com/onehelper) | 2024-05-24 |
| 19 | [宁哥](https://gitee.com/seabuckthorn-syrup) | 2024-05-29 | 20 | [cryptoneedle](https://gitee.com/cryptoneedle) | 2024-11-01 | 21 |                  别吓跑我的鱼                  | 2025-01-10 |
| 22 |   [代码裁缝](https://gitee.com/code-tailor)    | 2025-03-01 | 23 |                    Go ahead                    | 2025-03-10 | 24 |    [hoku](https://gitee.com/hoku888)     | 2025-06-18 |
| 25 |                     飞翔                     | 2025-07-19 | 26 |                                                |            | 27 |                                          |            |

# [八]、关注我

<table align="center">
  <tr>
    <th align="center">
      <p>公众号：码匠君</p>
    </th>
  </tr>
  <tr>
    <td align="center">
      <img src="./readme/公众号.jpg" alt="公众号" height="200px">
    </td>
  </tr>
</table>