고급

앱 아키텍처

presentation, domain, data 계층을 나누어 변경에 강한 앱 구조를 만듭니다.

개념 먼저 보기

앱 아키텍처의 기본 개념부터 잡기

앱 아키텍처 문서는 먼저 용어의 뜻을 잡고, 그 다음 Flutter 코드에서 어디에 쓰이는지 연결해서 읽는 것이 좋습니다.

아래 항목들은 이 문서에서 다루는 내용을 작은 단위로 나눈 것입니다. 각 항목을 읽은 뒤 예제를 보면 코드가 훨씬 덜 추상적으로 느껴집니다.

종류별로 하나씩

앱 아키텍처에서 나눠 볼 핵심 요소

계층 분리

presentation은 위젯과 화면 상태를 담당합니다.

언제 쓰나: domain은 앱의 핵심 규칙과 유스케이스를 표현합니다.

Flutter에서: data는 API, DB, 캐시 같은 외부 데이터 출처를 다룹니다.

// 앱 아키텍처 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
lib/
  features/
    lessons/
      presentation/
      domain/
      data/

의존성 방향

UI가 데이터 구현체에 직접 의존하면 변경이 어려워집니다.

언제 쓰나: Repository 인터페이스로 데이터 출처를 숨길 수 있습니다.

Flutter에서: 기능이 작을 때는 과한 구조보다 명확한 폴더와 이름이 먼저입니다.

// 앱 아키텍처 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
lib/
  features/
    lessons/
      presentation/
      domain/
      data/

부연 설명

계층 분리

  • presentation은 위젯과 화면 상태를 담당합니다.
  • domain은 앱의 핵심 규칙과 유스케이스를 표현합니다.
  • data는 API, DB, 캐시 같은 외부 데이터 출처를 다룹니다.

부연 설명

의존성 방향

  • UI가 데이터 구현체에 직접 의존하면 변경이 어려워집니다.
  • Repository 인터페이스로 데이터 출처를 숨길 수 있습니다.
  • 기능이 작을 때는 과한 구조보다 명확한 폴더와 이름이 먼저입니다.

깊게 이해하기

앱 아키텍처 문서는 Flutter 앱을 만들 때 반복해서 마주치는 개념을 독립적으로 정리한 페이지입니다. 먼저 용어의 의미를 잡고, 그 다음 실제 코드에서 어디에 배치되는지 연결해 보면 학습 속도가 빨라집니다.

이 주제는 단독으로 외우기보다 앞뒤 문서와 함께 보는 것이 좋습니다. 예를 들어 문법 주제는 위젯 코드에서 어떻게 드러나는지, 배포 주제는 실제 앱 운영 흐름에서 어떤 결정을 요구하는지 함께 확인하세요.

상세 예제

아래 예제는 이 문서의 핵심 개념을 실제 프로젝트에서 작은 단위로 적용하는 형태입니다.

lib/
  features/
    lessons/
      presentation/
      domain/
      data/

실무에서 주의할 점

  • 처음에는 가장 단순한 구현으로 시작하고, 반복되는 시점에 구조를 정리하세요.
  • 예제 코드를 그대로 외우기보다 입력, 출력, 책임을 나누어 읽어 보세요.
  • 새 문서를 추가할 때는 같은 형식으로 요약, 핵심 설명, 예제, 체크리스트를 유지하세요.

실습 체크리스트

계층별 책임 정의Repository 역할 이해기능별 폴더 구조 설계