# genti2024/genti-android architecture

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

- Interactive diagram: https://gitdiagram.com/genti2024/genti-android
- Repository: https://github.com/genti2024/genti-android

## Overview

##### Project type and purpose
- This is a multi-module Android application (“Genti”) built with Clean Architecture and MVI using Jetpack Compose.
- Its purpose is to let users create AI-generated photos, manage them in a feed/profile, handle onboarding, in-app purchases, and receive push notifications.

##### High-level architectural layers
- Presentation Layer (app + feature modules)
- Domain Layer (business rules, use cases)
- Data Layer (repositories, data sources, DTOs, network & local modules)
- Core Modules (shared utilities: common, design system, navigation, network, datastore)
- Build-logic (custom Gradle convention plugins)
- External Services (backend API, AWS S3, Firebase, Google Play Billing, Kakao Open API, Amplitude)

##### Main components
a. App Module
- Contains Android entry point, Hilt setup, Manifest, UI host (MyApp.kt)
- Depends on feature modules and core modules
b. Feature Modules (presentation for each screen flow)
- onboarding, main, feed, generate, profile, result, setting
- Each feature contains ViewModel (MVI intents, states, side-effects), Compose screens, navigation graph
c. Domain Module
- Contains UseCase classes and Repository interfaces
- Defines data models (entity/request/response) and business logic contracts
d. Data Module
- Implements Domain repositories (AuthRepositoryImpl, FeedRepositoryImpl, etc.)
- Contains DataSources (remote via Retrofit, local via SharedPrefs), DTOs, Service interfaces
- Uses core/network for Retrofit, core/datastore for SharedPref
e. Core Modules
- common: extensions, managers (ImageManager, PermissionManager, AmplitudeManager)
- designsystem: UI components (buttons, dialogs, themes)
- navigation: centralized route definitions
- network: RetrofitModule, AuthInterceptor
- datastore: Hilt modules for SharedPref
f. External Services
- Backend REST API (hosted service endpoints)
- AWS S3 (presigned URL upload)
- Firebase Cloud Messaging (push notifications)
- Google Play Billing API
- Kakao Open API (login)
- Amplitude (analytics)

##### Relationships and interactions
- Presentation → Domain: feature ViewModels invoke UseCases
- Domain → Data: UseCases call Repository interfaces
- Data → Core Network/Datastore: DataSources use RetrofitModule for HTTP calls and SharedPrefModule for local storage
- Data → External Services: Retrofit service interfaces communicate with backend; S3 SDK for uploads; BillingManager calls Play Billing; FCM receives push; Kakao SDK for login
- App Module wires everything with Hilt (DI graph connecting modules and external services)

##### Architectural patterns & design principles
- Clean Architecture separation of concerns (layers depend only inward)
- MVI (Model-View-Intent) in all feature modules
- Multi-Module Gradle project for parallel build and clear boundaries
- Single source of navigation in core/navigation, feature-specific nav graphs
- Dependency Injection with Hilt modules in each core and data module

## Diagram (Mermaid)

```mermaid
flowchart TD
    classDef presentation fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef domain fill:#E6FFEA,stroke:#22863A,color:#22863A;
    classDef data fill:#FFF5DA,stroke:#DBAB09,color:#DBAB09;
    classDef core fill:#F2F2F2,stroke:#6A737D,color:#6A737D;
    classDef buildlogic fill:#FFE4E1,stroke:#D73A49,color:#D73A49;
    classDef external fill:#FFF0B3,stroke:#735C0F,color:#735C0F;
    classDef di fill:#E0CFF2,stroke:#6F42C1,color:#6F42C1;

    subgraph "Presentation Layer"
        direction TB
        App["App Module"]:::presentation
        subgraph "Feature Modules"
            direction TB
            Onb["Onboarding"]:::presentation
            Main["Main"]:::presentation
            Feed["Feed"]:::presentation
            Generate["Generate"]:::presentation
            Profile["Profile"]:::presentation
            Result["Result"]:::presentation
            Setting["Setting"]:::presentation
        end
    end

    subgraph "Domain Layer"
        Domain["Domain Module"]:::domain
    end

    subgraph "Data Layer"
        Data["Data Module"]:::data
    end

    subgraph "Core Modules"
        direction TB
        Common["common"]:::core
        Design["designsystem"]:::core
        Navigation["navigation"]:::core
        Network["network"]:::core
        Datastore["datastore"]:::core
    end

    subgraph "Build-logic"
        BuildLogic["build-logic"]:::buildlogic
    end

    subgraph "External Services"
        direction TB
        API["Backend REST API"]:::external
        S3["AWS S3"]:::external
        FCM["Firebase FCM"]:::external
        Billing["Google Play Billing"]:::external
        Kakao["Kakao Open API"]:::external
        Amplitude["Amplitude"]:::external
    end

    Hilt["Hilt DI"]:::di

    %% Dependencies
    App -->|uses| Onb
    App -->|uses| Main
    App -->|uses| Feed
    App -->|uses| Generate
    App -->|uses| Profile
    App -->|uses| Result
    App -->|uses| Setting
    Onb -->|"invokes UseCases"| Domain
    Main -->|"invokes UseCases"| Domain
    Feed -->|"invokes UseCases"| Domain
    Generate -->|"invokes UseCases"| Domain
    Profile -->|"invokes UseCases"| Domain
    Result -->|"invokes UseCases"| Domain
    Setting -->|"invokes UseCases"| Domain

    Domain -->|"calls Repositories"| Data

    Data -->|"uses RetrofitModule"| Network
    Data -->|"uses SharedPrefModule"| Datastore
    Data -->|"injects Managers"| Common

    Data -->|"HTTP calls"| API
    Data -->|"S3 SDK upload"| S3
    Data -->|"BillingManager"| Billing
    Data -->|"Kakao SDK login"| Kakao

    Common -->|"analytics"| Amplitude

    App -->|"receives push"| FCM
    App -->|"billing callbacks"| Billing

    %% DI wiring
    Hilt --> App
    Hilt --> Domain
    Hilt --> Data
    Hilt --> Common
    Hilt --> Design
    Hilt --> Navigation
    Hilt --> Network
    Hilt --> Datastore

    %% Click Events
    click App "https://github.com/genti2024/genti-android/blob/develop/app/src/main/java/kr/genti/android/MyApp.kt"
    click Onb "https://github.com/genti2024/genti-android/tree/develop/feature/onboarding/src/main/java/kr/genti/onboarding"
    click Main "https://github.com/genti2024/genti-android/blob/develop/feature/main/src/main/java/kr/genti/main/MainActivity.kt"
    click Feed "https://github.com/genti2024/genti-android/blob/develop/feature/feed/src/main/java/kr/genti/feed/FeedViewModel.kt"
    click Generate "https://github.com/genti2024/genti-android/blob/develop/feature/generate/src/main/java/kr/genti/generate/GenerateViewModel.kt"
    click Profile "https://github.com/genti2024/genti-android/blob/develop/feature/profile/src/main/java/kr/genti/profile/ProfileViewModel.kt"
    click Result "https://github.com/genti2024/genti-android/blob/develop/feature/result/src/main/java/kr/genti/result/finished/FinishedViewModel.kt"
    click Setting "https://github.com/genti2024/genti-android/blob/develop/feature/setting/src/main/java/kr/genti/setting/SettingViewModel.kt"
    click Domain "https://github.com/genti2024/genti-android/tree/develop/domain/src/main/kotlin/kr/genti/domain"
    click Data "https://github.com/genti2024/genti-android/tree/develop/data/src/main/java/kr/genti/data"
    click Common "https://github.com/genti2024/genti-android/tree/develop/core/common/src/main/java/kr/genti/common"
    click Datastore "https://github.com/genti2024/genti-android/blob/develop/core/datastore/src/main/java/kr/genti/datastore/di/SharedPrefModule.kt"
    click Design "https://github.com/genti2024/genti-android/tree/develop/core/designsystem/src/main/java/kr/genti/designsystem"
    click Navigation "https://github.com/genti2024/genti-android/tree/develop/core/navigation/src/main/java/kr/genti/navigation"
    click Network "https://github.com/genti2024/genti-android/blob/develop/core/network/src/main/java/kr/genti/network/RetrofitModule.kt"
    click BuildLogic "https://github.com/genti2024/genti-android/tree/develop/build-logic/convention/src/main/java/kr/genti/convention/config"
```
