# madhusudan785/movies-discovery architecture

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

- Interactive diagram: https://gitdiagram.com/madhusudan785/movies-discovery
- Repository: https://github.com/madhusudan785/movies-discovery

## Overview

##### High-Level Components

a) Presentation Layer (UI)
- HomeScreen
- MoviesScreen
- TvShowsScreen
- DetailScreen
- Components (MediaItem)

b) Domain Layer (Business Logic)
- Use green to represent domain components
- Include:
- Models (Media)
- Repository Interfaces
- Use Cases (if any)

c) Data Layer
- Use blue to represent data components
- Split into:
- Remote (TMDB API)
- Local (Room Database)
- Repository Implementations

d) Core Infrastructure
- Use orange to represent infrastructure components
- Include:
- Dependency Injection (Dagger Hilt modules)
- Network handling
- Resource management

##### Component Relationships

- Data flow (blue)
- Event flow (green)
- Dependency injection (orange)

##### Detailed Component Breakdown

a) Presentation Layer Details:
**ViewModels**
- MediaListViewModel
- DetailsViewModel
- NetworkViewModel

**UI States**
- MediaListState
- DetailState
- UI Events

b) Data Layer Details:
**Remote**
- MediaApi
- DTOs
- Response Models

**Local**
- MediaDatabase
- DAOs
- Entities

##### Architecture Patterns

Following patterns with appropriate symbols:
- MVVM architecture
- Clean Architecture layers
- Repository pattern
- Dependency Injection
- State management

##### Technical Stack Indicators

- Jetpack Compose
- Room Database
- Retrofit
- Dagger Hilt
- Coroutines & Flow
- TMDB API

##### The state management flow

Remember to maintain a balance between detail and clarity, focusing on the architectural decisions that make this app unique, such as the offline support, dynamic theming, and efficient pagination implementation.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef presentation fill:#E6E6FA,stroke:#9370DB
    classDef domain fill:#90EE90,stroke:#228B22
    classDef data fill:#ADD8E6,stroke:#4682B4
    classDef infrastructure fill:#FFD700,stroke:#FFA500

    %% Infrastructure Layer
    subgraph Infrastructure
        DI[Dependency Injection]
        NO[Network Observer]
        RM[Resource Management]
        Theme[Theme Management]
    end
    class DI,NO,RM,Theme infrastructure

    %% Presentation Layer
    subgraph UI
        HS[Home Screen]
        MS[Movies Screen]
        TS[TV Shows Screen]
        DS[Detail Screen]
        MI[Media Item Component]
    end
    class HS,MS,TS,DS,MI presentation

    subgraph ViewModels
        MLV[Media List ViewModel]
        DV[Details ViewModel]
        NV[Network ViewModel]
    end
    class MLV,DV,NV presentation

    subgraph States
        MLS[Media List State]
        DST[Detail State]
    end
    class MLS,DST presentation

    %% Domain Layer
    subgraph Domain
        MM[Media Model]
        RI[Repository Interface]
    end
    class MM,RI domain

    %% Data Layer
    subgraph Remote
        API[Media API]
        DTO[DTOs]
        RES[Response Models]
    end
    class API,DTO,RES data

    subgraph Local
        DB[Media Database]
        DAO[Media DAO]
        ENT[Media Entity]
    end
    class DB,DAO,ENT data

    subgraph Repository
        IMPL[Repository Implementation]
        MAP[Mappers]
    end
    class IMPL,MAP data

    %% Relationships
    UI --> ViewModels
    ViewModels --> States
    ViewModels --> Domain
    Domain --> Repository
    Repository --> Remote
    Repository --> Local
    DI --> ViewModels
    DI --> Repository
    NO --> NV
    RM --> Repository

    %% Click Events
    click HS "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/core/presentation/HomeScreen.kt"
    click MS "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/presentation/MoviesScreen.kt"
    click TS "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/presentation/TvShowsScreen.kt"
    click DS "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/details/presentation/DetailScreen.kt"
    click MI "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/presentation/components/MediaItem.kt"
    click MLV "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/presentation/MediaListViewModel.kt"
    click DV "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/details/presentation/DetailsViewModel.kt"
    click NV "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/network/NetworkViewModel.kt"
    click MLS "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/presentation/MediaListState.kt"
    click DST "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/details/presentation/DetailState.kt"
    click MM "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/domain/model/Media.kt"
    click RI "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/domain/repository/MediaListRepository.kt"
    click API "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/data/remote/MediaApi.kt"
    click DTO "https://github.com/madhusudan785/Movies-Discovery/tree/main/app/src/main/java/com/example/shows/movieList/data/remote/response"
    click DB "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/data/local/movie/MediaDatabase.kt"
    click DAO "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/data/local/movie/MediaDao.kt"
    click ENT "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/data/local/movie/MediaEntity.kt"
    click IMPL "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/data/repository/MediaListRepositoryImpl.kt"
    click MAP "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/data/mappers/MediaMapper.kt"
    click DI "https://github.com/madhusudan785/Movies-Discovery/tree/main/app/src/main/java/com/example/shows/di"
    click NO "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/network/NetworkObserver.kt"
    click RM "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/movieList/util/Resource.kt"
    click Theme "https://github.com/madhusudan785/Movies-Discovery/blob/main/app/src/main/java/com/example/shows/ui/theme/Theme.kt"
```
