# aksharaa0613/internship_project2025 architecture

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

- Interactive diagram: https://gitdiagram.com/aksharaa0613/internship_project2025
- Repository: https://github.com/aksharaa0613/internship_project2025

## Overview

Budget Planner is a MERN application for users to create monthly budgets, record expenses, and review spending. The workflow runs from authenticated React pages through client hooks to an Express API, which authorizes requests, applies controller operations, and persists users, budgets, and expenses in MongoDB. The frontend also includes home/about content and dashboard, budget-list, and statistics views. The README is empty; links between components are limited to relationships visible in supplied excerpts or the SOURCE INDEX.

Main entry points: [`mernFrontend2025/src/App.jsx`](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/App.jsx) (App and routes), [`mernBackend2025/index.js`](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/index.js) (Express API), [`mernFrontend2025/src/components/functionalComponents/Hooks/useBudget.jsx`](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Hooks/useBudget.jsx) (Budget client state), [`mernFrontend2025/src/components/functionalComponents/Hooks/useExpense.jsx`](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Hooks/useExpense.jsx) (Expense client state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_app["App and routes<br/>[App.jsx]"]
  node_home["Home and about<br/>[Home.jsx]"]
  node_about["About page<br/>[About.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
end

subgraph group_auth["Authentication"]
  node_authui["Login and signup<br/>[Login.jsx]"]
  node_authstate["Auth state<br/>[useAuth.jsx]"]
end

subgraph group_budgeting["Budget management"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_budgetform["Add budget<br/>[AddBudget.jsx]"]
  node_budgetlist["Budget list<br/>[BudgetList.jsx]"]
  node_expenseform["Add expense<br/>[AddExpense.jsx]"]
  node_stats["Spending statistics<br/>[Stats.jsx]"]
  node_budgetstate["Budget client state<br/>[useBudget.jsx]"]
  node_expensestate["Expense client state<br/>[useExpense.jsx]"]
end

subgraph group_api["API and domain"]
  node_api["Express API<br/>[index.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_budgetroutes["Budget routes<br/>[budgetRoutes.js]"]
  node_expenseroutes["Expense routes<br/>[expenseRoutes.js]"]
  node_authcontroller["Auth controller<br/>[authController.js]"]
  node_budgetcontroller["Budget controller"]
  node_expensecontroller["Expense controller"]
end

subgraph group_storage["MongoDB persistence"]
  node_users[("User records<br/>[User.js]")]
  node_budgets[("Budget records<br/>[Budget.js]")]
  node_expenses[("Expense records<br/>[Expense.js]")]
end

node_user(("User"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_about
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_budgetform
node_app -->|"routes to"| node_budgetlist
node_app -->|"routes to"| node_expenseform
node_app -->|"routes to"| node_stats
node_authui -->|"uses"| node_authstate
node_navbar -->|"uses"| node_authstate
node_budgetform -->|"uses"| node_budgetstate
node_expenseform -->|"uses"| node_expensestate
node_expenseform -->|"uses"| node_budgetstate
node_budgetlist -->|"uses"| node_budgetstate
node_budgetlist -->|"uses"| node_expensestate
node_dashboard -->|"uses"| node_budgetstate
node_dashboard -->|"uses"| node_expensestate
node_dashboard -->|"uses"| node_authstate
node_stats -->|"uses"| node_budgetstate
node_stats -->|"uses"| node_expensestate
node_authstate -->|"sends auth requests"| node_api
node_budgetstate -->|"sends budget requests"| node_api
node_expensestate -->|"sends expense requests"| node_api
node_api -->|"mounts"| node_authroutes
node_api -->|"mounts"| node_budgetroutes
node_api -->|"mounts"| node_expenseroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_budgetroutes -->|"dispatches"| node_budgetcontroller
node_budgetroutes -->|"protects routes"| node_authcontroller
node_expenseroutes -->|"dispatches"| node_expensecontroller
node_expenseroutes -->|"protects routes"| node_authcontroller
node_authcontroller -->|"reads and writes"| node_users
node_budgetcontroller -->|"reads and writes"| node_budgets
node_expensecontroller -->|"reads and writes"| node_expenses
node_api -->|"connects"| node_mongodb

click node_app "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/App.jsx"
click node_home "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Home.jsx"
click node_about "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/About.jsx"
click node_navbar "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Navbar.jsx"
click node_authui "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Login.jsx"
click node_authstate "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Hooks/useAuth.jsx"
click node_dashboard "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Dashboard.jsx"
click node_budgetform "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/AddBudget.jsx"
click node_budgetlist "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/BudgetList.jsx"
click node_expenseform "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/AddExpense.jsx"
click node_stats "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Stats.jsx"
click node_budgetstate "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Hooks/useBudget.jsx"
click node_expensestate "https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Hooks/useExpense.jsx"
click node_api "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/index.js"
click node_authroutes "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/routes/authRoutes.js"
click node_budgetroutes "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/routes/budgetRoutes.js"
click node_expenseroutes "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/routes/expenseRoutes.js"
click node_authcontroller "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/controllers/authController.js"
click node_budgetcontroller "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/controllers/budgetController.js"
click node_expensecontroller "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/controllers/expenseController.js"
click node_users "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/models/User.js"
click node_budgets "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/models/Budget.js"
click node_expenses "https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/models/Expense.js"

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_home,node_about,node_navbar,node_user toneBlue
class node_authui,node_authstate,node_mongodb toneAmber
class node_dashboard,node_budgetform,node_budgetlist,node_expenseform,node_stats,node_budgetstate,node_expensestate toneMint
class node_api,node_authroutes,node_budgetroutes,node_expenseroutes,node_authcontroller,node_budgetcontroller,node_expensecontroller toneRose
class node_users,node_budgets,node_expenses toneIndigo
```

## Components

### React application

- [App and routes](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/App.jsx): `mernFrontend2025/src/App.jsx`
- [Home and about](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Home.jsx): `mernFrontend2025/src/components/functionalComponents/Home.jsx`
- [About page](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/About.jsx): `mernFrontend2025/src/components/functionalComponents/About.jsx`
- [Navigation](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Navbar.jsx): `mernFrontend2025/src/components/functionalComponents/Navbar.jsx`

### Authentication

- [Login and signup](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Login.jsx): `mernFrontend2025/src/components/functionalComponents/Login.jsx`
- [Auth state](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Hooks/useAuth.jsx): `mernFrontend2025/src/components/functionalComponents/Hooks/useAuth.jsx`

### Budget management

- [Dashboard](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Dashboard.jsx): `mernFrontend2025/src/components/functionalComponents/Dashboard.jsx`
- [Add budget](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/AddBudget.jsx): `mernFrontend2025/src/components/functionalComponents/AddBudget.jsx`
- [Budget list](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/BudgetList.jsx): `mernFrontend2025/src/components/functionalComponents/BudgetList.jsx`
- [Add expense](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/AddExpense.jsx): `mernFrontend2025/src/components/functionalComponents/AddExpense.jsx`
- [Spending statistics](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Stats.jsx): `mernFrontend2025/src/components/functionalComponents/Stats.jsx`
- [Budget client state](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Hooks/useBudget.jsx): `mernFrontend2025/src/components/functionalComponents/Hooks/useBudget.jsx`
- [Expense client state](https://github.com/aksharaa0613/internship_project2025/blob/main/mernFrontend2025/src/components/functionalComponents/Hooks/useExpense.jsx): `mernFrontend2025/src/components/functionalComponents/Hooks/useExpense.jsx`

### API and domain

- [Express API](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/index.js): `mernBackend2025/index.js`
- [Auth routes](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/routes/authRoutes.js): `mernBackend2025/routes/authRoutes.js`
- [Budget routes](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/routes/budgetRoutes.js): `mernBackend2025/routes/budgetRoutes.js`
- [Expense routes](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/routes/expenseRoutes.js): `mernBackend2025/routes/expenseRoutes.js`
- [Auth controller](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/controllers/authController.js): `mernBackend2025/controllers/authController.js`
- [Budget controller](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/controllers/budgetController.js): `mernBackend2025/controllers/budgetController.js`
- [Expense controller](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/controllers/expenseController.js): `mernBackend2025/controllers/expenseController.js`

### MongoDB persistence

- [User records](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/models/User.js): `mernBackend2025/models/User.js`
- [Budget records](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/models/Budget.js): `mernBackend2025/models/Budget.js`
- [Expense records](https://github.com/aksharaa0613/internship_project2025/blob/main/mernBackend2025/models/Expense.js): `mernBackend2025/models/Expense.js`

### Other components

- **User**
- **MongoDB**

## Connections

- User → App and routes: uses
- App and routes → Home and about: routes to (evidence: `mernFrontend2025/src/App.jsx`)
- App and routes → About page: routes to (evidence: `mernFrontend2025/src/App.jsx`)
- App and routes → Navigation: renders (evidence: `mernFrontend2025/src/App.jsx`)
- App and routes → Login and signup: routes to (evidence: `mernFrontend2025/src/App.jsx`)
- App and routes → Dashboard: routes to (evidence: `mernFrontend2025/src/App.jsx`)
- App and routes → Add budget: routes to (evidence: `mernFrontend2025/src/App.jsx`)
- App and routes → Budget list: routes to (evidence: `mernFrontend2025/src/App.jsx`)
- App and routes → Add expense: routes to (evidence: `mernFrontend2025/src/App.jsx`)
- App and routes → Spending statistics: routes to (evidence: `mernFrontend2025/src/App.jsx`)
- Login and signup → Auth state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/Login.jsx`)
- Navigation → Auth state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/Navbar.jsx`)
- Add budget → Budget client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/AddBudget.jsx`)
- Add expense → Expense client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/AddExpense.jsx`)
- Add expense → Budget client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/AddExpense.jsx`)
- Budget list → Budget client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/BudgetList.jsx`)
- Budget list → Expense client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/BudgetList.jsx`)
- Dashboard → Budget client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/Dashboard.jsx`)
- Dashboard → Expense client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/Dashboard.jsx`)
- Dashboard → Auth state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/Dashboard.jsx`)
- Spending statistics → Budget client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/Stats.jsx`)
- Spending statistics → Expense client state: uses (evidence: `mernFrontend2025/src/components/functionalComponents/Stats.jsx`)
- Auth state → Express API: sends auth requests (evidence: `mernFrontend2025/src/components/functionalComponents/Hooks/useAuth.jsx`)
- Budget client state → Express API: sends budget requests (evidence: `mernFrontend2025/src/components/functionalComponents/Hooks/useBudget.jsx`)
- Expense client state → Express API: sends expense requests (evidence: `mernFrontend2025/src/components/functionalComponents/Hooks/useExpense.jsx`)
- Express API → Auth routes: mounts (evidence: `mernBackend2025/index.js`)
- Express API → Budget routes: mounts (evidence: `mernBackend2025/index.js`)
- Express API → Expense routes: mounts (evidence: `mernBackend2025/index.js`)
- Auth routes → Auth controller: dispatches (evidence: `mernBackend2025/routes/authRoutes.js`)
- Budget routes → Budget controller: dispatches (evidence: `mernBackend2025/routes/budgetRoutes.js`)
- Budget routes → Auth controller: protects routes (evidence: `mernBackend2025/routes/budgetRoutes.js`)
- Expense routes → Expense controller: dispatches (evidence: `mernBackend2025/routes/expenseRoutes.js`)
- Expense routes → Auth controller: protects routes (evidence: `mernBackend2025/routes/expenseRoutes.js`)
- Auth controller → User records: reads and writes (evidence: `mernBackend2025/controllers/authController.js`)
- Budget controller → Budget records: reads and writes (evidence: `mernBackend2025/controllers/budgetController.js`)
- Expense controller → Expense records: reads and writes (evidence: `mernBackend2025/controllers/expenseController.js`)
- Express API → MongoDB: connects (evidence: `mernBackend2025/index.js`)
