システムの構成を説明するとき、「全体像から話したいのに細かい図になりすぎる」「関係者によって見たい粒度が違う」「図が増えるほど、どの図を見ればよいか分からなくなる」といった問題が起こりがちです。こうしたときに役立つのがC4モデルです。
C4モデルは、ソフトウェアアーキテクチャを複数の粒度に分けて表現する考え方です。いきなり細部を描くのではなく、まずシステム全体を示し、必要に応じて内部構造へ段階的に掘り下げます。
この記事では、C4モデルの意味、4つのレベル、使い方、具体例、向いている場面、注意点までを順に解説します。
C4モデルとは
C4モデルとは、ソフトウェアシステムの構造を、異なる粒度の図で段階的に説明するためのモデルです。
名称のC4は、主に次の4つのレベルを表します。
- Context:システムコンテキスト
- Container:コンテナ
- Component:コンポーネント
- Code:コード
特徴は、1枚の図にすべてを詰め込まないことです。
まず「このシステムは誰が使い、どの外部システムと関係するか」を示します。次に「内部にはどのアプリケーションやデータストアがあるか」、さらに必要なら「その中の主要コンポーネントはどう分かれるか」と掘り下げます。
この段階構造によって、経営・企画、業務担当、開発者など、異なる関係者に合わせて説明の粒度を変えやすくなります。
C4モデルの4つのレベル
1. System Context
最も大きな視点でシステムを捉える図です。
対象システムを中心に置き、利用者や外部システムとの関係を示します。ここでは内部実装の詳細には立ち入りません。
たとえばECサイトであれば、顧客、運営担当者、決済サービス、配送システムなどとの関係を表します。
この図の目的は、「対象システムは何で、誰と何につながっているか」を短時間で理解できるようにすることです。
2. Container
次に、対象システムの内部を大きな実行単位や保存単位に分けます。
ここでいうコンテナは、一般的な仮想化技術のコンテナだけを意味するものではありません。Webアプリケーション、モバイルアプリ、API、データベース、バッチ処理など、システムを構成する大きな単位として整理します。
ECサイトなら、Webアプリ、商品API、注文API、データベース、外部決済連携などを示します。
3. Component
コンテナの内部をさらに主要なコンポーネントへ分けた図です。
たとえば注文APIの中を、注文受付、在庫確認、決済連携、注文保存などの責務に分けて表現します。
このレベルでは、設計担当者や開発者が「どこにどの責務があるか」を理解できることが重要です。
4. Code
最も細かいレベルで、クラスやインターフェースなどコードに近い構造を示します。
ただし、すべてのシステムでCodeレベルまで作る必要はありません。実務では、Context、Container、必要な箇所だけComponentまで作るだけでも十分なことがあります。
C4モデルを使う目的
C4モデルの目的は、システム構造を「誰に、どの粒度で説明するか」を整理することです。
全体像と詳細を分ける
1枚の図にすべてを描くと、情報量が増えすぎます。C4モデルでは全体と詳細を分けるため、必要なレベルだけを見せられます。
関係者間の認識をそろえる
企画担当者が知りたいのは全体像、開発者が知りたいのは内部構造というように、立場によって必要な情報は異なります。
粒度を分けることで、同じシステムを異なる視点から説明できます。
設計意図を残す
コードだけでは「なぜこの構成なのか」が伝わりにくいことがあります。C4モデルで構造を残すと、後から参加したメンバーにも全体像を共有しやすくなります。
C4モデルのやり方
実務では、いきなり細かいComponent図から作るのではなく、上位レベルから順に進める方が整理しやすくなります。
詳しい手順はC4モデルのやり方|システム企画・業務設計で使う手順をステップで解説でも整理しています。
1. 対象システムを決める
まず、どのシステムを説明する図なのかを明確にします。
複数システムを一度に詳細化しようとすると境界が曖昧になるため、対象を決めてから作ります。
2. 利用者と外部システムを洗い出す
Context図では、誰が使うか、どの外部システムと連携するかを整理します。
この段階では、内部技術よりもシステムの役割と境界を確認することが重要です。
3. 主要なコンテナへ分ける
次に、対象システムをWebアプリ、API、データベースなどの大きな単位へ分けます。
各コンテナについて、役割と主な技術を簡潔に記載すると理解しやすくなります。
4. 必要な部分だけComponentへ掘り下げる
すべてのコンテナを詳細化する必要はありません。
複雑な部分、変更が多い部分、関係者間で認識をそろえたい部分を優先してComponent図を作ります。
5. 関係と方向を明確にする
箱だけを並べるのではなく、誰が何を使うのか、どのシステムからどこへ情報が流れるのかを矢印で示します。
6. 説明文を短く付ける
図の各要素には、名称だけでなく役割を短く書きます。
「注文API」だけではなく「注文受付と在庫確認を行うAPI」と記載すると、初見でも理解しやすくなります。
すぐに使える項目例はC4モデルテンプレート|そのまま使える項目例と書き方も参考になります。
C4モデルの具体例
例として、社内の申請システムを考えます。
Contextレベル
対象システムは「社内申請システム」です。
利用者として一般社員と承認者がいます。また、社員情報を取得する人事システム、通知を送るメールサービスと連携しています。
この図だけで、「誰が使うシステムで、外部と何につながるか」が分かります。
Containerレベル
社内申請システムを、次のように分けます。
- Webアプリ:申請入力と承認画面を提供
- 申請API:申請データの登録・更新を担当
- データベース:申請情報を保存
- 通知処理:承認依頼や完了通知を送信
この段階で、システム内部の大まかな役割分担が見えます。
Componentレベル
さらに申請APIを掘り下げると、申請受付、承認ルール判定、状態更新、履歴記録などのコンポーネントに分けられます。
ここまで整理すると、変更時に「どの部分へ影響するか」を考えやすくなります。
より具体的な活用イメージはC4モデルの具体例|システム企画・業務設計での活用イメージを解説で確認できます。
C4モデルが向いている場面
C4モデルは、次のような場面で使いやすい方法です。
- 新しいシステムの全体像を説明したい
- 既存システムの構造を整理したい
- 開発チームと業務担当で共通認識をつくりたい
- 複雑なシステムを段階的に説明したい
- 引き継ぎ資料としてアーキテクチャを残したい
- 改修時の影響範囲を把握したい
特に、1枚の巨大な構成図では説明しにくいシステムに向いています。
C4モデルでよくある失敗
最初から細かく描きすぎる
最初にクラスや内部処理まで描くと、全体像が見えなくなります。まずContext、次にContainerという順番を意識します。
レベルが混ざる
ひとつの図の中に、システム全体、データベース、細かなクラスを同じ粒度で置くと読みづらくなります。
どのレベルの図なのかを明確にし、その粒度に合わない要素は別図へ分けます。
箱だけで関係が分からない
要素を並べただけでは、どこからどこへアクセスするのか分かりません。関係線と簡単な説明を付けます。
技術名だけを書く
「Java」「PostgreSQL」などの技術名だけでは、役割が伝わりません。名称と役割をセットで記載します。
更新されない
システム変更後に図が更新されなければ、実態と合わない資料になります。変更時にどの図を更新するかを運用ルールに含めることが重要です。
よくあるつまずきと改善策はC4モデルで失敗しやすいポイント|よくある間違いと改善策でも整理しています。
C4モデルを実務で使いやすくするコツ
C4モデルは、すべてのレベルを完璧に作ることが目的ではありません。
重要なのは、説明相手に必要な粒度を選ぶことです。
経営・企画との会話ならContext、開発全体の設計共有ならContainer、特定領域の実装方針を議論するならComponentというように使い分けます。
また、図を作る際は各要素について次の3点を揃えると理解しやすくなります。
- 名前
- 役割
- 関係先
この3点が明確なら、図形の装飾を増やさなくても伝わる図になります。
生成AIを補助的に使って要素の洗い出しや図のたたき台を作る場合は、生成AIでC4モデルを使う方法|プロンプト例と人が確認すべきポイントも参考になります。生成AIが出した構成は、実際のシステム境界、データ連携、責務分担と一致しているかを人が確認する必要があります。
まとめ
C4モデルは、ソフトウェアシステムの構造をContext、Container、Component、Codeという異なる粒度で段階的に表現するモデルです。
ポイントは、1枚の図ですべてを説明しようとしないことです。全体像から必要な部分へ順に掘り下げることで、関係者ごとに適切な情報量で説明できます。
まずは対象システムについて、「誰が使うか」「どの外部システムとつながるか」をContext図として整理し、その後に主要なアプリケーションやデータストアをContainer図へ分けるところから始めると実務で使いやすくなります。