# trueguy64/iyb_app architecture

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

- Interactive diagram: https://gitdiagram.com/trueguy64/iyb_app
- Repository: https://github.com/trueguy64/iyb_app

## Overview

##### Main Components

a. User Interface Layer:
- Main activities (MainActivity, MainMenu, BudgetSetup, GraphAnalytics, etc.)
- Layout resources (/res/layout/) as they define the UI structure
- Night mode support (layout-night directory)

b. Data Management Layer:
- Local storage components (raw/*.txt files)
- LogsManager for transaction logging
- Data models for budget and transactions

c. Business Logic Layer:
- Core functionality classes
- Budget calculation and analytics components
- Transaction categorization system

**[User Interface Layer]**

- Activities
- MainActivity
- BudgetSetup
- GraphAnalytics
- LogsManager
- MainMenu

- Layouts
- Standard Layouts
- Night Mode Layouts

**[Business Logic Layer]**

- Budget Management
- Transaction Processing
- Analytics Engine

**[Data Layer]**

- Local Storage
- logs.txt
- netbudget.txt
- saveddata.txt

**[External Dependencies]**

- MPAndroidChart

##### Additional Elements

- Version information and build requirements
- Android system integration points
- Java 17 runtime environment

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and classes
    classDef ui fill:#a8d1f0,stroke:#333
    classDef logic fill:#90EE90,stroke:#333
    classDef data fill:#FFE5B4,stroke:#333
    classDef external fill:#D3D3D3,stroke:#333
    classDef layout fill:#ADD8E6,stroke:#333

    %% Title
    title[Android Budgeting Application - System Architecture]

    %% User Interface Layer
    subgraph UI[User Interface Layer]
        direction TB
        Activities --> Layouts
        
        subgraph Activities
            direction TB
            MA[MainActivity]:::ui
            BS[BudgetSetup]:::ui
            GA[GraphAnalytics]:::ui
            LM[LogsManager]:::ui
            MM[MainMenu]:::ui
        end

        subgraph Layouts
            direction TB
            SL[Standard Layouts]:::layout
            NL[Night Mode Layouts]:::layout
            CD[Currency Dropdown]:::layout
        end
    end

    %% Business Logic Layer
    subgraph BL[Business Logic Layer]
        direction TB
        BM[Budget Management]:::logic
        TP[Transaction Processing]:::logic
        AE[Analytics Engine]:::logic
        LVH[List View Handler]:::logic
        UM[User Management]:::logic
    end

    %% Data Layer
    subgraph DL[Data Layer]
        direction TB
        LS[Local Storage]:::data
        subgraph Files
            direction TB
            LF[logs.txt]:::data
            NB[netbudget.txt]:::data
            SD[saveddata.txt]:::data
        end
    end

    %% External Dependencies
    subgraph ED[External Dependencies]
        MP[MPAndroidChart]:::external
    end

    %% Relationships
    UI --> BL
    BL --> DL
    GA --> MP
    BL --> MP

    %% Click events for component mapping
    click MA "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/java/com/threestoges/iyb_app/MainActivity.java"
    click BS "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/java/com/threestoges/iyb_app/BudgetSetup.java"
    click GA "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/java/com/threestoges/iyb_app/GraphAnalytics.java"
    click MM "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/java/com/threestoges/iyb_app/MainMenu.java"
    click LM "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/java/com/threestoges/iyb_app/LogsManager.java"
    click SL "https://github.com/Trueguy64/IYB_App/tree/main/app/src/main/res/layout/"
    click NL "https://github.com/Trueguy64/IYB_App/tree/main/app/src/main/res/layout-night/"
    click CD "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/res/layout/dropdown_currencies.xml"
    click LF "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/res/raw/logs.txt"
    click NB "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/res/raw/netbudget.txt"
    click SD "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/res/raw/saveddata.txt"
    click LVH "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/java/com/threestoges/iyb_app/Listview.java"
    click UM "https://github.com/Trueguy64/IYB_App/blob/main/app/src/main/java/com/threestoges/iyb_app/userNew.java"

    %% Legend
    subgraph Legend
        L1[UI Components]:::ui
        L2[Business Logic]:::logic
        L3[Data Storage]:::data
        L4[External Dependencies]:::external
        L5[Layout Resources]:::layout
    end
```
