# shashishekhardixit/finance-management-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/shashishekhardixit/finance-management-dashboard
- Repository: https://github.com/shashishekhardixit/finance-management-dashboard

## Overview

FinanceFlow manages business finances: users register and sign in, then maintain clients, create and track invoices and payments, record income and expenses, and review GST reports and dashboard analytics. Construction estimates form a separate workflow and can be converted into invoices. The Vue client calls the Express API; routes dispatch to controllers, which calculate domain results and persist records in MongoDB. Relationships among frontend views and stores are kept broad where source excerpts do not establish specific calls. README-documented features are included, but their unsampled implementation links are not asserted.

Main entry points: [`frontend/src/utils/api.ts`](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/utils/api.ts) (API client), [`frontend/src/router/index.ts`](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/router/index.ts) (Page routing), [`backend/server.js`](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/server.js) (HTTP API server), [`backend/controllers/dashboardController.js`](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/dashboardController.js) (Dashboard analytics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web["FinanceFlow UI<br/>[App.vue]"]
  node_router["Page routing<br/>[index.ts]"]
  node_layout["App layout<br/>[AppLayout.vue]"]
  node_api_client["API client<br/>[api.ts]"]
  node_auth_ui["Sign-in and profile<br/>[auth.ts]"]
  node_finance_views["Finance screens<br/>[InvoicesView.vue]"]
  node_estimate_view["Estimate screen<br/>[EstimatesView.vue]"]
  node_gst_view["GST reports screen<br/>[GSTReportView.vue]"]
  node_dashboard_view["Dashboard screen<br/>[DashboardView.vue]"]
end

subgraph group_api["API and identity"]
  node_server["HTTP API server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_auth_guard["JWT protection<br/>[auth.js]"]
  node_client_routes["Client routes<br/>[clients.js]"]
  node_invoice_routes["Invoice routes<br/>[invoices.js]"]
  node_estimate_routes["Estimate routes<br/>[estimates.js]"]
end

subgraph group_finance["Finance operations"]
  node_client_controller["Client management"]
  node_invoice_controller["Invoice and payments"]
  node_expense_controller["Expense records"]
  node_income_controller["Income records"]
  node_estimate_controller["Construction estimates"]
end

subgraph group_insights["Reporting"]
  node_gst_controller["GST calculations<br/>[gstController.js]"]
  node_dashboard_controller["Dashboard analytics"]
end

subgraph group_data["MongoDB records"]
  node_client_model[("Client records<br/>[Client.js]")]
  node_invoice_model[("Invoice records<br/>[Invoice.js]")]
  node_estimate_model[("Estimate records<br/>[Estimate.js]")]
  node_expense_model[("Expense records<br/>[Expense.js]")]
  node_income_model[("Income records<br/>[Income.js]")]
  node_user_model[("User records<br/>[User.js]")]
end

node_owner(("Business user"))

node_owner -.->|"uses"| node_web
node_web -.->|"loads"| node_router
node_web -.->|"presents"| node_layout
node_router -.->|"routes to"| node_finance_views
node_router -.->|"routes to"| node_estimate_view
node_router -.->|"routes to"| node_gst_view
node_router -.->|"routes to"| node_dashboard_view
node_finance_views -.->|"requests data"| node_api_client
node_estimate_view -.->|"requests data"| node_api_client
node_gst_view -.->|"requests reports"| node_api_client
node_dashboard_view -.->|"requests metrics"| node_api_client
node_auth_ui -.->|"requests auth"| node_api_client
node_api_client -.->|"calls API"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_client_routes
node_server -->|"mounts"| node_invoice_routes
node_server -->|"mounts"| node_estimate_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects"| node_auth_guard
node_client_routes -->|"dispatches"| node_client_controller
node_client_routes -->|"protects"| node_auth_guard
node_invoice_routes -.->|"dispatches"| node_invoice_controller
node_estimate_routes -.->|"dispatches"| node_estimate_controller
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_guard -->|"loads user"| node_user_model
node_client_controller -->|"reads and writes"| node_client_model
node_invoice_controller -->|"reads and writes"| node_invoice_model
node_invoice_controller -->|"updates totals"| node_client_model
node_estimate_controller -->|"reads and writes"| node_estimate_model
node_estimate_controller -->|"creates invoice"| node_invoice_model
node_gst_controller -->|"aggregates"| node_invoice_model
node_gst_controller -->|"aggregates"| node_expense_model
node_dashboard_controller -->|"aggregates"| node_invoice_model
node_dashboard_controller -->|"aggregates"| node_expense_model
node_dashboard_controller -->|"aggregates"| node_income_model
node_dashboard_controller -->|"counts clients"| node_client_model

click node_web "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/App.vue"
click node_router "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/router/index.ts"
click node_layout "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/components/layout/AppLayout.vue"
click node_api_client "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/utils/api.ts"
click node_auth_ui "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/stores/auth.ts"
click node_finance_views "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/views/InvoicesView.vue"
click node_estimate_view "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/views/EstimatesView.vue"
click node_gst_view "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/views/GSTReportView.vue"
click node_dashboard_view "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/views/DashboardView.vue"
click node_server "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/server.js"
click node_auth_routes "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/routes/auth.js"
click node_auth_controller "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/authController.js"
click node_auth_guard "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/middleware/auth.js"
click node_client_routes "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/routes/clients.js"
click node_client_controller "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/clientController.js"
click node_invoice_routes "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/routes/invoices.js"
click node_invoice_controller "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/invoiceController.js"
click node_expense_controller "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/expenseController.js"
click node_income_controller "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/incomeController.js"
click node_estimate_routes "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/routes/estimates.js"
click node_estimate_controller "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/estimateController.js"
click node_gst_controller "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/gstController.js"
click node_dashboard_controller "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/dashboardController.js"
click node_client_model "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Client.js"
click node_invoice_model "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Invoice.js"
click node_estimate_model "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Estimate.js"
click node_expense_model "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Expense.js"
click node_income_model "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Income.js"
click node_user_model "https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/User.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_web,node_router,node_layout,node_api_client,node_auth_ui,node_finance_views,node_estimate_view,node_gst_view,node_dashboard_view,node_owner toneBlue
class node_server,node_auth_routes,node_auth_controller,node_auth_guard,node_client_routes,node_invoice_routes,node_estimate_routes toneAmber
class node_client_controller,node_invoice_controller,node_expense_controller,node_income_controller,node_estimate_controller toneMint
class node_gst_controller,node_dashboard_controller toneRose
class node_client_model,node_invoice_model,node_estimate_model,node_expense_model,node_income_model,node_user_model toneIndigo
```

## Components

### Web application

- [FinanceFlow UI](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Page routing](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/router/index.ts): `frontend/src/router/index.ts`
- [App layout](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/components/layout/AppLayout.vue): `frontend/src/components/layout/AppLayout.vue`
- [API client](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/utils/api.ts): `frontend/src/utils/api.ts`
- [Sign-in and profile](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/stores/auth.ts): `frontend/src/stores/auth.ts`
- [Finance screens](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/views/InvoicesView.vue): `frontend/src/views/InvoicesView.vue`
- [Estimate screen](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/views/EstimatesView.vue): `frontend/src/views/EstimatesView.vue`
- [GST reports screen](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/views/GSTReportView.vue): `frontend/src/views/GSTReportView.vue`
- [Dashboard screen](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/frontend/src/views/DashboardView.vue): `frontend/src/views/DashboardView.vue`

### API and identity

- [HTTP API server](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Authentication](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [JWT protection](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Client routes](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/routes/clients.js): `backend/routes/clients.js`
- [Invoice routes](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/routes/invoices.js): `backend/routes/invoices.js`
- [Estimate routes](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/routes/estimates.js): `backend/routes/estimates.js`

### Finance operations

- [Client management](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/clientController.js): `backend/controllers/clientController.js`
- [Invoice and payments](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/invoiceController.js): `backend/controllers/invoiceController.js`
- [Expense records](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/expenseController.js): `backend/controllers/expenseController.js`
- [Income records](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/incomeController.js): `backend/controllers/incomeController.js`
- [Construction estimates](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/estimateController.js): `backend/controllers/estimateController.js`

### Reporting

- [GST calculations](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/gstController.js): `backend/controllers/gstController.js`
- [Dashboard analytics](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/controllers/dashboardController.js): `backend/controllers/dashboardController.js`

### MongoDB records

- [Client records](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Client.js): `backend/models/Client.js`
- [Invoice records](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Invoice.js): `backend/models/Invoice.js`
- [Estimate records](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Estimate.js): `backend/models/Estimate.js`
- [Expense records](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Expense.js): `backend/models/Expense.js`
- [Income records](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/Income.js): `backend/models/Income.js`
- [User records](https://github.com/shashishekhardixit/finance-management-dashboard/blob/main/backend/models/User.js): `backend/models/User.js`

### Other components

- **Business user**

## Connections

- Business user → FinanceFlow UI: uses
- FinanceFlow UI → Page routing: loads
- FinanceFlow UI → App layout: presents
- Page routing → Finance screens: routes to
- Page routing → Estimate screen: routes to
- Page routing → GST reports screen: routes to
- Page routing → Dashboard screen: routes to
- Finance screens → API client: requests data
- Estimate screen → API client: requests data
- GST reports screen → API client: requests reports
- Dashboard screen → API client: requests metrics
- Sign-in and profile → API client: requests auth
- API client → HTTP API server: calls API
- HTTP API server → Auth routes: mounts (evidence: `backend/server.js`)
- HTTP API server → Client routes: mounts (evidence: `backend/server.js`)
- HTTP API server → Invoice routes: mounts (evidence: `backend/server.js`)
- HTTP API server → Estimate routes: mounts (evidence: `backend/server.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/routes/auth.js`)
- Auth routes → JWT protection: protects (evidence: `backend/routes/auth.js`)
- Client routes → Client management: dispatches (evidence: `backend/routes/clients.js`)
- Client routes → JWT protection: protects (evidence: `backend/routes/clients.js`)
- Invoice routes → Invoice and payments: dispatches (evidence: `backend/routes/invoices.js`)
- Estimate routes → Construction estimates: dispatches (evidence: `backend/routes/estimates.js`)
- Authentication → User records: reads and writes (evidence: `backend/controllers/authController.js`)
- JWT protection → User records: loads user (evidence: `backend/middleware/auth.js`)
- Client management → Client records: reads and writes (evidence: `backend/controllers/clientController.js`)
- Invoice and payments → Invoice records: reads and writes (evidence: `backend/controllers/invoiceController.js`)
- Invoice and payments → Client records: updates totals (evidence: `backend/controllers/invoiceController.js`)
- Construction estimates → Estimate records: reads and writes (evidence: `backend/controllers/estimateController.js`)
- Construction estimates → Invoice records: creates invoice (evidence: `backend/controllers/estimateController.js`)
- GST calculations → Invoice records: aggregates (evidence: `backend/controllers/gstController.js`)
- GST calculations → Expense records: aggregates (evidence: `backend/controllers/gstController.js`)
- Dashboard analytics → Invoice records: aggregates (evidence: `backend/controllers/dashboardController.js`)
- Dashboard analytics → Expense records: aggregates (evidence: `backend/controllers/dashboardController.js`)
- Dashboard analytics → Income records: aggregates (evidence: `backend/controllers/dashboardController.js`)
- Dashboard analytics → Client records: counts clients (evidence: `backend/controllers/dashboardController.js`)
