go ddd

Go-DDD：Golangのドメイン駆動型デザインテンプレート

Golangのドメイン駆動設計（DDD）アプローチを示すリファレンス実装/テンプレートリポジトリであるgo-dddへようこそ。このプロジェクトの目的は、開発者と建築家が特にGOのコンテキストでDDD構造を理解するのを支援すること、そしてそれがどのようにクリーン、より保守可能、およびスケーラブルなコードベースにつながるかを支援することです。

概要

ドメイン駆動型設計は、実装を進化するモデルに接続することにより、複雑なエンタープライズソフトウェアを構築するために使用される方法論と設計パターンです。 go-ddd Sellers Productsを販売できるシンプルな市場を設定することにより、これを紹介します。

なぜDDD？

• ユビキタス言語：開発者と利害関係者の間で共通の言語を促進します。
• ドメインロジックの分離：ドメインロジックは、インフラストラクチャおよびアプリケーションレイヤーとは別になく、固体原理を促進します。
• スケーラビリティ：マイクロサービスアーキテクチャの移行を容易にすることができます。

リポジトリ構造

• domain ：ビジネスロジックとルールを表すソフトウェアの中心。
  • entities ： ProductやSellerなど、システム内の基本的なオブジェクト。基本的な検証ロジックが含まれています。
• application ：ドメインレイヤーと相互作用するユースケース固有の操作が含まれています。
• infrastructure ：データベースアクセスなどの技術的な機能を備えた高レイヤーをサポートします。
  • db ：データベースアクセスとモデル。
  • repositories ：ストレージニーズの具体的な実装。
• interface ：APIエンドポイントのように、外部世界と相互作用する外部レイヤー。
  • api/rest ：HTTPリクエストと応答を管理するためのハンドラーまたはコントローラー。

さらなる原則

• ドメイン
  • 他のレイヤーに依存してはなりません。
  • インターフェイスを備えたインフラストラクチャを提供しますが、インフラストラクチャにアクセスしてはなりません。
  • ビジネスロジックとルールを実装します。
  • エンティティの検証を実行します。検証済みのエンティティは、インフラストラクチャレイヤーに渡されます。
  • ドメインレイヤーは、エンティティのデフォルトを設定します（例：IDまたは作成タイムスタンプなど）。インフラストラクチャレイヤーやデータベースにデフォルトを設定しないでください！
  • ドメインを外の世界に漏らしないでください。
• 応用
  • ドメインレイヤーとインフラストラクチャレイヤー間の接着剤コード。
• インフラストラクチャー
  • リポジトリは、ドメインエンティティをデータベースモデルに変換して取得する責任があります。ここではビジネスロジックは実行されません。
  • ドメインレイヤーによって定義されたインターフェイスを実装します。
  • PostgresまたはMySQLデータベースへのアクセスなど、永続性ロジックを実装します。
  • ストレージに書き込むときは、書き込みデータを返す前に読み取ります。これにより、データが正しく記述されることが保証されます。

ベストプラクティス

• リポジトリの読み取りメソッドから検証済みのエンティティを返しないでください。代わりに、ドメインエンティティタイプを直接返します。
  • 検証は将来的に変更される可能性があり、データベース内のすべてのデータを変更したくありません。
  • それ以外の場合、別の検証ロジックで記述されたデータベースからデータを読み取ることができません。
• データベースにデフォルト値（現在のタイムスタンプまたはIDなど）を入れないでください。いくつかの理由で、それらをドメインレイヤー（工場！）に設定します。
  • 2つの真実の源を持っていることは非常に危険です。
  • ドメインレイヤーをテストする方が簡単です。
  • データベースは交換される可能性があり、すべてのデフォルト値を変更する必要はありません。
• インフラストラクチャレイヤーで書き込み後、常にエンティティを読み取ります。
  • これにより、データが正しく記述されることが保証され、古いデータで動作することはありません。
• vs find 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ライセンスの下で配布されます。詳細については、ライセンスを参照してください。