commit 4e25f760a56b4866b0f3ed3797741410f5561a59 Author: haoxin963 <525899665@qq.com> Date: Mon Jun 7 11:31:04 2021 +0800 init diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..dd851b6 --- /dev/null +++ b/.gitignore @@ -0,0 +1,25 @@ +# Compiled class file +*.class +target + +# Log file +*.log + +# BlueJ files +*.ctxt + +# Mobile Tools for Java (J2ME) +.mtj.tmp/ + +# Package Files # +*.jar +*.war +*.ear +*.zip +*.tar.gz +*.rar +*.iml +.idea + +# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml +hs_err_pid* diff --git a/README.md b/README.md new file mode 100644 index 0000000..cdb47ae --- /dev/null +++ b/README.md @@ -0,0 +1,112 @@ +

+ + + +

+ +

xtoon-boot

+ +
+ +基于领域驱动设计(DDD)并支持SaaS平台的微服务开发脚手架. + +
+ +
+ +![](https://img.shields.io/badge/language-java-red.svg) +[![ApiAdmin](https://img.shields.io/hexpm/l/plug.svg)](http://xtoon-boot.xiangtoon.com/) +[![ApiAdmin](https://img.shields.io/badge/release-1.0.0-blue.svg)](http://xtoon-boot.xiangtoon.com/) +[![ApiAdmin](https://img.shields.io/badge/build-passing-brightgreen.svg)](http://xtoon-boot.xiangtoon.com/) + +
+ +## 为何选择xtoon-cloud +- 解决编写过程式和事务代码,造成后期维护逻辑混乱、维护成本高的痛点; +- 边界规范易维持,核心业务逻辑内聚在领域内,低耦合,高内聚,易于长期维护; +- 网上基本讲的都是DDD的理论很少有讲怎么落地,xtoon-cloud提供了完整落地方案和企业级微服务架构; +- 可以快速开发,框架提供了系统管理和组织架构等核心模块; +- 支持多租户的SaaS平台; + +## 技术交流 +如果有什么问题或建议可以 [提ISSUE](https://gitee.com/xtoon/xtoon-boot/issues) 或 加群(QQ:130950009),交流技术,分享经验。
+如果你解决了某些bug,或者新增了一些功能,欢迎 [贡献代码](https://gitee.com/xtoon/xtoon-boot/pulls),感激不尽~
+大家多点 ⭐Star 支持下。 + + +## 技术选型 +- 基础框架:Spring Cloud Alibaba +- 网关:Spring Cloud Gateway +- 鉴权认证:Spring Cloud Security+JWT +- 监控监控:spring-boot-admin +- 流量控制:Sentinel +- 注册配置中心:Nacos +- RPC:dubbo +- 分布式事务:Seata +- APM:Skywalking + + +## 主要模块 +1. 登录注册:账号、手机号验证登录,租户注册; +2. 用户管理:用户新增,分配角色,禁用等; +3. 角色管理:角色新增,查看,维护菜单等; +4. 菜单管理:树形菜单管理,可配置菜单和按钮权限等; +5. 租户管理:租户列表,禁用等; +6. 日志管理:记录操作日志记录和查询; + +## 项目结构 +``` +xtoon-cloud(开发中) + +``` + +## 核心理念 +### 六边形理论 +

+ +

+Alistair Cockburn提出了六边形架构,又被称为端口和适配器架构。观察上图我们发现,对于核心的应用程序和领域模型来说,其他的底层依赖或实现都可以抽象为输入和输出两类。组织关系变为了一个二维的内外关系,而不是上下结构。每个io与应用程序之前均有适配器完成隔离工作,每个最外围的边都是一个端口。基于六边形架构设计的系统是DDD追求的最终形态。 + +### 数据驱动和领域驱动对比 +

+ +

+领域驱动设计与之前的系统设计开发过程有很大的不同: +1. 就在于系统的参与角色,产品、开发、测试等,需要形成一套通用语言; +2. 在于方案设计不再把db设计放在一个核心问题去解决,更加专注于业务模型本身,进行领域、业务聚合的设计,领域层的聚合及实体才是整个系统的核心内容; +3. 真正的面向对象编程,由过程式的事务脚本方式,转变为真正的面向对象。 + +### 分层架构 +

+ +

+ +- 用户界面层(或表示层) +负责向用户显示信息和解释用户指令。这里指的用户可以是另一个计算机系统, 不一定是使用用户界面的人 +- 应用层 +定义软件要完成的任务,并且指挥表达领域概念的对象来解决问题。这一层所负 责的工作对业务来说意义重大,也是与其他系统的应用层进行交互的必要渠道 +应用层要尽量简单,不包含业务规则或者知识,而只为下一层中的领域对象协调 任务,分配工作,使它们互相协作。它没有反映业务情况的状态,但是却可以具有 另外一种状态,为用户或程序显示某个任务的进度 +- 领域层(或模型层) +负责表达业务概念,业务状态信息以及业务规则。尽管保存业务状态的技术细节 是由基础设施层实现的,但是反映业务情况的状态是由本层控制并且使用的。领域 层是业务软件的核心 +- 基础设施层 +为上面各层提供通用的技术能力:为应用层传递消息,为领域层提供持久化机制, 为用户界面层绘制屏幕组件,等等。基础设施层还能够通过架构框架来支持4个层次 间的交互模式 + +## 为何开源 +工作中一直有个困恼:为什么身边很多项目后期维护时业务逻辑变的混乱不堪,service层代码变的庞大难以变更,维护成本居高不下,有没有好的解决方式的?
+Eric Evans的DDD(Domain-Driven Design 领域驱动设计)正是为了解决复杂业务而提出。 +我们1.1版本终于上线了,框架开源出来是想跟大家探讨并一起维护,希望今后有更多的项目和产品能使用基于框架开发。 + +## 相关文档 +- [CSDN博客-DDD系列](https://blog.csdn.net/haoxin963/category_10708582.html)持续更新中,欢迎关注! + + +## 维护者 + +- [haoxin963](https://github.com/haoxin963) + + +## 版权声明 + +Apache-2.0 license + +本软件基于 Apache-2.0 协议进行分发和使用,更多信息参见 [协议文件](LICENSE)。 \ No newline at end of file diff --git a/pom.xml b/pom.xml new file mode 100644 index 0000000..98acda8 --- /dev/null +++ b/pom.xml @@ -0,0 +1,43 @@ + + + 4.0.0 + + com.xtoon.cloud + xtoon-cloud + pom + 1.0.0 + + xtoon-common + xtoon-ops + xtoon-service + + + xtoon-cloud + xtoon-cloud是一款基于DDD的微服务开发框架 + + + + xin + haoxin + xiangtoon, Inc. + http://www.xiangtoon.com + + + + + + nexus-aliyun + nexus-aliyun + http://maven.aliyun.com/nexus/content/groups/public/ + + true + + + false + + + + + \ No newline at end of file diff --git a/xtoon-common/pom.xml b/xtoon-common/pom.xml new file mode 100644 index 0000000..172e586 --- /dev/null +++ b/xtoon-common/pom.xml @@ -0,0 +1,15 @@ + + + + xtoon-cloud + com.xtoon.cloud + 1.0.0 + + 4.0.0 + + xtoon-common + + + \ No newline at end of file diff --git a/xtoon-ops/pom.xml b/xtoon-ops/pom.xml new file mode 100644 index 0000000..73f5ec1 --- /dev/null +++ b/xtoon-ops/pom.xml @@ -0,0 +1,15 @@ + + + + xtoon-cloud + com.xtoon.cloud + 1.0.0 + + 4.0.0 + + xtoon-ops + + + \ No newline at end of file diff --git a/xtoon-service/pom.xml b/xtoon-service/pom.xml new file mode 100644 index 0000000..631ddc7 --- /dev/null +++ b/xtoon-service/pom.xml @@ -0,0 +1,15 @@ + + + + xtoon-cloud + com.xtoon.cloud + 1.0.0 + + 4.0.0 + + xtoon-service + + + \ No newline at end of file