MENU

C4モデルテンプレート|そのまま使える項目例と書き方

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モデルを単なる構成図ではなく、「どこまでを誰が担い、どの要素がどう依存しているか」を段階的に合意するための設計フォーマットとして使いやすくなります。

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

コメント

コメント一覧 (1件)

目次