# vayu-401/invoiceai-final architecture

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

- Interactive diagram: https://gitdiagram.com/vayu-401/invoiceai-final
- Repository: https://github.com/vayu-401/invoiceai-final

## Overview

InvoiceAI provides account access, invoice uploads and processing, invoice browsing/export, and a human-review workflow. The visible frontend routes lead users through these capabilities; frontend stores call the backend over HTTP, while backend routes dispatch to controllers and models. The worker and chat capabilities appear in the source inventory, but their runtime links are not shown in the excerpts; those connections are therefore omitted. The README is empty, so capability coverage is based on the source tree and sampled files.

Main entry points: [`Frontend/vite-project/src/App.jsx`](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/App.jsx) (Page router), [`Backend/src/index.js`](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/index.js) (Express API), [`Frontend/vite-project/src/stores/useInvoiceStore.js`](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/stores/useInvoiceStore.js) (Invoice state), [`Frontend/vite-project/src/pages/Dashboard.jsx`](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Dashboard.jsx) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Page router<br/>[App.jsx]"]
  node_authpages["Account pages<br/>[Login.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_invoices["Invoice pages<br/>[Invoices.jsx]"]
  node_detail["Invoice detail<br/>[InvoiceDetails.jsx]"]
  node_review["Human review<br/>[HumanReview.jsx]"]
  node_uploadpage["Upload pages<br/>[Upload.jsx]"]
  node_uploadhistory["Upload history<br/>[YourUploads.jsx]"]
  node_authstate["Auth state<br/>[useAuthStore.js]"]
  node_invoicestate["Invoice state<br/>[useInvoiceStore.js]"]
  node_uploadstate["Upload state<br/>[useUploadStore.js]"]
  node_http["HTTP client<br/>[axios.js]"]
end

subgraph group_backend["API and processing"]
  node_api["Express API<br/>[index.js]"]
  node_authroutes["Account routes<br/>[user.routes.js]"]
  node_invoiceroutes["Invoice routes<br/>[invoice.route.js]"]
  node_uploadroutes["Upload routes<br/>[upload.routes.js]"]
  node_chatroutes["Chat routes<br/>[chat.routes.js]"]
  node_authctrl["Account logic<br/>[user.controller.js]"]
  node_invoicectrl["Invoice logic"]
  node_uploadctrl["Upload and export"]
  node_chatctrl["Chat logic<br/>[chat.controller.js]"]
  node_authmw["Token authentication"]
  node_worker["Invoice worker<br/>[worker.js]"]
  node_queue["Invoice queue"]
end

subgraph group_data["Persistence"]
  node_userdb[("User records<br/>[user.model.js]")]
  node_invoicedb[("Invoice records<br/>[invoice.model.js]")]
  node_uploaddb[("Upload records<br/>[upload.model.js]")]
  node_chatdb[("Chat records<br/>[chat.model.js]")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_invoices
node_app -->|"routes to"| node_detail
node_app -->|"routes to"| node_review
node_app -->|"routes to"| node_uploadpage
node_app -->|"routes to"| node_uploadhistory
node_authpages -->|"uses"| node_authstate
node_dashboard -->|"uses"| node_authstate
node_dashboard -->|"uses"| node_invoicestate
node_dashboard -->|"uses"| node_uploadstate
node_invoices -->|"uses"| node_invoicestate
node_detail -->|"uses"| node_invoicestate
node_review -->|"uses"| node_invoicestate
node_uploadpage -->|"uses"| node_uploadstate
node_authstate -->|"sends requests"| node_http
node_invoicestate -->|"sends requests"| node_http
node_uploadstate -->|"sends requests"| node_http
node_http -.->|"calls API"| node_api
node_api -->|"mounts"| node_authroutes
node_api -->|"mounts"| node_invoiceroutes
node_api -->|"mounts"| node_uploadroutes
node_api -->|"mounts"| node_chatroutes
node_authroutes -->|"authenticates"| node_authmw
node_invoiceroutes -->|"authenticates"| node_authmw
node_uploadroutes -->|"authenticates uploads"| node_authmw
node_authroutes -->|"dispatches to"| node_authctrl
node_invoiceroutes -->|"dispatches to"| node_invoicectrl
node_uploadroutes -->|"dispatches to"| node_uploadctrl
node_chatroutes -->|"dispatches to"| node_chatctrl
node_authmw -->|"loads user"| node_userdb
node_authctrl -->|"uses records"| node_userdb
node_invoicectrl -->|"uses records"| node_invoicedb
node_uploadctrl -->|"creates and reads"| node_uploaddb
node_uploadctrl -->|"reads records"| node_invoicedb
node_chatctrl -->|"uses records"| node_chatdb
node_chatctrl -->|"uses records"| node_userdb
node_chatctrl -->|"uses records"| node_uploaddb
node_uploadctrl -->|"enqueues invoices"| node_queue
node_queue -.->|"dispatches jobs"| node_worker
node_worker -->|"uses records"| node_invoicedb

click node_app "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/App.jsx"
click node_authpages "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Login.jsx"
click node_dashboard "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Dashboard.jsx"
click node_invoices "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Invoices.jsx"
click node_detail "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/InvoiceDetails.jsx"
click node_review "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/HumanReview.jsx"
click node_uploadpage "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Upload.jsx"
click node_uploadhistory "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/YourUploads.jsx"
click node_authstate "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/stores/useAuthStore.js"
click node_invoicestate "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/stores/useInvoiceStore.js"
click node_uploadstate "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/stores/useUploadStore.js"
click node_http "https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/lib/axios.js"
click node_api "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/index.js"
click node_authroutes "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/routes/user.routes.js"
click node_invoiceroutes "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/routes/invoice.route.js"
click node_uploadroutes "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/routes/upload.routes.js"
click node_chatroutes "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/routes/chat.routes.js"
click node_authctrl "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/controllers/user.controller.js"
click node_invoicectrl "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/controllers/invoice.controller.js"
click node_uploadctrl "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/controllers/upload.controller.js"
click node_chatctrl "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/controllers/chat.controller.js"
click node_authmw "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/middlewares/auth.middlewares.js"
click node_worker "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/workers/worker.js"
click node_userdb "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/models/user.model.js"
click node_invoicedb "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/models/invoice.model.js"
click node_uploaddb "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/models/upload.model.js"
click node_chatdb "https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/models/chat.model.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_authpages,node_dashboard,node_invoices,node_detail,node_review,node_uploadpage,node_uploadhistory,node_authstate,node_invoicestate,node_uploadstate,node_http,node_user toneBlue
class node_api,node_authroutes,node_invoiceroutes,node_uploadroutes,node_chatroutes,node_authctrl,node_invoicectrl,node_uploadctrl,node_chatctrl,node_authmw,node_worker,node_queue toneAmber
class node_userdb,node_invoicedb,node_uploaddb,node_chatdb toneMint
```

## Components

### Web application

- [Page router](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/App.jsx): `Frontend/vite-project/src/App.jsx`
- [Account pages](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Login.jsx): `Frontend/vite-project/src/pages/Login.jsx`
- [Dashboard](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Dashboard.jsx): `Frontend/vite-project/src/pages/Dashboard.jsx`
- [Invoice pages](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Invoices.jsx): `Frontend/vite-project/src/pages/Invoices.jsx`
- [Invoice detail](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/InvoiceDetails.jsx): `Frontend/vite-project/src/pages/InvoiceDetails.jsx`
- [Human review](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/HumanReview.jsx): `Frontend/vite-project/src/pages/HumanReview.jsx`
- [Upload pages](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/Upload.jsx): `Frontend/vite-project/src/pages/Upload.jsx`
- [Upload history](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/pages/YourUploads.jsx): `Frontend/vite-project/src/pages/YourUploads.jsx`
- [Auth state](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/stores/useAuthStore.js): `Frontend/vite-project/src/stores/useAuthStore.js`
- [Invoice state](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/stores/useInvoiceStore.js): `Frontend/vite-project/src/stores/useInvoiceStore.js`
- [Upload state](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/stores/useUploadStore.js): `Frontend/vite-project/src/stores/useUploadStore.js`
- [HTTP client](https://github.com/vayu-401/invoiceai-final/blob/main/Frontend/vite-project/src/lib/axios.js): `Frontend/vite-project/src/lib/axios.js`

### API and processing

- [Express API](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/index.js): `Backend/src/index.js`
- [Account routes](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/routes/user.routes.js): `Backend/src/routes/user.routes.js`
- [Invoice routes](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/routes/invoice.route.js): `Backend/src/routes/invoice.route.js`
- [Upload routes](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/routes/upload.routes.js): `Backend/src/routes/upload.routes.js`
- [Chat routes](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/routes/chat.routes.js): `Backend/src/routes/chat.routes.js`
- [Account logic](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/controllers/user.controller.js): `Backend/src/controllers/user.controller.js`
- [Invoice logic](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/controllers/invoice.controller.js): `Backend/src/controllers/invoice.controller.js`
- [Upload and export](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/controllers/upload.controller.js): `Backend/src/controllers/upload.controller.js`
- [Chat logic](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/controllers/chat.controller.js): `Backend/src/controllers/chat.controller.js`
- [Token authentication](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/middlewares/auth.middlewares.js): `Backend/src/middlewares/auth.middlewares.js`
- [Invoice worker](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/workers/worker.js): `Backend/src/workers/worker.js`
- **Invoice queue**

### Persistence

- [User records](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/models/user.model.js): `Backend/src/models/user.model.js`
- [Invoice records](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/models/invoice.model.js): `Backend/src/models/invoice.model.js`
- [Upload records](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/models/upload.model.js): `Backend/src/models/upload.model.js`
- [Chat records](https://github.com/vayu-401/invoiceai-final/blob/main/Backend/src/models/chat.model.js): `Backend/src/models/chat.model.js`

### Other components

- **User**

## Connections

- User → Page router: uses (evidence: `Frontend/vite-project/src/App.jsx`)
- Page router → Account pages: routes to (evidence: `Frontend/vite-project/src/App.jsx`)
- Page router → Dashboard: routes to (evidence: `Frontend/vite-project/src/App.jsx`)
- Page router → Invoice pages: routes to (evidence: `Frontend/vite-project/src/App.jsx`)
- Page router → Invoice detail: routes to (evidence: `Frontend/vite-project/src/App.jsx`)
- Page router → Human review: routes to (evidence: `Frontend/vite-project/src/App.jsx`)
- Page router → Upload pages: routes to (evidence: `Frontend/vite-project/src/App.jsx`)
- Page router → Upload history: routes to (evidence: `Frontend/vite-project/src/App.jsx`)
- Account pages → Auth state: uses (evidence: `Frontend/vite-project/src/pages/Login.jsx`)
- Dashboard → Auth state: uses (evidence: `Frontend/vite-project/src/pages/Dashboard.jsx`)
- Dashboard → Invoice state: uses (evidence: `Frontend/vite-project/src/pages/Dashboard.jsx`)
- Dashboard → Upload state: uses (evidence: `Frontend/vite-project/src/pages/Dashboard.jsx`)
- Invoice pages → Invoice state: uses (evidence: `Frontend/vite-project/src/pages/Invoices.jsx`)
- Invoice detail → Invoice state: uses (evidence: `Frontend/vite-project/src/pages/InvoiceDetails.jsx`)
- Human review → Invoice state: uses (evidence: `Frontend/vite-project/src/pages/HumanReview.jsx`)
- Upload pages → Upload state: uses (evidence: `Frontend/vite-project/src/pages/Upload.jsx`)
- Auth state → HTTP client: sends requests (evidence: `Frontend/vite-project/src/stores/useAuthStore.js`)
- Invoice state → HTTP client: sends requests (evidence: `Frontend/vite-project/src/stores/useInvoiceStore.js`)
- Upload state → HTTP client: sends requests (evidence: `Frontend/vite-project/src/stores/useUploadStore.js`)
- HTTP client → Express API: calls API
- Express API → Account routes: mounts (evidence: `Backend/src/index.js`)
- Express API → Invoice routes: mounts (evidence: `Backend/src/index.js`)
- Express API → Upload routes: mounts (evidence: `Backend/src/index.js`)
- Express API → Chat routes: mounts (evidence: `Backend/src/index.js`)
- Account routes → Token authentication: authenticates (evidence: `Backend/src/routes/user.routes.js`)
- Invoice routes → Token authentication: authenticates (evidence: `Backend/src/routes/invoice.route.js`)
- Upload routes → Token authentication: authenticates uploads (evidence: `Backend/src/routes/upload.routes.js`)
- Account routes → Account logic: dispatches to (evidence: `Backend/src/routes/user.routes.js`)
- Invoice routes → Invoice logic: dispatches to (evidence: `Backend/src/routes/invoice.route.js`)
- Upload routes → Upload and export: dispatches to (evidence: `Backend/src/routes/upload.routes.js`)
- Chat routes → Chat logic: dispatches to (evidence: `Backend/src/routes/chat.routes.js`)
- Token authentication → User records: loads user (evidence: `Backend/src/middlewares/auth.middlewares.js`)
- Account logic → User records: uses records (evidence: `Backend/src/controllers/user.controller.js`)
- Invoice logic → Invoice records: uses records (evidence: `Backend/src/controllers/invoice.controller.js`)
- Upload and export → Upload records: creates and reads (evidence: `Backend/src/controllers/upload.controller.js`)
- Upload and export → Invoice records: reads records (evidence: `Backend/src/controllers/upload.controller.js`)
- Chat logic → Chat records: uses records (evidence: `Backend/src/controllers/chat.controller.js`)
- Chat logic → User records: uses records (evidence: `Backend/src/controllers/chat.controller.js`)
- Chat logic → Upload records: uses records (evidence: `Backend/src/controllers/chat.controller.js`)
- Upload and export → Invoice queue: enqueues invoices (evidence: `Backend/src/controllers/upload.controller.js`)
- Invoice queue → Invoice worker: dispatches jobs
- Invoice worker → Invoice records: uses records (evidence: `Backend/src/workers/worker.js`)
