Next.js Pages Router(レガシー)
優先度: P0(重要)
[!IMPORTANT] このプロジェクトはNext.jsの Pages Router(
pages/ディレクトリ)を使用しています。App Routerの機能は使用しないでください。
実装ガイドライン
- ルーティングアーキテクチャ:
pages/ディレクトリを使用します。グローバル状態/レイアウトには_app.tsx、カスタムHTML属性には_document.tsxを使用します。動的ルートは ブラケット[id].tsxまたは キャッチオール[...slug].tsxで定義します。 - データフェッチング(SSR/SSG): リクエストごとに
getServerSideProps(ビルド時)またはgetStaticPropsとgetStaticPathsを動的ルートで使用します。これらは独立したasync関数 としてエクスポートします。 - ロジックの分離: サーバーサイドのフックから自分自身の
/apiエンドポイントをfetchしないでください。代わりにサービス層 またはDBロジックを直接インポートします。 - クライアントフック: ナビゲーションとクエリパラメータへのアクセスには
next/routerのuseRouter()を使用します。クライアントサイドルーティングにはrouter.push()または<Link>を使用します。 - API: サーバー専用ロジックやWebhookには
pages/api/にAPIルート を実装します。適切なHTTPステータスコードでレスポンスを標準化します。 - Next.js 15+ 互換性: Next.js 15 アップグレード には注意してください。すべての
getServerSidePropsが期待されるPagePropsに一致するオブジェクトを返すことを確認します。 - スタイリング: CSS Modules(
*.module.css) または Tailwind CSS で標準化します。_app.tsxでインポートしない限り、グローバルCSSは避けてください。