# ttatta-org/ttatta_android architecture

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

- Interactive diagram: https://gitdiagram.com/ttatta-org/ttatta_android
- Repository: https://github.com/ttatta-org/ttatta_android

## Overview

##### Project type and purpose
- This is a Kotlin-based Android mobile application built with Jetpack Compose, organized as a multi-module MVVM architecture.
- The “app” module is the entry point; “feature/…” modules each encapsulate a screen’s UI and ViewModel; “core” holds shared domain models and repository interfaces; “data” implements those interfaces, handles network (Retrofit), preferences, and geocoding; “design” provides shared UI components and theme.

##### File structure
- Top-level modules:
- app – MainApplication, Hilt setup, NavHost, aggregates feature modules.
- core – domain layer (data classes, repository interfaces).
- data – data layer (Retrofit APIs, DTOs, repository implementations, DI modules, serializers, preference abstractions).
- design – UI toolkit (Composable components, character rendering, theme, assets).
- feature/… – per-feature modules (login, home, category, challenge, footprint, record, mypage); each contains its own AndroidManifest, ViewModel, Composables, DI, assets, tests.
- test/… – integration or instrumentation-test variants mirroring features.
- Gradle and Hilt modules configure dependencies and injection points.

##### README for additional insights
- Tech stack: Kotlin, Jetpack Compose, Navigation, Hilt, Retrofit, SharedPreference, Room, Naver Map SDK, KakaoSDK.
- Architectural pattern: multi-module, MVVM, dependency injection (Hilt).

##### Elements
- Clear labels: module names, components (ViewModel, Repository, API)
- Blue rectangles for UI modules (feature/design)
- Yellow for domain (core)
- Green for data layer (data module)
- Clouds for external services (REST server, Naver Map, Kakao)

##### Detail to capture
- Hilt injection graph: e.g., DataModule provides ServerApi, RepositoryModule binds interface→impl, PreferenceModule provides SharedPreference.
- Navigation: app/NavHost dispatching to feature NavGraphs.
- Mapping from DTOs (data/api/dto) to domain models (core/model) and back into UI state.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Modules
    AppModule["Mobile App\n(app module)"]:::app

    subgraph "UI Layer"
        DesignModule["Design Module\n(shared UI toolkit)"]:::ui
        LoginModule["Login Feature"]:::ui
        HomeModule["Home Feature"]:::ui
        CategoryModule["Category Feature"]:::ui
        ChallengeModule["Challenge Feature"]:::ui
        FootprintModule["Footprint Feature"]:::ui
        RecordModule["Record Feature"]:::ui
        MyPageModule["MyPage Feature"]:::ui
    end

    CoreModule["Domain Layer\n(core module)"]:::domain
    DataModule["Data Layer\n(data module)"]:::data

    subgraph "External Services"
        RESTApi(("REST API Server")):::external
        NaverMap(("Naver Map SDK")):::external
        KakaoSDK(("Kakao SDK")):::external
        SharedPrefs(("SharedPreferences")):::storage
        RoomDB(("Room Database")):::storage
    end

    %% Data Flow
    AppModule -->|orchestrates NavHost| DesignModule
    AppModule -->|orchestrates NavHost| LoginModule
    AppModule -->|orchestrates NavHost| HomeModule
    AppModule -->|orchestrates NavHost| CategoryModule
    AppModule -->|orchestrates NavHost| ChallengeModule
    AppModule -->|orchestrates NavHost| FootprintModule
    AppModule -->|orchestrates NavHost| RecordModule
    AppModule -->|orchestrates NavHost| MyPageModule

    DesignModule -->|uses domain models & repos| CoreModule
    LoginModule -->|uses domain models & repos| CoreModule
    HomeModule -->|uses domain models & repos| CoreModule
    CategoryModule -->|uses domain models & repos| CoreModule
    ChallengeModule -->|uses domain models & repos| CoreModule
    FootprintModule -->|uses domain models & repos| CoreModule
    RecordModule -->|uses domain models & repos| CoreModule
    MyPageModule -->|uses domain models & repos| CoreModule

    CoreModule -->|implements interfaces| DataModule

    DataModule -->|Retrofit| RESTApi
    DataModule -->|Naver Map API| NaverMap
    DataModule -->|Kakao Auth| KakaoSDK
    DataModule -->|SharedPreference| SharedPrefs
    DataModule -->|Room| RoomDB

    %% Click Events - App
    click AppModule "https://github.com/ttatta-org/ttatta_android/blob/develop/app/src/main/java/com/umc/ttatta/MainApplication.kt"
    click AppModule "https://github.com/ttatta-org/ttatta_android/blob/develop/app/src/main/java/com/umc/ttatta/MainActivity.kt"
    click AppModule "https://github.com/ttatta-org/ttatta_android/blob/develop/app/src/main/java/com/umc/ttatta/MainScreen.kt"
    click AppModule "https://github.com/ttatta-org/ttatta_android/blob/develop/app/src/main/java/com/umc/ttatta/MainViewModel.kt"
    click AppModule "https://github.com/ttatta-org/ttatta_android/blob/develop/app/src/main/java/com/umc/ttatta/NavigationDestination.kt"
    click AppModule "https://github.com/ttatta-org/ttatta_android/blob/develop/app/build.gradle.kts"

    %% Click Events - Design
    click DesignModule "https://github.com/ttatta-org/ttatta_android/blob/develop/design/src/main/java/com/umc/design/BottomNavigationBar.kt"
    click DesignModule "https://github.com/ttatta-org/ttatta_android/blob/develop/design/src/main/java/com/umc/design/character/CharacterView.kt"
    click DesignModule "https://github.com/ttatta-org/ttatta_android/blob/develop/design/src/main/java/com/umc/design/theme/ThemeProvider.kt"

    %% Click Events - Core
    click CoreModule "https://github.com/ttatta-org/ttatta_android/tree/develop/core/src/main/java/com/umc/core/model/"
    click CoreModule "https://github.com/ttatta-org/ttatta_android/blob/develop/core/src/main/java/com/umc/core/repository/UserRepository.kt"
    click CoreModule "https://github.com/ttatta-org/ttatta_android/blob/develop/core/src/main/java/com/umc/core/repository/DiaryRepository.kt"
    click CoreModule "https://github.com/ttatta-org/ttatta_android/blob/develop/core/src/main/java/com/umc/core/Geocoder.kt"

    %% Click Events - Data
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/api/ServerApi.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/api/UserApi.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/api/GeocodingApi.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/tree/develop/data/src/main/java/com/umc/data/api/dto/"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/implementation/repository/UserRepositoryImpl.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/implementation/repository/DiaryRepositoryImpl.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/di/repository/UserRepositoryModule.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/di/repository/DiaryRepositoryModule.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/preference/AuthPreference.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/di/preference/AuthPreferenceModule.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/preference/ItemPreference.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/di/preference/ItemPreferenceModule.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/serializer/LocalDateSerializer.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/serializer/OffsetDateTimeSerializer.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/implementation/GeocoderImpl.kt"
    click DataModule "https://github.com/ttatta-org/ttatta_android/blob/develop/data/src/main/java/com/umc/data/di/GeocoderModule.kt"

    %% Click Events - Features
    click LoginModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/login/src/main/java/com/umc/login/LoginViewModel.kt"
    click LoginModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/login/src/main/java/com/umc/login/screen/LoginScreen.kt"
    click LoginModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/login/src/main/java/com/umc/login/navigation/AddLoginNavGraph.kt"
    click HomeModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/home/src/main/java/com/umc/home/HomeViewModel.kt"
    click HomeModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/home/src/main/java/com/umc/home/HomeScreen.kt"
    click HomeModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/home/src/main/java/com/umc/home/navigation/AppNavHost.kt"
    click CategoryModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/category/src/main/java/com/umc/category/CategoryViewModel.kt"
    click CategoryModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/category/src/main/java/com/umc/category/CategoryScreen.kt"
    click ChallengeModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/challenge/src/main/java/com/umc/challenge/ChallengeViewModel.kt"
    click ChallengeModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/challenge/src/main/java/com/umc/challenge/screen/ChallengeScreen.kt"
    click FootprintModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/footprint/src/main/java/com/umc/footprint/FootprintViewModel.kt"
    click FootprintModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/footprint/src/main/java/com/umc/footprint/FootprintScreen.kt"
    click RecordModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/record/src/main/java/com/umc/record/RecordViewModel.kt"
    click RecordModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/record/src/main/java/com/umc/record/screen/RecordScreen.kt"
    click MyPageModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/mypage/src/main/java/com/umc/mypage/MyPageViewModel.kt"
    click MyPageModule "https://github.com/ttatta-org/ttatta_android/blob/develop/feature/mypage/src/main/java/com/umc/mypage/MyPageScreen.kt"

    %% Styles
    classDef app fill:#f9c,stroke:#333,stroke-width:2px
    classDef ui fill:#bbf,stroke:#333,stroke-width:1px
    classDef domain fill:#ffeb8a,stroke:#333,stroke-width:1px
    classDef data fill:#9f9,stroke:#333,stroke-width:1px
    classDef external fill:#ccc,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
    classDef storage fill:#fca,stroke:#333,stroke-width:1px
```
