# dhruvjain01/money-manager architecture

> Architecture diagram of the GitHub repository dhruvjain01/money-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dhruvjain01/money-manager
- Repository: https://github.com/dhruvjain01/money-manager

## Overview

Money Manager is a personal-finance tracker with a React client and Spring Boot API. Users authenticate, then manage categories, income, and expenses; they can filter transactions and view dashboard summaries. The backend scopes finance data to profiles and persists it through Spring Data repositories. Authentication includes refresh-token renewal and password recovery; reporting supports Excel downloads and emailed reports. Several controllers and services are represented from the tree and README because their implementation excerpts were not provided, so their internal call paths are not asserted.

Main entry points: [`moneymanagerwebapp/src/util/axiosConfig.js`](https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/util/axiosConfig.js) (HTTP client), [`MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/IncomeService.java`](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/IncomeService.java) (Income tracking), [`MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExpenseService.java`](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExpenseService.java) (Expense tracking), [`MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ProfileService.java`](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ProfileService.java) (Profile service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Web application<br/>[App.jsx]"]
  node_session["Session context<br/>[AppContext.jsx]"]
  node_http["HTTP client<br/>[axiosConfig.js]"]
  node_api_map["API endpoints<br/>[apiEndpoints.js]"]
end

subgraph group_api["API workflows"]
  node_profile_api["Profile and auth API"]
  node_category_api["Category API"]
  node_income_api["Income API"]
  node_expense_api["Expense API"]
  node_filter_api["Transaction filters"]
  node_dashboard_api["Dashboard API"]
end

subgraph group_finance["Finance domain"]
  node_categories["Category management"]
  node_income["Income tracking<br/>[IncomeService.java]"]
  node_expense["Expense tracking"]
  node_dashboard["Dashboard analytics"]
  node_filtering["Filter service logic"]
end

subgraph group_identity["Identity and access"]
  node_profiles["Profile service"]
  node_security["JWT security"]
  node_jwt_filter["JWT filter"]
  node_tokens["Refresh tokens"]
end

subgraph group_reports["Reports and messaging"]
  node_excel["Excel generation<br/>[ExcelService.java]"]
  node_email["Email delivery<br/>[EmailService.java]"]
  node_email_api["Report email API"]
end

node_user(("Finance user"))
node_database[("MySQL database")]
node_mailer["Brevo email service"]

node_user -->|"uses"| node_web
node_web -->|"reads session"| node_session
node_session -->|"renews session"| node_http
node_session -->|"selects endpoint"| node_api_map
node_http -->|"uses endpoints"| node_api_map
node_http -.->|"sends API requests"| node_profile_api
node_http -.->|"sends API requests"| node_category_api
node_http -.->|"sends API requests"| node_income_api
node_http -.->|"sends API requests"| node_expense_api
node_http -.->|"sends API requests"| node_filter_api
node_http -.->|"sends API requests"| node_dashboard_api
node_expense -->|"gets current profile"| node_profiles
node_income -->|"gets current profile"| node_profiles
node_expense -.->|"reads and writes"| node_database
node_income -.->|"reads and writes"| node_database
node_categories -.->|"reads and writes"| node_database
node_profiles -.->|"reads and writes"| node_database
node_filter_api -->|"filters income"| node_income
node_filter_api -->|"filters expenses"| node_expense
node_dashboard_api -.->|"requests summary"| node_dashboard
node_dashboard -.->|"summarizes income"| node_income
node_dashboard -.->|"summarizes expenses"| node_expense
node_profile_api -->|"handles profiles"| node_profiles
node_profile_api -->|"sends recovery mail"| node_email
node_profiles -->|"sends activation mail"| node_email
node_profile_api -.->|"manages refresh flow"| node_tokens
node_security -.->|"configures filter"| node_jwt_filter
node_email_api -->|"requests report data"| node_excel
node_email_api -->|"sends report email"| node_email
node_email -->|"posts email"| node_mailer
node_excel -.->|"formats income data"| node_income
node_excel -.->|"formats expense data"| node_expense

click node_web "https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/App.jsx"
click node_session "https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/context/AppContext.jsx"
click node_http "https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/util/axiosConfig.js"
click node_api_map "https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/util/apiEndpoints.js"
click node_profile_api "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/ProfileController.java"
click node_category_api "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/CategoryController.java"
click node_income_api "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/IncomeController.java"
click node_expense_api "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/ExpenseController.java"
click node_filter_api "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/FilterController.java"
click node_dashboard_api "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/DashboardCollector.java"
click node_categories "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/CategoryService.java"
click node_income "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/IncomeService.java"
click node_expense "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExpenseService.java"
click node_dashboard "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/DashboardService.java"
click node_profiles "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ProfileService.java"
click node_security "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/config/SecurityConfig.java"
click node_jwt_filter "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/security/JwtAuthenticationFilter.java"
click node_tokens "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/util/RefreshTokenUtil.java"
click node_filtering "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/FilterController.java"
click node_excel "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExcelService.java"
click node_email "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/EmailService.java"
click node_email_api "https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/EmailController.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_session,node_http,node_api_map,node_user toneBlue
class node_profile_api,node_category_api,node_income_api,node_expense_api,node_filter_api,node_dashboard_api,node_database toneAmber
class node_categories,node_income,node_expense,node_dashboard,node_filtering toneMint
class node_profiles,node_security,node_jwt_filter,node_tokens toneRose
class node_excel,node_email,node_email_api,node_mailer toneIndigo
```

## Components

### Web client

- [Web application](https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/App.jsx): `moneymanagerwebapp/src/App.jsx`
- [Session context](https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/context/AppContext.jsx): `moneymanagerwebapp/src/context/AppContext.jsx`
- [HTTP client](https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/util/axiosConfig.js): `moneymanagerwebapp/src/util/axiosConfig.js`
- [API endpoints](https://github.com/dhruvjain01/money-manager/blob/main/moneymanagerwebapp/src/util/apiEndpoints.js): `moneymanagerwebapp/src/util/apiEndpoints.js`

### API workflows

- [Profile and auth API](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/ProfileController.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/ProfileController.java`
- [Category API](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/CategoryController.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/CategoryController.java`
- [Income API](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/IncomeController.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/IncomeController.java`
- [Expense API](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/ExpenseController.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/ExpenseController.java`
- [Transaction filters](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/FilterController.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/FilterController.java`
- [Dashboard API](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/DashboardCollector.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/DashboardCollector.java`

### Finance domain

- [Category management](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/CategoryService.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/CategoryService.java`
- [Income tracking](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/IncomeService.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/IncomeService.java`
- [Expense tracking](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExpenseService.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExpenseService.java`
- [Dashboard analytics](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/DashboardService.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/DashboardService.java`
- [Filter service logic](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/FilterController.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/FilterController.java`

### Identity and access

- [Profile service](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ProfileService.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ProfileService.java`
- [JWT security](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/config/SecurityConfig.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/config/SecurityConfig.java`
- [JWT filter](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/security/JwtAuthenticationFilter.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/security/JwtAuthenticationFilter.java`
- [Refresh tokens](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/util/RefreshTokenUtil.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/util/RefreshTokenUtil.java`

### Reports and messaging

- [Excel generation](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExcelService.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExcelService.java`
- [Email delivery](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/EmailService.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/EmailService.java`
- [Report email API](https://github.com/dhruvjain01/money-manager/blob/main/MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/EmailController.java): `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/EmailController.java`

### Other components

- **Finance user**
- **MySQL database**
- **Brevo email service**

## Connections

- Finance user → Web application: uses (evidence: `moneymanagerwebapp/src/App.jsx`)
- Web application → Session context: reads session (evidence: `moneymanagerwebapp/src/App.jsx`)
- Session context → HTTP client: renews session (evidence: `moneymanagerwebapp/src/context/AppContext.jsx`)
- Session context → API endpoints: selects endpoint (evidence: `moneymanagerwebapp/src/context/AppContext.jsx`)
- HTTP client → API endpoints: uses endpoints (evidence: `moneymanagerwebapp/src/util/axiosConfig.js`)
- HTTP client → Profile and auth API: sends API requests (evidence: `moneymanagerwebapp/src/util/axiosConfig.js`)
- HTTP client → Category API: sends API requests
- HTTP client → Income API: sends API requests
- HTTP client → Expense API: sends API requests
- HTTP client → Transaction filters: sends API requests
- HTTP client → Dashboard API: sends API requests
- Expense tracking → Profile service: gets current profile (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ExpenseService.java`)
- Income tracking → Profile service: gets current profile (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/IncomeService.java`)
- Expense tracking → MySQL database: reads and writes
- Income tracking → MySQL database: reads and writes
- Category management → MySQL database: reads and writes
- Profile service → MySQL database: reads and writes
- Transaction filters → Income tracking: filters income (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/FilterController.java`)
- Transaction filters → Expense tracking: filters expenses (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/FilterController.java`)
- Dashboard API → Dashboard analytics: requests summary
- Dashboard analytics → Income tracking: summarizes income
- Dashboard analytics → Expense tracking: summarizes expenses
- Profile and auth API → Profile service: handles profiles (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/ProfileController.java`)
- Profile and auth API → Email delivery: sends recovery mail (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/ProfileController.java`)
- Profile service → Email delivery: sends activation mail (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/ProfileService.java`)
- Profile and auth API → Refresh tokens: manages refresh flow
- JWT security → JWT filter: configures filter
- Report email API → Excel generation: requests report data (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/EmailController.java`)
- Report email API → Email delivery: sends report email (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/controller/EmailController.java`)
- Email delivery → Brevo email service: posts email (evidence: `MoneyManager/src/main/java/in/moneymanager/MoneyManager/service/EmailService.java`)
- Excel generation → Income tracking: formats income data
- Excel generation → Expense tracking: formats expense data
