Architektur (Feature-Sliced Design)
Priorität: P2 (MITTEL)
Übernehme Feature-Sliced Design (FSD) für skalierbare Anwendungen. Warnung: FSD führt Boilerplate ein. Verwende es nur, wenn das Projekt voraussichtlich deutlich wachsen wird (z. B. 20+ Features). Für kleinere Projekte ist eine einfache modulbasierte Struktur vorzuziehen.
Strategie
- RSC-Grenzen: Erzwinge strenge Serialisierungsregeln für Props, die vom Server an den Client übergeben werden. Siehe RSC-Grenzen & Serialisierung.
- App-Schicht ist dünn: Das
app/-Verzeichnis (App Router) ist nur für das Routing gedacht.- Regel:
page.tsxsollte nur Widgets/Features importieren. Keine Geschäftslogik (useEffect,fetch) direkt in Seiten.
- Regel:
- Slices statt Typen: Gruppiere Code nach Geschäftsdomäne (Benutzer, Produkt, Warenkorb), nicht nach Dateityp (Komponenten, Hooks, Utils).
- Schlecht:
src/components/LoginForm.tsx,src/hooks/useLogin.ts - Gut:
src/features/auth/login/enthält beides.
- Schlecht:
- Layer-Hierarchie: Code kann nur von tieferen Layern importieren.
App->Widgets->Features->Entities->Shared.
- Vermeide übermäßige Entities: Lege Entities nicht vorbeugend an.
- Regel: Starte Logik in
FeaturesoderPages. Verschiebe nachEntitiesnur, wenn Daten/Logik strikt über mehrere verschiedene Features hinweg wiederverwendet werden. - Regel: Einfaches CRUD gehört in
shared/api, nicht inentities.
- Regel: Starte Logik in
- Standardsegmente: Verwende innerhalb von Slices die Standardsegmentnamen.
ui(Komponenten),model(Zustand/Aktionen),api(Datenabruf),lib(Helfer),config(Konstanten).- Vermeide:
components,hooks,servicesals Segmentnamen.
Struktur-Referenz
Das spezifische Verzeichnislayout und die Layerdefinitionen finden sich in der Referenzdokumentation.
Architektur-Checkliste (Pflicht)
-
Layer-Importe: Importiert irgendein Layer aus einem Layer ÜBER ihm? (App > Widgets > Features > Entities > Shared)
-
Seitenlogik: Ist
page.tsxdünn, enthält nur Widgets/Features und keinuseEffect/fetch? -
RSC-Grenzen: Sind Server-Komponenten von Client-Komponenten mit korrekten
'use client'-Grenzen isoliert? -
Öffentliche API: Erfolgt der gesamte Zugriff auf einen Slice über die oberste
index.ts(öffentliche API)? -
Slice-übergreifend: Importieren Slices innerhalb desselben Layers (z. B. zwei Features) direkt voneinander? (Verboten)
-
Server-Aktionen: Platziere sie im
model/-Ordner eines Features (z. B.features/auth/model/actions.ts). -
Datenzugriff (DAL): Platziere Logik im
model/-Ordner einer Entität (z. B.entities/user/model/dal.ts). -
UI-Komponenten: Basis-UI (shadcn) gehört nach
shared/ui. Featurespezifische UI gehört nachfeatures/*/ui.
Antipatterns
- Keine slice-übergreifenden Importe: Slices im selben Layer dürfen nicht direkt voneinander importieren.
- Keine Geschäftslogik in
page.tsx: Seiten importieren nur Widgets/Features; keinuseEffect/fetch. - Keine dateityp-Ordner: Gruppiere nach Domäne (
features/auth/), nicht nach Typ (components/,hooks/). - Keine vorzeitige Entity-Erstellung: Starte in Features; verschiebe nach Entities nur bei strikter Wiederverwendung.