아키텍처 (Feature-Sliced Design)
우선순위: P2 (중간)
확장 가능한 애플리케이션을 위해 Feature-Sliced Design (FSD) 을 채택합니다. 경고: FSD는 보일러플레이트를 도입합니다. 프로젝트가 크게 성장할 것으로 예상될 때만 사용하세요 (예: 20개 이상의 기능). 소규모 프로젝트의 경우 간단한 모듈 기반 구조가 더 적합합니다.
전략
- RSC 경계: 서버에서 클라이언트로 전달되는 props에 대해 엄격한 직렬화 규칙을 적용합니다. RSC 경계 및 직렬화를 참조하세요.
- App 계층은 얇게:
app/디렉토리(App Router)는 오직 라우팅만을 위한 것입니다.- 규칙:
page.tsx는 Widgets/Features만 가져와야 합니다. 페이지에 직접 비즈니스 로직(useEffect,fetch)이 없어야 합니다.
- 규칙:
- 타입보다 슬라이스: 파일 타입(컴포넌트, 훅, 유틸)이 아닌 비즈니스 도메인(사용자, 제품, 장바구니)별로 코드를 그룹화합니다.
- 나쁜 예:
src/components/LoginForm.tsx,src/hooks/useLogin.ts - 좋은 예:
src/features/auth/login/안에 모두 포함.
- 나쁜 예:
- 계층 계층 구조: 코드는 아래 계층에서만 가져올 수 있습니다.
App->Widgets->Features->Entities->Shared.
- 과도한 Entity 생성 피하기: 미리 Entities를 생성하지 마십시오.
- 규칙: 로직은 Features 또는 Pages에서 시작하세요. 데이터/로직이 여러 다른 기능에서 엄격히 재사용될 때만 Entities로 이동하세요.
- 규칙: 단순 CRUD는
entities가 아닌shared/api에 속합니다.
- 표준 세그먼트: 슬라이스 내에서 표준 세그먼트 이름을 사용하세요.
ui(컴포넌트),model(상태/액션),api(데이터 페칭),lib(헬퍼),config(상수).- 피해야 할 것:
components,hooks,services를 세그먼트 이름으로 사용하지 마세요.
구조 참조
특정 디렉터리 레이아웃 및 계층 정의는 참조 문서를 확인하세요.
아키텍처 체크리스트 (필수)
-
계층 가져오기: 어떤 계층이 자기 위에 있는 계층에서 가져오고 있습니까? (App > Widgets > Features > Entities > Shared)
-
페이지 로직:
page.tsx가 얇게 유지되며 Widgets/Features만 포함하고useEffect/fetch가 전혀 없습니까? -
RSC 경계: 서버 컴포넌트가 적절한 'use client' 경계로 클라이언트 컴포넌트와 분리되어 있습니까?
-
공개 API: 모든 슬라이스 접근이 최상위
index.ts(공개 API)를 통해 이루어집니까? -
슬라이스 간: 같은 계층 내의 슬라이스끼리 서로 직접 가져오고 있습니까? (금지됨)
-
서버 액션: Feature의
model/폴더에 배치합니다 (예:features/auth/model/actions.ts). -
데이터 접근 계층 (DAL): Entity의
model/폴더에 배치합니다 (예:entities/user/model/dal.ts). -
UI 컴포넌트: 기본 UI(shadcn)는
shared/ui에 속합니다. 기능별 UI는features/*/ui에 속합니다.
안티 패턴
- 슬라이스 간 직접 가져오기 금지: 같은 계층의 슬라이스끼리 서로 직접 가져와서는 안 됩니다.
- page.tsx에 비즈니스 로직 금지: 페이지는 Widgets/Features만 가져오며,
useEffect/fetch가 전혀 없어야 합니다. - 파일 타입 폴더 금지: 타입별(
components/,hooks/)이 아닌 도메인별(features/auth/)로 그룹화합니다. - 조기 Entity 생성 금지: Features에서 시작하고, 엄격한 재사용이 확인될 때만 Entities로 이동하세요.