# priyansh42/spendee-expense-tracker-and-budget-manager architecture

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

- Interactive diagram: https://gitdiagram.com/priyansh42/spendee-expense-tracker-and-budget-manager
- Repository: https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager

## Overview

##### Project type and purpose
- This is a native Android mobile application (“Spendee”) written in Java, built with Android Studio, whose primary function is to help users track income/expenses, generate reports, and perform small finance calculations (EMI, tax). It uses Firebase Realtime Database and Firebase Authentication as its backend.

##### File structure
- Top-level “app” module contains everything:
- src/main/java/com/example/myapplication – Activities (MainActivity, DashboardFragment, ExpenseFragment, IncomeFragment, etc.), Model/Data.java, plus utility screens (Registration, Login, Forgot/Reset Password, Profile, Feedback, EMI/Tax calculators).
- src/main/res – XML layouts, navigation graph, drawables, fonts, animations, menus, themes.
- google-services.json – Firebase config.
- build.gradle/proguard-rules – Android build and obfuscation configs.
- Test directories for unit and instrumentation tests.
- Gradle wrapper and settings for multi-project config.

##### README for additional insights
- Tech stack: Java + Android SDK, Firebase Realtime Database, Firebase Auth.
- Key features: CRUD on income/expenses, search by date, statistical views, EMI/tax calculator, user management (register, login, reset password, email verification), rate-us, low balance alert.

##### Essential architectural elements
- Don’t overload with every single Activity; group similar screens (Authentication Screens, Dashboard Screens, Calculator Screens).
- Firebase’s dual role (Auth + Realtime DB).
- Real-time data sync pattern offered by Firebase listeners.
- Where local vs. remote processing occurs (calculators vs. CRUD operations).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Android Client"
        subgraph "UI Layer"
            MainActivity["MainActivity"]:::ui
            DashboardFragment["DashboardFragment"]:::ui
            ExpenseFragment["ExpenseFragment"]:::ui
            IncomeFragment["IncomeFragment"]:::ui
            Registration["Registration"]:::ui
            ResetPassword["resetpassword"]:::ui
            ChangePassword["change_password"]:::ui
            Profile["Profile"]:::ui
            About["about"]:::ui
            Feedback["feedback"]:::ui
            FirstHome["first_home_page"]:::ui
            HomeScreen["home_screen"]:::ui
            UIResources["UI Resources (layouts, navigation, menus)"]:::ui
        end
        subgraph "Business Logic Layer"
            EMI["emi"]:::logic
            IncEMI["inc_emi"]:::logic
            FinalInc["Finalinc"]:::logic
            NextIncome["NextIncome"]:::logic
            Income2["income2"]:::logic
            SearchData["searchdata"]:::logic
            SearchData2["searchdata2"]:::logic
        end
        subgraph "Data Access & Models"
            DataModel["Data.java"]:::data
        end
    end

    subgraph "External Services"
        FirebaseAuth["Firebase Authentication"]:::external
        FirebaseDB["Firebase Realtime Database"]:::external
    end

    MainActivity -->|checks session| FirebaseAuth
    MainActivity -->|initiates data ops| EMI
    Registration -->|signup/login| FirebaseAuth
    ResetPassword -->|password reset| FirebaseAuth
    UIResources -->|feeds UI screens| MainActivity
    DashboardFragment -->|view stats| SearchData
    ExpenseFragment -->|CRUD ops| Income2
    IncomeFragment -->|CRUD ops| Income2
    EMI -->|calculates EMI| IncEMI
    IncEMI --> FinalInc
    SearchData --> SearchData2
    EMI --> DataModel
    IncEMI --> DataModel
    FinalInc --> DataModel
    NextIncome --> DataModel
    Income2 --> DataModel
    SearchData --> DataModel
    SearchData2 --> DataModel
    DataModel -->|read/write| FirebaseDB
    DataModel -->|auth token| FirebaseAuth

    click MainActivity "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/MainActivity.java"
    click DashboardFragment "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/DashboardFragment.java"
    click ExpenseFragment "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/ExpenseFragment.java"
    click IncomeFragment "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/IncomeFragment.java"
    click Registration "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/Registration.java"
    click ResetPassword "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/resetpassword.java"
    click ChangePassword "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/change_password.java"
    click Profile "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/Profile.java"
    click About "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/about.java"
    click Feedback "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/feedback.java"
    click FirstHome "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/first_home_page.java"
    click HomeScreen "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/home_screen.java"
    click EMI "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/emi.java"
    click IncEMI "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/inc_emi.java"
    click FinalInc "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/Finalinc.java"
    click NextIncome "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/NextIncome.java"
    click Income2 "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/income2.java"
    click SearchData "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/searchdata.java"
    click SearchData2 "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/searchdata2.java"
    click DataModel "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/src/main/java/com/example/myapplication/Model/Data.java"
    click UIResources "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/tree/master/app/src/main/res"
    click FirebaseConfig "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/google-services.json"
    click BuildGradleApp "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/build.gradle"
    click ProGuard "https://github.com/priyansh42/spendee-expense-tracker-and-budget-manager/blob/master/app/proguard-rules.pro"

    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef logic fill:#90EE90,stroke:#333,stroke-width:1px
    classDef data fill:#FFFF99,stroke:#333,stroke-width:1px
    classDef external fill:#FFA500,stroke:#333,stroke-width:1px
```
