アーキテクチャ(Feature-Sliced Design)
優先度: P2(中)
スケーラブルなアプリケーションのためにFeature-Sliced Design (FSD) を採用します。 警告: FSDはボイラープレートを増やします。プロジェクトが大幅に成長することが見込まれる場合(例: 20以上の機能)にのみ使用してください。小規模なプロジェクトでは、シンプルなモジュールベースの構造が推奨されます。
戦略
- RSCバウンダリ: サーバーからクライアントに渡されるプロパティに対して、厳格なシリアライゼーションルールを適用します。RSCバウンダリとシリアライゼーションを参照してください。
- App層は薄く:
app/ディレクトリ(App Router)はルーティングのみに使用します。- ルール:
page.tsxはWidgets/Featuresのみをインポートします。ページ内に直接ビジネスロジック(useEffect、fetch)を記述してはいけません。
- ルール:
- タイプではなくスライス: コードはビジネスドメイン(ユーザー、商品、カート)でグループ化し、ファイルタイプ(コンポーネント、フック、ユーティリティ)でグループ化しないでください。
- 悪い例:
src/components/LoginForm.tsx、src/hooks/useLogin.ts - 良い例:
src/features/auth/login/に両方を含める。
- 悪い例:
- レイヤー階層: コードは 下位のレイヤーからのみ インポートできます。
App->Widgets->Features->Entities->Shared。
- 過剰なエンティティ作成を避ける: 事前にエンティティを作成しないでください。
- ルール: ロジックは
FeaturesまたはPagesで開始します。データ/ロジックが複数の異なる機能間で厳密に再利用される場合のみEntitiesに移動します。 - ルール: 単純なCRUDは
shared/apiに属し、entitiesには属しません。
- ルール: ロジックは
- 標準セグメント: スライス内では標準のセグメント名を使用します。
ui(コンポーネント)、model(状態/アクション)、api(データ取得)、lib(ヘルパー)、config(定数)。- 避けること: セグメント名として
components、hooks、servicesを使用しないでください。
構造リファレンス
具体的なディレクトリレイアウトとレイヤー定義については、リファレンスドキュメントを参照してください。
アーキテクチャチェックリスト(必須)
-
レイヤーインポート: どのレイヤーも上位のレイヤーからインポートしていませんか?(App > Widgets > Features > Entities > Shared)
-
ページロジック:
page.tsxはWidgets/Featuresのみを含み、useEffect/fetchがゼロで薄くなっていますか? -
RSCバウンダリ: サーバーコンポーネントは、適切な 'use client' バウンダリによってクライアントコンポーネントから分離されていますか?
-
公開API: スライスへのすべてのアクセスは、トップレベルの
index.ts(公開API)を介して行われていますか? -
クロススライス: 同じレイヤー内のスライス(例: 2つの機能)が互いに直接インポートしていませんか?(禁止)
-
サーバーアクション: 機能の
model/フォルダに配置します(例:features/auth/model/actions.ts)。 -
データアクセス(DAL): エンティティの
model/フォルダにロジックを配置します(例:entities/user/model/dal.ts)。 -
UIコンポーネント: ベースUI(shadcn)は
shared/uiに属します。機能固有のUIはfeatures/*/uiに属します。
アンチパターン
- クロススライスインポート禁止: 同じレイヤー内のスライスは互いに直接インポートしてはいけません。
page.tsx内のビジネスロジック禁止: ページはWidgets/Featuresのみをインポートします。useEffect/fetchはゼロにします。- ファイルタイプフォルダ禁止: タイプ(
components/、hooks/)ではなく、ドメイン(features/auth/)でグループ化します。 - 時期尚早なエンティティ作成禁止: Featuresで開始し、厳密な再利用がある場合のみEntitiesに移動します。