# vishvendra01/popflix architecture

> Architecture diagram of the GitHub repository vishvendra01/popflix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vishvendra01/popflix
- Repository: https://github.com/vishvendra01/popflix

## Overview

##### Main Components

a. Client Layer (UI):
- Fragments (MovieListingFragment, MovieDetailsFragment)
- Adapters (MovieListingAdapter)
- ViewModels (MovieListingViewModel)

b. Domain Layer:
- Repository (MovieRepository)
- Entity Models (MovieEntity)
- Data Models (Movie)
- Mappers (MovieMapper)

c. Data Layer:
- Split into two main sources:
- Local Source (Room Database)
- MovieDatabase
- MovieDao
- Remote Source (API)
- TMDb API Client
- NetworkSource

d. Dependencies/External Services:
- TMDb API
- Image Loading (Glide)
- Dependency Injection (Dagger components)

##### Connection Flow

- UI → ViewModel (one-way data binding)
- ViewModel → Repository (data requests)
- Repository ← → Local Source (Room DB)
- Repository ← → Remote Source (TMDb API)

##### Specific Implementation Details

a. Dependency Injection Structure:
- AppComponent
- MovieListingComponent
- Various Modules (NetworkModule, RepositoryModule, etc.)

b. Data Flow Patterns:
- RxJava Streams
- LiveData Observers
- Room Database flows

##### Technical Specifications

- Used Technologies:
- Kotlin
- RxJava
- Room
- Retrofit
- Glide
- Dagger

**[UI Layer (Fragments, ViewModels)]**
- ↓
**[Domain Layer (Repository, Models)]**
- ↓
**[Data Layer (Local/Remote Sources)]**
- ↓
**[External Services (TMDb API)]**

Important Considerations:

##### Offline-first architecture by showing the data flow
- First check local database
- If data not available/stale, fetch from network
- Cache network response

##### MVVM pattern
- Unidirectional data flow
- Clear separation of concerns
- ViewModel as the mediator

##### Single-Activity architecture
- MainActivity as the container
- Fragment navigation
- Shared ViewModel scopes

##### Pagination handling
- PaginationListener
- Data loading states
- Cache management

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef domain fill:#f1c40f,stroke:#f39c12,color:black
    classDef data fill:#2ecc71,stroke:#27ae60,color:white
    classDef external fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef di fill:#e74c3c,stroke:#c0392b,color:white

    %% UI Layer
    subgraph UI
        MA[MainActivity]
        MLF[MovieListingFragment]
        MDF[MovieDetailsFragment]
        MLA[MovieListingAdapter]
        MLV[MovieListingViewModel]
        PL[PaginationListener]
    end

    %% Domain Layer
    subgraph Domain
        MR[MovieRepository]
        ME[MovieEntity]
        MM[Movie Model]
        MAP[MovieMapper]
    end

    %% Data Layer
    subgraph Data
        subgraph Local
            MDB[MovieDatabase]
            MDAO[MovieDao]
            LSI[LocalSourceImpl]
        end
        
        subgraph Remote
            NS[NetworkSource]
            TMDB[TMDb API Client]
        end
    end

    %% Dependency Injection
    subgraph DI
        AC[AppComponent]
        MLC[MovieListingComponent]
        NM[NetworkModule]
        RM[RepositoryModule]
        LSM[LocalSourceModule]
    end

    %% External Services
    TMDBAPI[TMDb API]:::external
    GLIDE[Glide Image Loading]:::external

    %% Relationships
    MA --> MLF & MDF
    MLF --> MLA
    MLF --> MLV
    MLF --> PL
    MLV --> MR
    MR --> ME
    MR --> MM
    MR --> MAP
    MR --> LSI
    MR --> NS
    LSI --> MDB
    MDB --> MDAO
    NS --> TMDB
    TMDB --> TMDBAPI
    AC --> MLC
    AC --> NM & RM & LSM
    MLF --> GLIDE

    %% Click Events
    click MA "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/MainActivity.kt"
    click MLF "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/ui/listing/MovieListingFragment.kt"
    click MDF "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/ui/details/MovieDetailsFragment.kt"
    click MLA "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/ui/listing/MovieListingAdapter.kt"
    click MLV "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/ui/listing/MovieListingViewModel.kt"
    click PL "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/ui/common/PaginationListener.kt"
    click MR "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/data/repository/MovieRepository.kt"
    click ME "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/data/entity/MovieEntity.kt"
    click MM "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/data/model/Movie.kt"
    click MAP "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/data/mapper/MovieMapper.kt"
    click MDB "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/data/source/local/MovieDatabase.kt"
    click MDAO "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/data/source/local/MovieDao.kt"
    click LSI "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/data/source/local/LocalSourceImpl.kt"
    click NS "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/data/source/remote/NetworkSource.kt"
    click AC "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/di/app/AppComponent.kt"
    click MLC "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/di/MovieListingComponent.kt"
    click NM "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/di/app/NetworkModule.kt"
    click RM "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/di/app/RepositoryModule.kt"
    click LSM "https://github.com/vishvendra01/PopFlix/blob/master/app/src/main/java/com/app/newmoviesapp/di/app/LocalSourceModule.kt"

    %% Style Applications
    class MA,MLF,MDF,MLA,MLV,PL ui
    class MR,ME,MM,MAP domain
    class MDB,MDAO,LSI,NS,TMDB data
    class AC,MLC,NM,RM,LSM di
```
