# rohanmogalapalli/personal_finance_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/rohanmogalapalli/personal_finance_tracker
- Repository: https://github.com/rohanmogalapalli/personal_finance_tracker

## Overview

FinTrack is a personal-finance tracker whose main workflow is recording transactions, then reviewing cashflow and category spending against budgets. The React client combines routing, screens, and request handling in one large file; the Express server exposes the API and keeps transaction, budget, and user data in memory. The README documents the dashboard, ledger, budget planner, and slide-over entry flow; the sampled source also shows report export. Several client screens share a source path because they are implemented together. Links not evidenced by the excerpts or README are omitted.

Main entry points: [`server/server.js`](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.js) (Express API), [`client/src/App.js`](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js) (App routing), [`client/src/index.js`](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/index.js) (React entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Finance client"]
  node_entry["React entry<br/>[index.js]"]
  node_app["App routing<br/>[App.js]"]
  node_ledger["Transaction ledger<br/>[App.js]"]
  node_drawer["Entry drawer<br/>[App.js]"]
end

subgraph group_server["API and state"]
  node_api["Express API<br/>[server.js]"]
  node_txstate[("Transaction state<br/>[server.js]")]
  node_budgetstate[("Budget state<br/>[server.js]")]
  node_userstate[("User state<br/>[server.js]")]
end

subgraph group_identity["Account access"]
  node_auth["Login and register<br/>[App.js]"]
end

subgraph group_insights["Financial insights"]
  node_dashboard["Dashboard analytics<br/>[App.js]"]
  node_planner["Budget planner<br/>[App.js]"]
  node_report["PDF report<br/>[App.js]"]
end

node_person(("Finance user"))

node_person -->|"opens app"| node_entry
node_entry -->|"renders"| node_app
node_person -->|"uses screens"| node_app
node_app -->|"routes to"| node_auth
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_ledger
node_app -->|"routes to"| node_planner
node_person -->|"adds entry"| node_drawer
node_drawer -->|"creates or updates"| node_api
node_ledger -->|"deletes entry"| node_api
node_dashboard -->|"loads transactions"| node_api
node_planner -->|"updates limits"| node_api
node_planner -->|"loads budgets"| node_api
node_api -->|"reads and writes"| node_txstate
node_api -->|"reads and writes"| node_budgetstate
node_api -->|"reads and writes"| node_userstate
node_api -->|"calculates category spend"| node_txstate
node_person -->|"exports report"| node_report

click node_entry "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/index.js"
click node_app "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js"
click node_auth "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js"
click node_dashboard "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js"
click node_ledger "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js"
click node_drawer "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js"
click node_planner "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js"
click node_report "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js"
click node_api "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.js"
click node_txstate "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.js"
click node_budgetstate "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.js"
click node_userstate "https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.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_entry,node_app,node_ledger,node_drawer,node_person toneBlue
class node_api,node_txstate,node_budgetstate,node_userstate toneAmber
class node_auth toneMint
class node_dashboard,node_planner,node_report toneRose
```

## Components

### Finance client

- [React entry](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/index.js): `client/src/index.js`
- [App routing](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js): `client/src/App.js`
- [Transaction ledger](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js): `client/src/App.js`
- [Entry drawer](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js): `client/src/App.js`

### API and state

- [Express API](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.js): `server/server.js`
- [Transaction state](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.js): `server/server.js`
- [Budget state](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.js): `server/server.js`
- [User state](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/server/server.js): `server/server.js`

### Account access

- [Login and register](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js): `client/src/App.js`

### Financial insights

- [Dashboard analytics](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js): `client/src/App.js`
- [Budget planner](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js): `client/src/App.js`
- [PDF report](https://github.com/rohanmogalapalli/personal_finance_tracker/blob/main/client/src/App.js): `client/src/App.js`

### Other components

- **Finance user**

## Connections

- Finance user → React entry: opens app (evidence: `client/src/index.js`)
- React entry → App routing: renders (evidence: `client/src/index.js`)
- Finance user → App routing: uses screens (evidence: `README.md`)
- App routing → Login and register: routes to (evidence: `client/src/App.js`)
- App routing → Dashboard analytics: routes to (evidence: `client/src/App.js`)
- App routing → Transaction ledger: routes to (evidence: `client/src/App.js`)
- App routing → Budget planner: routes to (evidence: `client/src/App.js`)
- Finance user → Entry drawer: adds entry (evidence: `README.md`)
- Entry drawer → Express API: creates or updates (evidence: `client/src/App.js`)
- Transaction ledger → Express API: deletes entry (evidence: `README.md`)
- Dashboard analytics → Express API: loads transactions (evidence: `README.md`)
- Budget planner → Express API: updates limits (evidence: `client/src/App.js`)
- Budget planner → Express API: loads budgets (evidence: `README.md`)
- Express API → Transaction state: reads and writes (evidence: `server/server.js`)
- Express API → Budget state: reads and writes (evidence: `server/server.js`)
- Express API → User state: reads and writes (evidence: `server/server.js`)
- Express API → Transaction state: calculates category spend (evidence: `server/server.js`)
- Finance user → PDF report: exports report (evidence: `client/src/App.js`)
