目次 (15)
FSDアーキテクチャを使用しない理由と代替
FSD(Feature-Sliced Design)アーキテクチャについてご存知ですか?フロントエンドのために誕生した拡張可能なアーキテクチャです。コアは機能中心のプロジェクト構造を作ることです。以前は、技術中心でComponents、APIs、Styles、Servicesのように分けていたら、FSDではビジネスロジックとユーザーの機能中心に分けます。
FSDアーキテクチャ構造
FSDアーキテクチャは6つの機能中心に分けたLayersで構成されており、各LayerにはSlicesが存在し、各SliceにはSegmentが存在します。

Layer : アプリケーションでどのような役割を果たすかを責任(Responsibility)基準で割ったもの 以下のように6つの構成されている。
app: アプリケーションの初期化、Provider、Router
pages: URL 単位画面
widgets:ページを構成する大きなUIブロック(複数の機能セット)、通常はページで再利用可能な単位で構成
features: ユーザーが実行するアクション(いいね、ログインなど)
entities: コアドメインオブジェクト (User, Product)
shared: 特定のドメインに属さない再利用コード、Slice と Segment が存在しない。
Slice:ビジネスドメイン基準
user
post
...
Segment: 技術的分割
ui
api
model
...
FSDアーキテクチャ依存ルール
FSDアーキテクチャには、下位レイヤでは上位レイヤを使用できないルールがあります。そしてsharedレイヤーを除けば、同じレイヤー間のcross-importも許可しません。 cross-importを許可する場合は、フォルダ名に@xのようなフォルダ名を追加して、cross-importされることを使用する場所でわかるように例外ルールを作成して使用します。

FSDアーキテクチャフォルダ構造の例
理解を助けるために、FSDアーキテクチャのフォルダ構造の例を紹介します。
src/├── app/ # アプリ初期化、プロバイダ、ルーティング│ └── providers/│├── pages/ # ルート単位ページの組み合わせ│ ├── login/│ └── cart/│├── widgets/ # 独立して動作するUIブロック│ └── header/│├── features/ # ユーザー行為(シナリオ)単位│ ├── auth/ # ログイン│ │ ├── ui/│ │ │ └── LoginForm.tsx│ │ ├── model/│ │ │ └── useLogin.ts│ │ └── index.ts # public API(外部にはここでのみ公開)│ └── add-to-cart/ # カートに入れる│ ├── ui/│ │ └── AddToCartButton.tsx│ ├── model/│ │ └── useAddToCart.ts│ └── index.ts│├── entities/ # ビジネスドメインモデル│ ├── user/│ │ ├── ui/│ │ │ └── UserAvatar.tsx│ │ ├── model/│ │ │ ├── types.ts│ │ │ └── userStore.ts│ │ ├── api/│ │ │ └── userApi.ts│ │ └── index.ts│ └── product/│ ├── ui/│ │ └── ProductCard.tsx│ ├── model/│ │ └── types.ts│ ├── api/│ │ └── productApi.ts│ └── index.ts│└── shared/ # ドメインを知らないパブリックコード ├── ui/ │ └── Button.tsx ├── api/ │ └── apiClient.ts ├── lib/ │ └── formatPrice.ts └── config/ └── env.tsFSDアーキテクチャの評価
FSDアーキテクチャを5つの観点から評価してみましょう。
凝集度(cohesion)
結合度(coupling)
ナビゲーションの容易さ
メンタルモデル一致度
徐々に導入
1. 凝集度
凝集度とは、関連しているコードがどれだけ集まっているかを言います。散らばると凝集度が低いのです。
変更する1つの理由で一緒に変更しなければならないことを関連しているコードで見て凝集度が高いものと見ます。
FSDアーキテクチャはこのCohesionの観点から良くないと思います。なぜなら、実際には1つの機能を変えるとき、下位レイヤーまでチェックしなければならない場合が生じます。

上記のように凝集度が低いと見ることができるので、以下のような問題点が生じます。
認知負荷: もっと開いてみるべきファイルが多いということは、より多くのコンテキストを開発者が持っていなければなりません。
隠された依存性: 1つのレイヤーを変更すると、他のレイヤーに影響を与えることができます。下位レイヤーでも、上位レイヤーでも。
スローコードレビュー:レビューアは、1つの変更を理解するために複数のフォルダをチェックする必要があります。
難しいオンボーディング:新しく投入された開発者は、1つのフォルダを見て、どのように機能が動作するのか理解できません。
2. 結合度
結合度は、モジュールが互いにどれだけ独立しているかを示す尺度です。あるモジュールを変更すると、他のモジュールにどのように影響するかを示します。
あるモジュールを変更したときに他のモジュールに影響を与えて機能しないようにしたら、隠れた依存性を持って結合度が高いことを意味します。

FSDアーキテクチャでは、互いの領域に侵入しなければならない機能がアーキテクチャの限界のため原則を破らなければならない場合が生じます。
上記の方法ではなく、WidgetでAdd to Cartコンポーネントを組み合わせればいいのではないかと言うことができますが、それでは最終的にLayerを分けた基準を一つずつ壊すことになり、むしろより複雑になるでしょう。

上の図を見ると、凝集度と結合度による依存性と凝集度をマトリックスに分けて示しています。 FSDアーキテクチャの場合には構造自体では結合度が低く見えますが、実際に使ってみるとその限界で少し曖昧です。それで中程度の結合度を持つアーキテクチャだと思います。結論としては低い凝集度の中間結合も位置だと思います。
3. ナビゲーションの容易さ
ナビゲーションが簡単であれば、どのような機能や役割のコードを見つけたら、フォルダ構造だけを見てすぐに見つけることができます。 FSDアーキテクチャはナビゲーションの容易さに非常に深刻な問題があります。その原因は大きく2つです。
開発者ごとに異なるレイヤー位置の選択による問題 - レビューする人がレイヤー選択自体に同意できず、コードに集中できない可能性があります
低凝集道路
たとえば、「検索ウィンドウ」コンポーネントを作成するとします。この「検索ウィンドウ」は、widgetで見るのか、featureで見るのか、entityで見るのか、開発者ごとに違うと思います。そうすれば、Aという開発者が「検索ウィンドウ」を作ったとき、Bという開発者はどのレイヤーで「検索ウィンドウ」を見つけることができるか確信できません。
4. メンタルモデル一致度
メンタルモデルは、チームが考える製品コンセプトとフォルダ構造が一致するかどうかを示します。
コード構造は、チームが製品についてどのように考えているかを反映しています。チームメンバーが考える製品とコードが一致すれば、チームメンバーはどの機能について作成または読み取るときにアーキテクチャのどの部分を表すかを考える必要はありません。

FSDアーキテクチャは技術中心にレイヤーを分けています。そして、技術中心のレイヤーは実際に使ってみると人ごとに考えるところが違うので確信を持てません。だからいつも考えなければなりません。しかし、機能中心に最初に分ければ、どのような機能を考えると、より簡単にフォルダ構造と考えをマッチングできます。
FSDアーキテクチャのレイヤーに基づいてメンタルモデルを製品コンセプトと一致させる必要がある場合は、多くの合意と教育が必要になると思います。そうしてこそやっと一致させると思います。
実際にもメンタルモデルと一致させるためにFSDアーキテクチャを変形して概念化して使う場合が非常に多いです。
5. 徐々に導入
開発初期からアーキテクチャを確定できません。新たに要件が入ってきてアーキテクチャを修正しなければならない場合が発生します。
アーキテクチャは製品が変化しながら一緒に変化します。だから、普通のシンプルなアーキテクチャから始めて、ますます製品に合わせてアーキテクチャが変化します。
しかし、FSDアーキテクチャは最初から6つのレイヤー、スライス、セグメントを適用する必要があります。もちろん、FSDの公式文書を見ると徐々に導入ガイドがありますが、実際には既存のコードと構造自体が異なるように始まるので、適用するのは非常に難しいと思います。
FSD総合評価
利点
Sliceレベルの凝集力がいいです。
循環依存性がありません。
FSDアーキテクチャの文書化がうまくいっています。
欠点
機能レベルで凝集力が悪いです。
レイヤーの選択結果が異なる場合があります。
フォルダ構造は技術中心に強制されます。
徐々に導入が事実上難しいです。
代替アーキテクチャの提案
私はFSDアーキテクチャの代替として、Layered ArchitectureとVertical Sliceを活用することを提案します。
Layered Architecture(階層型アーキテクチャ)は、通常、小規模から中規模のアーキテクチャで推奨されるアーキテクチャです。階層アーキテクチャは、FSDなどの技術的責任に基づいてコードを構築するアーキテクチャです。 Webプロジェクトでは通常、Shared、Presentation、Business Logic、Data Access、Routerなどの役割に分けられます。バックエンド基準としてはController、Service、Repositoryに分けますね。
Web プロジェクト Layered アーキテクチャの例
Layered Architecture(階層型アーキテクチャ)は、通常、小規模から中規模のアーキテクチャで推奨されるアーキテクチャです。階層アーキテクチャは、FSDなどの技術的責任に基づいてコードを構築するアーキテクチャです。 Webプロジェクトでは通常、Shared、Presentation、Business Logic、Data Access、Routerなどの役割に分けられます。バックエンド基準としてはController、Service、Repositoryに分けますね。

それでは、階層アーキテクチャは5つの観点から総合評価するとどうでしょうか。
凝集度(cohesion) - 機能によって分けられず、凝集度が低い
結合度 - チームやプロジェクトによって異なります
ナビゲーションの容易さ - 簡単な構造で簡単にナビゲート可能
メンタルモデルの一致度 - 技術的に構造を分割したメンタルモデルと一致しない
徐々に導入 - 簡単に開始可能
WebプロジェクトのLayered Architecture + Vertical Sliceを適用
Vertical Sliceはアーキテクチャを技術中心にまず分けず、機能中心に分けます。通常、レイヤードアーキテクチャで1つの機能が大きすぎると、それをVertical Sliceに分割し始めると思います。

凝集度(cohesion) - 1つの機能のためのコードが1つのフォルダで高い
結合度 - チーム/プロジェクトによって異なります
ナビゲーションの容易さ - 1つの機能のコードが1つのフォルダにすべて存在します
メンタルモデルの一致度 - ビジネス機能とフォルダが簡単に一致
段階的な導入 - 1つの機能フォルダから簡単に起動可能
結論
FSDは、アーキテクチャは循環依存性の問題を解決し、きちんとしたルールによるスライス単位の良好な凝集度で長所を持つが、階層選定問題、低い機能単位の凝集度、難しい漸進的導入といった問題を持っています。だから実際にはFSDアーキテクチャそのまま書くよりは変形して再定義して書く場合も非常に多いです。
私もFSDアーキテクチャを会社で使用していますが、実際には好きではありません。むしろ、どの層に位置すべきかについての悩みが多くなり、コミュニケーションコストだけが大きくなると思います。だからとコミュニケーションしなければ、ずっと曖昧な状態に流れるしかないんですよ。さらに、どの機能を見るには、どのフォルダを通って行くべきかを見つけるのがはるかに困難になったりしました。
だからこそ、Layered ArchitectureにFeature Sliceを活用してドメイン別に分けると、はるかに柔軟になると思います。
まぁここに加えて私は次のグローはMFA(Micro Frontend Architecture)についても紹介するかと思います。チームの規模が徐々に大規模になると、配布とコード管理までの両方に分けなければならない場合がありますか?それで、一次元のより高い段階で分ける方法論について話しましょう。
