Priorité : P0 (CRITIQUE)
Directives d'implémentation
Architecture de routage
- Structure : Utilisez le répertoire
app/. Définissez les routes avec app/dashboard/layout.tsx retournant {children} ; l'interface partagée s'imbrique automatiquement dans app/layout.tsx. Gérez les états avec loading.tsx, error.tsx et not-found.tsx.
- Segments : Organisez les fonctionnalités avec des Groupes de routes (parenthèses
(auth)) qui sont exclus du chemin d'URL. Utilisez des Routes dynamiques (crochets [slug]) et définissez les chemins statiques via generateStaticParams.
- Spécialisé : Utilisez les Routes parallèles (
@modal) en ajoutant le slot au layout parent et en fournissant un fallback default.tsx. Utilisez les Routes interceptées ((.)route) pour des layouts avancés comme les tableaux de bord.
Données et fonctions
- Next.js 15+ Async : Attendez toujours
await pour params: Promise, searchParams, cookies() et headers().
- Sécurité : Utilisez
middleware.ts pour l'authentification côté edge et la redirection. Assurez-vous que tous les Route Handlers (route.ts) sont sécurisés avec les contrôles d'authentification appropriés.
- RSC : Par défaut, utilisez les Composants serveur React (RSC). Utilisez
'use client' uniquement dans les nœuds feuilles pour l'interactivité (hooks/événements).
- Limites d'erreur : Créez
app/dashboard/loading.tsx pour envelopper automatiquement les routes dans une limite Suspense. Dans error.tsx, utilisez 'use client' et fournissez une fonction reset: () => void.
const theme = cookieStore.get('theme');
## Conventions de fichiers
- **page.tsx** : Interface utilisateur pour une route.
- **layout.tsx** : Interface partagée enveloppant les enfants. Persiste lors de la navigation.
- **loading.tsx** : Limite Suspense pour les états de chargement.
- **error.tsx** : Limite d'erreur (Doit être un composant client).
- **route.ts** : Point de terminaison API côté serveur.
## Modèles de structure
- **Groupes de routes** : Utilisez les parenthèses `(auth)` pour organiser sans affecter le chemin d'URL.
- **Dossiers privés** : Utilisez le underscore `_lib` pour exclure du routage.
- **Routes dynamiques** : Utilisez les crochets `[slug]` ou `[...slug]` (tout capturer).
## Meilleures pratiques
- **Limites RSC** : Assurez-vous que les props passées aux composants clients sont sérialisables. Voir [Limites RSC et sérialisation](../architecture/references/RSC_BOUNDARIES.md).
- **Routes parallèles (`@folder`)** : Affichez plusieurs pages dans le même layout. Utilisez `default.tsx` comme fallback.
- **Routes interceptées (`(..)folder`)** : Chargez les routes dans le contexte du layout actuel.
- **Colocation** : Conservez les fichiers de composants, les styles et les tests dans le dossier de la route.
- **Layouts** : Utilisez le layout racine (`app/layout.tsx`) pour les balises `<html>` et `<body>`.
- [**Standard d'hébergement autonome**](references/SELF_HOSTING.md)
## Anti-patrons
- **Pas d'API asynchrones non attendues** : `params`, `cookies()`, `headers()` sont des Promesses dans Next.js 15+ ; attendez toujours.
- **Pas de `'use client'` à la racine de l'arbre** : Placez-le dans les feuilles ; conservez les layouts et les pages comme composants serveur.
- **Pas de `<html>`/`<body>` dans les layouts imbriqués** : Seul `app/layout.tsx` (layout racine) doit les inclure.
- **Pas de `error.tsx` manquant** : Chaque segment de route a besoin d'une limite d'erreur en tant que composant client.