『「The Clean Architecture」がWebフロントエンドでしっくりこないのは何故か - 制約から考えるアーキテクチャとテスト』を聞いたメモ

これは『[JSConf.jp おかわり Node学園46時限目](https://nodejs.connpass.com/event/344588/)』よりt-wadaさんの『「The Clean Architecture」がWebフロントエンドでしっくりこないのは何故か - 制約から考えるアーキテクチャとテスト』の講演を聞いたメモと感想です。

# Webフロントエンドでクリーンアーキテクチャがしっくりこない
主題は『クリーンアーキテクチャ（例の同心円）をWebフロントエンドで実装してみたがしっくりこない』という声の正体を探るもの。

例の同心円とは「Clean Architecture」の原則から導かれる具体例の一つである"The Clean Architecture"のバックエンド向けJava実装のこと。
その「形状」だけ真似てWebフロントエンドにもってくることはナンセンスとのこと。

フロントエンドとバックエンドでは追求する品質特性や制約が異なるため、立ち向かう複雑さが異なる。

## ソフトウェアアーキテクチャの目的
### 「Clean Architecture」にはどう書かれているか
『ソフトウェアアーキテクチャの目的は、求められるシステムを構築・保守するために必要な人材を最小限に抑えることである。』

[Clean Architecture　達人に学ぶソフトウェアの構造と設計 (アスキードワンゴ) | Ｒｏｂｅｒｔ Ｃ．Ｍａｒｔｉｎ, 角 征典, 高木 正弘 | 工学 | Kindleストア | Amazon](https://www.amazon.co.jp/Clean-Architecture-%E9%81%94%E4%BA%BA%E3%81%AB%E5%AD%A6%E3%81%B6%E3%82%BD%E3%83%95%E3%83%88%E3%82%A6%E3%82%A7%E3%82%A2%E3%81%AE%E6%A7%8B%E9%80%A0%E3%81%A8%E8%A8%AD%E8%A8%88-%E3%82%A2%E3%82%B9%E3%82%AD%E3%83%BC%E3%83%89%E3%83%AF%E3%83%B3%E3%82%B4-%EF%BC%B2%EF%BD%8F%EF%BD%82%EF%BD%85%EF%BD%92%EF%BD%94-%EF%BC%A3%EF%BC%8E%EF%BC%AD%EF%BD%81%EF%BD%92%EF%BD%94%EF%BD%89%EF%BD%8E-ebook/dp/B07FSBHS2V/ref=sr_1_1?crid=3NXDLYGFF5DSB&dib=eyJ2IjoiMSJ9.TYUmCbJ9elOgyVCJ69YBcnDAw2LnsH4ZCvU9gLBKbvijDLCKEpbFKiW4hnmEQdOtz31zbEaqBEphM1OHZhNErUWthZCgw2LEhtB9YUsvs4iM_MMlIXs80O7S1svyGj-m_FVPCEASoW3n99mjpLsqxHTGKn5hNt0zQ7IaK7Hzl6nYHwMfF7EJtISi23DV9xJr1O2afGQsqgqc1HhWu2h32xGsJPt6-Sz2xKW_zNBYFhfs9UGLuHCXAIpwbX6Kusm6dr8sz8Q8SjkD6JviYWV1WUQkSOL9IJ85CKlK2_1IV3SoKh8x5x5Jf5Bk2_NgZAW6WJjh61caSf_KoW2vS2GubziRmDvINgU5FQcw00n8FuJDi4wy8fbh79kioCVxvArSC6wxSLFX9byAD9Byi7dQsBKdpKvcwFmoOsR0rP6mwEOir1obcpfRV-Fq-pFMmsDI.Ono7UVb6MS01tUhVIl14uB3Cs2Z7qwvQYHyA1ywxfkI&dib_tag=se&keywords=clean+architecture&qid=1740925796&sprefix=clean+archi%2Caps%2C211&sr=8-1)

### 「Design it!」にはどう書かれているか
『システムのソフトウェアアーキテクチャとは、望まれる品質特性やその他の性質を促進するためにソフトウェアをどう構成するかということに対する、重要な設計判断が集まったものだ。』
→ 『望まれる品質特性を作るためにどう作るか』ということ。

[Design It! ―プログラマーのためのアーキテクティング入門 | Michael Keeling, 島田 浩二 |本 | 通販 | Amazon](https://www.amazon.co.jp/Design-%E2%80%95%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9E%E3%83%BC%E3%81%AE%E3%81%9F%E3%82%81%E3%81%AE%E3%82%A2%E3%83%BC%E3%82%AD%E3%83%86%E3%82%AF%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0%E5%85%A5%E9%96%80-Michael-Keeling/dp/4873118956/ref=sr_1_1?__mk_ja_JP=%E3%82%AB%E3%82%BF%E3%82%AB%E3%83%8A&dib=eyJ2IjoiMSJ9.annutZgDDrYFDuSLmhftVnKSKBnHghizSyJN0mf70GxYqRQaTbnurqUaszzM_X5LbEwLW-rcBCUqGUK6RTcZ52NfZXv9hyfNen88b0Lsnh15x1haYtI7tcoeoNJyG5CrFaGk-K0WQwCDuB1x49KlxX6n3-Cnf0Xrjp4GwQi7n5pC49r7PDUkxEA_UXXN-emrUNX_ILhKwK61vaW-xgwtqXxxQ6dMGVwABx6GMScBts-HeLU-ALkk_Wuk3wbHTkBLi4xN1zGe1op-Xro6CFQZflXRIBXb7j82qfzbRhwkHVqrPyXOEKahqFHfY6AY9pceeYsVO0T-7JrULNWyPWWbH0Uwz0lZ2JlipzSU4PCbYV0.ykb4FFZRlBr8eMcmSalYW-MiN99Symgl0SR7GhsnNbo&dib_tag=se&keywords=design+it&qid=1740925753&sr=8-1)

### アーキテクチャドライバ
品質特性に加えて、制約その他のアーキテクチャ選定に影響を与えるものを識別
- 制約
- 品質特性
- 影響を与える機能要求
- その他の影響を及ぼすもの

## 品質特性
### JIS X 25010の8つの品質特性
ソフトウェア品質を測定可能な特徴として定義したもの

機能適合性: 振る舞い要求（機能要求）に対する品質
その他特性: 非機能要求に対する品質

> [JIS X 25010の8つの品質特性](https://kikakurui.com/x2/X25010-2013-01.html)

![スクリーンショット 2025-03-02 23.12.47.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/634043/21ed8bd7-6569-4400-9284-1092ed8c19fb.png)

![スクリーンショット 2025-03-02 23.12.37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/634043/f66c589c-6877-4ea9-99f1-00d842775a3d.png)


### SQuaRE 品質モデル
SQuaRE 品質モデル: 製品品質の品質特性と品質副特性
> [つながる世界のソフトウェア品質ガイド あたらしい価値提供のための品質モデル活用のすすめ | アーカイブ | IPA 独立行政法人 情報処理推進機構](https://www.ipa.go.jp/archive/publish/tn20150529.html)

上記品質特性の下に紐づいているそれぞれが品質副特性。

→ The Clean Architectureは保守性に全振りしているが、品質は保守性だけではない。

### Webフロントエンドの目指す品質特性
#### Webフロントエンド版DX Criteria
- ユーザー体験を支える品質
  - パフォーマンス
  - アクセシビリティ
  - セキュリティ
  - プライバシー
  - デザイン

> [Webフロントエンド版DX Criteria (v202402)/プロダクトのユーザー体験と変化に適応するチームのためのガイドライン](https://dxcriteria.cto-a.org/frontend)

## Webフロントエンドとバックエンドの違い
### Webフロントエンドとバックエンドで異なるもの
- UIの重要性
- 実行環境の多様性
- 状態管理の複雑さ
- ビジネスロジックの複雑さ
- パフォーマンスの観点
- 信頼性の観点
- セキュリティの界面

製品品質に品質特性と制約をマッピングすると下記のようになる。
![square-品質特性と制約のマッピング.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/634043/4bee43fc-46a9-404b-9c36-b4a9ef09ac54.png)


### バックエンドで促進したい品質特性
![square-品質特性のバックエンド.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/634043/ddf8a014-1723-4e01-bd12-72849ba63557.png)


### 比較する
| 項目                 | Webフロントエンド | バックエンド |
|----------------------|------------------|-------------|
| **使用性 (Usability)** | ユーザー体験（UX）が非常に重要であり、ユーザーにとって使いやすく快適なインターフェースを構築する必要がある。操作性、アクセシビリティに加え、ユーザー操作のエラー・ハンドリングなどのユーザーエラー防止性も重要 | 直接的には影響しない |
| **適応性 (Adaptability)** | ユーザーのデバイスやブラウザ上で動作するため、ネットワーク環境やデバイス性能など、実行環境が非常に多様 | サーバー上で動作するため、実行環境は比較的均一。安定したネットワーク環境と豊富なリソースが利用可能 |
| **信頼性 (Reliability)** | あえて言うならネットワークの不安定性に伴う障害許容性 | サーバーやデータベース、ネットワークの成熟性（安定性）、可用性、障害許容性（対故障性）、回復性全てが重要 |
| **性能効率性 (Performance)** | ページの読み込み速度、レンダリング速度、ユーザー操作への応答速度などが重要 | サーバー側の処理速度、データベースのクエリ速度、サーバー群のスケーラビリティ、ネットワークの帯域幅などが重要 |
| **セキュリティ (Security)** | クライアント側のセキュリティ対策（XSS、CSRF、データ漏洩対策など）ユーザー入力の検証、プライバシー保護、安全なデータ送信、セキュリティヘッダーの設定など、クライアント側のセキュリティ対策を徹底し、セキュリティリスクを考慮した設計が重要 | サーバー側のセキュリティ対策（認証、認可、データ保護など）が重要 |


### 保守性
#### ビジネスロジックの複雑さ
- フロントエンド
  - ビジネスロジックの複雑さはバックエンドに比べて比較的単純/ビジネスロジック自体ほとんどない
- バックエンド
  - ビジネスロジックの複雑さは高い
  - *The Clean Architecture*, *DDD*で立ち向かう

### 状態管理の複雑さ
- フロントエンド
  - ユーザー操作や非同期処理によって状態が頻繁に変化し、複雑な状態管理が必要
  - *コンポーネント指向で立ち向かう*
- バックエンド
  - 主にDBで整合性を管理し、リクエストごとに状態を処理する

## クラス指向OOPとフロントエンド
- なぜWebフロントエンドはクラス指向OOPを避けるようになったのか。
- なぜWebフレームワークはクラスではなく値と関数を使わせようとするのか。

→ パフォーマンスの観点から、関数と値を使った方が高速、かつ最小限の再レンダリングが実現可能
→ 保守性の観点から、遅延束縛のクラスよりもESMの方がバンドルサイズ削減に向いている

### パフォーマンス
- Webフロントエンドのフレームワークはstateやpropsが変更された際に変更された部分のみを効率的に再レンダリングすることで、パフォーマンスを最適化している。
- 変更の検知において、値の比較はクラスのインスタンス比較よりも高速かつ容易。
- フレームワークは変更された部分のみを正確に特定し、最小限の再レンダリングで済ませられる。

### 保守性（モジュール性と資源最適性）
- バンドルサイズを削減するためにクラスよりモジュール(ESM)の方が向いている。
  - クラスは遅延束縛 = 実行時まで削減できるクラスがわからないためバンドルサイズ削減に向かない
    - 設計上の決定は先送りするが、実行上の決定は先送りすると不利なのがWebフロントエンド
> [ダイナミックバインディング - Wikipedia](https://ja.wikipedia.org/wiki/%E3%83%80%E3%82%A4%E3%83%8A%E3%83%9F%E3%83%83%E3%82%AF%E3%83%90%E3%82%A4%E3%83%B3%E3%83%87%E3%82%A3%E3%83%B3%E3%82%B0)


# まとめ
- Webフロントエンドでクリーンアーキテクチャがしっくりこないのは以下の二点
  - Clean Architectureで語っている原則を元に作成したJava実装で促進している品質が保守性であり、特にドメインの複雑性に立ち向かうものであるため。
  - "The Clean Architecture"はJava実装であるためクラスベースで語られているが、Webフロントエンドは関数と値を使用したコンポーネント指向が主流であるため、言語・FW仕様と噛み合わない。
- Webフロントエンドが立ち向かうべき複雑性は状態管理である。


普段バックエンドの開発が主なのでなぜフロントエンドはコンポーネント指向に向かっているのかよく理解していなかったため、非常に勉強になった。
バックエンドとフロントエンドでは立ち向かう複雑さが異なるという点が特にしっくりきた。

遅延束縛や決定の先送りといったことについて考えたことがなかったので今後インプットを増やしていきたい。