🏛️ Architecture - CommitBang/Snapfig-Frontend GitHub Wiki

🏗️ 아키텍처

SnapFig은 Clean Architecture와 MVVM 패턴을 기반으로 설계되어 확장성과 유지보수성을 보장합니다.

📐 전체 아키텍처 구조

┌─────────────────────────────────────────────────────────────┐
│                    Presentation Layer                       │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────────┐ │
│  │   Home Screen   │  │ PDF Viewer      │  │   Settings   │ │
│  │   (MVVM)        │  │ Screen (MVVM)   │  │   Screen     │ │
│  └─────────────────┘  └─────────────────┘  └──────────────┘ │
└─────────────────────────────────────────────────────────────┘
                              │
┌─────────────────────────────────────────────────────────────┐
│                    Business Logic Layer                     │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────────┐ │
│  │   PDF Service   │  │   OCR Service   │  │  AI Service  │ │
│  │   (Provider)    │  │   (Provider)    │  │  (Provider)  │ │
│  └─────────────────┘  └─────────────────┘  └──────────────┘ │
└─────────────────────────────────────────────────────────────┘
                              │
┌─────────────────────────────────────────────────────────────┐
│                      Data Layer                             │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────────┐ │
│  │   Isar DB       │  │   HTTP Client   │  │ File System  │ │
│  │   (Local)       │  │   (Remote)      │  │   (Cache)    │ │
│  └─────────────────┘  └─────────────────┘  └──────────────┘ │
└─────────────────────────────────────────────────────────────┘

🔧 핵심 아키텍처 패턴

1. MVVM (Model-View-ViewModel)

• View: Flutter Widgets (UI 컴포넌트)
• ViewModel: ChangeNotifier 기반 상태 관리
• Model: 데이터 모델 및 비즈니스 로직

2. Provider Pattern

• PDFProvider: PDF 문서 상태 및 OCR 처리 관리
• AIProvider: AI 서비스 통합 및 대화 상태 관리
• NavigationProvider: 앱 내 네비게이션 중앙 관리

3. Repository Pattern

• Local Repository: Isar 데이터베이스를 통한 로컬 데이터 관리
• Remote Repository: HTTP 클라이언트를 통한 외부 API 통신
• Cache Repository: 파일 시스템 기반 캐시 관리

📁 모듈별 책임

모듈	책임	주요 컴포넌트
Core	앱 전체 공통 요소	Constants, Theme, Utils
Features	기능별 독립 모듈	Screens, Widgets, Models
Shared	공통 서비스 및 위젯	Services, Widgets
Data	데이터 접근 및 관리	Repositories, Data Sources

---