Next.js Pages Router (레거시)
우선순위: P0 (CRITICAL)
[!IMPORTANT] 이 프로젝트는 Next.js Pages Router (
pages/디렉토리)를 사용합니다. App Router 기능을 사용하지 마세요.
구현 가이드라인
- 라우팅 아키텍처:
pages/디렉토리를 사용합니다. 전역 상태/레이아웃에는 **_app.tsx**를, 사용자 정의 HTML 속성에는 **_document.tsx**를 사용합니다. 동적 라우트는 대괄호[id].tsx또는 **catch-all[...slug].tsx**를 사용하여 정의합니다. - 데이터 페칭 (SSR/SSG): 매 요청 시에는 **
getServerSideProps**를, 빌드 시에는 **getStaticProps**를 사용하며 동적 라우트에는 **getStaticPaths**를 함께 사용합니다. 이 함수들은 독립적인async함수로 내보내십시오. - 로직 분리: 서버 사이드 훅에서 절대로 자체
/api엔드포인트를fetch하지 마십시오. 대신 서비스 레이어 또는 DB 로직을 직접 임포트하십시오. - 클라이언트 훅: 네비게이션 및 쿼리 파라미터 접근을 위해
next/router에서useRouter()를 사용합니다. 클라이언트 사이드 라우팅에는router.push()또는<Link>를 사용합니다. - API: 서버 전용 로직이나 웹훅을 위해
pages/api/디렉토리에 API Routes를 구현합니다. 적절한 HTTP 상태 코드와 함께 응답을 표준화하십시오. - Next.js 15+ 호환성: Next.js 15 업그레이드에 주의하십시오. 모든 **
getServerSideProps**가 예상되는PageProps와 일치하는 객체를 반환하는지 확인하십시오. - 스타일링: CSS Modules (
*.module.css) 또는 Tailwind CSS를 통해 표준화합니다._app.tsx에서 임포트하지 않는 한 전역 CSS 사용을 피하십시오.