# gibranhit/movies-challenge architecture

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

- Interactive diagram: https://gitdiagram.com/gibranhit/movies-challenge
- Repository: https://github.com/gibranhit/movies-challenge

## Overview

##### Project type and purpose
- This is a native Android mobile application that fetches popular movies from the TheMovieDB API.
- It follows Clean Architecture and MVVM to separate presentation, domain and data concerns.

##### File‐structure analysis
- Top‐level “app” module contains an Android Gradle project with src/main and src/test.
- src/main/java/mx/com/movieschallenge is organized into packages:
- base – Application class, BaseFragment, BaseViewModel
- ui – Activities, Fragments, ViewModels, Adapters, View-state models and listeners
- domain – Plain Kotlin entities (Movie), use-case interfaces and implementations
- data – Repository implementations, local (Room) and remote (Retrofit) data sources, mappers, models, DAO, database
- di – Koin module loader (ApplicationInjector)
- utils – Constants, extensions, RecyclerView helpers (pagination, decoration)
- Resources include layouts, navigation graph (Jetpack Navigation), drawables, raw animations.

##### Architecture layers and patterns
- Presentation layer (UI + MVVM): Fragments/Activities observe LiveData from ViewModels.
- Domain layer: pure Kotlin; UseCases encapsulate business rules, depend only on domain interfaces.
- Data layer: Repositories implement domain interfaces; choose between local (Room) and remote (Retrofit + HTTP interceptor) sources; use data mappers to convert between Data models and Domain entities.
- Dependency injection is managed by Koin.
- Coroutines handle asynchronous operations.

##### Main components
- App entry point: MoviesApplication → ApplicationInjector (DI container)
- Presentation: Activities/Fragments → ViewModels → UseCases
- Domain: UseCases → Domain Entities (Movie)
- Data:
- PopularMoviesRepository & FavoriteMoviesRepository
- RemoteDataSource: MovieEndpoints (Retrofit), HttpInterceptor
- LocalDataSource: MoviesDao, MoviesDataBase (Room)
- MapperData for converting between MovieData/PageMovie and Domain Movie
- External systems: TheMovieDB REST API
- Persistence: SQLite via Room
- Utility modules: extensions and RecyclerView helpers

##### Relationships and data flow
- ViewModel → Invoke a UseCase
- UseCase → Call Repository interface
- Repository → If network available: Retrofit → JSON → Mapper → Domain entity; Else: Room DAO → Entity → Mapper → Domain entity
- Domain entity → ViewModel → UI updates via LiveData

##### Architectural patterns & principles
- Clean Architecture: strict layer dependencies inward (UI → Domain → Data)
- MVVM in the presentation layer
- SOLID: each layer/component has single responsibility
- Dependency Inversion: ViewModels depend on UseCase interfaces; UseCases depend on Repository interfaces

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Dependency Injection Layer
    subgraph "Dependency Injection" 
        style DependencyInjection fill:#D6BCFA,stroke:#9F7AEA
        ApplicationInjector["ApplicationInjector"] 
        MoviesApplication["MoviesApplication"] 
    end

    %% Presentation Layer
    subgraph "Presentation Layer" 
        style PresentationLayer fill:#BEE3F8,stroke:#4299E1
        MainActivity["MainActivity"] 
        PopularMoviesFragment["PopularMoviesFragment"] 
        PopularMoviesViewModel["PopularMoviesViewModel"] 
        FavoritesMoviesFragment["FavoritesMoviesFragment"] 
        FavoritesMoviesViewModel["FavoritesMoviesViewModel"] 
        DetailMovieActivity["DetailMovieActivity"] 
        MoviesAdapter["MoviesAdapter"] 
        MoviesViewState["MoviesViewState"] 
        MovieCommunication["MovieCommunication"] 
        BaseFragment["BaseFragment"] 
        BaseViewModel["BaseViewModel"] 
    end

    %% Domain Layer
    subgraph "Domain Layer" 
        style DomainLayer fill:#C6F6D5,stroke:#48BB78
        MovieDomain["Movie"] 
        BaseUseCase["BaseUseCase"] 
        GetPopularMoviesUseCase["GetPopularMoviesUseCase"] 
        GetFavoritesMoviesUseCase["GetFavoritesMoviesUseCase"] 
    end

    %% Data Layer
    subgraph "Data Layer" 
        style DataLayer fill:#FEEBC8,stroke:#ED8936
        BaseRepository["BaseRepository"] 
        PopularMoviesRepository["PopularMoviesRepository"] 
        FavoriteMoviesRepository["FavoriteMoviesRepository"] 
        MovieEndpoints["MovieEndpoints"] 
        HttpInterceptor["HttpInterceptor"] 
        MoviesDao["MoviesDao"] 
        MoviesDataBase["MoviesDataBase"] 
        MovieData["MovieData"] 
        PageMovie["PageMovie"] 
        MapperData["MapperData"] 
    end

    %% External Systems
    subgraph "Infrastructure & External"
        style ExternalLayer fill:#EDF2F7,stroke:#A0AEC0
        TheMovieDBAPI["TheMovieDB API"] 
        RoomDB["Room Database (SQLite)"] 
    end

    %% DI to Presentation
    ApplicationInjector -->|provides| PopularMoviesViewModel
    ApplicationInjector -->|provides| FavoritesMoviesViewModel
    ApplicationInjector -->|provides| DetailMovieActivity
    ApplicationInjector -->|provides| MainActivity

    MoviesApplication -->|initializes| ApplicationInjector

    %% Presentation to Domain
    PopularMoviesViewModel -->|calls| GetPopularMoviesUseCase
    FavoritesMoviesViewModel -->|calls| GetFavoritesMoviesUseCase

    %% Domain to Data
    GetPopularMoviesUseCase -->|uses| PopularMoviesRepository
    GetFavoritesMoviesUseCase -->|uses| FavoriteMoviesRepository

    %% Repositories to DataSources
    PopularMoviesRepository -->|remote| MovieEndpoints
    PopularMoviesRepository -->|local| MoviesDao
    FavoriteMoviesRepository -->|local| MoviesDao

    %% Remote flow
    MovieEndpoints -->|fetches| TheMovieDBAPI
    MovieEndpoints -->|uses| HttpInterceptor
    MovieEndpoints -->|returns| PageMovie
    PageMovie -->|mapped by| MapperData
    MapperData -->|produces| MovieDomain

    %% Local flow
    MoviesDao -->|reads/writes| MoviesDataBase
    MoviesDao -->|returns| MovieData
    MovieData -->|mapped by| MapperData
    MapperData -->|produces| MovieDomain
    MovieDomain -->|to UI| PopularMoviesViewModel
    MovieDomain -->|to UI| FavoritesMoviesViewModel

    %% UI interactions
    MainActivity -->|navigates to| PopularMoviesFragment
    MainActivity -->|navigates to| FavoritesMoviesFragment
    MainActivity -->|navigates to| DetailMovieActivity
    PopularMoviesFragment -->|binds| PopularMoviesViewModel
    FavoritesMoviesFragment -->|binds| FavoritesMoviesViewModel
    PopularMoviesFragment -->|uses| MoviesAdapter
    MoviesAdapter -->|renders| MoviesViewState
    PopularMoviesFragment -->|communicates| MovieCommunication

    %% Persistence
    RoomDB -.->|backing| MoviesDataBase

    %% Utilities (not shown nodes)
    %% Click Events
    click MoviesApplication "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/base/MoviesApplication.kt"
    click ApplicationInjector "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/di/AplicationInjector.kt"
    click MainActivity "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/MainActivity.kt"
    click PopularMoviesFragment "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/popular/PopularMoviesFragment.kt"
    click PopularMoviesViewModel "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/popular/PopularMoviesViewModel.kt"
    click FavoritesMoviesFragment "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/favorite/FavoritesMoviesFragment.kt"
    click FavoritesMoviesViewModel "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/favorite/FavoritesMoviesViewModel.kt"
    click DetailMovieActivity "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/detail/DetailMovieActivity.kt"
    click MoviesAdapter "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/adapter/MoviesAdapter.kt"
    click MoviesViewState "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/model/MoviesViewState.kt"
    click MovieCommunication "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/ui/listener/MovieCommunication.kt"
    click MovieDomain "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/domain/model/Movie.kt"
    click BaseUseCase "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/domain/usecase/BaseUseCase.kt"
    click GetPopularMoviesUseCase "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/domain/usecase/GetPopularMoviesUseCase.kt"
    click GetFavoritesMoviesUseCase "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/domain/usecase/GetFavoritesMoviesUseCase.kt"
    click BaseRepository "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/repository/BaseRepository.kt"
    click PopularMoviesRepository "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/repository/PopularMoviesRepository.kt"
    click FavoriteMoviesRepository "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/repository/FavoriteMoviesRepository.kt"
    click MovieEndpoints "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/remote/MovieEndpoints.kt"
    click HttpInterceptor "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/remote/HttpInterceptor.kt"
    click MoviesDao "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/local/MoviesDao.kt"
    click MoviesDataBase "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/local/MoviesDataBase.kt"
    click MovieData "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/model/MovieData.kt"
    click PageMovie "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/model/PageMovie.kt"
    click MapperData "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/data/mapper/MapperData.kt"
    click BaseFragment "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/base/BaseFragment.kt"
    click BaseViewModel "https://github.com/gibranhit/movies-challenge/blob/master/app/src/main/java/mx/com/movieschallenge/base/BaseViewModel.kt"
    classDef DependencyInjection fill:#D6BCFA,stroke:#9F7AEA
    classDef PresentationLayer fill:#BEE3F8,stroke:#4299E1
    classDef DomainLayer fill:#C6F6D5,stroke:#48BB78
    classDef DataLayer fill:#FEEBC8,stroke:#ED8936
    classDef ExternalLayer fill:#EDF2F7,stroke:#A0AEC0
```
