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許可分發。有關更多信息，請參見許可證。