🔍 관련 이슈 (Related Issues)

• Closes [FEAT] 폴더 구조 세팅 (FSD) #4

📝 변경 사항 요약 (Summary)

FSD 폴더구조 설정하고 코드오너 변경했습니다 .

🎯 작업 내용 상세 (Details)

src/
├── app/ # 애플리케이션 초기화 및 전역 설정
├── pages/ # 라우팅 단위의 페이지 컴포넌트
├── widgets/ # 독립적인 UI 블록
├── features/ # 사용자 행동 단위의 기능
├── entities/ # 비즈니스 도메인 엔티티
└── shared/ # 전역 공유 리소스
├── ui/ # 공통 UI 컴포넌트
├── lib/ # 유틸리티, 커스텀 훅
├── api/ # API 인스턴스 및 설정
└── config/ # 공통 설정
위와 같은 구조로 설정했고

app
↓
pages
↓
widgets
↓
features
↓
entities
↓
shared

이러한 의존성 규칙을 가져서 상위 레이어는 하위 레이어를 import할 수 있으나 , 하위 레이어는 상위 레이어를 import할 수 없습니다.

📦 Layer Overview (FSD)

1. app/ – 애플리케이션 레이어

• 애플리케이션 진입점 및 전역 설정 담당
• Provider, Router, 전역 스타일, 전역 상태 설정 포함

예시

• App.tsx
• providers.tsx
• router.tsx

2. pages/ – 페이지 레이어

• 라우팅과 연결되는 페이지 단위 컴포넌트
• UI 조합과 페이지 흐름만 관리하며 비즈니스 로직은 하위 레이어에 위임

예시

• HomePage/
• ProductPage/
• MyPage/

3. widgets/ – 위젯 레이어

• 여러 feature / entity를 조합한 독립적인 UI 블록
• 페이지에서 바로 사용 가능한 단위

예시

• Header/
• Sidebar/
• ProductCard/
• UserProfile/

4. features/ – 기능 레이어

• 사용자 행동 단위의 비즈니스 기능
• UI, 상태 관리, API 호출 포함 가능

예시

• auth/
• product-search/
• add-to-cart/
• like-product/

5. entities/ – 엔티티 레이어

• 비즈니스 도메인의 핵심 개념
• 데이터 모델, 엔티티 기준 UI, 엔티티 단위 API 로직 포함

예시

• user/
• product/
• order/
• category/

6. shared/ – 공유 레이어

• 특정 도메인에 종속되지 않는 전역 재사용 리소스

구성

• ui/ : 공통 UI 컴포넌트 (Button, Input 등)
• lib/ : 유틸 함수, 커스텀 훅, 상수
• api/ : API 인스턴스, 인터셉터
• config/ : 환경 설정, 공통 설정 값

💬 리뷰어 참고사항 (Notes for Reviewers)

🔗 참고 자료

• Feature-Sliced Design 공식 문서
• FSD GitHub

구조에대해서 더 공부할 필요가 있을 건데 위 자료 확인해보시면 될 것같아요