# bala924/expense-tracker architecture

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

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

## Overview

This is a personal expense-tracking web app: users register or log in, then manage expenses and review spending summaries, history, and salary. The frontend routes users to those workflows, pages call API services, and the services issue HTTP requests to the Spring Boot backend. Frontend imports and calls are supported by the supplied source index and excerpts. Backend internals are represented from the file tree only; their call relationships could not be verified from the supplied evidence.

Main entry points: [`expense-tracker-frontend/src/App.jsx`](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/App.jsx) (App routing), [`expense-tracker-frontend/src/services/expenseService.js`](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/services/expenseService.js) (Expense API service), [`expense-tracker-frontend/src/pages/Dashboard.jsx`](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Dashboard.jsx) (Dashboard), [`expense-tracker-frontend/src/pages/History.jsx`](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/History.jsx) (Expense history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_router["App routing<br/>[App.jsx]"]
  node_auth[("Auth state<br/>[auth.js]")]
  node_format["Formatting helpers<br/>[formatters.js]"]
  node_usersvc["User API service<br/>[userService.js]"]
  node_expensesvc["Expense API service<br/>[expenseService.js]"]
  node_http["HTTP client<br/>[api.js]"]
end

subgraph group_views["User workflows"]
  node_authpages["Sign in and register<br/>[Login.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_expenses["Expense management<br/>[Expenses.jsx]"]
  node_history["Expense history<br/>[History.jsx]"]
  node_summary["Spending summary<br/>[Summary.jsx]"]
  node_salary["Salary settings<br/>[Salary.jsx]"]
  node_expenseui["Expense forms and table<br/>[ExpenseForm.jsx]"]
  node_modal["Expense modals<br/>[ExpenseModal.jsx]"]
  node_display["Shared display components<br/>[SummaryCard.jsx]"]
end

subgraph group_backend["Backend API"]
  node_usercontroller["User endpoints"]
  node_expensecontroller["Expense endpoints"]
  node_userservice["User service<br/>[UserService.java]"]
  node_expenseservice["Expense service"]
  node_security["Security configuration"]
end

subgraph group_domain["Backend domain"]
  node_userrepo["User repository"]
  node_expenserepo["Expense repository"]
  node_entities["Expense and user records"]
end

node_user(("User"))

node_user -->|"uses"| node_router
node_router -->|"routes to"| node_authpages
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_expenses
node_router -->|"routes to"| node_history
node_router -->|"routes to"| node_summary
node_router -->|"routes to"| node_salary
node_authpages -->|"calls"| node_usersvc
node_authpages -->|"stores user"| node_auth
node_dashboard -->|"requests summaries"| node_expensesvc
node_dashboard -->|"renders"| node_display
node_dashboard -->|"formats values"| node_format
node_expenses -->|"manages expenses"| node_expensesvc
node_expenses -->|"renders form"| node_expenseui
node_history -->|"filters and updates"| node_expensesvc
node_history -->|"renders"| node_modal
node_history -->|"renders table"| node_expenseui
node_summary -->|"requests summaries"| node_expensesvc
node_summary -->|"renders cards"| node_display
node_summary -->|"formats values"| node_format
node_salary -->|"updates salary"| node_usersvc
node_expenseui -->|"formats values"| node_format
node_modal -->|"formats dates"| node_format
node_usersvc -->|"sends requests"| node_http
node_expensesvc -->|"sends requests"| node_http
node_http -.->|"HTTP requests"| node_usercontroller
node_http -.->|"HTTP requests"| node_expensecontroller
node_usercontroller -.-> node_userservice
node_expensecontroller -.-> node_expenseservice
node_userservice -.-> node_userrepo
node_expenseservice -.-> node_expenserepo

click node_router "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/App.jsx"
click node_auth "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/utils/auth.js"
click node_authpages "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Login.jsx"
click node_dashboard "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Dashboard.jsx"
click node_expenses "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Expenses.jsx"
click node_history "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/History.jsx"
click node_summary "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Summary.jsx"
click node_salary "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Salary.jsx"
click node_expenseui "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/components/ExpenseForm.jsx"
click node_modal "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/components/ExpenseModal.jsx"
click node_display "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/components/SummaryCard.jsx"
click node_format "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/utils/formatters.js"
click node_usersvc "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/services/userService.js"
click node_expensesvc "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/services/expenseService.js"
click node_http "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/services/api.js"
click node_usercontroller "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/controller/UserController.java"
click node_expensecontroller "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/controller/ExpenseController.java"
click node_userservice "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/service/UserService.java"
click node_expenseservice "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/service/ExpenseService.java"
click node_userrepo "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/repository/UserRepository.java"
click node_expenserepo "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/repository/ExpenseRepository.java"
click node_entities "https://github.com/bala924/expense-tracker/tree/main/expense-tracker-backend/src/main/java/com/example/expensetracker/entity"
click node_security "https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/config/SecurityConfig.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_router,node_auth,node_format,node_usersvc,node_expensesvc,node_http,node_user toneBlue
class node_authpages,node_dashboard,node_expenses,node_history,node_summary,node_salary,node_expenseui,node_modal,node_display toneAmber
class node_usercontroller,node_expensecontroller,node_userservice,node_expenseservice,node_security toneMint
class node_userrepo,node_expenserepo,node_entities toneRose
```

## Components

### Web application

- [App routing](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/App.jsx): `expense-tracker-frontend/src/App.jsx`
- [Auth state](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/utils/auth.js): `expense-tracker-frontend/src/utils/auth.js`
- [Formatting helpers](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/utils/formatters.js): `expense-tracker-frontend/src/utils/formatters.js`
- [User API service](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/services/userService.js): `expense-tracker-frontend/src/services/userService.js`
- [Expense API service](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/services/expenseService.js): `expense-tracker-frontend/src/services/expenseService.js`
- [HTTP client](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/services/api.js): `expense-tracker-frontend/src/services/api.js`

### User workflows

- [Sign in and register](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Login.jsx): `expense-tracker-frontend/src/pages/Login.jsx`
- [Dashboard](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Dashboard.jsx): `expense-tracker-frontend/src/pages/Dashboard.jsx`
- [Expense management](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Expenses.jsx): `expense-tracker-frontend/src/pages/Expenses.jsx`
- [Expense history](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/History.jsx): `expense-tracker-frontend/src/pages/History.jsx`
- [Spending summary](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Summary.jsx): `expense-tracker-frontend/src/pages/Summary.jsx`
- [Salary settings](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/pages/Salary.jsx): `expense-tracker-frontend/src/pages/Salary.jsx`
- [Expense forms and table](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/components/ExpenseForm.jsx): `expense-tracker-frontend/src/components/ExpenseForm.jsx`
- [Expense modals](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/components/ExpenseModal.jsx): `expense-tracker-frontend/src/components/ExpenseModal.jsx`
- [Shared display components](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-frontend/src/components/SummaryCard.jsx): `expense-tracker-frontend/src/components/SummaryCard.jsx`

### Backend API

- [User endpoints](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/controller/UserController.java): `expense-tracker-backend/src/main/java/com/example/expensetracker/controller/UserController.java`
- [Expense endpoints](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/controller/ExpenseController.java): `expense-tracker-backend/src/main/java/com/example/expensetracker/controller/ExpenseController.java`
- [User service](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/service/UserService.java): `expense-tracker-backend/src/main/java/com/example/expensetracker/service/UserService.java`
- [Expense service](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/service/ExpenseService.java): `expense-tracker-backend/src/main/java/com/example/expensetracker/service/ExpenseService.java`
- [Security configuration](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/config/SecurityConfig.java): `expense-tracker-backend/src/main/java/com/example/expensetracker/config/SecurityConfig.java`

### Backend domain

- [User repository](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/repository/UserRepository.java): `expense-tracker-backend/src/main/java/com/example/expensetracker/repository/UserRepository.java`
- [Expense repository](https://github.com/bala924/expense-tracker/blob/main/expense-tracker-backend/src/main/java/com/example/expensetracker/repository/ExpenseRepository.java): `expense-tracker-backend/src/main/java/com/example/expensetracker/repository/ExpenseRepository.java`
- [Expense and user records](https://github.com/bala924/expense-tracker/tree/main/expense-tracker-backend/src/main/java/com/example/expensetracker/entity): `expense-tracker-backend/src/main/java/com/example/expensetracker/entity`

### Other components

- **User**

## Connections

- User → App routing: uses (evidence: `expense-tracker-frontend/src/App.jsx`)
- App routing → Sign in and register: routes to (evidence: `expense-tracker-frontend/src/App.jsx`)
- App routing → Dashboard: routes to (evidence: `expense-tracker-frontend/src/App.jsx`)
- App routing → Expense management: routes to (evidence: `expense-tracker-frontend/src/App.jsx`)
- App routing → Expense history: routes to (evidence: `expense-tracker-frontend/src/App.jsx`)
- App routing → Spending summary: routes to (evidence: `expense-tracker-frontend/src/App.jsx`)
- App routing → Salary settings: routes to (evidence: `expense-tracker-frontend/src/App.jsx`)
- Sign in and register → User API service: calls (evidence: `expense-tracker-frontend/src/pages/Login.jsx`)
- Sign in and register → Auth state: stores user (evidence: `expense-tracker-frontend/src/pages/Login.jsx`)
- Dashboard → Expense API service: requests summaries (evidence: `expense-tracker-frontend/src/pages/Dashboard.jsx`)
- Dashboard → Shared display components: renders (evidence: `expense-tracker-frontend/src/pages/Dashboard.jsx`)
- Dashboard → Formatting helpers: formats values (evidence: `expense-tracker-frontend/src/pages/Dashboard.jsx`)
- Expense management → Expense API service: manages expenses (evidence: `expense-tracker-frontend/src/pages/Expenses.jsx`)
- Expense management → Expense forms and table: renders form (evidence: `expense-tracker-frontend/src/pages/Expenses.jsx`)
- Expense history → Expense API service: filters and updates (evidence: `expense-tracker-frontend/src/pages/History.jsx`)
- Expense history → Expense modals: renders (evidence: `expense-tracker-frontend/src/pages/History.jsx`)
- Expense history → Expense forms and table: renders table (evidence: `expense-tracker-frontend/src/pages/History.jsx`)
- Spending summary → Expense API service: requests summaries (evidence: `expense-tracker-frontend/src/pages/Summary.jsx`)
- Spending summary → Shared display components: renders cards (evidence: `expense-tracker-frontend/src/pages/Summary.jsx`)
- Spending summary → Formatting helpers: formats values (evidence: `expense-tracker-frontend/src/pages/Summary.jsx`)
- Salary settings → User API service: updates salary (evidence: `expense-tracker-frontend/src/pages/Salary.jsx`)
- Expense forms and table → Formatting helpers: formats values (evidence: `expense-tracker-frontend/src/components/ExpenseForm.jsx`)
- Expense modals → Formatting helpers: formats dates (evidence: `expense-tracker-frontend/src/components/ExpenseModal.jsx`)
- User API service → HTTP client: sends requests (evidence: `expense-tracker-frontend/src/services/userService.js`)
- Expense API service → HTTP client: sends requests (evidence: `expense-tracker-frontend/src/services/expenseService.js`)
- HTTP client → User endpoints: HTTP requests
- HTTP client → Expense endpoints: HTTP requests
- User endpoints → User service
- Expense endpoints → Expense service
- User service → User repository
- Expense service → Expense repository
