# rishabhxvaz/wealthify architecture

> Architecture diagram of the GitHub repository rishabhxvaz/wealthify, 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/rishabhxvaz/wealthify
- Repository: https://github.com/rishabhxvaz/wealthify

## Overview

Wealthify is an expense tracker for Indian college students, combining JWT accounts, AI-assisted expense logging, spending analysis, budget planning, savings goals, and investment suggestions. The user workflow runs from the React app through authenticated API requests to Spring controllers and services, which classify and persist expenses or calculate financial results for the UI. The graph also preserves the separate auth, budget/goals, analytics, and investment branches. Several frontend-to-backend links are documented capabilities rather than shown client calls, so those links are dashed; unsampled implementation details are not inferred.

Main entry points: [`frontend/src/api/axios.js`](https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/api/axios.js) (HTTP client), [`backend/src/main/java/com/Wealthify/backend/service/GoalService.java`](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/GoalService.java) (Budget and goals), [`frontend/src/App.jsx`](https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/App.jsx) (App routing), [`backend/src/main/java/com/Wealthify/backend/service/ExpenseService.java`](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/ExpenseService.java) (Expense workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Auth state<br/>[AuthContext.jsx]"]
  node_budgetui["Budget state<br/>[BudgetContext.jsx]"]
  node_pages["Finance pages"]
  node_api_client["HTTP client<br/>[axios.js]"]
end

subgraph group_api["API and security"]
  node_auth_controller["Auth endpoints"]
  node_expense_controller["Expense endpoints"]
  node_goal_controller["Goal endpoints"]
  node_insight_controller["Insight endpoints"]
  node_analytics_controller["Analytics endpoints"]
  node_auth_service["Account service<br/>[AuthService.java]"]
  node_user_store[("User records")]
end

subgraph group_finance["Expense and planning"]
  node_expense_service["Expense workflow"]
  node_goal_service["Budget and goals<br/>[GoalService.java]"]
  node_expense_store[("Expense records")]
  node_goal_store[("Goal records")]
end

subgraph group_insights["AI and insights"]
  node_analytics_service["Analytics service"]
  node_stock_service["Spending and stocks"]
  node_ai_service["AI assistance<br/>[AiService.java]"]
end

node_user(("Student"))
node_groq{{"Groq AI"}}
node_email["Mail service"]

node_user -.->|"uses"| node_app
node_app -->|"routes"| node_pages
node_app -.->|"provides auth"| node_authui
node_app -.->|"provides budget"| node_budgetui
node_pages -.->|"requests data"| node_api_client
node_api_client -.->|"calls API"| node_auth_controller
node_api_client -.->|"calls API"| node_expense_controller
node_api_client -.->|"calls API"| node_goal_controller
node_api_client -.->|"calls API"| node_insight_controller
node_api_client -.->|"calls API"| node_analytics_controller
node_auth_controller -->|"delegates"| node_auth_service
node_auth_service -->|"reads and writes"| node_user_store
node_auth_service -->|"sends reset mail"| node_email
node_expense_controller -->|"delegates"| node_expense_service
node_expense_service -->|"classifies expense"| node_ai_service
node_expense_service -->|"stores and reads"| node_expense_store
node_expense_service -->|"loads user"| node_user_store
node_goal_controller -->|"delegates"| node_goal_service
node_goal_service -->|"stores and reads"| node_goal_store
node_goal_service -->|"loads user"| node_user_store
node_goal_service -->|"reads spending"| node_expense_store
node_goal_service -->|"requests plan"| node_ai_service
node_insight_controller -->|"delegates"| node_stock_service
node_stock_service -->|"reads spending"| node_expense_store
node_stock_service -->|"loads user"| node_user_store
node_stock_service -->|"generates guidance"| node_ai_service
node_ai_service -.->|"requests AI"| node_groq
node_analytics_controller -.->|"delegates"| node_analytics_service
node_analytics_service -.->|"reads spending"| node_expense_store

click node_app "https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/context/AuthContext.jsx"
click node_budgetui "https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/context/BudgetContext.jsx"
click node_pages "https://github.com/rishabhxvaz/wealthify/tree/main/frontend/src/pages"
click node_api_client "https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/api/axios.js"
click node_auth_controller "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/AuthController.java"
click node_expense_controller "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/ExpenseController.java"
click node_goal_controller "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/GoalController.java"
click node_insight_controller "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/InsightController.java"
click node_analytics_controller "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/AnalyticsController.java"
click node_auth_service "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/AuthService.java"
click node_expense_service "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/ExpenseService.java"
click node_goal_service "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/GoalService.java"
click node_analytics_service "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/AnalyticsService.java"
click node_stock_service "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/StockAdvisorService.java"
click node_ai_service "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/AiService.java"
click node_user_store "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/repository/UserRepository.java"
click node_expense_store "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/repository/ExpenseRepository.java"
click node_goal_store "https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/repository/GoalRepository.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_authui,node_budgetui,node_pages,node_api_client toneBlue
class node_auth_controller,node_expense_controller,node_goal_controller,node_insight_controller,node_analytics_controller,node_auth_service,node_user_store toneAmber
class node_expense_service,node_goal_service,node_expense_store,node_goal_store toneMint
class node_analytics_service,node_stock_service,node_ai_service toneRose
class node_user,node_groq,node_email toneIndigo
```

## Components

### React client

- [App routing](https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth state](https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Budget state](https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/context/BudgetContext.jsx): `frontend/src/context/BudgetContext.jsx`
- [Finance pages](https://github.com/rishabhxvaz/wealthify/tree/main/frontend/src/pages): `frontend/src/pages`
- [HTTP client](https://github.com/rishabhxvaz/wealthify/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### API and security

- [Auth endpoints](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/AuthController.java): `backend/src/main/java/com/Wealthify/backend/controller/AuthController.java`
- [Expense endpoints](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/ExpenseController.java): `backend/src/main/java/com/Wealthify/backend/controller/ExpenseController.java`
- [Goal endpoints](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/GoalController.java): `backend/src/main/java/com/Wealthify/backend/controller/GoalController.java`
- [Insight endpoints](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/InsightController.java): `backend/src/main/java/com/Wealthify/backend/controller/InsightController.java`
- [Analytics endpoints](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/controller/AnalyticsController.java): `backend/src/main/java/com/Wealthify/backend/controller/AnalyticsController.java`
- [Account service](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/AuthService.java): `backend/src/main/java/com/Wealthify/backend/service/AuthService.java`
- [User records](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/repository/UserRepository.java): `backend/src/main/java/com/Wealthify/backend/repository/UserRepository.java`

### Expense and planning

- [Expense workflow](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/ExpenseService.java): `backend/src/main/java/com/Wealthify/backend/service/ExpenseService.java`
- [Budget and goals](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/GoalService.java): `backend/src/main/java/com/Wealthify/backend/service/GoalService.java`
- [Expense records](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/repository/ExpenseRepository.java): `backend/src/main/java/com/Wealthify/backend/repository/ExpenseRepository.java`
- [Goal records](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/repository/GoalRepository.java): `backend/src/main/java/com/Wealthify/backend/repository/GoalRepository.java`

### AI and insights

- [Analytics service](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/AnalyticsService.java): `backend/src/main/java/com/Wealthify/backend/service/AnalyticsService.java`
- [Spending and stocks](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/StockAdvisorService.java): `backend/src/main/java/com/Wealthify/backend/service/StockAdvisorService.java`
- [AI assistance](https://github.com/rishabhxvaz/wealthify/blob/main/backend/src/main/java/com/Wealthify/backend/service/AiService.java): `backend/src/main/java/com/Wealthify/backend/service/AiService.java`

### Other components

- **Student**
- **Groq AI**
- **Mail service**

## Connections

- Student → App routing: uses
- App routing → Finance pages: routes (evidence: `frontend/src/App.jsx`)
- App routing → Auth state: provides auth
- App routing → Budget state: provides budget
- Finance pages → HTTP client: requests data (evidence: `frontend/src/pages/Goals.jsx`)
- HTTP client → Auth endpoints: calls API
- HTTP client → Expense endpoints: calls API
- HTTP client → Goal endpoints: calls API
- HTTP client → Insight endpoints: calls API
- HTTP client → Analytics endpoints: calls API
- Auth endpoints → Account service: delegates (evidence: `backend/src/main/java/com/Wealthify/backend/controller/AuthController.java`)
- Account service → User records: reads and writes (evidence: `backend/src/main/java/com/Wealthify/backend/service/AuthService.java`)
- Account service → Mail service: sends reset mail (evidence: `backend/src/main/java/com/Wealthify/backend/service/AuthService.java`)
- Expense endpoints → Expense workflow: delegates (evidence: `backend/src/main/java/com/Wealthify/backend/controller/ExpenseController.java`)
- Expense workflow → AI assistance: classifies expense (evidence: `backend/src/main/java/com/Wealthify/backend/service/ExpenseService.java`)
- Expense workflow → Expense records: stores and reads (evidence: `backend/src/main/java/com/Wealthify/backend/service/ExpenseService.java`)
- Expense workflow → User records: loads user (evidence: `backend/src/main/java/com/Wealthify/backend/service/ExpenseService.java`)
- Goal endpoints → Budget and goals: delegates (evidence: `backend/src/main/java/com/Wealthify/backend/controller/GoalController.java`)
- Budget and goals → Goal records: stores and reads (evidence: `backend/src/main/java/com/Wealthify/backend/service/GoalService.java`)
- Budget and goals → User records: loads user (evidence: `backend/src/main/java/com/Wealthify/backend/service/GoalService.java`)
- Budget and goals → Expense records: reads spending (evidence: `backend/src/main/java/com/Wealthify/backend/service/GoalService.java`)
- Budget and goals → AI assistance: requests plan (evidence: `backend/src/main/java/com/Wealthify/backend/service/GoalService.java`)
- Insight endpoints → Spending and stocks: delegates (evidence: `backend/src/main/java/com/Wealthify/backend/controller/InsightController.java`)
- Spending and stocks → Expense records: reads spending (evidence: `backend/src/main/java/com/Wealthify/backend/service/StockAdvisorService.java`)
- Spending and stocks → User records: loads user (evidence: `backend/src/main/java/com/Wealthify/backend/service/StockAdvisorService.java`)
- Spending and stocks → AI assistance: generates guidance (evidence: `backend/src/main/java/com/Wealthify/backend/service/StockAdvisorService.java`)
- AI assistance → Groq AI: requests AI
- Analytics endpoints → Analytics service: delegates
- Analytics service → Expense records: reads spending
