# ompathak-2605/fintrack architecture

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

- Interactive diagram: https://gitdiagram.com/ompathak-2605/fintrack
- Repository: https://github.com/ompathak-2605/fintrack

## Overview

FinTrack is a personal expense-management application with a React frontend and Spring Boot/PostgreSQL backend. The main workflow is user sign-in, navigating the dashboard and finance pages, and sending authenticated requests to manage transactions, budgets, goals, and profile data. Transaction summaries and budget progress are computed in backend services before results return to the UI. The excerpts show transaction, budget, goal, and authentication internals; several other routes and services are represented from the file tree and source index, so their detailed interactions are not asserted.

Main entry points: [`fintrack-frontend/src/api/axios.js`](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/api/axios.js) (HTTP client), [`fintrack-frontend/src/App.jsx`](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/App.jsx) (App navigation), [`fintrack/src/main/java/com/fintrack/repository/UserRepository.java`](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/UserRepository.java) (User records), [`fintrack/src/main/java/com/fintrack/service/BudgetService.java`](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/BudgetService.java) (Budget processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Frontend"]
  node_app["App navigation<br/>[App.jsx]"]
  node_authctx["Auth state<br/>[AuthContext.jsx]"]
  node_http["HTTP client<br/>[axios.js]"]
  node_login["Login and register<br/>[Login.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_transactionsui["Transactions UI<br/>[Transactions.jsx]"]
  node_budgetsui["Budgets UI<br/>[Budgets.jsx]"]
  node_goalsui["Goals UI<br/>[Goals.jsx]"]
  node_profileui["Profile UI<br/>[Profile.jsx]"]
end

subgraph group_api["API and security"]
  node_authcontroller["Authentication API"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_transactionsapi["Transaction API"]
  node_budgetsapi["Budget API"]
  node_goalsapi["Goal API"]
  node_categoriesapi["Category API"]
  node_usersapi["User API"]
end

subgraph group_finance["Finance domains"]
  node_transactionservice["Transaction processing"]
  node_budgetservice["Budget processing<br/>[BudgetService.java]"]
  node_goalservice["Goal processing<br/>[GoalService.java]"]
  node_userservice["User profile service<br/>[UserService.java]"]
end

subgraph group_persistence["Persistence"]
  node_transactionrepo[("Transaction records")]
  node_budgetrepo[("Budget records")]
  node_goalrepo[("Goal records")]
  node_userrepo[("User records")]
  node_categoryrepo[("Category records")]
end

node_person(("FinTrack user"))
node_postgres[("PostgreSQL")]

node_person -->|"uses"| node_app
node_app -->|"wraps app"| node_authctx
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_transactionsui
node_app -->|"routes to"| node_budgetsui
node_app -->|"routes to"| node_goalsui
node_app -->|"routes to"| node_profileui
node_authctx -->|"sets auth header"| node_http
node_budgetsui -->|"requests data"| node_http
node_goalsui -->|"requests data"| node_http
node_transactionsui -.->|"requests data"| node_http
node_dashboard -.->|"requests data"| node_http
node_profileui -.->|"requests data"| node_http
node_http -.->|"HTTP calls"| node_authcontroller
node_http -.->|"HTTP calls"| node_transactionsapi
node_http -.->|"HTTP calls"| node_budgetsapi
node_http -.->|"HTTP calls"| node_goalsapi
node_http -.->|"HTTP calls"| node_categoriesapi
node_http -.->|"HTTP calls"| node_usersapi
node_authcontroller -.->|"delegates"| node_authservice
node_authservice -->|"reads and saves"| node_userrepo
node_authservice -->|"generates token"| node_jwt
node_transactionsapi -->|"delegates"| node_transactionservice
node_transactionservice -->|"queries records"| node_transactionrepo
node_transactionservice -->|"resolves user"| node_userrepo
node_transactionservice -->|"resolves category"| node_categoryrepo
node_budgetsapi -->|"delegates"| node_budgetservice
node_budgetservice -->|"queries records"| node_budgetrepo
node_budgetservice -->|"sums expenses"| node_transactionrepo
node_budgetservice -->|"resolves category"| node_categoryrepo
node_budgetservice -->|"resolves user"| node_userrepo
node_goalsapi -->|"delegates"| node_goalservice
node_goalservice -->|"queries records"| node_goalrepo
node_goalservice -->|"resolves user"| node_userrepo
node_categoriesapi -->|"queries categories"| node_categoryrepo
node_categoriesapi -->|"resolves user"| node_userrepo
node_usersapi -.->|"delegates"| node_userservice
node_userservice -->|"reads and updates"| node_userrepo
node_transactionrepo -.->|"persists"| node_postgres
node_budgetrepo -.->|"persists"| node_postgres
node_goalrepo -.->|"persists"| node_postgres
node_userrepo -.->|"persists"| node_postgres
node_categoryrepo -.->|"persists"| node_postgres

click node_app "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/App.jsx"
click node_authctx "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/context/AuthContext.jsx"
click node_http "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/api/axios.js"
click node_login "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Login.jsx"
click node_dashboard "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Dashboard.jsx"
click node_transactionsui "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Transactions.jsx"
click node_budgetsui "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Budgets.jsx"
click node_goalsui "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Goals.jsx"
click node_profileui "https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Profile.jsx"
click node_authcontroller "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/AuthController.java"
click node_authservice "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/security/AuthService.java"
click node_jwt "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/security/JwtService.java"
click node_transactionsapi "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/TransactionController.java"
click node_budgetsapi "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/BudgetController.java"
click node_goalsapi "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/GoalController.java"
click node_categoriesapi "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/CategoryController.java"
click node_usersapi "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/UserController.java"
click node_transactionservice "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/TransactionService.java"
click node_budgetservice "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/BudgetService.java"
click node_goalservice "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/GoalService.java"
click node_userservice "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/UserService.java"
click node_transactionrepo "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/TransactionRepository.java"
click node_budgetrepo "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/BudgetRepository.java"
click node_goalrepo "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/GoalRepository.java"
click node_userrepo "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/UserRepository.java"
click node_categoryrepo "https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/CategoryRepository.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_app,node_authctx,node_http,node_login,node_dashboard,node_transactionsui,node_budgetsui,node_goalsui,node_profileui,node_person toneBlue
class node_authcontroller,node_authservice,node_jwt,node_transactionsapi,node_budgetsapi,node_goalsapi,node_categoriesapi,node_usersapi,node_postgres toneAmber
class node_transactionservice,node_budgetservice,node_goalservice,node_userservice toneMint
class node_transactionrepo,node_budgetrepo,node_goalrepo,node_userrepo,node_categoryrepo toneRose
```

## Components

### Frontend

- [App navigation](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/App.jsx): `fintrack-frontend/src/App.jsx`
- [Auth state](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/context/AuthContext.jsx): `fintrack-frontend/src/context/AuthContext.jsx`
- [HTTP client](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/api/axios.js): `fintrack-frontend/src/api/axios.js`
- [Login and register](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Login.jsx): `fintrack-frontend/src/pages/Login.jsx`
- [Dashboard](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Dashboard.jsx): `fintrack-frontend/src/pages/Dashboard.jsx`
- [Transactions UI](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Transactions.jsx): `fintrack-frontend/src/pages/Transactions.jsx`
- [Budgets UI](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Budgets.jsx): `fintrack-frontend/src/pages/Budgets.jsx`
- [Goals UI](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Goals.jsx): `fintrack-frontend/src/pages/Goals.jsx`
- [Profile UI](https://github.com/ompathak-2605/fintrack/blob/master/fintrack-frontend/src/pages/Profile.jsx): `fintrack-frontend/src/pages/Profile.jsx`

### API and security

- [Authentication API](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/AuthController.java): `fintrack/src/main/java/com/fintrack/controller/AuthController.java`
- [Authentication service](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/security/AuthService.java): `fintrack/src/main/java/com/fintrack/security/AuthService.java`
- [JWT service](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/security/JwtService.java): `fintrack/src/main/java/com/fintrack/security/JwtService.java`
- [Transaction API](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/TransactionController.java): `fintrack/src/main/java/com/fintrack/controller/TransactionController.java`
- [Budget API](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/BudgetController.java): `fintrack/src/main/java/com/fintrack/controller/BudgetController.java`
- [Goal API](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/GoalController.java): `fintrack/src/main/java/com/fintrack/controller/GoalController.java`
- [Category API](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/CategoryController.java): `fintrack/src/main/java/com/fintrack/controller/CategoryController.java`
- [User API](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/controller/UserController.java): `fintrack/src/main/java/com/fintrack/controller/UserController.java`

### Finance domains

- [Transaction processing](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/TransactionService.java): `fintrack/src/main/java/com/fintrack/service/TransactionService.java`
- [Budget processing](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/BudgetService.java): `fintrack/src/main/java/com/fintrack/service/BudgetService.java`
- [Goal processing](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/GoalService.java): `fintrack/src/main/java/com/fintrack/service/GoalService.java`
- [User profile service](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/service/UserService.java): `fintrack/src/main/java/com/fintrack/service/UserService.java`

### Persistence

- [Transaction records](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/TransactionRepository.java): `fintrack/src/main/java/com/fintrack/repository/TransactionRepository.java`
- [Budget records](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/BudgetRepository.java): `fintrack/src/main/java/com/fintrack/repository/BudgetRepository.java`
- [Goal records](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/GoalRepository.java): `fintrack/src/main/java/com/fintrack/repository/GoalRepository.java`
- [User records](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/UserRepository.java): `fintrack/src/main/java/com/fintrack/repository/UserRepository.java`
- [Category records](https://github.com/ompathak-2605/fintrack/blob/master/fintrack/src/main/java/com/fintrack/repository/CategoryRepository.java): `fintrack/src/main/java/com/fintrack/repository/CategoryRepository.java`

### Other components

- **FinTrack user**
- **PostgreSQL**

## Connections

- FinTrack user → App navigation: uses (evidence: `fintrack-frontend/src/App.jsx`)
- App navigation → Auth state: wraps app (evidence: `fintrack-frontend/src/App.jsx`)
- App navigation → Login and register: routes to (evidence: `fintrack-frontend/src/App.jsx`)
- App navigation → Dashboard: routes to (evidence: `fintrack-frontend/src/App.jsx`)
- App navigation → Transactions UI: routes to (evidence: `fintrack-frontend/src/App.jsx`)
- App navigation → Budgets UI: routes to (evidence: `fintrack-frontend/src/App.jsx`)
- App navigation → Goals UI: routes to (evidence: `fintrack-frontend/src/App.jsx`)
- App navigation → Profile UI: routes to (evidence: `fintrack-frontend/src/App.jsx`)
- Auth state → HTTP client: sets auth header (evidence: `fintrack-frontend/src/context/AuthContext.jsx`)
- Budgets UI → HTTP client: requests data (evidence: `fintrack-frontend/src/pages/Budgets.jsx`)
- Goals UI → HTTP client: requests data (evidence: `fintrack-frontend/src/pages/Goals.jsx`)
- Transactions UI → HTTP client: requests data
- Dashboard → HTTP client: requests data
- Profile UI → HTTP client: requests data
- HTTP client → Authentication API: HTTP calls
- HTTP client → Transaction API: HTTP calls
- HTTP client → Budget API: HTTP calls
- HTTP client → Goal API: HTTP calls
- HTTP client → Category API: HTTP calls
- HTTP client → User API: HTTP calls
- Authentication API → Authentication service: delegates
- Authentication service → User records: reads and saves (evidence: `fintrack/src/main/java/com/fintrack/security/AuthService.java`)
- Authentication service → JWT service: generates token (evidence: `fintrack/src/main/java/com/fintrack/security/AuthService.java`)
- Transaction API → Transaction processing: delegates (evidence: `fintrack/src/main/java/com/fintrack/controller/TransactionController.java`)
- Transaction processing → Transaction records: queries records (evidence: `fintrack/src/main/java/com/fintrack/service/TransactionService.java`)
- Transaction processing → User records: resolves user (evidence: `fintrack/src/main/java/com/fintrack/service/TransactionService.java`)
- Transaction processing → Category records: resolves category (evidence: `fintrack/src/main/java/com/fintrack/service/TransactionService.java`)
- Budget API → Budget processing: delegates (evidence: `fintrack/src/main/java/com/fintrack/controller/BudgetController.java`)
- Budget processing → Budget records: queries records (evidence: `fintrack/src/main/java/com/fintrack/service/BudgetService.java`)
- Budget processing → Transaction records: sums expenses (evidence: `fintrack/src/main/java/com/fintrack/service/BudgetService.java`)
- Budget processing → Category records: resolves category (evidence: `fintrack/src/main/java/com/fintrack/service/BudgetService.java`)
- Budget processing → User records: resolves user (evidence: `fintrack/src/main/java/com/fintrack/service/BudgetService.java`)
- Goal API → Goal processing: delegates (evidence: `fintrack/src/main/java/com/fintrack/controller/GoalController.java`)
- Goal processing → Goal records: queries records (evidence: `fintrack/src/main/java/com/fintrack/service/GoalService.java`)
- Goal processing → User records: resolves user (evidence: `fintrack/src/main/java/com/fintrack/service/GoalService.java`)
- Category API → Category records: queries categories (evidence: `fintrack/src/main/java/com/fintrack/controller/CategoryController.java`)
- Category API → User records: resolves user (evidence: `fintrack/src/main/java/com/fintrack/controller/CategoryController.java`)
- User API → User profile service: delegates
- User profile service → User records: reads and updates (evidence: `fintrack/src/main/java/com/fintrack/service/UserService.java`)
- Transaction records → PostgreSQL: persists
- Budget records → PostgreSQL: persists
- Goal records → PostgreSQL: persists
- User records → PostgreSQL: persists
- Category records → PostgreSQL: persists
