# zi-tasin/personalized-finance-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/zi-tasin/personalized-finance-tracker
- Repository: https://github.com/zi-tasin/personalized-finance-tracker

## Overview

Personalized Finance Tracker is a React/Express personal-finance app: users register or sign in, then manage user-scoped income, expenses, and monthly budgets and review dashboard summaries. The client pages call the REST API through a shared Axios client; Express routes dispatch to controllers, which use Mongoose models. Major documented capabilities also include Excel exports and optional profile-image uploads. Several UI branches are documented or indexed but not excerpted, so their internal wiring is shown only where evidence supports it.

Main entry points: [`server/server.js`](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/server.js) (Express app), [`client/src/App.jsx`](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/App.jsx) (Route shell), [`client/src/pages/Dashboard/Expense.jsx`](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/Expense.jsx) (Expense page), [`server/middleware/authMiddleware.js`](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/middleware/authMiddleware.js) (JWT guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route shell<br/>[App.jsx]"]
  node_signup["Sign up<br/>[SignUp.jsx]"]
  node_incomeui["Income page<br/>[income.jsx]"]
  node_expenseui["Expense page<br/>[Expense.jsx]"]
  node_budgetui["Budget page<br/>[Budget.jsx]"]
  node_home["Dashboard<br/>[Home.jsx]"]
  node_dlayout["Dashboard layout"]
  node_authlayout["Auth layout<br/>[AuthLayout.jsx]"]
  node_inputs["Form inputs<br/>[input.jsx]"]
  node_modals["Modal UI<br/>[Modals.jsx]"]
  node_userctx["User state<br/>[userContext.jsx]"]
  node_authhook["Session check<br/>[useUserAuth.jsx]"]
  node_apihelper["API paths<br/>[apiPaths.js]"]
  node_http["HTTP client<br/>[axiosInstance.js]"]
end

subgraph group_api["REST API"]
  node_express["Express app<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_incomeroutes["Income routes<br/>[incomeRoutes.js]"]
  node_expenseroutes["Expense routes<br/>[expenseRoutes.js]"]
  node_dashroutes["Dashboard routes<br/>[dashboardRoutes.js]"]
  node_budgetroutes["Budget routes<br/>[budgetRoutes.js]"]
end

subgraph group_records["Finance records"]
  node_incomectl["Income controller"]
  node_incomedb[("Income records<br/>[Income.js]")]
  node_expensectl["Expense controller"]
  node_expensedb[("Expense records<br/>[Expense.js]")]
  node_dashctl["Dashboard totals"]
  node_budgetctl["Budget controller"]
  node_budgetdb[("Budget records<br/>[Budget.js]")]
end

subgraph group_identity["Identity and profile"]
  node_authctl["Account controller<br/>[authController.js]"]
  node_guard["JWT guard<br/>[authMiddleware.js]"]
  node_userdb[("User records<br/>[User.js]")]
  node_upload["Image upload"]
end

node_person(("Finance user"))
node_mongo[("MongoDB")]

node_person -->|"uses"| node_app
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_incomeui
node_app -->|"routes to"| node_expenseui
node_app -->|"routes to"| node_budgetui
node_signup -->|"renders"| node_authlayout
node_signup -->|"uses"| node_inputs
node_expenseui -->|"renders"| node_dlayout
node_expenseui -->|"checks session"| node_authhook
node_expenseui -->|"renders"| node_modals
node_incomeui -->|"renders"| node_dlayout
node_budgetui -->|"renders"| node_dlayout
node_home -->|"renders"| node_dlayout
node_authhook -->|"updates state"| node_userctx
node_authhook -->|"fetches user"| node_http
node_signup -->|"submits account"| node_http
node_expenseui -->|"manages expenses"| node_http
node_expenseui -->|"checks threshold"| node_budgetui
node_http -->|"uses base URL"| node_apihelper
node_http -->|"sends API requests"| node_express
node_express -->|"mounts"| node_authroutes
node_express -->|"mounts"| node_incomeroutes
node_express -->|"mounts"| node_expenseroutes
node_express -->|"mounts"| node_dashroutes
node_express -->|"mounts"| node_budgetroutes
node_authroutes -->|"dispatches"| node_authctl
node_incomeroutes -->|"dispatches"| node_incomectl
node_expenseroutes -->|"dispatches"| node_expensectl
node_dashroutes -->|"dispatches"| node_dashctl
node_budgetroutes -->|"dispatches"| node_budgetctl
node_authroutes -->|"protects routes"| node_guard
node_incomeroutes -->|"protects routes"| node_guard
node_expenseroutes -->|"protects routes"| node_guard
node_dashroutes -->|"protects routes"| node_guard
node_budgetroutes -->|"protects routes"| node_guard
node_authctl -->|"reads/writes"| node_userdb
node_guard -->|"loads user"| node_userdb
node_incomectl -->|"reads/writes"| node_incomedb
node_expensectl -->|"reads/writes"| node_expensedb
node_dashctl -->|"aggregates"| node_incomedb
node_dashctl -->|"aggregates"| node_expensedb
node_budgetctl -->|"reads/writes"| node_budgetdb
node_budgetctl -->|"totals spending"| node_expensedb
node_express -->|"connects"| node_mongo
node_authroutes -->|"accepts images"| node_upload
node_person -.->|"records income"| node_incomeui
node_person -.->|"sets budgets"| node_budgetui

click node_app "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/App.jsx"
click node_signup "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Auth/SignUp.jsx"
click node_incomeui "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/income.jsx"
click node_expenseui "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/Expense.jsx"
click node_budgetui "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/Budget.jsx"
click node_home "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/Home.jsx"
click node_dlayout "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/components/layouts/DashboardLayout.jsx"
click node_authlayout "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/components/layouts/AuthLayout.jsx"
click node_inputs "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/components/Inputs/input.jsx"
click node_modals "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/components/Modals.jsx"
click node_userctx "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/context/userContext.jsx"
click node_authhook "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/hooks/useUserAuth.jsx"
click node_apihelper "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/utils/apiPaths.js"
click node_http "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/utils/axiosInstance.js"
click node_express "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/server.js"
click node_authroutes "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/authRoutes.js"
click node_incomeroutes "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/incomeRoutes.js"
click node_expenseroutes "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/expenseRoutes.js"
click node_dashroutes "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/dashboardRoutes.js"
click node_budgetroutes "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/budgetRoutes.js"
click node_authctl "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/authController.js"
click node_guard "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/middleware/authMiddleware.js"
click node_userdb "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/models/User.js"
click node_incomectl "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/incomeController.js"
click node_incomedb "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/models/Income.js"
click node_expensectl "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/expenseController.js"
click node_expensedb "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/models/Expense.js"
click node_dashctl "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/dashboardController.js"
click node_budgetctl "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/budgetController.js"
click node_budgetdb "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/models/Budget.js"
click node_upload "https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/middleware/uploadMiddleware.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_signup,node_incomeui,node_expenseui,node_budgetui,node_home,node_dlayout,node_authlayout,node_inputs,node_modals,node_userctx,node_authhook,node_apihelper,node_http,node_person toneBlue
class node_express,node_authroutes,node_incomeroutes,node_expenseroutes,node_dashroutes,node_budgetroutes,node_mongo toneAmber
class node_incomectl,node_incomedb,node_expensectl,node_expensedb,node_dashctl,node_budgetctl,node_budgetdb toneMint
class node_authctl,node_guard,node_userdb,node_upload toneRose
```

## Components

### React client

- [Route shell](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign up](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Auth/SignUp.jsx): `client/src/pages/Auth/SignUp.jsx`
- [Income page](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/income.jsx): `client/src/pages/Dashboard/income.jsx`
- [Expense page](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/Expense.jsx): `client/src/pages/Dashboard/Expense.jsx`
- [Budget page](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/Budget.jsx): `client/src/pages/Dashboard/Budget.jsx`
- [Dashboard](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/pages/Dashboard/Home.jsx): `client/src/pages/Dashboard/Home.jsx`
- [Dashboard layout](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/components/layouts/DashboardLayout.jsx): `client/src/components/layouts/DashboardLayout.jsx`
- [Auth layout](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/components/layouts/AuthLayout.jsx): `client/src/components/layouts/AuthLayout.jsx`
- [Form inputs](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/components/Inputs/input.jsx): `client/src/components/Inputs/input.jsx`
- [Modal UI](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/components/Modals.jsx): `client/src/components/Modals.jsx`
- [User state](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/context/userContext.jsx): `client/src/context/userContext.jsx`
- [Session check](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/hooks/useUserAuth.jsx): `client/src/hooks/useUserAuth.jsx`
- [API paths](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/utils/apiPaths.js): `client/src/utils/apiPaths.js`
- [HTTP client](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/client/src/utils/axiosInstance.js): `client/src/utils/axiosInstance.js`

### REST API

- [Express app](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/server.js): `server/server.js`
- [Auth routes](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Income routes](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/incomeRoutes.js): `server/routes/incomeRoutes.js`
- [Expense routes](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/expenseRoutes.js): `server/routes/expenseRoutes.js`
- [Dashboard routes](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/dashboardRoutes.js): `server/routes/dashboardRoutes.js`
- [Budget routes](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/routes/budgetRoutes.js): `server/routes/budgetRoutes.js`

### Finance records

- [Income controller](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/incomeController.js): `server/controllers/incomeController.js`
- [Income records](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/models/Income.js): `server/models/Income.js`
- [Expense controller](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/expenseController.js): `server/controllers/expenseController.js`
- [Expense records](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/models/Expense.js): `server/models/Expense.js`
- [Dashboard totals](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/dashboardController.js): `server/controllers/dashboardController.js`
- [Budget controller](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/budgetController.js): `server/controllers/budgetController.js`
- [Budget records](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/models/Budget.js): `server/models/Budget.js`

### Identity and profile

- [Account controller](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [JWT guard](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [User records](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/models/User.js): `server/models/User.js`
- [Image upload](https://github.com/zi-tasin/personalized-finance-tracker/blob/main/server/middleware/uploadMiddleware.js): `server/middleware/uploadMiddleware.js`

### Other components

- **Finance user**
- **MongoDB**

## Connections

- Finance user → Route shell: uses
- Route shell → Sign up: routes to (evidence: `client/src/App.jsx`)
- Route shell → Dashboard: routes to (evidence: `client/src/App.jsx`)
- Route shell → Income page: routes to (evidence: `client/src/App.jsx`)
- Route shell → Expense page: routes to (evidence: `client/src/App.jsx`)
- Route shell → Budget page: routes to (evidence: `client/src/App.jsx`)
- Sign up → Auth layout: renders (evidence: `client/src/pages/Auth/SignUp.jsx`)
- Sign up → Form inputs: uses (evidence: `client/src/pages/Auth/SignUp.jsx`)
- Expense page → Dashboard layout: renders (evidence: `client/src/pages/Dashboard/Expense.jsx`)
- Expense page → Session check: checks session (evidence: `client/src/pages/Dashboard/Expense.jsx`)
- Expense page → Modal UI: renders (evidence: `client/src/pages/Dashboard/Expense.jsx`)
- Income page → Dashboard layout: renders
- Budget page → Dashboard layout: renders (evidence: `client/src/pages/Dashboard/Budget.jsx`)
- Dashboard → Dashboard layout: renders (evidence: `client/src/pages/Dashboard/Home.jsx`)
- Session check → User state: updates state (evidence: `client/src/hooks/useUserAuth.jsx`)
- Session check → HTTP client: fetches user (evidence: `client/src/hooks/useUserAuth.jsx`)
- Sign up → HTTP client: submits account (evidence: `client/src/pages/Auth/SignUp.jsx`)
- Expense page → HTTP client: manages expenses (evidence: `client/src/pages/Dashboard/Expense.jsx`)
- Expense page → Budget page: checks threshold (evidence: `client/src/pages/Dashboard/Expense.jsx`)
- HTTP client → API paths: uses base URL (evidence: `client/src/utils/axiosInstance.js`)
- HTTP client → Express app: sends API requests
- Express app → Auth routes: mounts (evidence: `server/server.js`)
- Express app → Income routes: mounts (evidence: `server/server.js`)
- Express app → Expense routes: mounts (evidence: `server/server.js`)
- Express app → Dashboard routes: mounts (evidence: `server/server.js`)
- Express app → Budget routes: mounts (evidence: `server/server.js`)
- Auth routes → Account controller: dispatches (evidence: `server/routes/authRoutes.js`)
- Income routes → Income controller: dispatches (evidence: `server/routes/incomeRoutes.js`)
- Expense routes → Expense controller: dispatches (evidence: `server/routes/expenseRoutes.js`)
- Dashboard routes → Dashboard totals: dispatches (evidence: `server/routes/dashboardRoutes.js`)
- Budget routes → Budget controller: dispatches (evidence: `server/routes/budgetRoutes.js`)
- Auth routes → JWT guard: protects routes (evidence: `server/routes/authRoutes.js`)
- Income routes → JWT guard: protects routes (evidence: `server/routes/incomeRoutes.js`)
- Expense routes → JWT guard: protects routes (evidence: `server/routes/expenseRoutes.js`)
- Dashboard routes → JWT guard: protects routes (evidence: `server/routes/dashboardRoutes.js`)
- Budget routes → JWT guard: protects routes (evidence: `server/routes/budgetRoutes.js`)
- Account controller → User records: reads/writes (evidence: `server/controllers/authController.js`)
- JWT guard → User records: loads user (evidence: `server/middleware/authMiddleware.js`)
- Income controller → Income records: reads/writes (evidence: `server/controllers/incomeController.js`)
- Expense controller → Expense records: reads/writes (evidence: `server/controllers/expenseController.js`)
- Dashboard totals → Income records: aggregates (evidence: `server/controllers/dashboardController.js`)
- Dashboard totals → Expense records: aggregates (evidence: `server/controllers/dashboardController.js`)
- Budget controller → Budget records: reads/writes (evidence: `server/controllers/budgetController.js`)
- Budget controller → Expense records: totals spending (evidence: `server/controllers/budgetController.js`)
- Express app → MongoDB: connects
- Auth routes → Image upload: accepts images (evidence: `server/routes/authRoutes.js`)
- Finance user → Income page: records income
- Finance user → Budget page: sets budgets
