# taewan-p/gpt_mobile architecture

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

- Interactive diagram: https://gitdiagram.com/taewan-p/gpt_mobile
- Repository: https://github.com/taewan-p/gpt_mobile

## Overview

##### Main Components Overview

a) Presentation Layer (UI)
- Compose UI components (in presentation/ui/)
- ViewModels for each screen
- Theme and styling components

b) Domain Layer
- Use cases (implicit from the repository patterns)
- Model definitions and constants

c) Data Layer
- Local Storage (Room Database)
- DataStore for settings
- Network clients for multiple AI platforms
- Repositories

##### Key Architectural Elements

**[Presentation Layer]**
- UI Screens (Home, Chat, Settings, Setup)
- ViewModels
- Common Components
- Theme/Navigation

**[Domain Layer]**
- Models/DTOs
- Repository Interfaces

**[Data Layer]**
- Local Storage
- Room Database (ChatDatabase)
- DataStore (Settings)
- Network
- API Clients
- Anthropic API
- OpenAI API
- Google Gemini
- Groq
- Ollama

##### Important Relationships to Highlight

- Use dependency injection flows (shown by the DI modules in the di/ directory)
- Data flow between layers (following clean architecture)
- API communication patterns for different AI platforms

##### Implementation Details

- Kotlin/Compose based UI components
- Room Database for chat storage
- DataStore for settings
- Repository pattern implementation
- ViewModel/State management

##### External Dependencies

- AI Platform APIs
- Android Framework components
- Jetpack libraries (Compose, Room, DataStore)

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and Classes
    classDef ui fill:#2196F3,color:white
    classDef data fill:#4CAF50,color:white
    classDef network fill:#9C27B0,color:white
    classDef core fill:#FF9800,color:white
    classDef storage fill:#795548,color:white
    classDef theme fill:#607D8B,color:white

    subgraph Presentation
        UI["UI Layer"]
        
        subgraph Screens
            ChatScreen["Chat Screen"]:::ui
            HomeScreen["Home Screen"]:::ui
            SettingScreen["Settings Screen"]:::ui
            SetupScreen["Setup Screen"]:::ui
        end

        subgraph ViewModels
            ChatVM["Chat ViewModel"]:::ui
            HomeVM["Home ViewModel"]:::ui
            SettingVM["Settings ViewModel"]:::ui
            SetupVM["Setup ViewModel"]:::ui
        end

        ThemeSystem["Material You Theme System"]:::theme
        Navigation["Navigation System"]:::ui
    end

    subgraph Domain
        ChatManagement["Chat Management"]:::core
        SettingsManagement["Settings Management"]:::core
    end

    subgraph Data
        subgraph LocalStorage
            RoomDB["Room Database"]:::storage
            DataStore["DataStore"]:::storage
        end

        subgraph Repositories
            ChatRepo["Chat Repository"]:::data
            SettingRepo["Settings Repository"]:::data
        end

        subgraph NetworkServices
            AnthropicAPI["Anthropic API"]:::network
            OpenAIAPI["OpenAI API"]:::network
            GeminiAPI["Google Gemini API"]:::network
            GroqAPI["Groq API"]:::network
            OllamaAPI["Ollama API"]:::network
            NetworkClient["Network Client"]:::network
        end

        subgraph DataModels
            Entities["Database Entities"]:::data
            DTOs["DTOs"]:::data
            Constants["Model Constants"]:::data
        end
    end

    %% Relationships
    ChatScreen --> ChatVM
    HomeScreen --> HomeVM
    SettingScreen --> SettingVM
    SetupScreen --> SetupVM

    ChatVM --> ChatManagement
    HomeVM --> ChatManagement
    SettingVM --> SettingsManagement
    SetupVM --> SettingsManagement

    ChatManagement --> ChatRepo
    SettingsManagement --> SettingRepo

    ChatRepo --> RoomDB
    ChatRepo --> NetworkClient
    SettingRepo --> DataStore

    NetworkClient --> AnthropicAPI
    NetworkClient --> OpenAIAPI
    NetworkClient --> GeminiAPI
    NetworkClient --> GroqAPI
    NetworkClient --> OllamaAPI

    ThemeSystem -.-> Screens
    Navigation -.-> Screens

    %% Click Events
    click ChatScreen "https://github.com/Taewan-P/gpt_mobile/blob/main/presentation/ui/chat/ChatScreen.kt"
    click HomeScreen "https://github.com/Taewan-P/gpt_mobile/blob/main/presentation/ui/home/HomeScreen.kt"
    click SettingScreen "https://github.com/Taewan-P/gpt_mobile/blob/main/presentation/ui/setting/SettingScreen.kt"
    click SetupScreen "https://github.com/Taewan-P/gpt_mobile/tree/main/presentation/ui/setup/"
    click ChatVM "https://github.com/Taewan-P/gpt_mobile/blob/main/presentation/ui/chat/ChatViewModel.kt"
    click HomeVM "https://github.com/Taewan-P/gpt_mobile/blob/main/presentation/ui/home/HomeViewModel.kt"
    click SettingVM "https://github.com/Taewan-P/gpt_mobile/blob/main/presentation/ui/setting/SettingViewModel.kt"
    click SetupVM "https://github.com/Taewan-P/gpt_mobile/blob/main/presentation/ui/setup/SetupViewModel.kt"
    click ThemeSystem "https://github.com/Taewan-P/gpt_mobile/tree/main/app/src/main/kotlin/dev/chungjungsoo/gptmobile/presentation/theme/"
    click Navigation "https://github.com/Taewan-P/gpt_mobile/blob/main/app/src/main/kotlin/dev/chungjungsoo/gptmobile/presentation/common/NavigationGraph.kt"
    click RoomDB "https://github.com/Taewan-P/gpt_mobile/blob/main/data/database/ChatDatabase.kt"
    click DataStore "https://github.com/Taewan-P/gpt_mobile/blob/main/data/datastore/SettingDataSource.kt"
    click ChatRepo "https://github.com/Taewan-P/gpt_mobile/blob/main/data/repository/ChatRepository.kt"
    click SettingRepo "https://github.com/Taewan-P/gpt_mobile/blob/main/data/repository/SettingRepository.kt"
    click AnthropicAPI "https://github.com/Taewan-P/gpt_mobile/blob/main/data/network/AnthropicAPI.kt"
    click NetworkClient "https://github.com/Taewan-P/gpt_mobile/blob/main/data/network/NetworkClient.kt"
    click Entities "https://github.com/Taewan-P/gpt_mobile/tree/main/data/database/entity/"
    click DTOs "https://github.com/Taewan-P/gpt_mobile/tree/main/data/dto/"
    click Constants "https://github.com/Taewan-P/gpt_mobile/blob/main/data/ModelConstants.kt"

    %% Legend
    subgraph Legend
        UI_Component["UI Component"]:::ui
        Data_Component["Data Component"]:::data
        Network_Component["Network Component"]:::network
        Core_Component["Core Component"]:::core
        Storage_Component["Storage Component"]:::storage
        Theme_Component["Theme Component"]:::theme
    end
```
