世界一わかりやすいClean Architecture - 技術レイヤー分割より大切なモノ

1.

2.

3.

4.

5.

6.

7.

8.

9.

10.

About Me 中村充志 / Atsushi Nakamura • • • • リコージャパン株式会社所属 Enterprise（おもに金融）系SIerのITアーキテクト最近はプロダクトオーナー風なことも「持続可能なソフトウェア」の探求がライフワーク • Blog • Twitter(X) • GitHub https://zenn.dev/nuits_jp @nuits_jp https://github.com/nuitsjp Copyright 2025 @nuits_jp Slide 10

11.

12.

ブログ本日お話する内容は、下記のブログに原稿と合わせて公開します。 https://zenn.dev/nuits_jp/articles/2025-04-30-easiest-clean-architecture サンプルコードおよびPowerPointはGithubに「CC BY-SA 4.0」で公開しています。 https://github.com/nuitsjp/Easiest-Clean-Architecture Copyright 2025 @nuits_jp Slide 12

13.

14.

https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html

15.

16.

17.

18.

19.

20.

21.

22.

23.

24.

Clean Architectureの図は・・・ Hexagonal architecture 共通する特徴をまとめ、汎化・例示したものにすぎない汎化 Onion Architecture：https://jeffreypalermo.com/2008/07/the-onion-architecture-part-1/ Hexagonal architecture：https://en.wikipedia.org/wiki/Hexagonal_architecture_(software) Copyright 2025 @nuits_jp Slide 24

25.

あくまで例示であると取れる記載もある Clean Architecture説明の冒頭に、著名なアーキテクチャ（Hexagonal, Onion, etc...）には類似の共通点が見られるとある。そして続けてこう記載されている。 The diagram in Figure is an attempt at integrating all these architectures into a single actionable idea. （邦訳：図は、これらのすべてのアーキテクチャを単一の実行可能なアイデアに統合したものである。） Copyright 2025 @nuits_jp Slide 25

26.

すべてが同一アーキテクチャに帰結するとすれば以下は、あくまで一例であることは自明 • レイヤーが4つ※1 • UIがMVC的である • Web限定 • Output PortはUse Caseとの間「だけ」にある※2 • などなど ※1 とは限らないと書籍にも明記されている ※2 eventみたいなPub/SubがUse Case限定じゃ困っちゃう Copyright 2025 @nuits_jp Slide 26

27.

28.

29.

30.

31.

32.

33.

34.

35.

36.

37.

38.

39.

Application Overview ※ アプリケーション「HatPepper」 • 位置情報から周辺の店舗を検索する「コンソールアプリケーション」 • 「リクルートWebサービス」の「グルメサーチAPI」を利用させていただく（いつもお世話になっております。） ※「ホットペッパー」は株式会社リクルート様の登録商標です。 ※「HatPepper」は登録商標ではありません。安心。 Copyright 2025 @nuits_jp Slide 39

40.

41.

42.

43.

44.

45.

46.

47.

48.

49.

50.

51.

52.

53.

54.

55.

56.

57.

58.

59.

60.

61.

62.

63.

64.

65.

66.

67.

Application Overview ※ アプリケーション「HatPepper」 • 位置情報から周辺の店舗を検索する「コンソールアプリケーション」 • 「リクルートWebサービス」のこれこそが価値の本質「グルメサーチAPI」を利用させていただく（いつもお世話になっております。） ※「ホットペッパー」は株式会社リクルート様の登録商標です。 ※「HatPepper」は登録商標ではありません。安心。 Copyright 2025 @nuits_jp Slide 67

68.

69.

70.

71.

72.

73.

74.

75.

76.

77.

78.

79.

80.

81.

82.

83.

84.

85.

86.

87.

88.

89.

90.

91.

クラス図 { "results": { "results_start": 1, "results_returned": "2", "api_version": "1.26", "shop": [ { "name": "彩羽鶏いろはどり新宿東口店", "genre": { "catch": "新宿月あかり個室居酒屋…", … }, "budget": { "average": "2500円（通常平均）…", "name": "2001～3000円", "code": "B002" }, "mobile_access": "JR新宿駅東口より徒1分… Copyright 2025 @nuits_jp Slide 91

92.

93.

94.

95.

96.

97.

98.

99.

100.

101.

102.

103.

104.

105.

106.

107.

108.

109.

110.

111.

112.

113.

114.

115.

Application Overview ※ アプリケーション「HatPepper」 • 位置情報から周辺の店舗を検索し予約するグルメサイト • 「リクルートWebサービス」の「グルメサーチAPI」を利用させていただく（いつもお世話になっております。） ※「ホットペッパー」は株式会社リクルート様の登録商標です。 ※「HatPepper」は登録商標ではありません。安心。 Copyright 2025 @nuits_jp Slide 115

116.

117.

コンテキストマップ HatPepper <core-domain> 検索 <core-domain> 予約 <bounded context> 検索App <bounded context> 予約App <bounded context> 検索Gateway <bounded context> 予約Gateway Copyright 2025 @nuits_jp <support-domain> ・・・・ Slide 117

118.

コンテキストマップ HatPepper <generic-domain> HatPepper <bounded context> HotPepper <core-domain> 検索 <core-domain> 予約 <bounded context> 検索App <bounded context> 予約App <bounded context> 検索Gateway <bounded context> 予約Gateway Copyright 2025 @nuits_jp <support-domain> ・・・・ Slide 118

119.

コンテキストマップ HatPepper <generic-domain> HatPepper <bounded context> HatPepper <bounded context> Orchestrator <core-domain> 検索 <core-domain> 予約 <bounded context> 検索App <bounded context> 予約App <bounded context> 検索Gateway <bounded context> 予約Gateway Copyright 2025 @nuits_jp <support-domain> ・・・・ Slide 119

120.

コンテキストマップ HatPepper <generic-domain> HatPepper <bounded context> HatPepper <bounded context> Orchestrator <bounded context> Bootstrapper <core-domain> 検索 <core-domain> 予約 <bounded context> 検索App <bounded context> 予約App <bounded context> 検索Gateway <bounded context> 予約Gateway Copyright 2025 @nuits_jp <support-domain> ・・・・ Slide 120

121.

コンテキストマップ HatPepper <generic-domain> HatPepper <bounded context> HatPepper <bounded context> Orchestrator <bounded context> Bootstrapper <core-domain> 検索 <core-domain> 予約 <bounded context> 検索App <bounded context> 予約App <bounded context> 検索Gateway <bounded context> 予約Gateway Copyright 2025 @nuits_jp <support-domain> ・・・・ Slide 121

122.

123.

124.

125.

126.

ソフトウェアのフラクタルドメインサブドメイン境界付けられたコンテキスト技術レイヤー技術レイヤーサブドメイン境界付けられたコンテキスト技術レイヤー技術レイヤーソフトウェアオブジェクトソフトウェアオブジェクトすべてに、ここまでの話は適用可能 • 要素間のインターフェースの文脈により、制御の流れと依存関係は制御可能 • 依存関係によって、安定性と柔軟性をコントロール可能 Copyright 2025 @nuits_jp Slide 126

127.

128.

コンテキストマップ HatPepper <generic-domain> HatPepper <bounded context> HatPepper <bounded context> Orchestrator <bounded context> Bootstrapper <core-domain> 検索 <core-domain> 予約 <bounded context> 検索App <bounded context> 予約App <bounded context> 検索Gateway <bounded context> 予約Gateway Copyright 2025 @nuits_jp <support-domain> ・・・・ Slide 128

129.

130.

131.

132.

133.

134.

ソフトウェアアーキテクチャとは何か？ソフトウェアアーキテクチャでは、ソフトウェアシステムの構成に関する一連の重要な判断を網羅しています。これには、システムを構成する要素とインターフェイスの選択、要素間のコラボレーションとして指定される動作、このような構成と動作の要素のより大きなサブシステムに対する構成、この構成の指針となるアーキテクチャスタイルが含まれます。また、機能性、ユーザビリティ、復元性、パフォーマンス、再利用性、理解できること、経済的な制約、テクノロジの制約、トレードオフ、および外観への配慮も必要です。 by Philippe Kruchten, Grady Booch, Kurt Bittner, Rich Reitman Microsoft 「アプリケーションアーキテクチャガイド2.0」より引用 Copyright 2025 @nuits_jp Copyright 2017 @nuits_jp Slide 134

135.

ソフトウェアアーキテクチャとは何か？アーキテクチャは、システムを大きなレベルで分解したもので、決定事項の変更は困難です。システムには複数のアーキテクチャが存在し、アーキテクチャにとって重要な事項はシステムの運用中に変化します。要するに、重要な要素は、すべてアーキテクチャということになります。 by Martin Fowler Microsoft 「アプリケーションアーキテクチャガイド2.0」より引用 Copyright 2025 @nuits_jp Copyright 2017 @nuits_jp Slide 135

136.

ソフトウェアアーキテクチャとは何か？ソフトウェアアーキテクチャとは、抽象化と問題の分割によって複雑性を減らすことを主に念頭に置いたものである。ただし、今までのところ、「ソフトウェアアーキテクチャ」という用語に関して、万人が合意した厳密な定義は存在しない Wikipedia「ソフトウェアアーキテクチャ」より引用 Copyright 2025 @nuits_jp Copyright 2017 @nuits_jp Slide 136

137.

138.

ソフトウェアアーキテクチャとは何か？かみ砕くと… 1. ソフトウェアアーキテクチャとはシステムアーキテクチャのうち、ソフトウェア領域のアーキテクチャであるこの時「システム」とは「IT」だけではなく、それらを取り巻く社会やビジネスを含めた「仕組み」を指すことも多い ※ 元来「System」とは制度・組織・体系・系統などのこと Copyright 2025 @nuits_jp Copyright 2017 @nuits_jp Slide 138

139.

140.

ソフトウェアアーキテクチャとは何か？かみ砕くと… 3. ソフトウェアアーキテクチャを構築するのはなぜか？ • 「システムの実現をサポートする」 • 「持続可能なソフトウェア」を • 「バランスよく」構築するため 4. ソフトウェアアーキテクチャのバランスとは？ 1. Quality（機能・非機能） 2. Cost 3. Delivery（開発期間）アーキテクチャは非機能要求からも大きく影響をうける Copyright 2025 @nuits_jp Copyright 2017 @nuits_jp Slide 140

141.

142.

143.

144.

ソフトウェアアーキテクチャとは何か？かみ砕くと… 2. ソフトウェアアーキテクチャとは 1. ソフトウェアにおける重要な決定事項全てである 2. その中でも特につぎの2点が重要 1. ソフトウェア全体を、どのように分割するか 2. 分割した部分同士を、どう結合し、相互作用させるかソフトウェアアーキテクチャ3種の神器 Copyright 2025 @nuits_jp Copyright 2017 @nuits_jp Slide 144

145.

146.

147.

148.

149.

150.

151.

152.

153.

154.

155.

156.