Flutter 대규모 프로젝트 구조: Layer First에서 Feature First로
기능이 늘어난 Flutter 프로젝트에서 Layer First 구조가 만드는 탐색·의존성 문제를 살펴보고, UI·상태·데이터 코드를 기능 단위로 묶는 Feature First 구조와 점진적 전환 방법을 제안한다.
초기 프로젝트는 pages, models, repositories처럼 기술 계층별로 나누기 쉽다. 기능이 수십 개로 늘어나면 주문 화면 하나를 고치기 위해 여러 최상위 폴더를 오가게 된다.
Layer First
lib/
├── pages/
├── cubits/
├── models/
├── repositories/
└── services/
구조가 단순하지만 폴더 안의 파일 수가 계속 증가하고 기능의 경계가 흐려진다.
Feature First
lib/
├── app/
│ ├── router/
│ └── di/
├── core/
│ ├── network/
│ ├── design_system/
│ └── errors/
└── features/
├── orders/
│ ├── data/
│ ├── domain/
│ └── presentation/
└── scanning/
├── data/
└── presentation/
flowchart TD
A[Presentation] --> B[Domain Use Case]
B --> C[Repository Interface]
D[Repository 구현] --> C
D --> E[API 또는 Local DB]
의존성 방향
Presentation은 API 응답 모델을 직접 알지 않는다. 화면에 필요한 모델이나 Domain 객체만 받는다.
abstract interface class OrderRepository {
Future<List<Order>> fetchOrders(OrderFilter filter);
}
final class LoadOrders {
const LoadOrders(this._repository);
final OrderRepository _repository;
Future<List<Order>> call(OrderFilter filter) {
return _repository.fetchOrders(filter);
}
}
final class OrderListCubit extends Cubit<OrderListState> {
OrderListCubit(this._loadOrders) : super(const OrderListState());
final LoadOrders _loadOrders;
Future<void> load(OrderFilter filter) async {
emit(state.copyWith(status: LoadStatus.loading));
try {
final orders = await _loadOrders(filter);
emit(state.copyWith(status: LoadStatus.success, orders: orders));
} catch (error) {
emit(state.copyWith(status: LoadStatus.failure));
}
}
}
모든 기능에 Domain Layer가 필요한 것은 아니다. CRUD 화면처럼 규칙이 단순하다면 data와 presentation만으로 시작하고, 복잡해질 때 Domain을 추가할 수 있다.
공통 코드의 기준
두 곳에서 사용한다고 바로 common으로 옮기지 않는다. 기능 의미가 같은지, 변경 주기가 같은지 확인한다.
공통에 적합한 항목은 다음과 같다.
- 네트워크 클라이언트와 인증 Interceptor
- 오류 타입과 로깅
- 디자인 토큰과 원자 UI 컴포넌트
- 날짜·숫자 포맷
- 앱 Router와 환경 설정
업무 규칙이 포함된 주문 카드나 스캔 검증은 해당 Feature 안에 두는 편이 안전하다.
점진적 전환 순서
- 신규 기능부터 Feature First로 만든다.
- API Client 같은 진짜 공통 코드만
core로 이동한다. - 변경이 잦은 기존 기능을 하나씩 이동한다.
- 의존성 방향을 테스트로 보호한다.
- 빈 레거시 폴더를 제거한다.
관련 문서
다른 게시글
현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어
기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.
Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분
Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.
Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정
Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.