# coderprem/compose-expense-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/coderprem/compose-expense-tracker
- Repository: https://github.com/coderprem/compose-expense-tracker

## Overview

##### Project Type and Purpose
- The project is a full-fledged Android application designed to help users track expenses.
- The README (“compose-expense-tracker”) and usage of Jetpack Compose elements (given the “ui/screens” and “ui/theme” folders) indicate that the application relies on Compose for the UI.
- It also incorporates data handling (ViewModel), persistence (Room or similar, inferred from the db package with ExpenseDatabase, ExpenseDao, and Converters), and navigation components to manage screen flows (NavGraph and Screen).

##### Analyzing the File Structure
- Top-Level Directories/Files:
– The “app” directory contains the main source code and resources.
– There is a clear separation between source code (app/src/main/java) and tests (app/src/test, app/src/androidTest).
– “gradle” and configuration files (build.gradle.kts, settings.gradle.kts) denote standard Android build setup.

- Key Subdirectories within “app/src/main/java/com/example/expensetracker”:
– MainActivity.kt and MainApplication.kt for application setup and lifecycle management.
– “data” folder with files like AddExpenseViewModel.kt, RegistrationUIState.kt, and UIEvent.kt, indicating the MVVM pattern.
– “db” folder with ExpenseDatabase.kt, ExpenseDao.kt and a Converters.kt file, indicating a Room database usage.
– “models” dictionary representing data entities (Expense, BottomNavItem, transactionItem).
– “navigation” folder containing NavGraph.kt and Screen.kt to define navigation logic across screens.
– “ui/screens” subdirectories defining various pages (HomeScreen, ProfileScreen, WalletScreen, AddExpenses, GraphScreen) and additional reusable components.

##### Relationships and Interactions
- Data Flow:
– User interactions in the UI trigger events; these events are captured by the ViewModel in the data layer.
– The ViewModel processes these events, interacts with the Persistence Layer (using DAO to query or update the ExpenseDatabase), and then updates the UI accordingly.
- Navigation Flow:
– The Navigation component (NavGraph) directs the flow between the UI screens.
- Integration Flow:
– Domain Models act as the common data contracts that connect the UI, data, and persistence layers.

##### Architectural Patterns and Design Principles
- MVVM (Model-View-ViewModel) is clearly employed, separating UI presentation (View) from business logic (ViewModel) and data (models/database).
- Use of Jetpack Compose ensures declarative UI development.
- Modularization into clear packages (data, db, models, navigation, ui) promotes clean code separation and maintainability.

- Components showing that the Application Layer branches into separate components: UI, Data Handling, and Persistence.
- Within the UI block, include individual screens (HomeScreen, WalletScreen, etc.) and mark the Navigation block that governs transitions.
- In the Persistence block, detail out the Database (ExpenseDatabase) and DAOs (ExpenseDao) with a link to Domain Models.

## Diagram (Mermaid)

```mermaid
graph TD
    subgraph "Application Layer"
        MA("MainActivity") 
        MApp("MainApplication")
    end

    subgraph "UI Layer"
        direction TB
        HS("HomeScreen")
        WS("WalletScreen")
        PS("ProfileScreen")
        AE("AddExpenses")
        GS("GraphScreen")
        Theme("Theme")
    end

    subgraph "Navigation Component"
        Nav("NavGraph")
        Screen("Screen")
    end

    subgraph "Data Layer"
        VM("AddExpenseViewModel")
        Event("UIEvent/RegistrationUIState")
    end

    subgraph "Persistence Layer"
        DB("ExpenseDatabase")
        DAO("ExpenseDao")
        Conv("Converters")
    end

    subgraph "Domain Models"
        DM("Expense, BottomNavItem, transactionItem")
    end

    %% Connections
    MA -->|"starts"| Nav
    MApp -->|"initializes"| VM

    Nav -->|"routes"| HS
    Nav -->|"routes"| WS
    Nav -->|"routes"| PS
    Nav -->|"routes"| AE
    Nav -->|"routes"| GS

    HS -->|"triggerAction"| VM
    WS -->|"triggerAction"| VM
    PS -->|"triggerAction"| VM
    AE -->|"triggerAction"| VM
    GS -->|"triggerAction"| VM

    VM -->|"queriesUpdates"| DAO
    DAO -->|"executesOps"| DB
    DB -->|"mapsData"| DM

    %% Click Events
    click MA "https://github.com/coderprem/compose-expense-tracker/blob/main/app/src/main/java/com/example/expensetracker/MainActivity.kt"
    click MApp "https://github.com/coderprem/compose-expense-tracker/blob/main/app/src/main/java/com/example/expensetracker/MainApplication.kt"
    click HS "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/ui/screens"
    click WS "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/ui/screens"
    click PS "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/ui/screens"
    click AE "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/ui/screens"
    click GS "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/ui/screens"
    click Theme "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/ui/theme"
    click Nav "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/navigation"
    click Screen "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/navigation"
    click VM "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/data"
    click Event "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/data"
    click DB "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/db"
    click DAO "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/db"
    click Conv "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/db"
    click DM "https://github.com/coderprem/compose-expense-tracker/tree/main/app/src/main/java/com/example/expensetracker/models"

    %% Styles
    classDef app fill:#ffd966,stroke:#333,stroke-width:2px;
    classDef ui fill:#cfe2f3,stroke:#333,stroke-width:2px;
    classDef nav fill:#d9ead3,stroke:#333,stroke-width:2px;
    classDef data fill:#f4cccc,stroke:#333,stroke-width:2px;
    classDef persist fill:#fff2cc,stroke:#333,stroke-width:2px;
    classDef domain fill:#d9d2e9,stroke:#333,stroke-width:2px;

    class MA,MApp app;
    class HS,WS,PS,AE,GS,Theme ui;
    class Nav,Screen nav;
    class VM,Event data;
    class DB,DAO,Conv persist;
    class DM domain;
```
