Flutter 애플리케이션을 어떻게 설계(아키텍처)하나요?

Question

Accepted Answer

Flutter 앱을 잘 설계하는 것은 **관심사 분리**(UI, 비즈니스 로직, 데이터), **state 관리 접근 방식** 선택, **유지보수성, 테스트 가능성, 확장성**을 위한 코드 구조화를 포함합니다. 좋은 아키텍처는 앱이 커질수록 중요합니다.

## 관심사 분리 (계층)

```text
앱을 명확한 책임을 가진 계층으로 분리:
  PRESENTATION (UI) → 위젯/화면; 표시 + 사용자 상호작용 (비즈니스 로직 없음)
  BUSINESS LOGIC → state 관리, 유스 케이스, 앱 로직 (UI와 독립)
  DATA → repository, 데이터 소스(API, 로컬 DB), 모델
→ 각 계층은 하나의 책임; 하위 계층에만 의존 → 유지보수 및 테스트 가능.
```

## 흔한 아키텍처 패턴

```text
✓ 계층형/CLEAN 아키텍처 → presentation / domain / data 계층; 의존성은 안쪽을 향함;
  비즈니스 로직은 UI 및 프레임워크와 독립
✓ MVVM → View(위젯) + ViewModel(state/로직) + Model(데이터)
✓ Repository 패턴 → 데이터 접근을 추상화 (UI/로직은 데이터가 API에서 오는지 캐시에서
  오는지 모름) → 교체 가능, 테스트 가능
✓ state 관리(Bloc, Riverpod 등)가 로직 계층을 구조화
```

## 프로젝트 구조

```text
→ FEATURE별(대형 앱에 권장) 또는 계층별로 구성:
  lib/features/auth/{presentation, domain, data}/
  lib/features/cart/...
  lib/core/ (공유: 네트워킹, utils, 테마)
→ 기능 기반 구조는 잘 확장됨; 관련 코드를 함께 유지.
```

## 좋은 아키텍처를 위한 원칙

```text
✓ 관심사 분리 — UI를 로직에서, 로직을 데이터에서 분리
✓ 테스트 가능성 — 비즈니스 로직을 UI 없이 테스트 가능; mock 가능한 dependency
✓ 의존성 주입 — dependency를 제공 (하드코딩하지 않음) → 테스트/유연
✓ 위젯을 DUMB하게 유지 (표시); 로직은 state/로직 계층에
✓ 작은 앱을 과도하게 설계하지 말 것; 아키텍처를 앱 복잡성에 맞춤
```

## 왜 중요한가

Flutter 애플리케이션을 어떻게 설계하는지 이해하는 것은 중요한 시니어 수준 지식입니다. 왜냐하면 **좋은 아키텍처는 앱이 커질수록 유지보수 가능하고 테스트 가능하며 확장 가능한 앱을 만드는 데 필수적**이기 때문이며, 따라서 진지한 Flutter 개발에 가치가 있습니다.

앱이 단순한 예제를 넘어 커질수록, 부실한 아키텍처(위젯에 섞인 로직, 관심사 분리 없음)는 유지보수, 테스트, 확장을 어렵게 만들어 아키텍처적 사고를 중요하게 만듭니다.

핵심 원칙 — **관심사를 계층으로 분리**(표시와 상호작용을 위한 presentation/UI, 앱 로직과 state를 위한 비즈니스 로직, repository와 소스를 위한 데이터)하고 명확한 책임과 의존성을 가짐 — 은 유지보수 및 테스트 가능한 코드에 근본적이며, UI를 비즈니스 로직에서 자유롭게 유지하고 각 계층을 독립적으로 이해하고 변경할 수 있게 만듭니다.

**흔한 패턴** — 계층형/클린 아키텍처(비즈니스 로직이 UI 및 프레임워크와 독립), MVVM, 그리고 **repository 패턴**(데이터 접근을 추상화하여 UI와 로직이 데이터가 API에서 오는지 캐시에서 오는지에 의존하지 않게 하고, 교체 및 테스트 가능하게 만듦) — 을 이해하는 것은 검증된 구조를 제공합니다.

**프로젝트 구조**(대형 앱을 위해 기능별로 구성하여 관련 코드를 함께 유지, 잘 확장됨)를 이해하는 것은 실용적으로 가치가 있습니다.

**좋은 아키텍처를 위한 원칙** — 관심사 분리, 테스트 가능성(비즈니스 로직을 UI 없이 테스트 가능), **의존성 주입**(테스트 가능성과 유연성을 위해 하드코딩 대신 dependency 제공), 위젯을 "dumb"하게 유지(표시만, 로직은 로직 계층에), 작은 앱을 과도하게 설계하지 않기(아키텍처를 복잡성에 맞춤) — 은 성숙한 아키텍처적 판단을 반영합니다.

좋은 아키텍처는 앱이 커질수록 유지보수 가능하고 테스트 가능하며 확장 가능한 Flutter 앱에 필수적이고(부실한 아키텍처가 실제 유지보수와 테스트 문제를 야기함), 계층형 분리, repository 같은 패턴, 프로젝트 구조, 아키텍처 원칙을 이해하는 것이 잘 구조화된 앱을 만들 수 있게 하므로, Flutter 애플리케이션을 어떻게 설계하는지 이해하는 것은 진지한 Flutter 개발에 중요한 시니어 수준 지식입니다 — 전문적 개발을 구별하는, 유지보수 가능하고 확장 가능한 앱을 만드는 핵심 역량이자 시니어 역할에 기대되는 아키텍처적 사고를 반영합니다.