# team-mument/mument-aos architecture

> Architecture diagram of the GitHub repository team-mument/mument-aos, 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/team-mument/mument-aos
- Repository: https://github.com/team-mument/mument-aos

## Overview

##### Project type and purpose
- This is a multi-module Android mobile application (“MUMENT”) built with a Clean-Architecture flavor: MVVM + MVI.
- It’s a client-side app for recording and viewing music impressions, with features like social login, home feed, detail screens, record creation, notifications, and more.

##### File structure
Top-level modules:
- app: the Android application entry point, Dagger-Hilt setup, launcher Activity, AndroidManifest, and glue to feature modules.
- feature/*: six UI feature modules (detail, home, locker, login, mypage, record), each encapsulating its own Activities/Fragments, ViewModels, and layouts.
- navigation: abstraction for in-app navigation (navigator providers).
- data: data layer (controllers, datasources, DTOs, Room DB, Retrofit services, mappers, repositories).
- domain: domain layer (entities, repository interfaces, use-cases).
- core & core_dependent: shared base classes, utilities, common UI widgets & extensions.
- buildSrc: centralized Gradle dependency management.

##### README for additional insights
- Architecture: MVVM + MVI, Clean layers.
- Libraries: Jetpack, Navigation, Lifecycle, Hilt, Coroutine, Retrofit/OkHttp, Timber, Firebase FCM, Lottie, Coil, Kakao SDK.

##### Detail
- Hilt modules (NetworkModule, RepositoryModule, UseCaseModule, RoomModule, etc.) under App module to show DI bindings.
- Feature modules individually to reflect multi-module boundaries.
- Core and core_dependent as shared libraries consumed by both Presentation and Data layers.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        AppModule["App Module"]:::presentation
        HiltModules["Hilt Modules"]:::presentation
        NavigationModule["Navigation Module"]:::presentation
        DetailFeature["Feature: Detail"]:::presentation
        HomeFeature["Feature: Home"]:::presentation
        LockerFeature["Feature: Locker"]:::presentation
        LoginFeature["Feature: Login"]:::presentation
        MypageFeature["Feature: Mypage"]:::presentation
        RecordFeature["Feature: Record"]:::presentation
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        DomainEntities["Domain: Entities"]:::domain
        DomainRepositories["Domain: Repository Interfaces"]:::domain
        UseCases["Domain: Use Cases"]:::domain
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        Controllers["Data: Controllers"]:::data
        DataSources["Data: DataSources"]:::data
        NetworkServices["Data: Network Services & AuthInterceptor"]:::data
        LocalDB["Data: Local Database (Room)"]:::data
        DTOs["Data: DTOs"]:::data
        Mappers["Data: Mappers"]:::data
        RepoImpl["Data: Repository Implementations"]:::data
        UtilWrappers["Data: Utility Wrappers"]:::data
    end

    %% Core Libraries
    Core["Core"]:::core
    CoreDependent["Core_Dependent"]:::core

    %% External Services
    subgraph "External Services"
        direction TB
        RESTAPI["REST API Server"]:::external
        FirebaseFCM["Firebase FCM"]:::external
        KakaoAuth["Kakao Auth"]:::external
    end

    %% Relationships
    DetailFeature -->|uses| AppModule
    HomeFeature -->|uses| AppModule
    LockerFeature -->|uses| AppModule
    LoginFeature -->|uses| AppModule
    MypageFeature -->|uses| AppModule
    RecordFeature -->|uses| AppModule
    AppModule -->|provides| HiltModules
    HiltModules -->|injects| NavigationModule

    %% UI to Domain
    DetailFeature -->|calls| UseCases
    HomeFeature -->|calls| UseCases
    LockerFeature -->|calls| UseCases
    LoginFeature -->|calls| UseCases
    MypageFeature -->|calls| UseCases
    RecordFeature -->|calls| UseCases

    %% Domain to Data
    UseCases -->|use| DomainRepositories
    DomainRepositories -->|implemented by| RepoImpl

    RepoImpl -->|uses| Controllers
    RepoImpl -->|uses| DataSources

    Controllers -->|access| DTOs
    Controllers -->|use| Mappers

    DataSources -->|remote| NetworkServices
    DataSources -->|local| LocalDB

    NetworkServices -->|api calls| RESTAPI
    NetworkServices -->|push| FirebaseFCM
    NetworkServices -->|social login| KakaoAuth

    %% Shared Libraries
    Core -->|helpers| AppModule
    Core -->|helpers| RepoImpl
    CoreDependent -->|ui components| DetailFeature
    CoreDependent -->|ui components| HomeFeature
    CoreDependent -->|ui components| LockerFeature
    CoreDependent -->|ui components| LoginFeature
    CoreDependent -->|ui components| MypageFeature
    CoreDependent -->|ui components| RecordFeature

    %% Click Events
    click AppModule "https://github.com/team-mument/mument-aos/tree/main/app/src/main/java/com/mument_android/app"
    click HiltModules "https://github.com/team-mument/mument-aos/tree/main/app/src/main/java/com/mument_android/app/di"
    click NavigationModule "https://github.com/team-mument/mument-aos/tree/main/navigation/src/main/java/com/angdroid/navigation"
    click DetailFeature "https://github.com/team-mument/mument-aos/tree/main/feature/detail/src/main/java/com/mument_android/detail"
    click HomeFeature "https://github.com/team-mument/mument-aos/tree/main/feature/home/src/main/java/com/mument_android/home"
    click LockerFeature "https://github.com/team-mument/mument-aos/tree/main/feature/locker/src/main/java/com/mument_android/locker"
    click LoginFeature "https://github.com/team-mument/mument-aos/tree/main/feature/login/src/main/java/com/mument_android/login"
    click MypageFeature "https://github.com/team-mument/mument-aos/tree/main/feature/mypage/src/main/java/com/mument_android/mypage"
    click RecordFeature "https://github.com/team-mument/mument-aos/tree/main/feature/record/src/main/java/com/mument_android/record"
    click Core "https://github.com/team-mument/mument-aos/tree/main/core/src/main/java/com/mument_android/core"
    click CoreDependent "https://github.com/team-mument/mument-aos/tree/main/core_dependent/src/main/java/com/mument_android/core_dependent"
    click DomainEntities "https://github.com/team-mument/mument-aos/tree/main/domain/src/main/java/com/mument_android/domain/entity"
    click DomainRepositories "https://github.com/team-mument/mument-aos/tree/main/domain/src/main/java/com/mument_android/domain/repository"
    click UseCases "https://github.com/team-mument/mument-aos/tree/main/domain/src/main/java/com/mument_android/domain/usecase"
    click Controllers "https://github.com/team-mument/mument-aos/tree/main/data/src/main/java/com/mument_android/data/controller"
    click DataSources "https://github.com/team-mument/mument-aos/tree/main/data/src/main/java/com/mument_android/data/datasource"
    click NetworkServices "https://github.com/team-mument/mument-aos/tree/main/data/src/main/java/com/mument_android/data/network"
    click LocalDB "https://github.com/team-mument/mument-aos/tree/main/data/src/main/java/com/mument_android/data/local"
    click DTOs "https://github.com/team-mument/mument-aos/tree/main/data/src/main/java/com/mument_android/data/dto"
    click Mappers "https://github.com/team-mument/mument-aos/tree/main/data/src/main/java/com/mument_android/data/mapper"
    click RepoImpl "https://github.com/team-mument/mument-aos/tree/main/data/src/main/java/com/mument_android/data/repository"
    click UtilWrappers "https://github.com/team-mument/mument-aos/tree/main/data/src/main/java/com/mument_android/data/util"

    %% Styles
    classDef presentation fill:#D0E8FF,stroke:#0366D6,color:#0366D6
    classDef domain fill:#DFF5E1,stroke:#28A745,color:#28A745
    classDef data fill:#FFE5CC,stroke:#FF8C00,color:#FF8C00
    classDef core fill:#F0F0F0,stroke:#6A737D,color:#6A737D
    classDef external fill:#F8F9FA,stroke:#959DA5,color:#959DA5
```
