<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
<p><a href="https://www.nac-care.co.jp" target="_blank" rel="nofollow noopener noreferrer">株式会社エヌ・エイ・シー</a>の高橋です。<br>
ソフトウェアアーキテクチャを表現するための色々図はあるけど、ルールが多くて書くのも読むのもだるかったりしますよね。<br>
C4モデル使ってコミュニケーション取ったら結構いい感じだったので、今回はその紹介です。</p>
<h2 id="c4%E3%83%A2%E3%83%87%E3%83%AB%E3%81%A8%E3%81%AF">
<a class="header-anchor-link" href="#c4%E3%83%A2%E3%83%87%E3%83%AB%E3%81%A8%E3%81%AF" aria-hidden="true"></a> C4モデルとは</h2>
<ul>
<li>ソフトウェアアーキテクチャを表現するための表記法</li>
<li>
<code>UML</code>と<code>4+1アーキテクチャビューモデル</code>が元になっている
<ul>
<li>
<a href="https://ja.wikipedia.org/wiki/%E7%B5%B1%E4%B8%80%E3%83%A2%E3%83%87%E3%83%AA%E3%83%B3%E3%82%B0%E8%A8%80%E8%AA%9E" target="_blank" rel="nofollow noopener noreferrer">UML</a>
<ul>
<li>統一モデリング言語</li>
<li>表現できる図も豊富だし、表記ルールも豊富</li>
</ul>
</li>
<li>
<a href="https://www.jstage.jst.go.jp/article/jssst/32/1/32_1_35/_pdf" target="_blank" rel="nofollow noopener noreferrer">4+1アーキテクチャビューモデル</a>
<ul>
<li>4つの視座(利用者,プログラム開発者,システムエンジニア,インテグレータ)+小規模なユースケースでソフトウェアアーキテクチャを表現する</li>
</ul>
</li>
</ul>
</li>
</ul>
<h2 id="%E8%A7%A3%E6%B1%BA%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8">
<a class="header-anchor-link" href="#%E8%A7%A3%E6%B1%BA%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8" aria-hidden="true"></a> 解決すること</h2>
<ul>
<li>ソフトウェアアーキテクチャを表現する図を見ると同じような問題をよく見かける
<ul>
<li>一貫性のない表記のせいで余計混乱する</li>
<li>色分けが謎</li>
<li>抽象度がグチャグチャ</li>
<li>図の中の色々な箱が何を示しているかが謎</li>
<li>箱と箱の間を結ぶ線が関係を示しているんだろうけど、何を意味しているか分からない</li>
<li>UMLは統一的な表記ルールを決めているけど、ルールが多すぎてパパッと書けないから結局使わなくなることが多い</li>
<li>etc…</li>
</ul>
</li>
<li>解決法として
<ul>
<li>抽象化レベルと図の種類を少なくして、とっつきやすくした</li>
<li>Google Mapsで興味のある地域を拡大したり縮小したりするように、ソフトウェアアーキテクチャを表現した<br>
<img src="https://res.cloudinary.com/zenn/image/fetch/s--AtOJd8CG--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://c4model.com/img/c4-overview.png" alt="c4-overview" loading="lazy" class="md-img">
</li>
</ul>
</li>
</ul>
<h2 id="%E8%A1%A8%E7%8F%BE%E3%81%99%E3%82%8B%E3%82%82%E3%81%AE">
<a class="header-anchor-link" href="#%E8%A1%A8%E7%8F%BE%E3%81%99%E3%82%8B%E3%82%82%E3%81%AE" aria-hidden="true"></a> 表現するもの</h2>
<p>ソフトウェアシステムの階層化された構成要素を書く。</p>
<ul>
<li>ソフトウェアシステムの構成要素を抽象化すると次の4つの要素が階層関係になっていることがわかる<br>
<img src="https://res.cloudinary.com/zenn/image/fetch/s--8m5ucu1y--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://c4model.com/img/abstractions.png" alt="abstractions" loading="lazy" class="md-img">
<ul>
<li>
<strong>ソフトウェアシステム</strong>は1つ以上の<strong>コンテナ</strong>(Webアプリケーション/モバイルアプリケーション/デスクトップアプリケーション/データベース/ファイルシステムなど)で構成され</li>
<li>それらが1つ以上の<strong>コンポーネント</strong>を含み</li>
<li>さらにそれらは1つ以上の<strong>コード</strong>(クラス、インタフェース、オブジェクト、関数など)で実装されている</li>
</ul>
</li>
<li>構成要素のざっくり説明
<ul>
<li>ソフトウェアシステム
<ul>
<li>ユーザー(人間であるかどうかにかかわらない)に価値を提供するもの</li>
</ul>
</li>
<li>コンテナ
<ul>
<li>ソフトウェアシステム全体が動作するために実行される必要があるもの</li>
<li>アプリケーションやデータストアの境界を指す</li>
</ul>
</li>
<li>コンポーネント
<ul>
<li>明確に定義されたインタフェースの背後にカプセル化された関連機能のグループのことを指す</li>
<li>JavaやC#などの言語を使用している場合、コンポーネントを考える最も簡単な方法は、インタフェースの背後にある実装クラスの集合体と捉える</li>
</ul>
</li>
</ul>
</li>
<li>構成要素の階層関係を表現するのがC4モデル<br>
<img src="https://i.gyazo.com/8e7fc6ceb09be17949be35ff1c01d75f.png" alt="c4-overview" loading="lazy" class="md-img">
<ul>
<li>
<ol>
<li>システムコンテキスト図</li>
</ol>
<ul>
<li>出発点となる図</li>
<li>対象となるソフトウェアシステムと周囲のソフトウェアシステム、ユーザーとの関連を示す</li>
</ul>
</li>
<li>
<ol start="2">
<li>コンテナ図</li>
</ol>
<ul>
<li>対象となるソフトウェアシステムにズームインし、高レベルの技術的な構成要素を示す</li>
</ul>
</li>
<li>
<ol start="3">
<li>コンポーネント図</li>
</ol>
<ul>
<li>個々のコンテナにズームインし、その中のコンポーネントを示す</li>
</ul>
</li>
<li>
<ol start="4">
<li>コード図</li>
</ol>
<ul>
<li>UMLのクラス図等を使用して個々のコンポーネントがどのように実装されているかを示す</li>
</ul>
</li>
</ul>
</li>
</ul>
<h2 id="%E6%9B%B8%E3%81%8D%E6%96%B9">
<a class="header-anchor-link" href="#%E6%9B%B8%E3%81%8D%E6%96%B9" aria-hidden="true"></a> 書き方</h2>
<h3 id="1.-%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%82%B3%E3%83%B3%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E5%9B%B3">
<a class="header-anchor-link" href="#1.-%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E3%82%B3%E3%83%B3%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E5%9B%B3" aria-hidden="true"></a> 1. システムコンテキスト図</h3>
<p><img src="https://res.cloudinary.com/zenn/image/fetch/s--Xzez0X-K--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://c4model.com/img/bigbankplc-SystemContext.png" alt="bigbankplc-SystemContext" loading="lazy" class="md-img"></p>
<ul>
<li>この図の役割
<ul>
<li>全体を俯瞰できる</li>
<li>人と外部のソフトウェアシステムに焦点が当たっている</li>
</ul>
</li>
<li>表現しない情報
<ul>
<li>技術やプロトコルなどの低レベルな技術要素に関する情報</li>
</ul>
</li>
<li>対象となる読者
<ul>
<li>ソフトウェア開発チーム内外の技術者、非技術者を問わず、全員</li>
</ul>
</li>
<li>作るべきか
<ul>
<li>Yes</li>
</ul>
</li>
</ul>
<h3 id="2.%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E5%9B%B3">
<a class="header-anchor-link" href="#2.%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E5%9B%B3" aria-hidden="true"></a> 2.コンテナ図</h3>
<p><img src="https://res.cloudinary.com/zenn/image/fetch/s--l2lIivXB--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://c4model.com/img/bigbankplc-Containers.png" alt="bigbankplc-SystemContext" loading="lazy" class="md-img"></p>
<ul>
<li>この図の役割
<ul>
<li>ソフトウェアシステムのざっくりとした構成が俯瞰できる</li>
<li>次の3つが理解できる
<ul>
<li>ソフトウェアシステムが選択した主要な技術</li>
<li>複数のコンテナの責務</li>
<li>コンテナ同士の通信</li>
</ul>
</li>
</ul>
</li>
<li>表現しない情報
<ul>
<li>デプロイメントシナリオ</li>
<li>クラスタリング</li>
<li>レプリケーション</li>
<li>フェイルオーバー etc…</li>
</ul>
</li>
<li>対象となる読者
<ul>
<li>ソフトウェア開発チーム内外の技術者（ソフトウェアアーキテクト、開発者、運用・サポートスタッフなど）</li>
</ul>
</li>
<li>作るべきか
<ul>
<li>Yes</li>
</ul>
</li>
</ul>
<h3 id="3.%E3%82%B3%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%8D%E3%83%B3%E3%83%88%E5%9B%B3">
<a class="header-anchor-link" href="#3.%E3%82%B3%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%8D%E3%83%B3%E3%83%88%E5%9B%B3" aria-hidden="true"></a> 3.コンポーネント図</h3>
<p><img src="https://res.cloudinary.com/zenn/image/fetch/s--belePk9p--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://c4model.com/img/bigbankplc-Components.png" alt="bigbankplc-Components" loading="lazy" class="md-img"></p>
<ul>
<li>この図の役割
<ul>
<li>コンテナの主要な構成要素が俯瞰できる</li>
<li>次の3つが理解できる
<ul>
<li>複数のコンポーネントの責務</li>
<li>コンポーネント同士の通信</li>
<li>技術/実装の詳細</li>
</ul>
</li>
</ul>
</li>
<li>対象となる読者
<ul>
<li>ソフトウェア設計者、開発者</li>
</ul>
</li>
<li>作るべきか
<ul>
<li>コンテナが複雑だったら作ってもいいかも</li>
<li>メンテナンスコストがかかるので長いこと保守してくなら自動を検討した方が良い</li>
</ul>
</li>
</ul>
<h3 id="4.%E3%82%B3%E3%83%BC%E3%83%89%E5%9B%B3">
<a class="header-anchor-link" href="#4.%E3%82%B3%E3%83%BC%E3%83%89%E5%9B%B3" aria-hidden="true"></a> 4.コード図</h3>
<p><img src="https://res.cloudinary.com/zenn/image/fetch/s--RUcZ6yQb--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://c4model.com/img/bigbankplc-Classes.png" alt="bigbankplc-Classes" loading="lazy" class="md-img"></p>
<ul>
<li>この図の役割
<ul>
<li>どのように実装されているかを、UMLのクラス図や実体関係図などで理解できる</li>
<li>最も重要なコンポーネントや複雑なコンポーネントがどう実装されているか理解できる</li>
</ul>
</li>
<li>対象となる読者
<ul>
<li>ソフトウェア設計者、開発者</li>
</ul>
</li>
<li>作るべきか
<ul>
<li>No</li>
<li>メンテナンスコストがかかりすぎるので、自動化は必須</li>
</ul>
</li>
</ul>
<h3 id="%E5%88%A9%E7%94%A8%E3%81%97%E3%81%A6%E3%81%84%E3%81%A6%E5%BE%97%E3%81%9F%E5%AD%A6%E3%81%B3">
<a class="header-anchor-link" href="#%E5%88%A9%E7%94%A8%E3%81%97%E3%81%A6%E3%81%84%E3%81%A6%E5%BE%97%E3%81%9F%E5%AD%A6%E3%81%B3" aria-hidden="true"></a> 利用していて得た学び</h3>
<h4 id="%F0%9F%99%85%E2%80%8D%E2%99%80%EF%B8%8F-%E7%B7%9A%E3%82%92%E3%81%84%E3%81%84%E3%81%8B%E3%82%93%E3%81%98%E3%81%AB%E6%9B%B8%E3%81%93%E3%81%86%E3%81%A8%E3%81%97%E3%81%99%E3%81%8E%E3%81%AA%E3%81%84">
<a class="header-anchor-link" href="#%F0%9F%99%85%E2%80%8D%E2%99%80%EF%B8%8F-%E7%B7%9A%E3%82%92%E3%81%84%E3%81%84%E3%81%8B%E3%82%93%E3%81%98%E3%81%AB%E6%9B%B8%E3%81%93%E3%81%86%E3%81%A8%E3%81%97%E3%81%99%E3%81%8E%E3%81%AA%E3%81%84" aria-hidden="true"></a> 🙅‍♀️ 線をいいかんじに書こうとしすぎない</h4>
<ul>
<li>メンテナンスコストが激増する、ざっくり見やすければそれでよし</li>
<li>コンテナ図以降は時間が経つにつれ結構変化していく、メンテナンスの機会は結構多い</li>
</ul>
<h3 id="%E6%84%8F%E8%AD%98%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8">
<a class="header-anchor-link" href="#%E6%84%8F%E8%AD%98%E3%81%99%E3%82%8B%E3%81%93%E3%81%A8" aria-hidden="true"></a> 意識すること</h3>
<h4 id="%E5%85%A8%E8%88%AC">
<a class="header-anchor-link" href="#%E5%85%A8%E8%88%AC" aria-hidden="true"></a> 全般</h4>
<ul>
<li>図の種類と範囲を説明するタイトルが必要
<ul>
<li>その四角の囲いは何を意味しているか</li>
<li>このシステムコンテキスト図は何を示しているか</li>
</ul>
</li>
<li>使用されている表記法（図形、色、枠線、線種、矢印など）を説明するキーや凡例が必要
<ul>
<li>いきなり紫色の矢印があちこちに書かれ始めたら混乱しちゃうよね</li>
</ul>
</li>
<li>略語（ビジネス/ドメインまたはテクノロジー）は読み手が理解できるようにするか、凡例で説明する必要がある
<ul>
<li>あなたが知っている言葉を誰もが知ってると思っちゃいけない</li>
</ul>
</li>
</ul>
<h4 id="%E8%A6%81%E7%B4%A0%E3%82%92%E6%9B%B8%E3%81%8F%E6%99%82">
<a class="header-anchor-link" href="#%E8%A6%81%E7%B4%A0%E3%82%92%E6%9B%B8%E3%81%8F%E6%99%82" aria-hidden="true"></a> 要素を書く時</h4>
<ul>
<li>要素の種類は明示的に指定すること
<ul>
<li>Person,Software System,Container,Component etc…</li>
<li>見た目がかっこいいアイコンを並べまくっても、悪夢みたいな図しかできなくなる</li>
</ul>
</li>
<li>要素には簡単な説明をつけ、主要な責任を「一目でわかる」ようにすること</li>
<li>すべてのコンテナとコンポーネントは、採用した技術を明示的に指定すること</li>
</ul>
<h4 id="%E9%96%A2%E4%BF%82%E3%82%92%E6%9B%B8%E3%81%8F%E6%99%82">
<a class="header-anchor-link" href="#%E9%96%A2%E4%BF%82%E3%82%92%E6%9B%B8%E3%81%8F%E6%99%82" aria-hidden="true"></a> 関係を書く時</h4>
<ul>
<li>要素と要素の繋ぎ方に明確なルールは無い。分かりやすが一番大事</li>
<li>「AがBのAPIを呼び出すー」のように声に出して読んでみるといい、読めないものは何かが間違っている</li>
<li>関係の方向性や意図（依存関係やデータフローなど）と一致するように、すべての線にラベル付ける必要がある</li>
<li>ラベルは「利用」のような単一単語は避け、できるだけ具体的に書くようにすること</li>
</ul>
<h5>すべての線は一方向の関係を表す必要がある</h5>
<ul>
<li>リクエストとレスポンスは本来双方向の通信が生じるので、ちゃんと書こうとするとこんな感じになる<br>
<img src="https://i.gyazo.com/1635c563cb8be99bce95cb3e409ede06.png" alt="lines-two-way" loading="lazy" class="md-img">
</li>
<li>冗長で複雑になるので線は一方向にしたほうがわかりやすい<br>
<img src="https://i.gyazo.com/f3fb3de2dce596491be21a6bf5f4941c.png" alt="lines-one-way" loading="lazy" class="md-img">
</li>
<li>もちろん例外もあって単純なリクエスト/レスポンスを超えた意味を表現する場合とかは、こんな風にかくとわかりやすい<br>
<img src="https://i.gyazo.com/fdd17bbcc72944ce18d88c1e9d3d5465.png" alt="lines-exception" loading="lazy" class="md-img">
</li>
<li>have &amp; spokeな図を書く時も線の書き方に注意<br>
<img src="https://i.gyazo.com/354aaa4c292cea3cde93512dc1d5cec5.png" alt="lines-hava_and_spoke-bad" loading="lazy" class="md-img">
</li>
<li>この図では「誰がどこに何をしたいか」が大事なので、こうしてみたらいいかも<br>
<img src="https://i.gyazo.com/0c99b8ba94699944db0638c32aca89e8.png" alt="lines-hava_and_spoke-good" loading="lazy" class="md-img">
</li>
</ul>
<h2 id="%E5%8F%82%E8%80%83">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83" aria-hidden="true"></a> 参考</h2>
<ul>
<li><a href="https://c4model.com/" target="_blank" rel="nofollow noopener noreferrer">本家</a></li>
<li><a href="https://www.infoq.com/jp/articles/C4-architecture-model/" target="_blank" rel="nofollow noopener noreferrer">infoQの記事</a></li>
<li><a href="https://en.wikipedia.org/wiki/4%2B1_architectural_view_model" target="_blank" rel="nofollow noopener noreferrer">4+1 architectural view model</a></li>
<li><a href="https://youtu.be/x2-rSnhpw0g" target="_blank" rel="nofollow noopener noreferrer">C4modelのこと話してるYouTube</a></li>
</ul>


Discussion