C4モデルは、ソフトウェアや業務システムの構造を「Context」「Container」「Component」「Code」の4つの粒度で段階的に整理するための考え方です。
実務で使うときに難しいのは、図を描くことそのものより、「どこまで細かく書くか」「誰との関係を載せるか」「責任境界をどう表すか」を揃えることです。
この記事では、C4モデルをそのまま使えるテンプレート形式でまとめます。各欄の書き方、受注管理システムを題材にした記入済み例、良い例・悪い例、レビュー時の判断基準まで含めています。
C4モデルの意味や基本構造から確認したい場合は、C4モデルとは?を参照してください。実際の作成手順を先に確認したい場合は、C4モデルのやり方が役立ちます。
そのまま使えるC4モデルテンプレート
以下をコピーして、対象システムごとに埋めてください。
1. 基本情報
- 対象システム名:
- 図の目的:
- 主な読者:
- 今回扱う粒度:Context / Container / Component / Code
- 作成日:
- 作成者:
- レビュー者:
2. Contextテンプレート
- 対象システム:
- 対象システムの役割:
- 主な利用者:
- 外部システム:
- 利用者との関係:
- 外部システムとの関係:
- 対象システムの外に置く責任:
- 対象システムの境界:
- Context図で伝えたいこと:
3. Containerテンプレート
各Containerについて、次を記入します。
- Container名:
- 種別:Webアプリ / API / バッチ / DB / メッセージキュー / その他
- 主な責任:
- 主な利用者・呼び出し元:
- 接続先:
- 主なデータ:
- 採用技術:
- このContainerに置かない責任:
- 可用性・性能・セキュリティ上の注意点:
4. Componentテンプレート
詳細化が必要なContainerだけ、次を記入します。
- 対象Container:
- Component名:
- 主な責任:
- 入力:
- 出力:
- 呼び出すComponent:
- 呼び出されるComponent:
- 依存する外部要素:
- 例外・失敗時の扱い:
- この粒度で確認したい設計判断:
5. Codeテンプレート
Codeレベルまで説明が必要な場合だけ使います。
- 対象Component:
- クラス・モジュール名:
- 主な責任:
- 主要な公開インターフェース:
- 主な依存先:
- 主要データ構造:
- 実装上の制約:
- この図が必要な理由:
6. 依存関係・データ所有テンプレート
- データ名:
- 正本を持つContainer / 外部システム:
- 読み取り側:
- 更新側:
- 同期 / 非同期:
- 連携方式:
- 失敗時の再試行:
- 二重更新を防ぐ方法:
- 監査・追跡方法:
7. 非機能要件対応テンプレート
- 非機能要件:
- 対応するContainer / Component:
- 設計上の対応:
- 確認方法:
例:
- 非機能要件:受注登録は通常2秒以内
- 対応箇所:受注API
- 設計上の対応:同期処理を受注受付・検証・確定までに限定し、請求連携は非同期化
- 確認方法:負荷試験で95パーセンタイルを確認
8. レビューチェック
- Contextで利用者と外部システムが分かるか:
- システム境界が明確か:
- Containerごとの責任が重複していないか:
- データの正本が明確か:
- 依存方向が分かるか:
- 同期・非同期の違いが分かるか:
- 必要以上にComponent化していないか:
- Code図が本当に必要か:
- 非機能要件と構造が対応しているか:
- 読者に対して粒度が細かすぎないか:
各欄の書き方
図の目的を最初に書く
悪い例:
- システム構成を説明する
これでは、誰に何を伝えるかが曖昧です。
良い例:
- 業務部門と開発チームで、受注管理システムの責任境界と外部連携を合意する
目的が決まると、どのレベルまで描くべきかを判断しやすくなります。
Contextでは内部構造を書きすぎない
Contextは「対象システムが誰と何をやり取りするか」を示すレベルです。
悪い例:
- API、DB、ジョブ、テーブルまで書き込む
良い例:
- 営業担当者
- 受注管理システム
- 在庫管理システム
- 請求システム
- 顧客マスタ
- 外部与信サービス
Containerでは技術要素より責任を先に書く
悪い例:
- Spring Boot
- PostgreSQL
- React
だけを並べることです。
良い例では、
- 営業向けWebアプリ:受注入力・確認
- 受注API:受注受付、入力検証、価格計算、与信照会、在庫引当要求、受注確定
- 受注DB:受注情報の正本
のように責任を明確にします。
Componentは必要なContainerだけ掘る
全部のContainerをComponentまで分解すると、図が増え、読む側の負担も大きくなります。
設計議論が必要な箇所、変更が多い箇所、責任が曖昧な箇所だけ詳細化します。
記入済み具体例|受注管理システム
ここでは、受注管理システム刷新を例にテンプレートを埋めます。
基本情報
- 対象システム名:受注管理システム
- 図の目的:業務部門と開発チームで責任境界・データ所有・外部連携を合意する
- 主な読者:営業、業務企画、アーキテクト、開発リーダー
- 今回扱う粒度:Context / Container / 受注APIのComponent
Context
- 対象システム:受注管理システム
- 対象システムの役割:営業担当者から受注を受け付け、価格・与信・在庫を確認し、受注確定情報を管理する
- 主な利用者:営業担当者
- 外部システム:在庫管理、請求、顧客マスタ、外部与信サービス
- 対象システムの外に置く責任:在庫の正本管理、請求確定、顧客基本情報の正本、与信判定ロジック
- 対象システムの境界:受注受付から受注確定まで
Container
#### 営業向けWebアプリ
- 主な責任:受注入力、入力内容確認、受注状況表示
- 呼び出し先:受注API
- このContainerに置かない責任:価格計算、与信判定、在庫更新
#### 受注API
- 主な責任:受注受付、入力検証、価格計算、与信照会、在庫引当要求、受注確定
- 接続先:受注DB、顧客マスタ、在庫管理、与信サービス、メッセージキュー
- このContainerに置かない責任:請求処理そのもの
#### 受注DB
- 主な責任:受注情報の正本
- 主なデータ:受注番号、顧客、明細、金額、受注状態
- このContainerに置かない責任:在庫数量・請求残高の正本管理
#### 外部連携ワーカー
- 主な責任:請求システムへの非同期連携
- 接続先:メッセージキュー、請求システム
- 失敗時:再試行し、規定回数超過時は運用アラート
#### メッセージキュー
- 主な責任:受注確定イベントの非同期配送
- 用途:受注登録の応答時間と請求連携を分離する
Component|受注API
- 受注受付:リクエスト受理と形式確認
- 入力検証:必須項目・値域・業務ルール検証
- 価格計算:単価、割引、税の計算
- 与信照会:外部与信サービスへ問い合わせ
- 在庫引当要求:在庫管理へ引当要求
- 受注確定:受注DBへ確定情報を保存
データ所有
- 受注情報の正本:受注DB
- 在庫数量の正本:在庫管理システム
- 請求情報の正本:請求システム
- 顧客基本情報の正本:顧客マスタ
非機能要件
- 受注登録:通常2秒以内
- 請求連携:数分の遅延を許容
- 外部連携失敗:自動再試行
- 受注確定:監査ログを保持
この例では、Contextで外部との関係を合意し、Containerで責任とデータ所有を整理し、設計議論が必要な受注APIだけComponentまで掘っています。
良い例と悪い例
悪い例|ContextとContainerが同じ図になる
ContextにもAPIやDBを載せると、粒度の違いが消えます。
改善後は、Contextは利用者・外部システム・対象システムだけに絞り、内部構造はContainerで表します。
悪い例|技術名しか書かない
「React」「Java」「PostgreSQL」だけでは、各要素の責任が分かりません。
改善後は、責任を先に書き、その後に必要なら技術名を添えます。
悪い例|データの正本が不明
受注DB、在庫DB、請求DBの関係を描いても、どこが正本か書かれていないと更新責任が曖昧です。
改善後は、データごとに正本を明記します。
悪い例|すべてをComponentまで分解する
詳細図が大量に増え、レビューしにくくなります。
改善後は、責任が曖昧なContainer、変更頻度が高いContainer、設計判断が必要なContainerだけ掘ります。
テンプレートを使うときの判断基準
Contextで止めてよい場面
経営層・業務部門へシステムの役割と外部関係を説明するだけなら、Contextで十分な場合があります。
Containerまで必要な場面
開発・運用チームと責任境界、データ所有、同期・非同期を議論するならContainerが必要です。
Componentまで必要な場面
1つのContainerの内部責任を分けないと設計判断が進まないときに使います。
Codeまで必要な場面
クラス設計や実装構造そのものがレビュー対象であり、文章やコードだけでは共有しづらい場合に限定します。
テンプレート利用時の注意点
粒度を混ぜない
1枚の図にContext・Container・Componentの要素を無理に混在させると、読み手が構造を追いにくくなります。
矢印だけで意味を伝えない
関係には「受注登録」「顧客情報取得」「受注確定イベント」のような意味を付けます。
境界と責任を優先する
技術スタックより先に、「誰が何を担うか」を合意します。
図を固定化しない
システム構造や責任分担が変わったら、C4図も更新します。
読者ごとに必要な粒度を変える
業務部門にはContext・Container中心、開発者には必要箇所のComponent、実装レビューでは必要に応じてCodeというように使い分けます。
関連記事で理解を深める
実際の作成手順を確認したい場合は、C4モデルのやり方が役立ちます。
具体的な導入ケースを通して判断の流れを見たい場合は、C4モデルの具体例を参照してください。
よくある失敗を避けたい場合は、C4モデルで失敗しやすいポイントが参考になります。
生成AIを補助的に使って、要素候補や関係性の洗い出しを効率化したい場合は、生成AIでC4モデルを使う方法も確認してください。
最終チェックリスト
- 図の目的を書いたか
- 読者を決めたか
- Contextで利用者と外部システムを整理したか
- システム境界を明確にしたか
- Containerごとの責任を書いたか
- データの正本を明示したか
- 依存関係の意味を書いたか
- 同期・非同期を区別したか
- 非機能要件と構造を対応付けたか
- Componentへ掘る範囲を絞ったか
- Code図が本当に必要か確認したか
- 読者に対して粒度が細かすぎないか確認したか
まとめ
C4モデルテンプレートを使うときは、図をきれいに描くことより、Context・Container・Component・Codeそれぞれの目的と粒度を分けることが重要です。
特に、対象システムの境界、Containerごとの責任、データの正本、依存関係、非機能要件との対応を明示すると、業務部門と開発チームの認識を揃えやすくなります。
このテンプレートを使えば、C4モデルを単なる構成図ではなく、「どこまでを誰が担い、どの要素がどう依存しているか」を段階的に合意するための設計フォーマットとして使いやすくなります。
コメント
コメント一覧 (1件)
[…] そのまま使える記入形式が必要なら、C4モデルテンプレートを使うと、Context、Container、Component、Code、データ所有、非機能要件、レビュー項目まで整理しやすくなります。 […]