https://design.okuda-studio.com/tags/domain/Recent content in Domain on 設計で、迷わなくなるために | 奥田智紘Hugo -- 0.159.2jaMon, 09 Feb 2026 11:00:00 +0900https://design.okuda-studio.com/posts/0007-domain-vs-usecase/Mon, 09 Feb 2026 11:00:00 +0900https://design.okuda-studio.com/posts/0007-domain-vs-usecase/<ul> <li><a href="#domain-%E3%81%A8-usecase-%E3%81%AE%E9%81%95%E3%81%84%E3%82%92%E6%95%B4%E7%90%86%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B">Domain と UseCase の違いを整理してみる</a> <ul> <li><a href="#%E4%B8%80%E8%A8%80%E3%81%A7%E8%A8%80%E3%81%86%E3%81%A8%E4%BD%95%E3%81%8C%E9%81%95%E3%81%86%E3%81%AE%E3%81%8B">一言で言うと何が違うのか</a></li> <li><a href="#domain-%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B">Domain とは何か</a> <ul> <li><a href="#domain-%E3%81%AF%E6%84%8F%E5%91%B3%E3%81%A8%E3%83%AB%E3%83%BC%E3%83%AB%E3%81%AE%E9%9B%86%E5%90%88%E4%BD%93">Domain は「意味」と「ルール」の集合体</a></li> <li><a href="#domain-%E3%81%AE%E4%BE%8B">Domain の例</a></li> </ul> </li> <li><a href="#domain-%E3%81%8C%E3%82%84%E3%82%89%E3%81%AA%E3%81%84%E3%81%93%E3%81%A8">Domain がやらないこと</a></li> <li><a href="#usecase-%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B">UseCase とは何か</a> <ul> <li><a href="#usecase-%E3%81%AF%E5%8B%95%E8%A9%9E%E3%81%AE%E5%B1%A4">UseCase は「動詞の層」</a></li> <li><a href="#usecase-%E3%81%AE%E4%BE%8B">UseCase の例</a></li> </ul> </li> <li><a href="#domain-%E3%81%A8-usecase-%E3%81%AE%E9%96%A2%E4%BF%82">Domain と UseCase の関係</a></li> <li><a href="#%E3%81%AA%E3%81%9C-usecase-%E3%81%8C%E5%88%86%E3%81%8B%E3%82%8A%E3%81%AB%E3%81%8F%E3%81%84%E3%81%AE%E3%81%8B">なぜ UseCase が分かりにくいのか</a></li> <li><a href="#usecase-%E3%82%92%E4%BD%9C%E3%82%8B%E3%81%B9%E3%81%8D%E3%82%BF%E3%82%A4%E3%83%9F%E3%83%B3%E3%82%B0">UseCase を作るべきタイミング</a></li> <li><a href="#entity--domain-%E5%A4%89%E6%8F%9B%E3%81%AF%E3%81%A9%E3%81%93%E3%81%A7%E3%82%84%E3%82%8B%E3%81%B9%E3%81%8D%E3%81%8B">Entity → Domain 変換はどこでやるべきか</a></li> <li><a href="#domain-%E3%81%A8-usecase-%E3%82%92%E5%88%86%E3%81%91%E3%82%8B%E6%9C%80%E5%A4%A7%E3%81%AE%E3%83%9D%E3%82%A4%E3%83%B3%E3%83%88">Domain と UseCase を分ける最大のポイント</a></li> <li><a href="#%E3%82%88%E3%81%8F%E3%81%82%E3%82%8B%E3%82%A2%E3%83%B3%E3%83%81%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3">よくあるアンチパターン</a></li> <li><a href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB">おわりに</a></li> </ul> </li> </ul> <h1 id="domain-と-usecase-の違いを整理してみる">Domain と UseCase の違いを整理してみる</h1> <p>Clean Architecture や DDD を学んでいると、ほぼ確実に次の疑問にぶつかります。</p> <ul> <li>Domain と UseCase の違いがよく分からない</li> <li>どこまでが Domain で、どこからが UseCase なのか曖昧</li> <li>UseCase を作ろうとすると、何を書けばいいのか分からない</li> </ul> <p>私自身、このあたりで何度も立ち止まりました。 この記事では、実装経験を通して整理できた <strong>Domain と UseCase の違い</strong> を、自分なりの言葉でまとめてみます。</p> <hr> <h2 id="一言で言うと何が違うのか">一言で言うと何が違うのか</h2> <p>まず、かなり大胆に要約します。</p> <ul> <li> <p><strong>Domain</strong> →「この世界では、何が正しく、何が成り立つか」を表す</p> </li> <li> <p><strong>UseCase</strong> →「その正しさを、どういう手順・文脈で使うか」を表す</p>https://design.okuda-studio.com/posts/0006-domain-layer-or-not/Sun, 08 Feb 2026 17:00:00 +0900https://design.okuda-studio.com/posts/0006-domain-layer-or-not/<ul> <li><a href="#domain-%E3%83%AC%E3%82%A4%E3%83%A4%E3%83%BC%E3%81%8B%E3%81%A9%E3%81%86%E3%81%8B%E3%82%92%E5%88%A4%E6%96%AD%E3%81%99%E3%82%8B%E5%9F%BA%E6%BA%96">Domain レイヤーかどうかを判断する基準</a> <ul> <li><a href="#domain-%E3%83%AC%E3%82%A4%E3%83%A4%E3%83%BC%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B%E7%B0%A1%E5%8D%98%E3%81%AB">Domain レイヤーとは何か（簡単に）</a></li> <li><a href="#%E5%88%A4%E6%96%AD%E5%9F%BA%E6%BA%96%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%8C%E3%81%9D%E3%82%8C%E3%82%92%E6%84%8F%E8%AD%98%E3%81%99%E3%82%8B%E3%81%8B">判断基準：ユーザーがそれを意識するか？</a></li> <li><a href="#%E4%BE%8B1%E4%BF%9D%E5%AD%98%E5%87%A6%E7%90%86%E3%81%AF-domain-%E3%81%8B">例1：保存処理は Domain か？</a> <ul> <li><a href="#%E3%82%B1%E3%83%BC%E3%82%B9a%E4%BF%9D%E5%AD%98%E5%85%88%E3%82%92%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%8C%E6%84%8F%E8%AD%98%E3%81%97%E3%81%AA%E3%81%84%E5%A0%B4%E5%90%88">ケースA：保存先をユーザーが意識しない場合</a></li> <li><a href="#%E3%82%B1%E3%83%BC%E3%82%B9b%E4%BF%9D%E5%AD%98%E5%85%88%E3%82%92%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%8C%E6%84%8F%E8%AD%98%E7%9A%84%E3%81%AB%E9%81%B8%E6%8A%9E%E3%81%99%E3%82%8B%E5%A0%B4%E5%90%88">ケースB：保存先をユーザーが意識的に選択する場合</a></li> </ul> </li> <li><a href="#%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%8C%E6%84%8F%E8%AD%98%E3%81%99%E3%82%8B%E3%81%A8%E3%81%84%E3%81%86%E5%9F%BA%E6%BA%96%E3%81%AE%E4%BD%BF%E3%81%84%E3%81%A9%E3%81%93%E3%82%8D">「ユーザーが意識する」という基準の使いどころ</a></li> <li><a href="#usecase-%E3%81%A8%E3%81%AE%E9%96%A2%E4%BF%82">UseCase との関係</a></li> <li><a href="#%E6%B3%A8%E6%84%8F%E7%82%B9%E3%81%99%E3%81%B9%E3%81%A6%E3%82%92-domain-%E3%81%AB%E5%85%A5%E3%82%8C%E3%81%AA%E3%81%84">注意点：すべてを Domain に入れない</a></li> <li><a href="#%E8%BF%B7%E3%81%A3%E3%81%9F%E3%81%A8%E3%81%8D%E3%81%AE%E6%9C%80%E7%B5%82%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF">迷ったときの最終チェック</a></li> <li><a href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB">おわりに</a></li> </ul> </li> </ul> <h1 id="domain-レイヤーかどうかを判断する基準">Domain レイヤーかどうかを判断する基準</h1> <p>―「ユーザーが意識するか？」という視点―</p> <p>設計をしていると、次のような悩みにぶつかることがあります。</p> <ul> <li>この処理は Domain レイヤーに置くべきか？</li> <li>UseCase なのか、それとも Data レイヤーの責務なのか？</li> <li>そもそも Domain って何を置く場所なのか？</li> </ul> <p>とくに Clean Architecture や DDD を学び始めた頃は、 「正解の置き場所」を探そうとして、かえって混乱しがちです。</p> <p>この記事では、私が設計を考える際に <strong>ひとつの判断基準</strong> として使っている考え方を紹介します。</p> <hr> <h2 id="domain-レイヤーとは何か簡単に">Domain レイヤーとは何か（簡単に）</h2> <p>Domain レイヤーは、ざっくり言うと</p> <ul> <li>アプリが扱う <strong>概念</strong></li> <li>その概念に関する <strong>ルール</strong></li> <li>「それは正しいかどうか」の判断</li> </ul> <p>を表す層です。</p> <p>技術的な詳細（DB、API、ライブラリなど）からは距離を置き、 <strong>アプリの意味そのもの</strong> を表現する場所だと考えています。</p> <hr> <h2 id="判断基準ユーザーがそれを意識するか">判断基準：ユーザーがそれを意識するか？</h2> <p>私が Domain レイヤーかどうかを判断する際に使っている基準は、次の問いです。</p> <blockquote> <p><strong>「ユーザーは、その機能や概念を意識してアプリを操作するか？」</strong></p> </blockquote> <p>この問いに <strong>YES</strong> なら、 その概念や処理は Domain レイヤー（または UseCase）に属する可能性が高いです。</p> <p><strong>NO</strong> なら、 それは Data レイヤーや Infrastructure に閉じ込めるべきものだと考えます。</p>