Go_MYクリーンアーキテクチャ

クリーンアーキテクチャ

1. 例

/root
|-- /app
|   |-- /handler        # リクエストを受け取り、レスポンスを返すためのハンドラ（Controllerの役割）
|   |-- /middleware     # Middleware関連 (認証、ロギングなど)
|
|-- /domain
|   |-- /entity         # ドメインモデル (Databaseのテーブルやオブジェクトの定義)
|   |-- /repository     # データの保存や取得に関するインターフェース
|   |-- /service        # ビジネスロジックやドメインロジックを実装
|   |-- /usecase        # アプリケーションのユースケースを表現
|
|-- /infrastructure
|   |-- /db             # データベース接続、マイグレーション、ORMなど
|   |-- /logger         # ロギングの実装
|   |-- /repository     # repositoryインターフェースの実際の実装 (例: DBへの保存や取得の処理)
|
|-- /cmd                # アプリケーションのエントリーポイントやCLIツール
|
|-- go.mod              # 依存関係の管理
|-- go.sum              # 依存関係のチェックサム
|-- main.go             # アプリケーションの起動ポイント

2.例

/project-name
|--/cmd
|  |--/appname
|  |  |--main.go
|
|--/pkg
|  |--/usecase
|  |  |--/user
|  |  |  |--usecase.go
|  |  |  |--usecase_test.go
|  |
|  |--/repository
|  |  |--/user
|  |  |  |--memory.go
|  |  |  |--mysql.go
|  |  |  |--repository.go
|  |
|  |--/entity
|  |  |--user.go
|
|--/internal
|  |--/handler
|  |  |--/http
|  |  |  |--user_handler.go
|
|  |--/middleware
|  |  |--auth.go
|
|--/config
|  |--config.go
|
|--/migration
|  |--001_initial_setup.sql
|
|--/scripts
|  |--deploy.sh
|
|--go.mod
|--go.sum
|--README.md

1. cmd - アプリケーションのエントリーポイント。main関数がここに配置される。

2. pkg - 主要なビジネスロジックやコアロジックが配置される。
• usecase - アプリケーションのユースケースやビジネスロジックを表現する。
• repository - データの永続化やデータアクセスメソッドを持つインターフェースと、それを実装する具体的なリポジトリ。
• entity - ドメインオブジェクトやエンティティの定義。

3. internal - アプリケーションの内部の実装。
• handler - HTTPリクエストハンドラや、その他のインターフェースのハンドラ。
• middleware - ミドルウェアの定義や実装。

4. config - アプリケーションの設定や環境変数の管理。

5. migration - データベースのマイグレーションスクリプト。

6. scripts - デプロイやビルドを助けるスクリプト。

3.例：

project-root/
├── cmd/
│   └── appname/
│       └── main.go     # アプリケーションのエントリーポイント
├── api/                # API定義やミドルウェア
│   ├── handler/
│   ├── middleware/
│   └── response/
├── domain/             # ドメインロジックやエンティティの定義
│   ├── entity/
│   └── service/
├── usecase/            # アプリケーションのユースケースを表現するロジック
├── repository/         # データへのアクセス方法を定義 (例: DB, 他のサービス)
├── delivery/           # アプリケーションのインターフェース部分 (例: HTTP, gRPC)
│   ├── http/
│   └── grpc/
├── pkg/                # 共用のヘルパー関数やライブラリ
└── infrastructure/     # データベースの接続、ログ、外部サービスとの通信などのインフラ関連のコード

• cmd/: アプリケーションの実際のエントリーポイント。main.go では依存性の注入やアプリケーションの起動処理を行う。

• domain/: アプリケーションの中核をなすドメインロジックやエンティティをここに配置する。

• usecase/: ビジネスロジックを表現する部分。

• repository/: 永続化のためのインターフェースを定義。具体的な実装は infrastructure/ にある。

• delivery/: アプリケーションがどのようにデリバリーされるかを定義 (例: HTTP API, gRPC, CLI など)。

• pkg/: アプリケーション全体で使用するヘルパーや共通の関数。

• infrastructure/: インフラストラクチャ関連の具体的な実装を配置。