MENU

C4モデルで失敗しやすいポイント|よくある間違いと改善策

C4モデルは、ソフトウェアや業務システムの構造を「Context」「Container」「Component」「Code」の4つの粒度で段階的に整理するための考え方です。

一方で、実務では「図は作ったのに責任境界が伝わらない」「ContextとContainerの違いがなくなる」「詳細化しすぎて誰も読まない」といった失敗が起きやすくなります。

この記事では、C4モデルでありがちな失敗を、具体的な失敗場面、原因、改善前後、改善後の状態、読者用チェックポイントの順で解説します。

基本の意味から確認したい場合は、C4モデルとは?を、実際の作成手順を確認したい場合はC4モデルのやり方を参照してください。

目次

失敗1|Context図に内部構造まで詰め込む

ありがちな失敗場面

Context図に、利用者や外部システムだけでなく、API、DB、バッチ、メッセージキューまで描き込みます。

原因

「1枚で全部説明したい」と考え、粒度を分けていないためです。

改善前

営業担当者、顧客マスタ、在庫管理、請求システムと同じ図に、受注API、受注DB、外部連携ワーカーまで混在しています。

改善方法

Contextでは、

  • 利用者
  • 対象システム
  • 外部システム
  • それらの関係

だけに絞ります。

内部構造はContainerへ分けます。

改善後の状態

対象システムの役割と外部との関係を、非技術部門も含めて短時間で理解できます。

チェックポイント

  • ContextにAPIやDBを書き込んでいないか
  • 対象システムの境界が一目で分かるか
  • 外部との関係が主役になっているか

失敗2|Container図が単なる技術一覧になる

ありがちな失敗場面

Container図に、React、Java、PostgreSQL、Redisなど技術名だけを並べます。

原因

「何で作るか」を先に考え、「何を担当するか」を後回しにしているためです。

改善前

  • React
  • Spring Boot
  • PostgreSQL
  • RabbitMQ

だけが並び、各要素の責任が分かりません。

改善方法

責任を先に書きます。

  • 営業向けWebアプリ:受注入力・確認
  • 受注API:受注受付、検証、価格計算、与信照会、在庫引当要求、受注確定
  • 受注DB:受注情報の正本
  • 外部連携ワーカー:請求システムへの非同期連携

必要なら、その後に採用技術を添えます。

改善後の状態

技術変更があっても、構造上の責任を保ったまま議論できます。

チェックポイント

  • 各Containerの責任を1文で説明できるか
  • 技術名がなくても役割が伝わるか
  • 責任が重複していないか

失敗3|システム境界が曖昧なまま描き始める

ありがちな失敗場面

受注管理システムの図を描き始めたものの、在庫管理や請求処理まで「受注システム側」に含める人と、外部システムと考える人が混在しています。

原因

最初に対象範囲と外部責任を合意していないためです。

改善前

同じ図を見ても、担当者ごとに「この箱の中に何が含まれるか」の理解が違います。

改善方法

最初に、

  • 対象システムの役割
  • 対象システムが持つ責任
  • 外部へ置く責任
  • 境界をまたぐ主なやり取り

を明文化します。

改善後の状態

「受注受付から受注確定までが対象」「在庫の正本は在庫管理」「請求確定は請求システム」といった境界を関係者で共有できます。

チェックポイント

  • 対象システムの開始点と終了点が決まっているか
  • 外部システムの責任が明確か
  • 図の箱と責任境界が一致しているか

失敗4|データの正本を決めない

ありがちな失敗場面

受注DB、在庫DB、請求DBへ似た情報が保存されているのに、どこが正本か分かりません。

原因

「保存されている場所」と「更新責任を持つ場所」を区別していないためです。

改善前

顧客名や在庫数量が複数箇所で更新され、どの値を信頼すべきか分からなくなります。

改善方法

データごとに正本を明示します。

  • 受注情報:受注DB
  • 顧客基本情報:顧客マスタ
  • 在庫数量:在庫管理システム
  • 請求情報:請求システム

必要に応じて、他システムには参照用のコピーやスナップショットを置きます。

改善後の状態

更新責任と参照責任が分かれ、整合性の議論がしやすくなります。

チェックポイント

  • データごとに正本を決めたか
  • コピーと正本を混同していないか
  • 更新元が複数になっていないか

失敗5|矢印に意味を書かない

ありがちな失敗場面

箱同士を矢印でつないだだけで、「何をやり取りしているか」が書かれていません。

原因

接続関係だけ示せば十分と考えているためです。

改善前

受注APIと在庫管理の間に矢印はありますが、「在庫参照」なのか「在庫引当要求」なのか分かりません。

改善方法

矢印には、

  • 顧客情報取得
  • 在庫引当要求
  • 受注確定イベント
  • 請求連携

のような意味を付けます。

改善後の状態

依存関係と業務上のやり取りを同時に確認できます。

チェックポイント

  • 主要な矢印に意味が書かれているか
  • 読み手が処理方向を判断できるか
  • 同期・非同期の違いが分かるか

失敗6|同期・非同期の判断を図に反映しない

ありがちな失敗場面

受注登録後の請求連携が、同期なのか非同期なのか資料から分かりません。

原因

機能のつながりだけを描き、実行特性を考えていないためです。

改善前

請求システムの障害が、受注登録そのものを失敗させる構成になっています。

改善方法

業務要件と非機能要件から判断します。

たとえば、

  • 受注登録:通常2秒以内
  • 請求連携:数分遅延を許容

なら、受注確定後にイベントを出し、外部連携ワーカーで非同期処理する案を検討します。

改善後の状態

受注処理と後続連携の責任が分かれ、障害時の影響範囲も説明できます。

チェックポイント

  • 即時応答が必要な処理は何か
  • 遅延を許容できる処理は何か
  • 非同期処理の再試行責任を決めたか

失敗7|すべてのContainerをComponentまで掘る

ありがちな失敗場面

「C4モデルだから4段階すべて描く」と考え、全ContainerをComponent、さらにCodeまで詳細化します。

原因

必要な粒度ではなく、形式の完全さを目的にしているためです。

改善前

図が大量に増え、どれが重要な設計判断なのか分からなくなります。

改善方法

次のようなContainerだけ詳細化します。

  • 責任が曖昧
  • 変更頻度が高い
  • 複雑な業務ロジックが集中している
  • 設計判断をレビューしたい

改善後の状態

受注APIだけComponentへ掘るなど、論点に集中した資料になります。

チェックポイント

  • このContainerを掘る理由を説明できるか
  • 詳細化しないと何が判断できないのか
  • 読者にとって必要な粒度か

失敗8|Codeレベルを必須だと考える

ありがちな失敗場面

システム企画の説明資料にも、クラスやモジュールまで描きます。

原因

4レベルすべてを埋めることが正しいと誤解しているためです。

改善前

業務部門のレビューに実装詳細が持ち込まれ、本来の責任境界の議論が進みません。

改善方法

Codeは、クラス設計や実装構造そのものがレビュー対象のときだけ使います。

改善後の状態

企画・業務設計ではContext/Container中心、詳細設計では必要なComponent、実装レビューでは必要なCodeという使い分けができます。

チェックポイント

  • Code図の読者は誰か
  • その図で決める設計判断は何か
  • ソースコードや別資料で十分ではないか

失敗9|業務責任とシステム責任を混同する

ありがちな失敗場面

「与信判断」を受注APIの責任と書いていますが、実際の与信ロジックは外部与信サービスが持っています。

原因

「処理を呼び出す責任」と「業務ルールの正本責任」を分けていないためです。

改善前

どちらのシステムで与信ルールを変更するかが曖昧になります。

改善方法

受注APIは「与信照会を実行する」、外部与信サービスは「与信判定ロジックを持つ」と分けます。

改善後の状態

変更責任と依存方向が明確になります。

チェックポイント

  • 呼び出し責任と判断責任を分けているか
  • 業務ルールの正本はどこか
  • 変更時の担当が分かるか

失敗10|非機能要件を別資料のまま放置する

ありがちな失敗場面

C4図は機能構造だけ、性能・可用性・監査・再試行は別の要件書にだけあります。

原因

構造と非機能要件を対応付けていないためです。

改善前

「2秒以内」「自動再試行」「監査ログ」が、どのContainerで実現されるか分かりません。

改善方法

非機能要件ごとに責任要素を対応付けます。

  • 受注登録2秒以内 → 受注APIの同期処理範囲を限定
  • 請求連携再試行 → 外部連携ワーカー
  • 受注確定の追跡 → 監査ログ

改善後の状態

非機能要件が構造上の判断へつながります。

チェックポイント

  • 性能要件に責任要素が対応しているか
  • 障害時の再試行責任が明確か
  • セキュリティ・監査要件の担当が分かるか

失敗11|読者を決めず同じ図を全員に見せる

ありがちな失敗場面

経営層、業務部門、開発者、運用担当へ同じ詳細図を配ります。

原因

「正しい図は1つ」と考えているためです。

改善前

業務部門には細かすぎ、開発者には粗すぎる資料になります。

改善方法

読者ごとに粒度を変えます。

  • 業務部門:Context中心
  • アーキテクト・開発:Container中心
  • 設計担当:必要箇所のComponent
  • 実装レビュー:必要なCode

改善後の状態

同じシステム構造を、読者に合う解像度で説明できます。

チェックポイント

  • この図の主な読者は誰か
  • その読者が判断すべきことは何か
  • 情報量が多すぎないか

失敗12|図を作った後に更新しない

ありがちな失敗場面

設計変更後もC4図が古いまま残ります。

原因

C4図を「一度作る成果物」と考えているためです。

改善前

実装は非同期連携へ変更済みなのに、図では同期接続のままです。

改善方法

レビューや大きな設計変更のタイミングで更新します。

特に、

  • 新しいContainer追加
  • データ正本変更
  • 同期/非同期変更
  • 外部依存変更
  • 責任境界変更

は更新対象とします。

改善後の状態

図が現在のアーキテクチャを説明する資料として使えます。

チェックポイント

  • 最終更新日を記録しているか
  • 主要な設計変更を反映したか
  • 実装と図が矛盾していないか

通し例|C4モデルが形骸化した案件を立て直す

受注管理システム刷新で、最初に作られたC4資料は次の状態でした。

  • Context図にAPI・DB・バッチまで混在
  • Containerは技術名中心
  • 在庫・顧客・請求の正本が不明
  • 請求連携が同期か非同期か不明
  • 全ContainerをComponentまで分解
  • Code図まで作成
  • 非機能要件は別資料
  • 業務部門と開発部門へ同じ図を提示

このままでは、図は多いものの、責任境界を合意できませんでした。

そこで、まずContextを作り直し、営業担当者、受注管理システム、顧客マスタ、在庫管理、請求、外部与信サービスだけに絞りました。

次に、対象システムの責任を「受注受付から受注確定まで」とし、在庫の正本は在庫管理、顧客基本情報の正本は顧客マスタ、請求確定は請求システムと明示しました。

Containerは、

  • 営業向けWebアプリ
  • 受注API
  • 受注DB
  • 外部連携ワーカー
  • メッセージキュー

へ整理し、それぞれに責任を書きました。

受注登録2秒以内という要件と、請求連携は数分遅延可能という条件から、請求連携を非同期へ変更しました。

Componentは、業務ロジックが集中していた受注APIだけに絞り、受注受付、入力検証、価格計算、与信照会、在庫引当要求、受注確定へ分解しました。

Code図は今回の企画・アーキテクチャ合意では不要と判断し、削除しました。

最後に、業務部門にはContext、開発・運用にはContainer、受注API担当にはComponentを使ってレビューしました。

結果として、

  • 責任境界
  • データの正本
  • 同期/非同期
  • 障害時の再試行責任
  • 非機能要件の担当

を同じ構造上で説明できるようになりました。

この立て直しで重要だったのは、図を増やすことではなく、粒度を分け、責任と依存関係を明確にし、必要な箇所だけ詳細化したことです。

自分のC4モデルを見直すチェックリスト

  • Contextに内部構造を入れすぎていないか
  • Containerの責任を文章で説明できるか
  • システム境界が関係者で揃っているか
  • データの正本が決まっているか
  • 矢印にやり取りの意味があるか
  • 同期・非同期が分かるか
  • 詳細化する理由があるContainerだけ掘っているか
  • Codeレベルを必要以上に作っていないか
  • 呼び出し責任と業務判断責任を分けているか
  • 非機能要件を構造へ対応付けているか
  • 読者ごとに適切な粒度を使っているか
  • 設計変更後に図を更新しているか

そのまま使える記入形式が必要なら、C4モデルテンプレートを使うと、Context、Container、Component、Code、データ所有、非機能要件、レビュー項目まで整理しやすくなります。

具体案件での適用イメージを追いたい場合は、C4モデルの具体例が参考になります。生成AIを補助的に使って要素候補や依存関係の洗い出しを効率化したい場合は、生成AIでC4モデルを使う方法も参照してください。

まとめ

C4モデルで失敗しやすいのは、ContextとContainerの粒度を混ぜること、技術名だけを並べること、システム境界やデータの正本を決めないこと、矢印の意味や同期・非同期を曖昧にすることです。

また、すべてをComponentやCodeまで詳細化する、読者を決めず同じ図を使う、非機能要件を構造へ結び付けない、設計変更後に更新しないと、図が増えても意思決定には使いにくくなります。

実務では、Contextで外部との関係と境界を揃え、Containerで責任とデータ所有を明確にし、設計判断が必要な箇所だけComponentへ掘ることが重要です。さらに、非機能要件、同期・非同期、障害時責任を構造へ対応付け、読者ごとに粒度を変えることで、C4モデルを単なる構成図ではなく、責任境界と設計判断を合意するための実践的な道具として使いやすくなります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次