# venkatasaieeshreddy005/bank-backend architecture

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

- Interactive diagram: https://gitdiagram.com/venkatasaieeshreddy005/bank-backend
- Repository: https://github.com/venkatasaieeshreddy005/bank-backend

## Overview

Vaulta is a banking and bill-splitting application: users authenticate, manage accounts and friends, transfer funds, pay bills, and track transactions. The React frontend routes users through these workflows and calls an Express API; backend controllers coordinate account, bill, split-bill, and transaction operations. The sampled escrow service performs ledger-backed fund movements. The graph preserves major documented UI and API capabilities, but some controller and page implementations were not sampled, so their internal calls are not asserted.

Main entry points: [`bank-frontend/src/App.jsx`](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/App.jsx) (React app routes), [`src/middleware/auth.js`](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/middleware/auth.js) (Authentication middleware), [`src/app.js`](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/app.js) (Express API), [`bank-frontend/src/services/api.js`](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/services/api.js) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Banking frontend"]
  node_app["React app routes<br/>[App.jsx]"]
  node_authui["Session context<br/>[AuthContext.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_accountsui["Accounts and transfers<br/>[Transfer.jsx]"]
  node_billsui["Bills<br/>[MyBills.jsx]"]
  node_splitui["Split bills<br/>[SplitBill.jsx]"]
  node_friendsui["Friends<br/>[Friends.jsx]"]
  node_transactionsui["Transactions<br/>[Transactions.jsx]"]
  node_http["HTTP client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_express["Express API<br/>[app.js]"]
  node_authroute["Authentication routes<br/>[auth.js]"]
  node_accountroute["Account routes<br/>[account.js]"]
  node_transactionroute["Transaction routes<br/>[transaction.js]"]
  node_billroute["Bill routes<br/>[billRoutes.js]"]
  node_friendroute["Friend routes<br/>[friendRoutes.js]"]
  node_splitroute["Split-bill routes<br/>[splitBillRoutes.js]"]
  node_authmw["Authentication middleware<br/>[auth.js]"]
end

subgraph group_domains["Banking workflows"]
  node_authctrl["Authentication workflow<br/>[auth.js]"]
  node_accountctrl["Account workflow<br/>[account.js]"]
  node_transactionctrl["Transaction workflow<br/>[transaction.js]"]
  node_billctrl["Bill workflow<br/>[billController.js]"]
  node_friendctrl["Friend workflow"]
  node_splitctrl["Split-bill workflow"]
end

subgraph group_data["Persistence and transfers"]
  node_escrow["Escrow transfers<br/>[escrowTransfer.js]"]
  node_accounts[("Accounts<br/>[account.js]")]
  node_ledger[("Ledger entries<br/>[ledger.js]")]
  node_transactions[("Transaction records<br/>[transaction.js]")]
  node_bills[("Bills<br/>[billModel.js]")]
  node_splitmodels[("Split records<br/>[splitBillModel.js]")]
  node_participants[("Split participants")]
  node_friends[("Friend links<br/>[friendModel.js]")]
  node_users[("User records<br/>[user.js]")]
  node_blacklist[("Token blacklist<br/>[blacklist.js]")]
end

node_user(("Bank user"))

node_user -->|"uses"| node_app
node_app -->|"provides context"| node_authui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_accountsui
node_app -->|"routes to"| node_billsui
node_app -->|"routes to"| node_splitui
node_app -->|"routes to"| node_friendsui
node_app -->|"routes to"| node_transactionsui
node_authui -->|"calls"| node_http
node_dashboard -->|"calls"| node_http
node_billsui -->|"calls"| node_http
node_splitui -->|"calls"| node_http
node_friendsui -->|"calls"| node_http
node_transactionsui -->|"calls"| node_http
node_http -.->|"requests"| node_express
node_express -->|"mounts"| node_authroute
node_express -->|"mounts"| node_accountroute
node_express -->|"mounts"| node_transactionroute
node_express -->|"mounts"| node_billroute
node_express -->|"mounts"| node_friendroute
node_express -->|"mounts"| node_splitroute
node_authroute -->|"uses"| node_authmw
node_authroute -->|"dispatches"| node_authctrl
node_accountroute -.->|"uses"| node_authmw
node_accountroute -.->|"dispatches"| node_accountctrl
node_transactionroute -->|"uses"| node_authmw
node_transactionroute -->|"dispatches"| node_transactionctrl
node_billroute -->|"uses"| node_authmw
node_billroute -.->|"dispatches"| node_billctrl
node_friendroute -->|"uses"| node_authmw
node_friendroute -->|"dispatches"| node_friendctrl
node_splitroute -->|"uses"| node_authmw
node_splitroute -->|"dispatches"| node_splitctrl
node_authmw -->|"loads user"| node_users
node_authmw -->|"checks token"| node_blacklist
node_authctrl -->|"uses"| node_users
node_authctrl -->|"uses"| node_blacklist
node_authctrl -.->|"sends email"| node_user
node_friendctrl -->|"uses"| node_friends
node_friendctrl -->|"uses"| node_users
node_billctrl -->|"reads and writes"| node_bills
node_billctrl -->|"reads"| node_accounts
node_billctrl -->|"moves funds"| node_escrow
node_billctrl -->|"delegates split payment"| node_splitctrl
node_splitctrl -->|"reads and writes"| node_splitmodels
node_splitctrl -->|"reads and writes"| node_participants
node_splitctrl -->|"reads and writes"| node_bills
node_splitctrl -->|"validates friends"| node_friends

click node_app "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/App.jsx"
click node_authui "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/context/AuthContext.jsx"
click node_dashboard "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/Dashboard.jsx"
click node_accountsui "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/Transfer.jsx"
click node_billsui "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/MyBills.jsx"
click node_splitui "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/SplitBill.jsx"
click node_friendsui "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/Friends.jsx"
click node_transactionsui "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/Transactions.jsx"
click node_http "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/services/api.js"
click node_express "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/app.js"
click node_authroute "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/auth.js"
click node_accountroute "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/account.js"
click node_transactionroute "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/transaction.js"
click node_billroute "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/billRoutes.js"
click node_friendroute "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/friendRoutes.js"
click node_splitroute "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/splitBillRoutes.js"
click node_authmw "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/middleware/auth.js"
click node_authctrl "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/auth.js"
click node_accountctrl "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/account.js"
click node_transactionctrl "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/transaction.js"
click node_billctrl "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/billController.js"
click node_friendctrl "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/friendController.js"
click node_splitctrl "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/splitBillController.js"
click node_escrow "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/services/escrowTransfer.js"
click node_accounts "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/account.js"
click node_ledger "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/ledger.js"
click node_transactions "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/transaction.js"
click node_bills "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/billModel.js"
click node_splitmodels "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/splitBillModel.js"
click node_participants "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/splitParticipantModel.js"
click node_friends "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/friendModel.js"
click node_users "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/user.js"
click node_blacklist "https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/blacklist.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_authui,node_dashboard,node_accountsui,node_billsui,node_splitui,node_friendsui,node_transactionsui,node_http,node_user toneBlue
class node_express,node_authroute,node_accountroute,node_transactionroute,node_billroute,node_friendroute,node_splitroute,node_authmw toneAmber
class node_authctrl,node_accountctrl,node_transactionctrl,node_billctrl,node_friendctrl,node_splitctrl toneMint
class node_escrow,node_accounts,node_ledger,node_transactions,node_bills,node_splitmodels,node_participants,node_friends,node_users,node_blacklist toneRose
```

## Components

### Banking frontend

- [React app routes](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/App.jsx): `bank-frontend/src/App.jsx`
- [Session context](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/context/AuthContext.jsx): `bank-frontend/src/context/AuthContext.jsx`
- [Dashboard](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/Dashboard.jsx): `bank-frontend/src/pages/Dashboard.jsx`
- [Accounts and transfers](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/Transfer.jsx): `bank-frontend/src/pages/Transfer.jsx`
- [Bills](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/MyBills.jsx): `bank-frontend/src/pages/MyBills.jsx`
- [Split bills](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/SplitBill.jsx): `bank-frontend/src/pages/SplitBill.jsx`
- [Friends](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/Friends.jsx): `bank-frontend/src/pages/Friends.jsx`
- [Transactions](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/pages/Transactions.jsx): `bank-frontend/src/pages/Transactions.jsx`
- [HTTP client](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/bank-frontend/src/services/api.js): `bank-frontend/src/services/api.js`

### API and access

- [Express API](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/app.js): `src/app.js`
- [Authentication routes](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/auth.js): `src/routes/auth.js`
- [Account routes](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/account.js): `src/routes/account.js`
- [Transaction routes](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/transaction.js): `src/routes/transaction.js`
- [Bill routes](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/billRoutes.js): `src/routes/billRoutes.js`
- [Friend routes](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/friendRoutes.js): `src/routes/friendRoutes.js`
- [Split-bill routes](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/routes/splitBillRoutes.js): `src/routes/splitBillRoutes.js`
- [Authentication middleware](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/middleware/auth.js): `src/middleware/auth.js`

### Banking workflows

- [Authentication workflow](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/auth.js): `src/controller/auth.js`
- [Account workflow](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/account.js): `src/controller/account.js`
- [Transaction workflow](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/transaction.js): `src/controller/transaction.js`
- [Bill workflow](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/billController.js): `src/controller/billController.js`
- [Friend workflow](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/friendController.js): `src/controller/friendController.js`
- [Split-bill workflow](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/controller/splitBillController.js): `src/controller/splitBillController.js`

### Persistence and transfers

- [Escrow transfers](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/services/escrowTransfer.js): `src/services/escrowTransfer.js`
- [Accounts](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/account.js): `src/models/account.js`
- [Ledger entries](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/ledger.js): `src/models/ledger.js`
- [Transaction records](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/transaction.js): `src/models/transaction.js`
- [Bills](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/billModel.js): `src/models/billModel.js`
- [Split records](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/splitBillModel.js): `src/models/splitBillModel.js`
- [Split participants](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/splitParticipantModel.js): `src/models/splitParticipantModel.js`
- [Friend links](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/friendModel.js): `src/models/friendModel.js`
- [User records](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/user.js): `src/models/user.js`
- [Token blacklist](https://github.com/venkatasaieeshreddy005/bank-backend/blob/main/src/models/blacklist.js): `src/models/blacklist.js`

### Other components

- **Bank user**

## Connections

- Bank user → React app routes: uses (evidence: `bank-frontend/src/App.jsx`)
- React app routes → Session context: provides context (evidence: `bank-frontend/src/App.jsx`)
- React app routes → Dashboard: routes to (evidence: `bank-frontend/src/App.jsx`)
- React app routes → Accounts and transfers: routes to (evidence: `bank-frontend/src/App.jsx`)
- React app routes → Bills: routes to (evidence: `bank-frontend/src/App.jsx`)
- React app routes → Split bills: routes to (evidence: `bank-frontend/src/App.jsx`)
- React app routes → Friends: routes to (evidence: `bank-frontend/src/App.jsx`)
- React app routes → Transactions: routes to (evidence: `bank-frontend/src/App.jsx`)
- Session context → HTTP client: calls (evidence: `bank-frontend/src/context/AuthContext.jsx`)
- Dashboard → HTTP client: calls (evidence: `bank-frontend/src/pages/Dashboard.jsx`)
- Bills → HTTP client: calls (evidence: `bank-frontend/src/pages/MyBills.jsx`)
- Split bills → HTTP client: calls (evidence: `bank-frontend/src/pages/SplitBill.jsx`)
- Friends → HTTP client: calls (evidence: `bank-frontend/src/pages/Friends.jsx`)
- Transactions → HTTP client: calls (evidence: `bank-frontend/src/pages/Transactions.jsx`)
- HTTP client → Express API: requests
- Express API → Authentication routes: mounts (evidence: `src/app.js`)
- Express API → Account routes: mounts (evidence: `src/app.js`)
- Express API → Transaction routes: mounts (evidence: `src/app.js`)
- Express API → Bill routes: mounts (evidence: `src/app.js`)
- Express API → Friend routes: mounts (evidence: `src/app.js`)
- Express API → Split-bill routes: mounts (evidence: `src/app.js`)
- Authentication routes → Authentication middleware: uses (evidence: `src/routes/auth.js`)
- Authentication routes → Authentication workflow: dispatches (evidence: `src/routes/auth.js`)
- Account routes → Authentication middleware: uses
- Account routes → Account workflow: dispatches
- Transaction routes → Authentication middleware: uses (evidence: `src/routes/transaction.js`)
- Transaction routes → Transaction workflow: dispatches (evidence: `src/routes/transaction.js`)
- Bill routes → Authentication middleware: uses (evidence: `src/routes/billRoutes.js`)
- Bill routes → Bill workflow: dispatches (evidence: `src/routes/billRoutes.js`)
- Friend routes → Authentication middleware: uses (evidence: `src/routes/friendRoutes.js`)
- Friend routes → Friend workflow: dispatches (evidence: `src/routes/friendRoutes.js`)
- Split-bill routes → Authentication middleware: uses (evidence: `src/routes/splitBillRoutes.js`)
- Split-bill routes → Split-bill workflow: dispatches (evidence: `src/routes/splitBillRoutes.js`)
- Authentication middleware → User records: loads user (evidence: `src/middleware/auth.js`)
- Authentication middleware → Token blacklist: checks token (evidence: `src/middleware/auth.js`)
- Authentication workflow → User records: uses (evidence: `src/controller/auth.js`)
- Authentication workflow → Token blacklist: uses (evidence: `src/controller/auth.js`)
- Authentication workflow → Bank user: sends email
- Friend workflow → Friend links: uses (evidence: `src/controller/friendController.js`)
- Friend workflow → User records: uses (evidence: `src/controller/friendController.js`)
- Bill workflow → Bills: reads and writes (evidence: `src/controller/billController.js`)
- Bill workflow → Accounts: reads (evidence: `src/controller/billController.js`)
- Bill workflow → Escrow transfers: moves funds (evidence: `src/controller/billController.js`)
- Bill workflow → Split-bill workflow: delegates split payment (evidence: `src/controller/billController.js`)
- Split-bill workflow → Split records: reads and writes (evidence: `src/controller/splitBillController.js`)
- Split-bill workflow → Split participants: reads and writes (evidence: `src/controller/splitBillController.js`)
- Split-bill workflow → Bills: reads and writes (evidence: `src/controller/splitBillController.js`)
- Split-bill workflow → Friend links: validates friends (evidence: `src/controller/splitBillController.js`)
