# cronos14/demoplatzi architecture

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

- Interactive diagram: https://gitdiagram.com/cronos14/demoplatzi
- Repository: https://github.com/cronos14/demoplatzi

## Overview

##### Main Components
- Presentation Layer (UI):
- Located primarily in the “app” module.
- Contains Activities, Fragments (e.g., CardsFragment, CardDetailFragment, DeckFragment) and ViewModels.
- Includes the Component Adapter system (adapter/factory/viewholder) for dynamic views.

- Domain Layer (Business Logic):
- Found in the “domain” module.
- Contains use cases (e.g., CardUseCase, DeckUseCase), repository interfaces, error handling (CardError), and data models (Card, MonsterCard, SpellCard, TrapCard).
- Captures core business rules, independent of UI and external data sources.

- Data Layer (Infrastructure):
- Found in the “data” module.
- Implements data sources (both remote and local), DAOs, Room database (AppDatabase), API interactions, and paging data source.
- Contains the Repository implementations (CardRepositoryImp and DeckRepositoryImp).

- Dependency Injection (DI) Module:
- Located in the “di” module.
- Contains modules for database, network, use cases, and view models.
- Ensures that dependencies are wired up correctly between UI, data, and domain layers.

##### Relationships and Interactions
- The Presentation Layer (UI) interacts with its ViewModels, which in turn call the use cases found in the Domain Layer.
- The Domain Layer (use cases) interacts with repository interfaces that abstract the data sources.
- The Data Layer provides concrete implementations of these repository interfaces and handles data fetching from local (Room database) and remote sources (API calls).
- The DI Module ties everything together using Hilt, ensuring that ViewModels, use cases, and repository implementations are injected where needed.

##### Key Architectural Patterns & Principles
- MVVM pattern is clearly applied in the separation between UI (Activities/Fragments), ViewModels, and business logic.
- Clean Architecture is observed by dividing the project into distinct modules – presentation, domain, and data – which reduces coupling.
- Dependency Injection is central using Hilt for modular configuration.
- Various design patterns (Adapter and Factory) are used for dynamically creating and managing UI components (e.g., the Component Adapter system).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer (UI)
    subgraph "Presentation Layer (UI)"
        P1["MainActivity"]:::presentation
        P2["CardsFragment"]:::presentation
        P3["CardDetailFragment"]:::presentation
        P4["DeckFragment"]:::presentation
        subgraph "ViewModels"
            PV1["CardsViewModel"]:::presentation
            PV2["CardDetailViewModel"]:::presentation
            PV3["DeckViewModel"]:::presentation
        end
        subgraph "UI Component Adapter System"
            PA1["ComponentAdapter"]:::presentation
            PA2["ComponentViewHolderFactory"]:::presentation
            PA3["CardsAdapter"]:::presentation
            PA4["FooterAdapter"]:::presentation
            PA5["ComponentViewHolder"]:::presentation
        end
    end

    %% Domain Layer (Business Logic)
    subgraph "Domain Layer (Business Logic)"
        D1["CardUseCase"]:::domain
        D1imp["CardUseCaseImp"]:::domain
        D2["DeckUseCase"]:::domain
        D2imp["DeckUseCaseImp"]:::domain
        RI1["CardRepository Interface"]:::domain
        RI2["DeckRepository Interface"]:::domain
        DM["Card Models (Card,MonsterCard,SpellCard,TrapCard)"]:::domain
    end

    %% Data Layer (Infrastructure)
    subgraph "Data Layer (Infrastructure)"
        DA["AppDatabase"]:::data
        DAO1["MonsterCardDao"]:::data
        DAO2["SpellCardDao"]:::data
        DAO3["TrapCardDao"]:::data
        DS1["RemoteDataSource"]:::data
        subgraph "Local DataSources"
            LDS1["CardLocalDatasourceFacade"]:::data
            LDS2["MonsterCardLocalDataSource"]:::data
            LDS3["SpellCardLocalDataSource"]:::data
            LDS4["TrapCardLocalDataSource"]:::data
        end
        API["Api"]:::data
        PDS["CardPagingDataSource"]:::data
        RIimp1["CardRepositoryImp"]:::data
        RIimp2["DeckRepositoryImp"]:::data
    end

    %% Dependency Injection (DI) Module
    subgraph "DI Module"
        DI1["ModuleDatabase"]:::di
        DI2["ModuleDispatcher"]:::di
        DI3["ModuleNetwork"]:::di
        DI4["ModuleUseCase"]:::di
        DI5["ModuleViewModel"]:::di
    end

    %% External System
    external["YuGiOh Pro API"]:::external

    %% Relationships
    %% Presentation Layer -> ViewModels
    P1 -->|"calls"| PV1
    P2 -->|"uses"| PV1
    P3 -->|"uses"| PV2
    P4 -->|"uses"| PV3
    %% Presentation Layer -> Adapter System
    P2 -->|"binds"| PA3

    %% ViewModels -> Domain Layer (Use Cases)
    PV1 -->|"calls"| D1
    PV2 -->|"calls"| D1
    PV3 -->|"calls"| D2

    %% Domain Internal Relationships
    D1 -->|"implementedBy"| D1imp
    D2 -->|"implementedBy"| D2imp
    D1 -->|"calls"| RI1
    D2 -->|"calls"| RI2

    %% Domain to Data Layer
    RI1 -->|"implementedBy"| RIimp1
    RI2 -->|"implementedBy"| RIimp2

    %% Data Layer Relationships
    RIimp1 -->|"fetchesFrom"| DS1
    RIimp1 -->|"fetchesFrom"| LDS1
    RIimp2 -->|"fetchesFrom"| DS1

    DS1 -->|"calls"| API
    DS1 -->|"calls"| external

    LDS1 -->|"accesses"| DA
    LDS2 -->|"accesses"| DA
    LDS3 -->|"accesses"| DA
    LDS4 -->|"accesses"| DA

    DA -->|"providesTo"| DAO1
    DA -->|"providesTo"| DAO2
    DA -->|"providesTo"| DAO3

    RIimp1 -->|"paginates"| PDS

    %% DI Module Injection
    DI5 -->|"injects"| PV1
    DI5 -->|"injects"| PV2
    DI5 -->|"injects"| PV3
    DI4 -->|"injects"| D1
    DI4 -->|"injects"| D2
    DI1 -->|"configures"| DA
    DI3 -->|"configures"| API
    DI3 -->|"configures"| DS1
    DI2 -->|"configures"| PDS

    %% Click Events for Presentation Layer
    click P1 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/common/activity/MainActivity.kt"
    click P2 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/cardsexplorer/fragment/CardsFragment.kt"
    click P3 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/carddetail/fragment/CardDetailFragment.kt"
    click P4 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/deck/fragment/DeckFragment.kt"
    click PV1 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/cardsexplorer/viewmodel/CardsViewModel.kt"
    click PV2 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/common/viewmodel/CardDetailViewModel.kt"
    click PV3 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/deck/viewmodel/DeckViewModel.kt"
    click PA1 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/common/adapter/ComponentAdapter.kt"
    click PA2 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/common/factory/ComponentViewHolderFactory.kt"
    click PA3 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/cardsexplorer/adapter/CardsAdapter.kt"
    click PA4 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/cardsexplorer/adapter/FooterAdapter.kt"
    click PA5 "https://github.com/cronos14/demoplatzi/blob/master/app/src/main/java/com/javatar/demoplatzi/common/viewholder/ComponentViewHolder.kt"

    %% Click Events for Domain Layer
    click D1 "https://github.com/cronos14/demoplatzi/blob/master/domain/src/main/java/com/javatar/domain/cardexplorer/usecase/CardUseCase.kt"
    click D1imp "https://github.com/cronos14/demoplatzi/blob/master/domain/src/main/java/com/javatar/domain/cardexplorer/usecase/CardUseCaseImp.kt"
    click D2 "https://github.com/cronos14/demoplatzi/blob/master/domain/src/main/java/com/javatar/domain/deck/usecase/DeckUseCase.kt"
    click D2imp "https://github.com/cronos14/demoplatzi/blob/master/domain/src/main/java/com/javatar/domain/deck/usecase/DeckUseCaseImp.kt"
    click RI1 "https://github.com/cronos14/demoplatzi/blob/master/domain/src/main/java/com/javatar/domain/cardexplorer/repository/CardRepository.kt"
    click RI2 "https://github.com/cronos14/demoplatzi/blob/master/domain/src/main/java/com/javatar/domain/deck/repository/DeckRepository.kt"
    click DM "https://github.com/cronos14/demoplatzi/tree/master/domain/src/main/java/com/javatar/domain/models/"

    %% Click Events for Data Layer
    click DA "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/database/AppDatabase.kt"
    click DAO1 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/dao/MonsterCardDao.kt"
    click DAO2 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/dao/SpellCardDao.kt"
    click DAO3 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/dao/TrapCardDao.kt"
    click DS1 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/datasource/RemoteDataSource.kt"
    click LDS1 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/datasource/local/CardLocalDatasourceFacade.kt"
    click LDS2 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/datasource/local/MonsterCardLocalDataSource.kt"
    click LDS3 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/datasource/local/SpellCardLocalDataSource.kt"
    click LDS4 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/datasource/local/TrapCardLocalDataSource.kt"
    click API "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/network/Api.kt"
    click PDS "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/pagingdatasource/CardPagingDataSource.kt"
    click RIimp1 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/repository/CardRepositoryImp.kt"
    click RIimp2 "https://github.com/cronos14/demoplatzi/blob/master/data/src/main/java/com/javatar/data/repository/DeckRepositoryImp.kt"

    %% Click Events for DI Module
    click DI1 "https://github.com/cronos14/demoplatzi/blob/master/di/src/main/java/com/javatar/di/ModuleDatabase.kt"
    click DI2 "https://github.com/cronos14/demoplatzi/blob/master/di/src/main/java/com/javatar/di/ModuleDispatcher.kt"
    click DI3 "https://github.com/cronos14/demoplatzi/blob/master/di/src/main/java/com/javatar/di/ModuleNetwork.kt"
    click DI4 "https://github.com/cronos14/demoplatzi/blob/master/di/src/main/java/com/javatar/di/ModuleUseCase.kt"
    click DI5 "https://github.com/cronos14/demoplatzi/blob/master/di/src/main/java/com/javatar/di/ModuleViewModel.kt"

    %% Styles
    classDef presentation fill:#ADD8E6,stroke:#000,stroke-width:1px;
    classDef domain fill:#90EE90,stroke:#000,stroke-width:1px;
    classDef data fill:#FFDAB9,stroke:#000,stroke-width:1px;
    classDef di fill:#E6E6FA,stroke:#000,stroke-width:1px;
    classDef external fill:#FFCCCC,stroke:#000,stroke-width:1px;
```
