Was macht Next.js Pages Router (Legacy)?
Priorität: P0 (KRITISCH)
[!WICHTIG] Das Projekt verwendet Next.js Pages Router (
pages/-Verzeichnis). Verwenden Sie KEINE App Router-Funktionen.
Implementierungsrichtlinien
- Routing-Architektur: Verwenden Sie das
pages/-Verzeichnis. Verwenden Sie_app.tsxfür globalen Zustand/Layouts und_document.tsxfür benutzerdefinierte HTML-Attribute. Definieren Sie dynamische Routen mit eckigen Klammern[id].tsxoder Catch-all[...slug].tsx. - Data Fetching (SSR/SSG): Verwenden Sie
getServerSideProps(für jede Anfrage) odergetStaticProps(zur Build-Zeit) mitgetStaticPathsfür dynamische Routen. Exportieren Sie diese als eigenständigeasync-Funktionen. - Logik-Isolation: Führen Sie NIEMALS
fetchauf Ihre eigenen/api-Endpunkte von Server-seitigen Hooks aus. Importieren Sie die Service-Layer oder die DB-Logik direkt. - Client-Hooks: Verwenden Sie
useRouter()ausnext/routerfür Navigation und Zugriff auf Query-Parameter. Verwenden Sierouter.push()oder<Link>für Client-seitiges Routing. - APIs: Implementieren Sie API-Routen in
pages/api/für Server-only-Logik oder Webhooks. Standardisieren Sie Antworten mit geeigneten HTTP-Statuscodes. - Next.js 15+ Kompatibilität: Seien Sie vorsichtig bei Next.js 15-Upgrades; stellen Sie sicher, dass alle
getServerSideProps-Objekte zurückgeben, die den erwartetenPagePropsentsprechen. - Styling: Standardisieren Sie über CSS Module (
*.module.css) oder Tailwind CSS. Vermeiden Sie globales CSS, es sei denn, es wird in_app.tsximportiert.