C4モデルは、ソフトウェアや業務システムの構造を、見る人に必要な粒度へ段階的に分けて表現する方法です。
いきなり細かなモジュールやクラス図から描くのではなく、まず「誰が何のためにこのシステムを使うのか」をContextで整理し、次に実行単位やデータストアなどをContainerで分け、その中の主要な責務をComponentで整理し、必要な箇所だけCodeレベルへ降ります。
実務で重要なのは、4種類の図を必ず全部描くことではありません。意思決定に必要な粒度まで描き、関係者が同じ構造を共有できる状態を作ることです。
この記事では、C4モデルを実務で使う手順を、各ステップの入力・行動・出力・判断基準と、受注管理システム刷新の通し例で解説します。
基本的な意味や構造から確認したい場合は、C4モデルとは?を参照してください。
C4モデルで扱う4つの粒度
C4モデルでは、主に次の4段階で構造を整理します。
- Context:対象システムと利用者・外部システムの関係
- Container:アプリケーション、サービス、データストアなど、実行・配置上の主要単位
- Component:各Container内部の主要な責務や構成要素
- Code:クラス、関数、実装構造などコードに近い詳細
実務では、企画・業務設計の段階ならContextとContainerが中心です。設計レビューではComponentまで必要になることがあります。Codeレベルは、複雑な実装箇所だけに限定しても構いません。
ステップ1|対象システムと目的を決める
入力
- 対象業務
- 対象システム
- 改善・刷新の目的
- 主な関係者
- 今回決めたいこと
行動
「何を描くか」より先に、「この図で何を判断するか」を決めます。
たとえば、
- 受注管理システム刷新の対象範囲を合意したい
- 営業、在庫、請求との責任境界を整理したい
- 新旧システムの連携方針を決めたい
といった目的です。
出力
- 対象システム
- 図の利用目的
- 主な読者
- 対象範囲
判断基準
図を見た人が「何を決めるためのC4モデルか」を一文で説明できるか確認します。
ステップ2|Context図で外部との関係を描く
Context図では、対象システムの外側にいる人とシステムを整理します。
入力
- 主な利用者
- 業務上の関係者
- 外部システム
- 対象システムの役割
行動
中央に対象システムを置き、その周囲に人と外部システムを配置します。
たとえば受注管理なら、
- 営業担当者
- 受注管理システム
- 在庫管理システム
- 請求システム
- 顧客マスタ
を置きます。
線には「何をやり取りするか」を書きます。
悪い例:
- 連携する
- 使用する
良い例:
- 営業担当者が受注を登録する
- 受注管理が在庫引当を依頼する
- 受注確定後に請求情報を送る
出力
システムコンテキスト図。
判断基準
- 対象システムの役割が一文で説明できるか
- 利用者と外部システムが混ざっていないか
- 線に具体的な関係が書かれているか
- 対象外の内部詳細を描きすぎていないか
ステップ3|Context図で対象範囲を合意する
Context図を描いたら、すぐContainerへ進まず、関係者で境界を確認します。
確認すること
- どこまでが今回の対象か
- 外部システムとして扱うものは何か
- 誰がこのシステムを使うか
- 主要なデータ連携は何か
- 責任境界に認識差がないか
出力
合意されたシステム境界。
判断基準
「それはこのシステムの責任か、外部の責任か」で意見が割れている箇所が残っていないか確認します。
ステップ4|Container図で主要な実行単位へ分ける
Contextで境界が決まったら、対象システムの内部をContainerへ分けます。
ここでいうContainerは、単なるDockerコンテナという意味ではありません。Webアプリケーション、API、バッチ、データベース、メッセージ基盤など、独立した実行・配置・データ保持単位を表します。
入力
- Context図
- 主なユースケース
- 非機能要件
- 既存システム構成
行動
受注管理システムなら、たとえば、
- 営業向けWebアプリ
- 受注API
- 在庫連携バッチ
- 受注DB
- メッセージキュー
のように分けます。
それぞれについて、
- 役割
- 主な利用者
- 使用技術
- データの持ち方
- 他Containerとの通信
を書きます。
出力
Container図。
判断基準
- 役割が重複していないか
- データの所有者が分かるか
- 同期・非同期など主要な通信方式が分かるか
- 技術名だけでなく責務が書かれているか
ステップ5|業務責任とContainerの境界を照らす
システム企画では、技術構成だけでなく業務責任との対応を見ることが重要です。
たとえば、
- 受注登録
- 在庫引当
- 与信確認
- 請求連携
という業務責任が、どのContainerで実行されるか確認します。
判断基準
一つの業務責任が複数Containerへ曖昧に分散していないかを確認します。
ステップ6|必要なContainerだけComponent図へ降りる
すべてのContainerをComponentまで描く必要はありません。
複雑で、責務分担や変更影響を確認したい箇所だけ詳細化します。
入力
- Container図
- 複雑なユースケース
- 変更頻度が高い領域
- 障害が起きやすい領域
行動
受注APIを例にすると、
- 受注受付
- 受注検証
- 価格計算
- 在庫引当要求
- 受注確定
- 外部通知
などのComponentへ分けます。
出力
Component図。
判断基準
- 各Componentの責務が一文で言えるか
- 同じ業務ルールが重複していないか
- 変更理由が違うものを無理にまとめていないか
- 外部依存がどこにあるか分かるか
ステップ7|依存関係とデータの流れを確認する
箱を並べるだけでは、設計判断に使えません。
次の点を確認します。
- 誰が誰を呼ぶか
- どのデータを渡すか
- データの正本はどこか
- 同期か非同期か
- 失敗時にどこで再試行するか
- どこでトランザクション境界を持つか
出力
主要な依存関係とデータ流れ。
判断基準
「このContainerが止まったら、どこまで影響するか」を説明できるか確認します。
ステップ8|非機能要件を重ねて確認する
C4モデルは構造図ですが、実務では非機能要件との対応も重要です。
たとえば、
- 可用性
- 性能
- セキュリティ
- 監査
- 運用
- 障害復旧
をContainerごとに確認します。
例:
- Webアプリは営業時間帯99.9%を求める
- 在庫連携は数秒遅延を許容する
- 受注確定履歴は監査ログを残す
- 外部連携失敗時は再送キューへ入れる
判断基準
非機能要件が特定のContainerへ落ちているかを確認します。
ステップ9|Codeレベルは必要箇所だけ描く
Codeレベルは、クラス図や実装構造など、開発者向けの詳細です。
描くとよい場面
- 複雑なドメインロジックがある
- 変更影響を共有したい
- 新メンバーの理解が難しい
- 実装方針に複数案がある
描かなくてもよい場面
企画段階で、ContextとContainerだけで意思決定できる場合。
判断基準
Code図を描くことで、具体的な設計判断が前進するかを確認します。
ステップ10|図ごとに読者を分ける
C4モデルの利点は、全員へ同じ図を見せなくてよいことです。
- 経営・業務責任者:Context中心
- プロダクト・企画:Context+Container
- アーキテクト・開発リーダー:Container+Component
- 実装担当者:必要に応じてCode
判断基準
読者が必要以上の詳細に埋もれていないか確認します。
ステップ11|レビュー後に決定事項を反映する
C4モデルは一度描いて終わりではありません。
レビューで決まった、
- システム境界
- Container分割
- データ所有
- 連携方式
- 非機能要件
を反映し、図と実際の設計がずれないよう更新します。
通し例|受注管理システム刷新でC4モデルを使う
ある企業では、受注処理が複数システムに分散していました。
営業担当者は受注情報を入力し、その後、在庫確認、与信確認、請求連携が別々の仕組みで動いていました。
課題は、
- どのシステムが受注の正本か不明確
- 在庫連携エラー時の責任部署が曖昧
- 請求連携の再送が手作業
- 新旧システムの境界が決まっていない
ことでした。
1. Context図を作る
中央に「新受注管理システム」を置き、周囲に、
- 営業担当者
- 在庫管理システム
- 請求システム
- 顧客マスタ
を置きました。
主な関係は、
- 営業担当者が受注を登録
- 顧客マスタから顧客情報を参照
- 在庫管理へ引当要求を送る
- 受注確定後に請求情報を送る
としました。
2. システム境界を合意する
与信確認を受注管理の内部へ持つ案もありましたが、既存の与信サービスを外部システムとして利用する方針にしました。
ここで「受注管理は与信判断そのものを持たず、与信結果を利用する」と境界を決めました。
3. Container図を作る
新受注管理システムを、
- 営業向けWebアプリ
- 受注API
- 受注DB
- 外部連携ワーカー
- メッセージキュー
へ分けました。
Webアプリは入力と状態確認、受注APIは業務ルール、受注DBは受注の正本、外部連携ワーカーは在庫・請求との連携、メッセージキューは再送可能な非同期処理を担当します。
4. データ所有を決める
受注の正本は受注DBとしました。
在庫数量は在庫管理システム、請求状態は請求システムを正本とし、受注管理では必要な参照情報だけ保持する方針にしました。
5. 外部連携を非同期化する
従来は請求システムが一時停止すると受注確定まで失敗していました。
刷新後は、受注確定と請求連携を分け、受注確定後にメッセージキューへ連携要求を積む構成にしました。
これにより、請求システムが一時停止しても受注確定自体は継続できます。
6. Component図へ降りる
受注APIだけを、
- 受注受付
- 入力検証
- 価格計算
- 与信照会
- 在庫引当要求
- 受注確定
へ分けました。
価格計算と与信照会を分離したことで、料金ルール変更と与信サービス変更の影響範囲を分けやすくなりました。
7. 非機能要件を確認する
- 受注登録は2秒以内を目標
- 請求連携は数分の遅延を許容
- 外部連携失敗は自動再試行
- 受注確定は監査ログを保存
と決めました。
8. 結果
C4モデルを使ったことで、
- 新旧システムの境界
- 受注データの正本
- 在庫・請求との責任分担
- 同期/非同期の連携方針
- Componentまで深掘りすべき箇所
を関係者間で共有できました。
特に、最初から細かな実装図を描かず、Context→Container→Componentの順に粒度を下げたことで、業務責任者と開発者が同じ構造を異なる詳細度で確認できた点が有効でした。
そのまま使える記入形式が必要なら、C4モデルテンプレートを使うと、各レベルで必要な項目を整理しやすくなります。
具体的な適用判断をケースで追いたい場合は、C4モデルの具体例も参考になります。よくある失敗を先に確認したい場合は、C4モデルで失敗しやすいポイントを確認してください。生成AIを補助的に使って構成要素候補や抜け漏れを整理したい場合は、生成AIでC4モデルを使う方法も参照できます。
C4モデルでつまずきやすいポイント
Context図に内部構成を書きすぎる
Contextは外部との関係を共有する図です。内部技術まで入れると読みにくくなります。
Containerを単なるサーバー一覧にする
Containerでは、役割、データ、通信を示します。インフラ名だけでは設計判断に使えません。
すべてをComponentまで描く
必要な部分だけ深掘りします。図の量を増やすことが目的ではありません。
線の意味を書かない
「接続」だけでは、何を依存しているか分かりません。データや処理の意味を書きます。
図と実装がずれる
アーキテクチャ変更後に更新しなければ、C4モデルはすぐ古くなります。
実務で使うためのチェックリスト
- 図の目的と読者を決めたか
- Contextで利用者と外部システムを整理したか
- 対象システムの責任境界を合意したか
- Containerごとの役割が明確か
- データの正本を決めたか
- 同期・非同期など主要な通信方式を確認したか
- 必要なContainerだけComponentへ降りたか
- 外部依存と変更影響を確認したか
- 非機能要件をContainerへ対応づけたか
- Codeレベルを必要以上に描いていないか
- 読者に合った粒度の図を使っているか
- レビュー後の決定事項を図へ反映したか
まとめ
C4モデルを実務で使うときは、Context→Container→Component→Codeの順に、必要なところまで粒度を下げていきます。
まずContextで利用者・外部システム・責任境界を整理し、Containerでアプリケーション・サービス・データストアなどの主要単位へ分けます。その後、設計判断が必要な箇所だけComponentへ降り、Codeは実装詳細を共有する必要がある場合に限定します。
重要なのは、4種類の図を全部そろえることではありません。企画・業務設計・アーキテクチャ設計のそれぞれで、誰が何を判断するのかに合わせて適切な粒度を選び、システム境界、責務、データ所有、依存関係を共通認識にすることです。
コメント
コメント一覧 (1件)
[…] 基本の意味から確認したい場合は、C4モデルとは?を、実際の作成手順を確認したい場合はC4モデルのやり方を参照してください。 […]