C4モデルは、ソフトウェアや業務システムの構造を「Context」「Container」「Component」「Code」の4段階で整理するための考え方です。
実務では、単に図を描くだけでは不十分です。誰が使うのか、どこまでを対象システムの責任とするのか、どのデータをどこが持つのか、どこから先を詳細化するのかを、関係者と段階的に合意していく必要があります。
この記事では、受注管理システムの刷新を題材に、C4モデルをどのようにシステム企画・業務設計へ適用したかを、背景、課題、適用理由、実際の整理、設計判断、結果、学びまで通して解説します。
C4モデルの意味や全体像から確認したい場合は、C4モデルとは?を参照してください。実際の作成手順は、C4モデルのやり方で確認できます。
ケースの背景|受注管理システムを刷新することになった
ある企業では、営業部門が使う受注管理システムを刷新することになりました。
既存システムは長年の追加改修で複雑化し、受注入力、価格計算、在庫確認、与信確認、請求連携の責任が複数のアプリケーションやバッチへ分散していました。
刷新プロジェクトには、
- 営業部門
- 業務企画
- IT企画
- アーキテクト
- 開発チーム
- 運用チーム
が参加しました。
しかし、初期の打ち合わせでは、各担当者が異なる粒度でシステムを説明していました。
営業部門は「受注を登録して請求まで流れる仕組み」と捉えていましたが、開発チームはAPIやDB、バッチ単位で議論し、運用チームは障害時の再処理や監視単位を気にしていました。
同じシステムについて話しているのに、見ている範囲が揃っていませんでした。
課題|構成図はあるが責任境界が分からない
既存資料にはシステム構成図がありました。
ただし、そこにはサーバー、DB、API、外部システムが大量に並び、次の点が不明でした。
- 受注管理システムの境界はどこか
- 在庫の正本はどこか
- 顧客情報の正本はどこか
- 請求処理は受注側の責任か、請求システム側の責任か
- 受注登録の応答時間にどこまで含めるのか
- どの内部処理を同期にし、どこを非同期にするのか
特に問題だったのは、「図に載っていること」と「そのシステムが責任を持つこと」が混同されていた点です。
なぜC4モデルを使ったのか
この案件で必要だったのは、いきなり詳細な技術構成を決めることではありませんでした。
まず、
- 対象システムが誰と何をやり取りするか
- 対象システム内部をどの責任単位へ分けるか
- 詳細な設計議論が必要な箇所はどこか
を順番に揃える必要がありました。
C4モデルなら、ContextからContainer、必要な箇所だけComponentへ段階的に掘り下げられます。
そのため、関係者ごとに必要な粒度を変えながら、同じ構造を共有できると判断しました。
1. Contextで対象システムの外側を整理した
最初にContextレベルで、受注管理システムとその周囲を整理しました。
利用者
- 営業担当者
対象システム
- 受注管理システム
外部システム
- 顧客マスタ
- 在庫管理システム
- 請求システム
- 外部与信サービス
関係
営業担当者は受注管理システムへ受注を入力します。
受注管理システムは、顧客マスタから顧客情報を参照し、外部与信サービスへ与信照会を行い、在庫管理システムへ在庫引当を依頼し、受注確定後に請求システムへ情報を渡します。
2. Contextで責任境界を合意した
図を描いた後、各システムが持つ責任を文章で確認しました。
受注管理システムが持つ責任
- 受注受付
- 入力内容の検証
- 価格計算
- 与信照会の実行
- 在庫引当要求
- 受注確定
- 受注情報の保持
外部へ置く責任
- 顧客基本情報の正本管理:顧客マスタ
- 在庫数量の正本管理:在庫管理システム
- 与信判定ロジック:外部与信サービス
- 請求確定・請求残高管理:請求システム
ここでの判断
当初は「受注システムが在庫も管理する」という案がありました。
しかし、在庫管理システムがすでに在庫数量の正本であり、他の業務からも利用されていました。
そのため、受注管理システムは在庫の正本を持たず、必要な時点で在庫引当を依頼する設計にしました。
3. Containerへ分解した
Contextで境界を合意した後、受注管理システム内部をContainerレベルへ分けました。
営業向けWebアプリ
責任:
- 受注入力
- 入力内容の確認
- 受注状況表示
ここには価格計算や在庫更新の責任を置かないことにしました。
受注API
責任:
- 受注受付
- 入力検証
- 価格計算
- 与信照会
- 在庫引当要求
- 受注確定
受注DB
責任:
- 受注情報の正本
保持する主なデータは、受注番号、顧客、明細、金額、受注状態です。
外部連携ワーカー
責任:
- 受注確定後の請求システム連携
メッセージキュー
責任:
- 受注確定イベントの非同期配送
4. 受注登録の応答時間から同期・非同期を分けた
業務部門からは、「受注登録は通常2秒以内で完了してほしい」という要望がありました。
一方、請求システムへの連携は、数分程度遅れても業務上問題ありませんでした。
そこで、受注APIの同期処理は、
- 入力検証
- 価格計算
- 与信照会
- 在庫引当要求
- 受注確定
までとし、請求連携は受注確定後にメッセージキューへイベントを出し、外部連携ワーカーが非同期で処理する設計にしました。
ここでの判断
もし請求システムへの送信まで同期処理に含めると、請求側の遅延や障害が受注登録の応答時間へ直接影響します。
そこで、受注確定と請求連携を分離しました。
5. データの正本を明確にした
Container図を見ながら、データごとの正本も整理しました。
- 受注情報:受注DB
- 顧客基本情報:顧客マスタ
- 在庫数量:在庫管理システム
- 請求情報:請求システム
ここでの判断
「参照できる場所」と「正本を持つ場所」を分けて考えました。
受注DBに顧客名や商品情報のスナップショットを保存する場合でも、顧客基本情報そのものの正本は顧客マスタです。
この違いを明示したことで、「どこを更新すべきか」の混乱を減らせました。
6. Componentへ掘る範囲を絞った
すべてのContainerをComponentまで分解すると、図が増えすぎます。
この案件では、受注APIの内部責任だけが設計上の論点になっていたため、受注APIのみComponentレベルへ詳細化しました。
受注APIのComponent
- 受注受付
- 入力検証
- 価格計算
- 与信照会
- 在庫引当要求
- 受注確定
なぜここだけ掘ったのか
営業向けWebアプリは画面責任が比較的明確で、受注DBもデータ保持が主責任でした。
一方、受注APIには業務ロジックが集中しており、与信・在庫・価格・確定処理の責任境界が曖昧でした。
そのため、設計判断が必要な受注APIだけ詳細化しました。
7. Component間の依存を確認した
Componentレベルでは、単に名前を並べるだけでなく、処理順と失敗時の扱いも確認しました。
たとえば、
- 受注受付
- 入力検証
- 価格計算
- 与信照会
- 在庫引当要求
- 受注確定
という順序です。
与信照会が失敗した場合
受注を確定しません。
在庫引当が失敗した場合
在庫不足として営業担当者へ返し、受注確定へ進めません。
受注確定後の請求連携が失敗した場合
受注そのものは確定済みなので取り消さず、外部連携ワーカーで再試行します。
ここで、「受注登録失敗」と「後続連携失敗」を別の状態として扱う設計が明確になりました。
8. 非機能要件を構造へ対応付けた
C4モデルを使う際、機能構造だけでなく非機能要件も確認しました。
受注登録は通常2秒以内
対応:請求連携を非同期化し、同期処理を受注確定までに限定。
外部連携失敗時は自動再試行
対応:外部連携ワーカーに再試行機構を持たせ、規定回数超過時は運用アラートを出す。
受注確定操作を追跡可能にする
対応:受注確定時に監査ログを保存。
ここでの判断
非機能要件を別資料だけで管理せず、どのContainerやComponentがその責任を担うかを対応付けました。
9. Codeレベルは描かなかった
今回の目的は、システム企画・業務設計とアーキテクチャの責任境界を合意することでした。
クラス設計やメソッド設計までは議論対象ではありませんでした。
そのため、Codeレベルは作成しませんでした。
ここでの判断
C4モデルは4段階すべてを必ず描くものではありません。
必要な粒度まで掘り、不要な粒度は描かない方が、関係者にとって読みやすくなります。
10. 業務部門と開発部門でレビューした
Context図は業務部門とIT企画でレビューし、
- 誰が利用するか
- 外部システムは何か
- 受注管理システムの責任範囲はどこか
を確認しました。
Container図はアーキテクト、開発、運用チームを交えて、
- 責任の重複がないか
- データの正本が明確か
- 同期・非同期が適切か
- 障害時の責任が分かるか
を確認しました。
Component図は受注APIの開発メンバーを中心にレビューし、内部責任の分割と依存方向を調整しました。
11. レビューで実際に修正したポイント
最初のContainer案では、受注APIが請求システムへ直接同期連携する構成でした。
しかし、受注登録2秒以内という要件と、請求システム障害時の影響を考えると不適切でした。
レビュー後、
- 受注APIは受注確定まで担当
- 受注確定イベントをメッセージキューへ送る
- 外部連携ワーカーが請求システムへ非同期連携
へ変更しました。
また、当初は受注DBに在庫数量を持たせる案もありましたが、在庫管理システムを正本とする方針へ統一しました。
C4モデルを描いたことで、図の見た目ではなく、責任境界とデータ所有の矛盾をレビューできました。
12. 適用後の結果
結果1|関係者の会話の粒度が揃った
業務部門はContext、開発・運用はContainer、詳細設計が必要な担当者はComponentというように、必要な粒度で議論できるようになりました。
結果2|責任境界が明確になった
受注、在庫、顧客、請求の正本と責任を分けて説明できるようになりました。
結果3|非機能要件と構造がつながった
「2秒以内」「再試行」「監査ログ」といった要件を、どのContainer・Componentが担うか確認できました。
結果4|不要な詳細化を避けられた
受注APIだけComponentまで掘り、Codeレベルは作らなかったため、資料量を増やしすぎずに済みました。
このケースから分かるC4モデルの使いどころ
1. いきなり詳細図から始めない
まずContextで利用者、外部システム、対象システムの境界を揃えます。
2. 技術要素より責任を先に考える
「Java」「DB」「API」より、「何を担当するか」を先に明確にします。
3. データの正本を決める
参照先が複数あっても、更新責任を持つ正本は明確にします。
4. 詳細化は設計議論が必要な箇所だけ行う
全部をComponentやCodeまで掘る必要はありません。
5. 非機能要件を構造へ対応付ける
性能、可用性、再試行、監査などを、どの要素が担うか確認します。
自分の業務へ置き換えるときの確認ポイント
自分のシステム企画や業務設計へC4モデルを適用する場合は、次を確認してください。
- 対象システムの目的は明確か
- 主な利用者は誰か
- 外部システムは何か
- 対象システムの責任範囲はどこまでか
- 各Containerの責任は重複していないか
- データの正本は明確か
- 同期処理と非同期処理を分ける基準はあるか
- 障害時にどこが再試行するか決まっているか
- Componentまで掘る理由はあるか
- Codeレベルが本当に必要か
- 非機能要件と構造が対応しているか
- 読者ごとに適切な粒度で説明できているか
そのまま使える記入形式が必要なら、C4モデルテンプレートを使うと、Context、Container、Component、Code、データ所有、非機能要件、レビュー項目まで整理しやすくなります。
よくある失敗を先に確認したい場合は、C4モデルで失敗しやすいポイントも参考になります。生成AIを補助的に使って要素候補や依存関係を洗い出したい場合は、生成AIでC4モデルを使う方法も参照してください。
まとめ
このケースでは、受注管理システム刷新で、業務部門と開発部門が異なる粒度で話していたことが課題でした。
C4モデルを使い、まずContextで利用者、外部システム、責任境界を整理し、その後Containerで営業向けWebアプリ、受注API、受注DB、外部連携ワーカー、メッセージキューへ分割しました。
さらに、設計議論が必要だった受注APIだけComponentまで詳細化し、受注受付、入力検証、価格計算、与信照会、在庫引当要求、受注確定へ責任を分けました。
その過程で、在庫・顧客・請求の正本を明確にし、受注登録2秒以内という要件から請求連携を非同期化し、外部連携失敗時の再試行や監査ログの責任も構造へ対応付けました。
C4モデルの価値は、図をきれいに描くことではありません。関係者が同じ構造を異なる粒度で見ながら、責任境界、データ所有、依存関係、非機能要件を段階的に合意できることにあります。