# anubothu-aravind/vendor-finance architecture

> Architecture diagram of the GitHub repository anubothu-aravind/vendor-finance, 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/anubothu-aravind/vendor-finance
- Repository: https://github.com/anubothu-aravind/vendor-finance

## Overview

Vastrams is a vendor and finance management system. Users sign in, manage vendors and bills, record payments and cheques, handle financier loans and repayments, then review ledgers, statements, and reports. The React frontend routes these workflows through an API utility to an Express backend, where controllers coordinate domain services and MongoDB models. Settings and backup workflows provide a separate administration branch. The graph follows documented capabilities and indexed imports; several route and page implementations were not sampled, so their internal relationships are not expanded.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/App.jsx) (React application), [`backend/src/controllers/settings.controller.js`](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/settings.controller.js) (Settings and restore), [`backend/src/controllers/payment.controller.js`](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/payment.controller.js) (Payment processing), [`backend/src/controllers/loan.controller.js`](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/loan.controller.js) (Loan workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_webapp["React application<br/>[App.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_vendorui["Vendor and bills<br/>[Vendors.jsx]"]
  node_paymentsui["Vendor payments<br/>[VendorPayments.jsx]"]
  node_financeui["Finance workflows<br/>[Loans.jsx]"]
  node_reportsui["Reports and ledgers<br/>[Reports.jsx]"]
  node_settingsui["Settings<br/>[Settings.jsx]"]
end

subgraph group_identity["Identity and administration"]
  node_authui["Authentication<br/>[AuthContext.jsx]"]
  node_authroutes["Auth routes<br/>[auth.routes.js]"]
  node_authcontroller["Auth service<br/>[auth.controller.js]"]
  node_userstore[("User records<br/>[User.js]")]
end

subgraph group_trade["Vendor operations"]
  node_billcontroller["Bill management<br/>[bill.controller.js]"]
  node_paymentcontroller["Payment processing"]
  node_vendorstore[("Vendor records<br/>[Vendor.js]")]
  node_billstore[("Bills<br/>[Bill.js]")]
  node_paymentstore[("Payments<br/>[Payment.js]")]
  node_chequestore[("Cheque registry<br/>[Cheque.js]")]
end

subgraph group_finance["Finance and reconciliation"]
  node_loancontroller["Loan workflows<br/>[loan.controller.js]"]
  node_financiercontroller["Financier management"]
  node_loanstore[("Loans<br/>[Loan.js]")]
  node_financierstore[("Financiers<br/>[Financier.js]")]
  node_ledger["Ledger service<br/>[ledger.service.js]"]
  node_transactionstore[("Transactions<br/>[Transaction.js]")]
  node_reportscontroller["Reports"]
end

subgraph group_platform["Backend platform"]
  node_settingscontroller["Settings and restore"]
  node_settingsstore[("Settings<br/>[Settings.js]")]
  node_server["Express API<br/>[server.js]"]
  node_events["Live event stream<br/>[sse.js]"]
end

node_user(("Staff user"))

node_user -->|"uses"| node_webapp
node_webapp -->|"provides context"| node_authui
node_webapp -.->|"routes requests"| node_api
node_api -->|"calls API"| node_server
node_webapp -->|"routes to"| node_vendorui
node_webapp -->|"routes to"| node_paymentsui
node_webapp -->|"routes to"| node_financeui
node_webapp -->|"routes to"| node_reportsui
node_webapp -->|"routes to"| node_settingsui
node_authroutes -->|"dispatches"| node_authcontroller
node_authcontroller -->|"reads and writes"| node_userstore
node_server -->|"mounts routes"| node_authroutes
node_paymentcontroller -->|"reads and writes"| node_paymentstore
node_paymentcontroller -->|"records cheques"| node_chequestore
node_paymentcontroller -->|"allocates payments"| node_billstore
node_paymentcontroller -->|"posts transactions"| node_ledger
node_ledger -->|"updates balances"| node_vendorstore
node_ledger -->|"updates balances"| node_financierstore
node_ledger -->|"records entries"| node_transactionstore
node_loancontroller -->|"reads and writes"| node_loanstore
node_loancontroller -->|"loads financier"| node_financierstore
node_loancontroller -->|"links cheque"| node_chequestore
node_loancontroller -->|"posts repayments"| node_ledger
node_billcontroller -.->|"manages bills"| node_billstore
node_financiercontroller -.->|"manages records"| node_financierstore
node_reportscontroller -.->|"queries history"| node_transactionstore
node_settingscontroller -->|"reads and writes"| node_settingsstore
node_settingscontroller -->|"restores vendors"| node_vendorstore
node_settingscontroller -->|"restores loans"| node_loanstore
node_settingscontroller -->|"restores bills"| node_billstore
node_settingscontroller -->|"restores payments"| node_paymentstore
node_settingscontroller -->|"restores cheques"| node_chequestore
node_server -->|"serves events"| node_events
node_paymentcontroller -->|"broadcasts updates"| node_events
node_loancontroller -->|"broadcasts updates"| node_events

click node_webapp "https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/App.jsx"
click node_api "https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/utils/api.js"
click node_vendorui "https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/Vendors.jsx"
click node_paymentsui "https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/VendorPayments.jsx"
click node_financeui "https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/Loans.jsx"
click node_reportsui "https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/Reports.jsx"
click node_settingsui "https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/Settings.jsx"
click node_authui "https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/hooks/AuthContext.jsx"
click node_authroutes "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/routes/auth.routes.js"
click node_authcontroller "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/auth.controller.js"
click node_userstore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/User.js"
click node_billcontroller "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/bill.controller.js"
click node_paymentcontroller "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/payment.controller.js"
click node_vendorstore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Vendor.js"
click node_billstore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Bill.js"
click node_paymentstore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Payment.js"
click node_chequestore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Cheque.js"
click node_loancontroller "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/loan.controller.js"
click node_financiercontroller "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/financier.controller.js"
click node_loanstore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Loan.js"
click node_financierstore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Financier.js"
click node_ledger "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/services/ledger.service.js"
click node_transactionstore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Transaction.js"
click node_reportscontroller "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/reports.controller.js"
click node_settingscontroller "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/settings.controller.js"
click node_settingsstore "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Settings.js"
click node_server "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/server.js"
click node_events "https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/utils/sse.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_webapp,node_api,node_vendorui,node_paymentsui,node_financeui,node_reportsui,node_settingsui,node_user toneBlue
class node_authui,node_authroutes,node_authcontroller,node_userstore toneAmber
class node_billcontroller,node_paymentcontroller,node_vendorstore,node_billstore,node_paymentstore,node_chequestore toneMint
class node_loancontroller,node_financiercontroller,node_loanstore,node_financierstore,node_ledger,node_transactionstore,node_reportscontroller toneRose
class node_settingscontroller,node_settingsstore,node_server,node_events toneIndigo
```

## Components

### Web application

- [React application](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [API client](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/utils/api.js): `Frontend/src/utils/api.js`
- [Vendor and bills](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/Vendors.jsx): `Frontend/src/pages/Vendors.jsx`
- [Vendor payments](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/VendorPayments.jsx): `Frontend/src/pages/VendorPayments.jsx`
- [Finance workflows](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/Loans.jsx): `Frontend/src/pages/Loans.jsx`
- [Reports and ledgers](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/Reports.jsx): `Frontend/src/pages/Reports.jsx`
- [Settings](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/pages/Settings.jsx): `Frontend/src/pages/Settings.jsx`

### Identity and administration

- [Authentication](https://github.com/anubothu-aravind/vendor-finance/blob/main/Frontend/src/hooks/AuthContext.jsx): `Frontend/src/hooks/AuthContext.jsx`
- [Auth routes](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/routes/auth.routes.js): `backend/src/routes/auth.routes.js`
- [Auth service](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [User records](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/User.js): `backend/src/models/User.js`

### Vendor operations

- [Bill management](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/bill.controller.js): `backend/src/controllers/bill.controller.js`
- [Payment processing](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/payment.controller.js): `backend/src/controllers/payment.controller.js`
- [Vendor records](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Vendor.js): `backend/src/models/Vendor.js`
- [Bills](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Bill.js): `backend/src/models/Bill.js`
- [Payments](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Payment.js): `backend/src/models/Payment.js`
- [Cheque registry](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Cheque.js): `backend/src/models/Cheque.js`

### Finance and reconciliation

- [Loan workflows](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/loan.controller.js): `backend/src/controllers/loan.controller.js`
- [Financier management](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/financier.controller.js): `backend/src/controllers/financier.controller.js`
- [Loans](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Loan.js): `backend/src/models/Loan.js`
- [Financiers](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Financier.js): `backend/src/models/Financier.js`
- [Ledger service](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/services/ledger.service.js): `backend/src/services/ledger.service.js`
- [Transactions](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Transaction.js): `backend/src/models/Transaction.js`
- [Reports](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/reports.controller.js): `backend/src/controllers/reports.controller.js`

### Backend platform

- [Settings and restore](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/controllers/settings.controller.js): `backend/src/controllers/settings.controller.js`
- [Settings](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/models/Settings.js): `backend/src/models/Settings.js`
- [Express API](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/server.js): `backend/src/server.js`
- [Live event stream](https://github.com/anubothu-aravind/vendor-finance/blob/main/backend/src/utils/sse.js): `backend/src/utils/sse.js`

### Other components

- **Staff user**

## Connections

- Staff user → React application: uses (evidence: `README.md`)
- React application → Authentication: provides context (evidence: `Frontend/src/App.jsx`)
- React application → API client: routes requests
- API client → Express API: calls API (evidence: `README.md`)
- React application → Vendor and bills: routes to
- React application → Vendor payments: routes to
- React application → Finance workflows: routes to
- React application → Reports and ledgers: routes to
- React application → Settings: routes to
- Auth routes → Auth service: dispatches (evidence: `backend/src/routes/auth.routes.js`)
- Auth service → User records: reads and writes (evidence: `backend/src/controllers/auth.controller.js`)
- Express API → Auth routes: mounts routes (evidence: `backend/src/server.js`)
- Payment processing → Payments: reads and writes (evidence: `backend/src/controllers/payment.controller.js`)
- Payment processing → Cheque registry: records cheques (evidence: `backend/src/controllers/payment.controller.js`)
- Payment processing → Bills: allocates payments (evidence: `backend/src/controllers/payment.controller.js`)
- Payment processing → Ledger service: posts transactions (evidence: `backend/src/controllers/payment.controller.js`)
- Ledger service → Vendor records: updates balances (evidence: `backend/src/services/ledger.service.js`)
- Ledger service → Financiers: updates balances (evidence: `backend/src/services/ledger.service.js`)
- Ledger service → Transactions: records entries (evidence: `backend/src/services/ledger.service.js`)
- Loan workflows → Loans: reads and writes (evidence: `backend/src/controllers/loan.controller.js`)
- Loan workflows → Financiers: loads financier (evidence: `backend/src/controllers/loan.controller.js`)
- Loan workflows → Cheque registry: links cheque (evidence: `backend/src/controllers/loan.controller.js`)
- Loan workflows → Ledger service: posts repayments (evidence: `backend/src/controllers/loan.controller.js`)
- Bill management → Bills: manages bills
- Financier management → Financiers: manages records
- Reports → Transactions: queries history
- Settings and restore → Settings: reads and writes (evidence: `backend/src/controllers/settings.controller.js`)
- Settings and restore → Vendor records: restores vendors (evidence: `backend/src/controllers/settings.controller.js`)
- Settings and restore → Loans: restores loans (evidence: `backend/src/controllers/settings.controller.js`)
- Settings and restore → Bills: restores bills (evidence: `backend/src/controllers/settings.controller.js`)
- Settings and restore → Payments: restores payments (evidence: `backend/src/controllers/settings.controller.js`)
- Settings and restore → Cheque registry: restores cheques (evidence: `backend/src/controllers/settings.controller.js`)
- Express API → Live event stream: serves events (evidence: `backend/src/server.js`)
- Payment processing → Live event stream: broadcasts updates (evidence: `backend/src/controllers/payment.controller.js`)
- Loan workflows → Live event stream: broadcasts updates (evidence: `backend/src/controllers/loan.controller.js`)
