기존의 클론코딩 - 토이 프로젝트, 외부 프로젝트에서의 폴더구조는 미세하게 다른 구조로 만들었다. 물론 모두 리액트 cra 세팅에 맞춰서 했다.

React 18버전부터 나오는 서버 컴포넌트를 문서로 통해 접하면서 Next.js 13 App 라우터 방식으로 다음 프로젝트를 진행하고는 싶은데 폴더 세팅에 관하여 ‘정석’ 이라는 느낌은 받지 못했다. Korean FE Article 을 흘깃 보면서 FSD (Feature-Sliced Design, FSD) 아키텍처에 대해 알게되었고 나만의 방식대로 정리해보려고 한다.

(번역) 기능 분할 설계 - 최고의 프런트엔드 아키텍처

서론

나(?)를 비롯한 프론트엔드 개발자는 종종 어플리케이션 아키텍처와 관련된 문제를 한번쯤은 생각해보게 된다. 대부분 모듈 간의 느슨한 결합과 높은 응집력을 제공해야 하며 쉽게 확장할 수 있는 아키텍쳐를 필요로 한다. 위 북마크를 실제로 적은 사람에 의하면 FSD 아키텍처가 사용 가능한 옵션 중 최고라고 생각한다고 한다 !

차례대로 FSD의 개념과 이 아키텍처 방법론이 해결하는 문제를 다루고, FSD를 기존 아키텍처 및 모듈식 아키텍처와 비교한 뒤 장단점까지 알아보자.

먼저 레이어(layer), 슬라이스(slice), 세그먼트(segment)의 세 가지 개념을 구분해보자.

FSD 세 가지 계층분리

1. 레이어

레이어는 최상위 디렉토리이자 애플리케이션 분해의 첫 번째 단계이다. 레이어의 수는 최대 7개로 제한되어 있으며, 일부는 선택 사항이지만 표준화되어 있다. 현재 다음과 같이 레이어가 구분되어 있다.

각 레이어에는 고유한 책임 영역이 있으며 이는 비즈니스 지향적이다.

• app: 애플리케이션 로직이 초기화되는 곳이다. 프로바이더, 라우터, 전역 스타일, 전역 타입 선언 등이 여기에서 정의된다. 애플리케이션의 진입점 역할을 한다.

• processes: 이 레이어는 여러 단계로 이루어진 등록과 같이 여러 페이지에 걸쳐 있는 프로세스를 처리한다. 이 레이어는 더 이상 사용되지 않는 것으로 간주되지만 여전히 가끔씩 마주할 수 있다. 선택적 레이어이다.

• pages: 이 레이어에는 애플리케이션의 페이지가 포함된다.

• widgets: 페이지에 사용되는 독립적인 UI 컴포넌트이다.

• features: 이 레이어는 비즈니스 가치를 전달하는 사용자 시나리오와 기능을 다룬다. 예를 들어 좋아요, 리뷰 작성, 제품 평가 등이 있다. 이 또한 선택적 레이어이다.

• entities: 이 레이어는 비즈니스 엔티티를 나타낸다. 이러한 엔티티에는 사용자, 리뷰, 댓글 등이 포함될 수 있다. 선택적 레이어이다.

• shared: 이 레이어에는 특정 비즈니스 로직에 종속되지 않은 재사용 가능한 컴포넌트와 유틸리티가 포함되어 있다. 여기에는 UI 키트, axios 설정, 애플리케이션 설정, 비즈니스 로직에 묶이지 않은 헬퍼 등이 포함된다.

이러한 레이어들은 코드베이스를 조직화하고, 모듈화되고 유지보수 용이한 확장 가능한 아키텍처를 촉진하는데 도움이 된다.

기능 분할 설계의 주요 특징 중 하나는 계층 구조이다. 이 구조에서 features 레이어가 entities 레이어보다 더 위에 있기 때문에 entities 레이어는 features 레이어의 기능을 사용할 수 없다. 마찬가지로 features 레이어는 widgets 레이어나 processes 레이어의 컴포넌트를 사용할 수 없으며, 위 레이어는 아래 레이어만 활용할 수 있다. 이는 한 방향으로만 향하는 선형적인 흐름을 유지하기 위함이다.

계층 구조에서 레이어의 위치가 낮을수록 코드의 더 많은 곳에서 사용될 가능성이 높기 때문에, 레이어를 변경하는 것이 더 위험하다. 예를 들어 shared 레이어의 UI 키트는 features, widgets, 심지어 pages 레이어에서도 사용된다.

2. 슬라이스

각 레이어에는 애플리케이션 분해의 두 번째 수준인 슬라이스라는 하위 디렉토리가 있다. 슬라이스에서 연결은 추상적인 것이 아니라 특정 비스니스 엔티티에 대한 것이다. 슬라이스의 주요 목표는 코드를 값별로 그룹화하는 것이다.

슬라이스 이름은 프로젝트의 비즈니스 영역에 따라 직접 결정되므로 표준화되어 있지 않다. 예를 들어 사진 갤러리에는 사진, 앨범, 갤러리와 같은 섹션이 있을 수 있다. 소셜 네트워크에는 게시물, 사용자, 뉴스피드와 같은 슬라이스가 필요할 수 있다.

밀접하게 관련된 조각들은 구조적으로 디렉토리 내에 그룹지을 수 있지만 다른 슬라이스와 동일한 격리 규칙을 준수해야 하며, 이 디렉토리에 있는 코드는 직접적으로 공유되지 않아야 한다.

3. 세그먼트

각 슬라이스는 세그먼트로 구성된다. 세그먼트는 목적에 따라 슬라이스 내의 코드를 나누는 데 도움이 된다. 팀의 합의에 따라 세그먼트의 구성과 이름이 변경될 수 있다. 일반적으로 사용되는 세그먼트들은 다음과 같다.

• api: 필요한 서버 요청

• ui: 슬라이스의 UI 컴포넌트

• model: 비즈니스 로직, 즉 상태와의 상호 작용. actions 및 selectors가 이에 해당함

• lib: 슬라이스 내에서 사용되는 보조 기능

• config: 슬라이스에 필요한 구성값이지만 구성 세그먼트는 거의 필요하지 않음.

• consts: 필요한 상수

공개 API

각 슬라이스와 세그먼트에는 공개 API가 있다. 공개 API는 index.js 또는 index.ts 파일이며, 이 파일을 통해 슬라이스 또는 세그먼트에서 필요한 기능만 외부로 추출하고 불필요한 기능은 격리할 수 있다. 인덱스 파일은 진입점 역할을 한다.

공개 API에 대한 규칙은 다음과 같다.

• 애플리케이션 슬라이스와 세그먼트는 공개 API 인덱스 파일에 정의된 슬라이스의 기능과 컴포넌트만 사용한다.

• 공개 API에 정의되지 않은 슬라이스 또는 세그먼트의 내부 부분은 격리된 것으로 간주되며 슬라이스 또는 세그먼트 내부에서만 접근할 수 있다.

공개 API는 import 및 export로 단순하게 작동하므로 애플리케이션을 변경할 때 코드의 모든 곳에서 import를 변경할 필요가 없다.

아키텍처에 대해 더 자세히 알아보기

추상화 및 비즈니스 로직

계층이 높은 레이어일수록 특정 비즈니스 노드에 더 많이 종속되고 더 많은 비즈니스 로직이 포함된다. 계층이 낮은 레이어일수록 추상화 수준이 높고 재사용성이 높으며 레이어 자체의 자율성이 적다.

FSD가 문제를 해결하는 방식

기능 분할 설계의 과제 중 하나는 결합을 느슨하게 하고 응집력을 높이는 것이다. FSD가 이러한 결과를 어떻게 달성하는지 이해하는 것은 중요하다.

OOP에서는 다형성(polymorphism), 캡슐화(encapsulation), 상속(inheritance) 및 추상화(abstraction) 와 같은 개념을 통해 이러한 문제들을 오랜 시간 동안 해결해 왔다. 이러한 개념들은 코드의 격리, 재사용성, 그리고 다양한 결과를 보장한다. 이는 컴포넌트나 기능이 어떻게 사용되느냐에 따라 다른 결과를 얻을 수 있도록 한다.

기능 분할 설계는 이러한 원칙들을 프론트엔드에 적용하는 데 도움을 준다.

추상화와 다형성은 레이어를 통해 달성된다. 낮은 레이어는 더 추상화 되어있기 때문에 더 높은 레이어에서 재사용될 수 있으며, 특정한 매개변수나 속성에 따라 컴포넌트나 기능이 다르게 작동할 수 있다.

캡슐화는 슬라이스와 세그먼트 외부에서 필요하지 않은 것을 격리시키는 공개 API를 통해 달성된다. 슬라이스의 내부 세그먼트에 대한 접근은 제한되며, 공개 API는 슬라이스 또는 세그먼트의 기능 및 컴포넌트에 접근할 수 있는 유일한 방법이다.

상속 또한 레이어를 통해 달성된다. 더 높은 레이어는 낮은 레이어를 재사용할 수 있다.

고전적인 아키텍처와의 비교

어쩌면 지금까지 최근에 했던 나의 프로젝트에도 고전적인 아키텍처이지 않았나 싶다. 일반적으로 다음과 같은 형식이 고전적인 아키텍처로 칭해진다.

가장 큰 단점은 컴포넌트 간의 암묵적인 연결과 모듈의 복잡성 때문에 프로젝트가 유지보수하기 어려워진다는 것이다. 이러한 단점은 시간이 흐를수록 더욱 분명해진다. 프로젝트가 진화할수록 애플리케이션 아키텍처는 엉망진창이 되어 버린다.

물론 고전적인 아키텍쳐는 지속적인 유지보수가 없는 작은 프로젝트나 개인 프로젝트에는 적합할 수 있다.

기능 분할 설계는 기 개념과 표준 덕분에 고전적인 아키텍처의 문제를 해결할 수 있다. 그러나 FSD를 사용하는 개발자들은 고전적인 아키텍처를 다룰 때보다 더 높은 이해도와 기술 수준을 필요로 한다.

일반적으로 2년 미만의 경력을 가진 (나를 포함한) 개발자들은 FSD에 대해 들어보지 못한 경우가 많다.

그러나 기능 분할 설계를 사용할 때는 문제를 “나중” 이 아닌 “지금” 해결해야 한다. 코드의 문제점과 개념에서 벗어난 부분들이 즉시 드러난다.

단순한 모듈식 아키텍처와의 비교

단순한 모듈식 아키텍처에는 몇 가지 단점이 있다.

• 기능을 어떤 모듈이나 컴포넌트에 넣을지 명확하지 않을 때가 있다.
• 다른 모듈 내에서 모듈 사용에 어려움이 있다.
• 비즈니스 엔티티를 저장하는 데 문제가 있다.
• 글로벌 함수의 암시적 종속성으로 인해 구조가 복잡해진다.

복잡하거나 적당히 복잡한 프로젝트의 경우, 단순한 모듈식 아키텍처보다는 기능 분할 설계를 선호해야 한다. FSD는 많은 근본적인 아키텍처 문제를 해결하며 단점도 거의 없다.

단순함 및 개발 속도 측면에서 단순 모듈식 아키텍처가 FSD보다 유리할 수 있다. MVP가 필요하거나 수명이 짧은 프로젝트를 개발하는 경우에는 단순한 모듈식 아키텍처가 FSD보다 적합할 수 있다. 하지만 그 외의 경우에는 기능 분할 설계가 더 바람직해 보인다.

Next.js와 FSD의 충돌

최근에는 Next.js를 기능 분할 설계와 함께 사용하는 경향이 증가하고 있다. Next.js는 FSD와 잘 작동하지만, 페이지의 파일 라우팅과 앱의 부재라는 두 가지 영역에서 충돌이 발생한다.

Pages

Next.js에서는 pages 디렉토리가 파일 라우팅을 담당하며, 각 컴포넌트가 하나의 라우트를 나타낸다. FSD에서는 pages는 페이지들의 평면 목록을 담고 있는 레이어로 사용된다. 이로 인해 Next.js 페이지와 FSD 페이지를 어떻게 결합할지에 대한 충돌이 발생한다.

Next.js와 FSD를 함께 사용할 때, [root]/pages/ 와 같이 Next.js 페이지를 애플리케이션 루트에 저장하는 방법이 있다. 그리고 FSD 페이지는 [root]/src/pages/ 와 같이 src 폴더 내에 저장한다.

다른 해결 방법으로는 두 개의 디렉토리를 유지하는 것이 있다. FSD의 페이지들의 평면 목록을 다시 이름 지은 pages-flat과 Next.js의 중첩된 라우트를 위한 pages이다. 실제 페이지 코드는 pages-flat에 저장되고, 그 후에 pages로 내보낼 수 있다.

허나 나는 Next.js 12버전 이하로는 학습을 한 적이 없기에 이 방법은 고려안할것 같다.

App

app 레이어의 모든 기본적인 기능은 Next.js에서 처리한다. 그러나 페이지와 독립적으로 전체 애플리케이션에 대해 무언가를 실행해야 하는 경우 레이아웃 패턴을 사용하여 전체 애플리케이션을 위한 레이아웃을 만들 수 있다.

app 라우터를 이용한 Next.js에서의 패턴은 https://feature-sliced.design/docs/guides/tech/with-nextjs를 참고하자.

기능 분할 설계의 잠재력

FSD는 비교적 젊은 소프트웨어 아키텍처 방법론이다. 그러나 이미 많은 은행, 핀테크, B2B, 전자상거래 등 다양한 기업들에서 사용되고 있다.

이 아키텍처의 잠재력은 매우 높게 평가되며, 전 세께의 다양한 대형 기업들 사이에서 널리 사용되고 있다. 적절한 도입이 이루어진다면, FSD는 프론트엔드 개발 분야에서 주도적인 아키텍처 솔루션으로 성장할 수 있는 잠재력을 가지고 있다.

아키텍처의 장점과 단점

장점

• 아키텍처 구조 요소를 쉽게 교체, 추가, 제거할 수 있다.
• 아키텍처 표준화
• 확장성
• 방법론은 개발 스택과 독립적이다.
• 예기치 않은 부작용 없이 모듈 간의 연결이 제어되고 명시적이다.
• 아키텍처 방법론이 비즈니스 지향적이다.

단점

• 다른 많은 아키텍처 솔루션들에 비해 높은 진입 장벽이 있다.
• 인식, 팀 문화 및 개념 준수가 필요하다.
• 도전 과제와 문제를 나중이 아닌 즉시 해결해야 한다. 코드 문제와 개념에서 벗어난 부분을 즉시 확인할 수 있다. 그러나 이는 장점으로도 볼 수 있다.

결론

---

기능 분할 설계(FSD)는 프론트엔드 개발자가 알고 사용할 수 있는 흥미롭고 가치 있는 발견이다. FSD는 팀에 유연하고 표준화되며 확장 가능한 아키텍처와 개발 문화를 제공할 수 있다. 하지만 이 방법론의 긍정적인 측면을 활용하려면 팀 내에서 지식, 인식 및 규칙이 필요하다.

FSD는 명확한 비즈니스 지향성, 엔티티 정의, 애플리케이션의 기능 및 컴포넌트 구성과 같은 특징들로 인해 다른 아키텍처들 사이에서 돋보인다.

또한 개별적으로 프로젝트에서 FSD를 사용한 사례와, 기능 분할 설계의 공식 문서를 잘 살펴볼 수도 있다.

공식문서

예제. Github Client

예제. Nike Sneaker and Footwear Store

예제. Sudoku