# shrivishal007/inventory-management architecture

> Architecture diagram of the GitHub repository shrivishal007/inventory-management, 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/shrivishal007/inventory-management
- Repository: https://github.com/shrivishal007/inventory-management

## Overview

This is a rice sales and fulfillment application: salespeople register or sign in, request quotes, place/manage orders, and retrieve invoices; owners review quotes, manage stock, and inspect orders and salespeople. The React client uses a shared authenticated API client, while Express routes dispatch requests through controllers to domain services backed by a database pool. Vehicle allocation and invoice retrieval are distinct fulfillment stages. Some service internals and the database implementation were not sampled, so their finer relationships are omitted.

Main entry points: [`Backend/src/controllers/salesperson.js`](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/controllers/salesperson.js) (Sales controller), [`Frontend/src/App.jsx`](https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/App.jsx) (App routes), [`Backend/src/app.js`](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/app.js) (Express app), [`Frontend/src/api.js`](https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web_app["App routes<br/>[App.jsx]"]
  node_home["Homepage<br/>[Homepage.jsx]"]
  node_owner_pages["Owner pages"]
  node_sales_pages["Salesperson pages"]
  node_invoice_ui["Invoice download"]
  node_api_client["API client<br/>[api.js]"]
  node_auth_store["Browser auth<br/>[auth.js]"]
end

subgraph group_api["API and access"]
  node_backend["Express app<br/>[app.js]"]
  node_user_routes["Salesperson routes<br/>[userRoutes.js]"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_rice_routes["Rice route<br/>[riceRoute.js]"]
  node_auth_mw["Role auth<br/>[auth.js]"]
  node_db[("Database pool<br/>[db.js]")]
end

subgraph group_sales["Sales workflow"]
  node_sales_controller["Sales controller<br/>[salesperson.js]"]
  node_sales_auth["Salesperson access"]
  node_registration["Registration<br/>[registerUser.js]"]
  node_sales_details["Sales dashboard data<br/>[userDetails.js]"]
  node_quotes["Quote requests<br/>[quoteLogic.js]"]
  node_orders["Order processing<br/>[processOrder.js]"]
end

subgraph group_owner["Owner operations"]
  node_owner_controller["Owner controller<br/>[admin.js]"]
  node_owner_services["Owner operations"]
  node_rice_details["Rice details<br/>[riceDetails.js]"]
end

subgraph group_fulfill["Fulfillment"]
  node_vehicle["Vehicle allocation<br/>[allocateVehicle.js]"]
  node_invoice["Invoice data<br/>[fetchInvoice.js]"]
end

node_salesperson(("Salesperson"))
node_owner_actor(("Owner"))

node_salesperson -->|"uses"| node_web_app
node_owner_actor -->|"uses"| node_web_app
node_web_app -->|"routes to"| node_home
node_web_app -->|"routes to"| node_owner_pages
node_web_app -->|"routes to"| node_sales_pages
node_sales_pages -->|"uses"| node_invoice_ui
node_owner_pages -->|"requests through"| node_api_client
node_sales_pages -->|"requests through"| node_api_client
node_api_client -->|"reads tokens"| node_auth_store
node_api_client -.->|"sends API requests"| node_backend
node_backend -->|"mounts"| node_user_routes
node_backend -->|"mounts"| node_admin_routes
node_backend -->|"mounts"| node_rice_routes
node_user_routes -->|"dispatches"| node_sales_controller
node_admin_routes -->|"dispatches"| node_owner_controller
node_user_routes -->|"guards routes"| node_auth_mw
node_admin_routes -->|"guards routes"| node_auth_mw
node_sales_controller -->|"passes pool"| node_db
node_sales_controller -->|"authenticates"| node_sales_auth
node_sales_controller -->|"registers"| node_registration
node_sales_controller -->|"loads dashboard"| node_sales_details
node_sales_controller -->|"creates quote"| node_quotes
node_sales_controller -->|"processes order"| node_orders
node_sales_controller -->|"allocates vehicle"| node_vehicle
node_sales_controller -->|"fetches invoice"| node_invoice
node_owner_controller -->|"passes pool"| node_db
node_owner_controller -->|"dispatches operations"| node_owner_services
node_rice_routes -->|"routes to"| node_rice_details
node_auth_mw -.->|"verifies token"| node_sales_auth

click node_web_app "https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/App.jsx"
click node_home "https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/Homepage.jsx"
click node_owner_pages "https://github.com/shrivishal007/inventory-management/tree/main/Frontend/src/pages/owner"
click node_sales_pages "https://github.com/shrivishal007/inventory-management/tree/main/Frontend/src/pages/salesperson"
click node_invoice_ui "https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/pages/salesperson/InvoiceDownload.jsx"
click node_api_client "https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/api.js"
click node_auth_store "https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/auth.js"
click node_backend "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/app.js"
click node_user_routes "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/routes/userRoutes.js"
click node_admin_routes "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/routes/adminRoutes.js"
click node_rice_routes "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/routes/riceRoute.js"
click node_auth_mw "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/middleware/auth.js"
click node_db "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/config/db.js"
click node_sales_controller "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/controllers/salesperson.js"
click node_sales_auth "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/authenticateUser.js"
click node_registration "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/registerUser.js"
click node_sales_details "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/userDetails.js"
click node_quotes "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/quoteLogic.js"
click node_orders "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/processOrder.js"
click node_owner_controller "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/controllers/admin.js"
click node_owner_services "https://github.com/shrivishal007/inventory-management/tree/main/Backend/src/services/admin"
click node_rice_details "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/riceDetails.js"
click node_vehicle "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/allocateVehicle.js"
click node_invoice "https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/fetchInvoice.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_app,node_home,node_owner_pages,node_sales_pages,node_invoice_ui,node_api_client,node_auth_store toneBlue
class node_backend,node_user_routes,node_admin_routes,node_rice_routes,node_auth_mw,node_db toneAmber
class node_sales_controller,node_sales_auth,node_registration,node_sales_details,node_quotes,node_orders toneMint
class node_owner_controller,node_owner_services,node_rice_details toneRose
class node_vehicle,node_invoice,node_salesperson,node_owner_actor toneIndigo
```

## Components

### Web client

- [App routes](https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Homepage](https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/Homepage.jsx): `Frontend/src/Homepage.jsx`
- [Owner pages](https://github.com/shrivishal007/inventory-management/tree/main/Frontend/src/pages/owner): `Frontend/src/pages/owner`
- [Salesperson pages](https://github.com/shrivishal007/inventory-management/tree/main/Frontend/src/pages/salesperson): `Frontend/src/pages/salesperson`
- [Invoice download](https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/pages/salesperson/InvoiceDownload.jsx): `Frontend/src/pages/salesperson/InvoiceDownload.jsx`
- [API client](https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/api.js): `Frontend/src/api.js`
- [Browser auth](https://github.com/shrivishal007/inventory-management/blob/main/Frontend/src/auth.js): `Frontend/src/auth.js`

### API and access

- [Express app](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/app.js): `Backend/src/app.js`
- [Salesperson routes](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/routes/userRoutes.js): `Backend/src/routes/userRoutes.js`
- [Admin routes](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/routes/adminRoutes.js): `Backend/src/routes/adminRoutes.js`
- [Rice route](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/routes/riceRoute.js): `Backend/src/routes/riceRoute.js`
- [Role auth](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/middleware/auth.js): `Backend/src/middleware/auth.js`
- [Database pool](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/config/db.js): `Backend/src/config/db.js`

### Sales workflow

- [Sales controller](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/controllers/salesperson.js): `Backend/src/controllers/salesperson.js`
- [Salesperson access](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/authenticateUser.js): `Backend/src/services/user/authenticateUser.js`
- [Registration](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/registerUser.js): `Backend/src/services/user/registerUser.js`
- [Sales dashboard data](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/userDetails.js): `Backend/src/services/user/userDetails.js`
- [Quote requests](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/quoteLogic.js): `Backend/src/services/user/quoteLogic.js`
- [Order processing](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/processOrder.js): `Backend/src/services/user/processOrder.js`

### Owner operations

- [Owner controller](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/controllers/admin.js): `Backend/src/controllers/admin.js`
- [Owner operations](https://github.com/shrivishal007/inventory-management/tree/main/Backend/src/services/admin): `Backend/src/services/admin`
- [Rice details](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/riceDetails.js): `Backend/src/services/riceDetails.js`

### Fulfillment

- [Vehicle allocation](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/allocateVehicle.js): `Backend/src/services/user/allocateVehicle.js`
- [Invoice data](https://github.com/shrivishal007/inventory-management/blob/main/Backend/src/services/user/fetchInvoice.js): `Backend/src/services/user/fetchInvoice.js`

### Other components

- **Salesperson**
- **Owner**

## Connections

- Salesperson → App routes: uses (evidence: `Frontend/src/App.jsx`)
- Owner → App routes: uses (evidence: `Frontend/src/App.jsx`)
- App routes → Homepage: routes to (evidence: `Frontend/src/App.jsx`)
- App routes → Owner pages: routes to (evidence: `Frontend/src/App.jsx`)
- App routes → Salesperson pages: routes to (evidence: `Frontend/src/App.jsx`)
- Salesperson pages → Invoice download: uses (evidence: `Frontend/src/pages/salesperson/SalespersonOrders.jsx`)
- Owner pages → API client: requests through (evidence: `Frontend/src/pages/owner/OwnerDashboard.jsx`)
- Salesperson pages → API client: requests through (evidence: `Frontend/src/pages/salesperson/SalespersonDashboard.jsx`)
- API client → Browser auth: reads tokens (evidence: `Frontend/src/api.js`)
- API client → Express app: sends API requests
- Express app → Salesperson routes: mounts (evidence: `Backend/src/app.js`)
- Express app → Admin routes: mounts (evidence: `Backend/src/app.js`)
- Express app → Rice route: mounts (evidence: `Backend/src/app.js`)
- Salesperson routes → Sales controller: dispatches (evidence: `Backend/src/routes/userRoutes.js`)
- Admin routes → Owner controller: dispatches (evidence: `Backend/src/routes/adminRoutes.js`)
- Salesperson routes → Role auth: guards routes (evidence: `Backend/src/routes/userRoutes.js`)
- Admin routes → Role auth: guards routes (evidence: `Backend/src/routes/adminRoutes.js`)
- Sales controller → Database pool: passes pool (evidence: `Backend/src/controllers/salesperson.js`)
- Sales controller → Salesperson access: authenticates (evidence: `Backend/src/controllers/salesperson.js`)
- Sales controller → Registration: registers (evidence: `Backend/src/controllers/salesperson.js`)
- Sales controller → Sales dashboard data: loads dashboard (evidence: `Backend/src/controllers/salesperson.js`)
- Sales controller → Quote requests: creates quote (evidence: `Backend/src/controllers/salesperson.js`)
- Sales controller → Order processing: processes order (evidence: `Backend/src/controllers/salesperson.js`)
- Sales controller → Vehicle allocation: allocates vehicle (evidence: `Backend/src/controllers/salesperson.js`)
- Sales controller → Invoice data: fetches invoice (evidence: `Backend/src/controllers/salesperson.js`)
- Owner controller → Database pool: passes pool (evidence: `Backend/src/controllers/admin.js`)
- Owner controller → Owner operations: dispatches operations (evidence: `Backend/src/controllers/admin.js`)
- Rice route → Rice details: routes to (evidence: `Backend/src/routes/riceRoute.js`)
- Role auth → Salesperson access: verifies token
