Architecture (Feature-Sliced Design)
Priorité : P2 (MOYENNE)
Adopter Feature-Sliced Design (FSD) pour des applications évolutives. Attention : FSD introduit du code standard (boilerplate). Utilisez-le uniquement si le projet doit croître significativement (par exemple, 20+ fonctionnalités). Pour les petits projets, une structure simple basée sur des modules est préférable.
Stratégie
- Limites RSC : Appliquez des règles strictes de sérialisation pour les propriétés passées du serveur au client. Voir Limites RSC & Sérialisation.
- Couche App fine : Le répertoire
app/(App Router) est uniquement dédié au routage.- Règle :
page.tsxne doit importer que des Widgets/Fonctionnalités. Pas de logique métier (useEffect,fetch) directement dans les pages.
- Règle :
- Slices avant types : Grouper le code par Domaine Métier (Utilisateur, Produit, Panier), pas par type de fichier (Composants, Hooks, Utilitaires).
- Mauvais :
src/components/LoginForm.tsx,src/hooks/useLogin.ts - Bon :
src/features/auth/login/contenant les deux.
- Mauvais :
- Hiérarchie des couches : Le code ne peut importer que depuis les couches inférieures.
App->Widgets->Features->Entities->Shared.
- Éviter les Entités excessives : Ne pas créer d'Entités de manière préventive.
- Règle : Commencer la logique dans
FeaturesouPages. Déplacer versEntitiesuniquement lorsque les données/la logique sont strictement réutilisées dans plusieurs fonctionnalités différentes. - Règle : Les opérations CRUD simples vont dans
shared/api, pas dansentities.
- Règle : Commencer la logique dans
- Segments standards : Utiliser des noms de segments standards dans les slices.
ui(Composants),model(État/actions),api(Récupération de données),lib(Aides),config(Constantes).- Éviter :
components,hooks,servicescomme noms de segments.
Référence de structure
Pour la disposition exacte des répertoires et la définition des couches, voir la documentation de référence.
- Structure des dossiers FSD
- Regroupement & Compatibilité
- Sélection d'exécution (Edge/Node)
- Astuces de débogage & MCP
Liste de vérification de l'architecture (Obligatoire)
-
Importations entre couches : Une couche importe-t-elle depuis une couche SUPÉRIEURE ? (App > Widgets > Features > Entities > Shared)
-
Logique de page :
page.tsxest-elle légère, contenant uniquement des Widgets/Fonctionnalités et aucunuseEffect/fetch? -
Limites RSC : Les composants serveur sont-ils isolés des composants client avec des barrières 'use client' appropriées ?
-
API publique : Tout accès à un slice se fait-il via le
index.tsde niveau supérieur (API publique) ? -
Importations inter-slices : Les slices d'une même couche (par exemple, deux fonctionnalités) s'importent-ils directement ? (Interdit)
-
Actions serveur : Les placer dans le dossier
model/d'une Fonctionnalité (ex.features/auth/model/actions.ts). -
Accès aux données (DAL) : Placer la logique dans le dossier
model/d'une Entité (ex.entities/user/model/dal.ts). -
Composants UI : L'UI de base (shadcn) va dans
shared/ui. L'UI spécifique à une fonctionnalité va dansfeatures/*/ui.
Anti-patrons
- Pas d'importations inter-slices : Les slices d'une même couche ne doivent pas s'importer directement.
- Pas de logique métier dans
page.tsx: Les pages n'importent que des Widgets/Fonctionnalités ; zérouseEffect/fetch. - Pas de dossiers par type de fichier : Grouper par domaine (
features/auth/), pas par type (components/,hooks/). - Pas de création prématurée d'Entités : Commencer dans Features ; ne déplacer dans Entities qu'en cas de réutilisation stricte.