Design Decisions

주요 설계 선택 배경

Why MVVM?

SnapFig은 Clean Architecture와의 호환성과 테스트 용이성을 위해 MVVM(Model-View-ViewModel) 패턴을 채택했습니다.
MVVM은 UI(View)와 비즈니스 로직(ViewModel)을 명확히 분리하여 코드의 유지보수성을 높이고, Flutter의 ChangeNotifier 기반 상태 관리와 자연스럽게 연동됩니다.

Why Isar?

로컬 데이터베이스로 Isar를 선택한 이유는 다음과 같습니다:

• 뛰어난 성능: 모바일 환경에서 매우 빠른 쿼리 속도를 제공
• 경량화: 앱 다운로드 크기 증가가 약 1–1.5 MB로 최소화
• 코드 생성 지원: build_runner를 통한 모델 클래스 자동 생성으로 개발 생산성 향상

Why FastAPI?

백엔드 API 서버로 FastAPI를 도입한 이유는:

• 비동기 지원(ASGI): 대규모 동시 요청을 효율적으로 처리
• 자동 문서화: OpenAPI/Swagger 기반 인터랙티브 문서 제공
• 타입 힌트 검증: Pydantic을 활용해 런타임 데이터 유효성을 컴파일 타임처럼 검증
• 고성능: Flask/Django 대비 더 나은 처리 속도

대안 검토 및 Trade-off 요약

기술	대안	장점	단점
MVVM	MVC, BLoC	UI/비즈니스 로직 분리 → 테스트 용이	러닝 커브, 보일러플레이트 코드 증가
Isar	Hive, SQflite, ObjectBox	고성능 쿼리, Flutter 네이티브 지원, 코드 생성 도구	커뮤니티 규모 작음, 대용량 마이그레이션 제약
FastAPI	Flask, Django	ASGI 기반 비동기 처리, 자동 문서화, 타입 힌트 검증	비교적 신생 프레임워크, 생태계·플러그인 적음