プロジェクト構造

Go プロジェクトアーキテクチャパターン：フラット構造こうぞうと DDD。

フラットプロジェクト構造（Lightweight DDD / CRUD-heavy）

project-root/
├── cmd/
│   └── api/
│       └── main.go              # エントリポイント：DB、Router、DI 初期化
├── internal/
│   ├── config/
│   │   └── config.go            # 環境変数 / 設定読み込み
│   ├── order/                   # リソースモジュール
│   │   ├── model.go             # Entity / Value Object（純粋なデータ構造）
│   │   ├── repository.go        # Repository interface + シンプルな DB 実装
│   │   ├── service.go           # ビジネスロジック / Use Case
│   │   └── handler.go           # HTTP Handler / Router
│   ├── user/                    # 別のリソースモジュール、同じ構造
│   │   ├── model.go
│   │   ├── repository.go
│   │   ├── service.go
│   │   └── handler.go
│   └── util/                    # ユーティリティ関数 / helper
│       └── logger.go
├── scripts/                     # migration、seed またはその他のツールスクリプト
├── test/                        # 統合テスト / fixtures
└── go.mod

フラット構造の説明

ファイル	責任
model.go	Entity / Value Object、純粋じゅんすいなデータオブジェクト、DB や HTTP ロジックを含ふくまない
repository.go	Repository interface + シンプルな実装じっそう（DB CRUD）、service が呼よび出だす
service.go	ビジネスロジック / Use Case、フローオーケストレーション、repository を呼よび出だす
handler.go	HTTP / gRPC Handler、request を解析かいせき → service を呼よび出だす → response を返かえす
util/logger.go	共有きょうゆうユーティリティ関数かんすう、ログ、helper、検証けんしょう関数かんすうなど

呼よび出だしフロー：

HTTP Request → handler.go → service.go → repository.go → DB

DDD（Domain-Driven Design）

project-root/
├── cmd/
│   └── api/
│       └── main.go                    # エントリポイント、依存関係の組み立て、HTTP Server 起動
├── internal/
│   ├── domain/                        # コアビジネスロジック、フレームワークに依存しない
│   │   └── order/
│   │       ├── aggregate/             # Aggregate Root、コア動作を担う
│   │       │   └── order.go
│   │       ├── entity/                # 補助 Entity
│   │       │   └── line_item.go
│   │       ├── valueobject/           # Value Object、不変オブジェクト
│   │       │   ├── order_id.go
│   │       │   └── money.go
│   │       ├── repository/            # Repository Interface（Domain インターフェース）
│   │       │   └── order_repository.go
│   │       ├── service/               # Domain Service（Aggregate 間 / 複雑なルール）
│   │       │   └── order_domain_service.go
│   │       ├── event/                 # Domain Event
│   │       │   └── order_created.go
│   │       └── factory/               # Aggregate Factory
│   │           └── order_factory.go
│   ├── application/                   # システム Use Case（エントリ）
│   │   └── order/
│   │       ├── command/               # システム状態を変更
│   │       │   └── create_order.go
│   │       ├── query/                 # データ読み取り
│   │       │   └── get_order.go
│   │       └── dto/                   # Data Transfer Object
│   │           └── order_dto.go
│   ├── infrastructure/                # 技術詳細の実装
│   │   └── order/
│   │       ├── persistence/           # Repository 実装（MySQL, Postgres…）
│   │       │   └── mysql_order_repository.go
│   │       └── messaging/             # Kafka / RabbitMQ Publisher
│   │           └── kafka_publisher.go
│   └── interfaces/                    # 外部インターフェース / API レイヤー
│       └── http/
│           └── order/
│               └── handler.go         # HTTP handler、application のみを呼び出す
└── app/
    └── bootstrap.go                   # プロジェクト組み立てポイント、DI / wiring

正式せいしき DDD の説明せつめい

レイヤー	責任せきにん
domain	コアビジネスロジック、Aggregate / Entity / ValueObject / Domain Service / Repository Interface / Event / Factory を含ふくむ
application	システム Use Case、フローと transaction boundary を決定けってい、外部がいぶに DTO を返かえす
infrastructure	技術ぎじゅつ実装じっそうの詳細しょうさい、Repository / Event Publisher / Messaging を実装じっそう
interfaces	外部がいぶインターフェース (HTTP/gRPC/CLI)、application レイヤーのみを呼よび出だす
app/bootstrap	DI / wiring、repository / service / use case / handler を構築こうちく

呼よび出だしフロー：

HTTP Request → interfaces/handler → application/command → domain/aggregate + domain/service → repository → DB

よくある間違い