FSD 아키텍처 적용기: 코드 위치의 명확성 확보

이 게시물은 복잡한 레포지토리 구조 문제를 해결하기 위해 FSD(Feature-Sliced Design) 아키텍처를 도입한 실무 경험을 공유합니다.

FSD 아키텍처 개념과 구조

• 코드를 레이어(Layers), 슬라이스(Slices), 세그먼트(Segments) 세 차원으로 분리
• 레이어는 단방향 의존성 규칙을 가지며, 슬라이스는 도메인별 코드 그룹핑, 세그먼트는 기술 목적별 구분

적용 과정과 고민

• 기존 구조에서 개발 생산성 저하와 시스템 안정성 문제 발생
• widgets 레이어 제외, 슬라이스 그룹핑 허용, API 위치 기준 명확화, 상향식 점진적 마이그레이션 적용

적용 후 효과

• 코드 위치 파악 용이 및 재사용 통제 강화
• 비즈니스 도메인 명확화와 개발 생산성 향상
• 리팩토링과 테스트 용이성 증가

장단점

장점은 일관성, 확장성, 유지보수성 향상이며, 단점은 학습 비용이 필요하다는 점입니다.
FSD 아키텍처는 복잡한 프론트엔드 프로젝트의 구조적 문제에 명확한 해답을 제시하며, 확장 가능한 서비스 기반 구축에 핵심적 역할을 했습니다.