repository-placement

name	repository-placement
description	リポジトリインターフェースの配置場所に関するガイド。クリーンアーキテクチャにおいて リポジトリインターフェースをドメイン層ではなくユースケース層に配置すべき理由を解説。 ドメインモデルとリポジトリの結合防止、構造による設計意図の強制を主眼とする。 トリガー：「リポジトリをどこに置く」「リポジトリインターフェースの配置」「ドメイン層にリポジトリ」 「クリーンアーキテクチャでリポジトリ」等のリポジトリ配置関連リクエストで起動。

リポジトリインターフェースの配置

結論

リポジトリインターフェースはユースケース層に置く。ドメイン層には置かない。

なぜドメイン層に置くと問題か

物理的な近さが結合を誘発する

同じ層にあると、ドメインモデルがリポジトリを使いやすくなる：

// ❌ 集約の中でリポジトリを使ってしまう
class Order {
  Order withRelatedOrder(OrderId relatedId, OrderRepository repo) {
    Order related = repo.findById(relatedId);  // ← 同じ層にあるから気軽に使える
    return this.withAddedRelatedOrder(related);
  }
}

// ❌ ドメインサービスがリポジトリだらけになる
class OrderDomainService {
  private OrderRepository orderRepo;
  private CustomerRepository customerRepo;
  private ProductRepository productRepo;
  private InventoryRepository inventoryRepo;
  // リポジトリの注入が増え続ける
}

ドメインが「永続化」を知ってしまう

// ドメイン層にこれがあるということは...
interface OrderRepository {
  void save(Order order);      // ← 「保存」という概念を知っている
  Order findById(OrderId id);  // ← 「取得」という概念を知っている
}

ドメインモデルは純粋なビジネスルールだけを持つべき。

ユースケース層に置く利点

構造が設計意図を強制する

[ドメイン層]              ← リポジトリをimportできない = 結合しない
     ↑
[ユースケース層]          ← リポジトリインターフェース定義（出力ポート）
     ↑
[インターフェースアダプタ層] ← リポジトリ実装（入力/出力アダプタ）

物理的な距離がガードレールになる：

• ドメインモデルからimportしにくい（別パッケージ/モジュール）
• 「リポジトリはユースケース層のポート」という意図が構造で伝わる
• 集約がIDで参照するルールを守りやすい

集約のID参照ルールを自然に守れる

// ✅ 集約は他の集約をIDで参照
class Order {
  private final CustomerId customerId;  // Customer実体ではなくID
  private final List<ProductId> productIds;
}

// ユースケース層でリポジトリを使って解決
class PlaceOrderUseCase {
  private OrderRepository orderRepo;
  private CustomerRepository customerRepo;

  void execute(PlaceOrderCommand cmd) {
    Customer customer = customerRepo.findById(cmd.customerId);
    // ユースケース層で必要なエンティティを取得
  }
}

検出パターン

ドメイン層にリポジトリがある兆候

domain/
  order/
    Order.java
    OrderRepository.java  ← ❌ ここにある

インターフェースアダプタ層にリポジトリインターフェースがある兆候

interface-adapters/
  repositories/
    OrderRepository.java  ← ❌ ここにある

正しい配置

domain/
  order/
    Order.java
    OrderId.java

usecases/  (または application/, interactor/)
  order/
    OrderRepository.java      ← インターフェース定義

interface-adapters/  (または adapters/, infra/)
  repositories/
    JpaOrderRepository.java   ← 実装

DDDとの関係

DDDの伝統的解釈では、リポジトリはドメインの一部（集約のライフサイクル管理）とされる。

しかし実践上は、ドメイン層に置くと結合が生まれやすい。クリーンアーキテクチャの規約では、 リポジトリインターフェースはユースケース層の出力ポートとして扱う。

アプローチ	メリット	デメリット
ドメイン層に配置	DDDの教科書通り	結合が生まれやすい
ユースケース層に配置	規約に一致/依存方向が明確	DDDの純粋主義と異なる

推奨: ユースケース層に配置し、構造でガードする。

レビューチェックリスト

1. 配置確認: リポジトリインターフェースがユースケース層にあるか？
2. 結合確認: ドメインモデル（エンティティ/集約）がリポジトリをimportしていないか？
3. ID参照確認: 集約が他の集約を実体ではなくIDで参照しているか？

参考

• Martin, Robert C. "Clean Architecture" (2017)
• Vernon, Vaughn. "Implementing Domain-Driven Design" (2013)

関連スキル（併読推奨）

このスキルを使用する際は、以下のスキルも併せて参照すること：

• clean-architecture: リポジトリ配置の基盤となる4層アーキテクチャ
• aggregate-design: リポジトリが対応する集約の設計ルール
• repository-design: リポジトリの命名・CQS・メソッド設計