go ddd

GO-DDD：Golang的域驱动设计模板

欢迎使用go-ddd ，这是一个参考实现/模板存储库，该存储库演示了Golang域驱动设计（DDD）方法。该项目旨在帮助开发人员和建筑师了解DDD结构，尤其是在GO的背景下，以及如何导致更清洁，更可维护和可扩展的代码库。

概述

域驱动的设计是一种方法和设计模式，用于通过将实现连接到不断发展的模型来构建复杂的企业软件。 go-ddd通过建立一个简单的市场来展示这一点， Sellers可以在其中出售Products 。

为什么要DDD？

• 无处不在的语言：促进开发人员和利益相关者之间的通用语言。
• 域逻辑的隔离：域逻辑与基础架构和应用层分开，促进坚实的原理。
• 可伸缩性：允许更轻松的微服务体系结构过渡。

存储库结构

• domain ：软件的核心，代表业务逻辑和规则。
  • entities ：我们系统中的基本对象，例如Product和Seller 。包含基本验证逻辑。
• application ：包含与域层相互作用的用例特定操作。
• infrastructure ：支持具有数据库访问等技术功能的较高层。
  • db ：数据库访问和模型。
  • repositories ：我们的存储需求的具体实现。
• interface ：与外部世界相互作用的外层，例如API端点。
  • api/rest ：用于管理HTTP请求和响应的处理程序或控制器。

进一步的原则

• 领域
  • 不得取决于其他层。
  • 提供具有接口的基础架构，但不得访问基础架构。
  • 实施业务逻辑和规则。
  • 对实体执行验证。经过验证的实体将传递给基础架构层。
  • 域层设置实体的默认值（例如，ID或创建时间戳）。不要在基础架构层甚至数据库中设置默认值！
  • 不要将域对象泄漏到外界。
• 应用
  • 域和基础架构层之间的胶水代码。
• 基础设施
  • 存储库负责将域实体转换为数据库模型并检索它。这里没有执行业务逻辑。
  • 实现由域层定义的接口。
  • 实现持久性逻辑，例如访问Postgres或MySQL数据库。
  • 写入存储时，请在返回书面数据之前先阅读书面数据。这样可以确保数据正确编写。

最佳实践

• 不要从存储库中的读取方法返回经过验证的实体。而是直接返回域实体类型。
  • 验证将来可能会发生变化，并且您不想更改数据库中的所有数据。
  • 否则，您将无法读取具有不同验证逻辑的数据库中的数据。
• 不要将默认值（例如当前时间戳或ID）放在数据库中。由于几个原因，将它们设置在域层（工厂！）中：
  • 有两个真理来源是非常危险的。
  • 测试域层更容易。
  • 数据库可以更换，您不想更改所有默认值。
• 在基础架构层写入后，始终读取实体。
  • 这样可以确保数据正确编写，并且我们从不在过时的数据上运行。
• find vs get ：
  • find方法可以返回null或空列表。
  • get方法必须返回值。如果找不到该值，请丢下错误。
• 删除：始终使用软删除。在删除实体时，在数据库中创建deleted_at列，并将其设置为当前时间戳。这样，您可以随时在需要时恢复实体。

入门

1. 克隆这个存储库：

git clone https://github.com/sklinkert/go-ddd.git
cd go-ddd
go mod download
go run ./...

贡献

欢迎贡献，问题和功能请求！随时检查问题页面。

执照

根据MIT许可分发。有关更多信息，请参见许可证。