How anubothu-aravind/vendor-finance works
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: App.jsx React application · settings.controller.js Settings and restore · payment.controller.js Payment processing · loan.controller.js Loan workflows
Components 29
Web application
- React application
Frontend/src/App.jsx - API client
Frontend/src/utils/api.js - Vendor and bills
Frontend/src/pages/Vendors.jsx - Vendor payments
Frontend/src/pages/VendorPayments.jsx - Finance workflows
Frontend/src/pages/Loans.jsx - Reports and ledgers
Frontend/src/pages/Reports.jsx - Settings
Frontend/src/pages/Settings.jsx
Identity and administration
- Authentication
Frontend/src/hooks/AuthContext.jsx - Auth routes
backend/src/routes/auth.routes.js - Auth service
backend/src/controllers/auth.controller.js - User records
backend/src/models/User.js
Vendor operations
- Bill management
backend/src/controllers/bill.controller.js - Payment processing
backend/src/controllers/payment.controller.js - Vendor records
backend/src/models/Vendor.js - Bills
backend/src/models/Bill.js - Payments
backend/src/models/Payment.js - Cheque registry
backend/src/models/Cheque.js
Finance and reconciliation
- Loan workflows
backend/src/controllers/loan.controller.js - Financier management
backend/src/controllers/financier.controller.js - Loans
backend/src/models/Loan.js - Financiers
backend/src/models/Financier.js - Ledger service
backend/src/services/ledger.service.js - Transactions
backend/src/models/Transaction.js - Reports
backend/src/controllers/reports.controller.js
Backend platform
- Settings and restore
backend/src/controllers/settings.controller.js - Settings
backend/src/models/Settings.js - Express API
backend/src/server.js - Live event stream
backend/src/utils/sse.js
Other components
- Staff user
Connections 35
- Staff user → React application: uses
README.md - React application → Authentication: provides context
Frontend/src/App.jsx - React application → API client: routes requests
- API client → Express API: calls API
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
backend/src/routes/auth.routes.js - Auth service → User records: reads and writes
backend/src/controllers/auth.controller.js - Express API → Auth routes: mounts routes
backend/src/server.js - Payment processing → Payments: reads and writes
backend/src/controllers/payment.controller.js - Payment processing → Cheque registry: records cheques
backend/src/controllers/payment.controller.js - Payment processing → Bills: allocates payments
backend/src/controllers/payment.controller.js - Payment processing → Ledger service: posts transactions
backend/src/controllers/payment.controller.js - Ledger service → Vendor records: updates balances
backend/src/services/ledger.service.js - Ledger service → Financiers: updates balances
backend/src/services/ledger.service.js - Ledger service → Transactions: records entries
backend/src/services/ledger.service.js - Loan workflows → Loans: reads and writes
backend/src/controllers/loan.controller.js - Loan workflows → Financiers: loads financier
backend/src/controllers/loan.controller.js - Loan workflows → Cheque registry: links cheque
backend/src/controllers/loan.controller.js - Loan workflows → Ledger service: posts repayments
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
backend/src/controllers/settings.controller.js - Settings and restore → Vendor records: restores vendors
backend/src/controllers/settings.controller.js - Settings and restore → Loans: restores loans
backend/src/controllers/settings.controller.js - Settings and restore → Bills: restores bills
backend/src/controllers/settings.controller.js - Settings and restore → Payments: restores payments
backend/src/controllers/settings.controller.js - Settings and restore → Cheque registry: restores cheques
backend/src/controllers/settings.controller.js - Express API → Live event stream: serves events
backend/src/server.js - Payment processing → Live event stream: broadcasts updates
backend/src/controllers/payment.controller.js - Loan workflows → Live event stream: broadcasts updates
backend/src/controllers/loan.controller.js