# uttkarsh779/roadaxe architecture

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

- Interactive diagram: https://gitdiagram.com/uttkarsh779/roadaxe
- Repository: https://github.com/uttkarsh779/roadaxe

## Overview

Roadaxe is a product-sales and dealer-management web application. Customers browse products, submit enquiries, and place orders; administrators manage catalogue content and incoming work, while dealers have quote and order screens. The graph shows frontend routing and the documented backend route/controller structure, plus key storage and integration responsibilities. The README contains no usable product description, and many frontend/API connections and backend subsystems were not sampled, so unsupported links are omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/App.jsx) (Application routes), [`backend/app.js`](https://github.com/uttkarsh779/roadaxe/blob/main/backend/app.js) (Express application), [`backend/routes/adminRoutes.js`](https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/adminRoutes.js) (Admin routes), [`backend/controllers/adminController.js`](https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/adminController.js) (Admin management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_frontend["Application routes<br/>[App.jsx]"]
  node_home["Home page<br/>[Home.jsx]"]
  node_storefront["Shopping pages"]
  node_checkout["Checkout and payment<br/>[Checkout.jsx]"]
  node_content["Editorial pages<br/>[BlogList.jsx]"]
  node_adminui["Admin screens"]
  node_dealerui["Dealer screens"]
  node_authctx["Authentication state<br/>[AuthContext.jsx]"]
end

subgraph group_api["API services"]
  node_server["Express application<br/>[app.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_publicroutes["Public routes<br/>[publicRoutes.js]"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_dealerroutes["Dealer routes<br/>[dealerRoutes.js]"]
  node_orderroutes["Order routes<br/>[orderRoutes.js]"]
  node_formroutes["Form routes<br/>[formRoutes.js]"]
  node_enquiryroutes["Enquiry routes<br/>[enquiryRoutes.js]"]
  node_authcontroller["Authentication logic<br/>[authController.js]"]
  node_publiccontroller["Public catalogue logic"]
  node_admincontroller["Admin management<br/>[adminController.js]"]
  node_dealercontroller["Dealer operations"]
  node_ordercontroller["Order and payment logic<br/>[orderController.js]"]
  node_enquirycontroller["Enquiry handling"]
  node_formcontroller["Form handling<br/>[formController.js]"]
  node_authmiddleware["Access control<br/>[authMiddleware.js]"]
  node_upload["Upload handling"]
end

subgraph group_domain["Business data"]
  node_products[("Product records<br/>[Product.js]")]
  node_orders[("Customer orders<br/>[Order.js]")]
  node_user[("User accounts<br/>[User.js]")]
  node_contentdata[("Site content records<br/>[Article.js]")]
  node_productenquiry[("Product enquiries<br/>[ProductEnquiry.js]")]
  node_dealerdata[("Dealer order records<br/>[DealershipOrder.js]")]
end

subgraph group_integrations["External services"]
end

node_visitor(("Customer"))
node_dealer(("Dealer"))
node_admin(("Administrator"))

node_visitor -->|"browses"| node_frontend
node_dealer -->|"opens"| node_frontend
node_admin -->|"opens"| node_frontend
node_frontend -->|"routes to"| node_home
node_frontend -->|"routes to"| node_storefront
node_frontend -->|"routes to"| node_checkout
node_frontend -->|"routes to"| node_content
node_frontend -->|"routes to"| node_adminui
node_frontend -->|"routes to"| node_dealerui
node_frontend -->|"wraps with"| node_authctx
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_publicroutes
node_server -->|"mounts"| node_adminroutes
node_server -->|"mounts"| node_dealerroutes
node_server -->|"mounts"| node_orderroutes
node_server -->|"mounts"| node_formroutes
node_server -->|"mounts"| node_enquiryroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_publicroutes -->|"dispatches"| node_publiccontroller
node_adminroutes -->|"dispatches"| node_admincontroller
node_adminroutes -->|"dispatches"| node_ordercontroller
node_adminroutes -->|"dispatches"| node_enquirycontroller
node_adminroutes -->|"protects"| node_authmiddleware
node_adminroutes -->|"uses"| node_upload
node_dealerroutes -->|"dispatches"| node_dealercontroller
node_dealerroutes -->|"protects"| node_authmiddleware
node_orderroutes -->|"dispatches"| node_ordercontroller
node_orderroutes -->|"protects"| node_authmiddleware
node_formroutes -->|"dispatches"| node_formcontroller
node_formroutes -->|"uses"| node_upload
node_enquiryroutes -->|"dispatches"| node_enquirycontroller
node_authmiddleware -->|"loads account"| node_user
node_publiccontroller -->|"reads"| node_products
node_publiccontroller -->|"reads"| node_contentdata
node_ordercontroller -->|"reads"| node_products
node_ordercontroller -->|"creates and updates"| node_orders
node_admincontroller -->|"manages"| node_products
node_admincontroller -->|"manages"| node_contentdata
node_admincontroller -->|"manages"| node_orders
node_dealercontroller -->|"uses"| node_dealerdata
node_enquirycontroller -->|"stores and lists"| node_productenquiry

click node_frontend "https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/pages/public/Home.jsx"
click node_storefront "https://github.com/uttkarsh779/roadaxe/tree/main/frontend/src/pages/public"
click node_checkout "https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/pages/public/Checkout.jsx"
click node_content "https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/pages/public/BlogList.jsx"
click node_adminui "https://github.com/uttkarsh779/roadaxe/tree/main/frontend/src/pages/admin"
click node_dealerui "https://github.com/uttkarsh779/roadaxe/tree/main/frontend/src/pages/dealer"
click node_authctx "https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/context/AuthContext.jsx"
click node_server "https://github.com/uttkarsh779/roadaxe/blob/main/backend/app.js"
click node_authroutes "https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/authRoutes.js"
click node_publicroutes "https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/publicRoutes.js"
click node_adminroutes "https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/adminRoutes.js"
click node_dealerroutes "https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/dealerRoutes.js"
click node_orderroutes "https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/orderRoutes.js"
click node_formroutes "https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/formRoutes.js"
click node_enquiryroutes "https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/enquiryRoutes.js"
click node_authcontroller "https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/authController.js"
click node_publiccontroller "https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/publicController.js"
click node_admincontroller "https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/adminController.js"
click node_dealercontroller "https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/dealerController.js"
click node_ordercontroller "https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/orderController.js"
click node_enquirycontroller "https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/enquiryController.js"
click node_formcontroller "https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/formController.js"
click node_authmiddleware "https://github.com/uttkarsh779/roadaxe/blob/main/backend/middleware/authMiddleware.js"
click node_upload "https://github.com/uttkarsh779/roadaxe/blob/main/backend/middleware/uploadMiddleware.js"
click node_products "https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/Product.js"
click node_orders "https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/Order.js"
click node_user "https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/User.js"
click node_contentdata "https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/Article.js"
click node_productenquiry "https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/ProductEnquiry.js"
click node_dealerdata "https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/DealershipOrder.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_frontend,node_home,node_storefront,node_checkout,node_content,node_adminui,node_dealerui,node_authctx toneBlue
class node_server,node_authroutes,node_publicroutes,node_adminroutes,node_dealerroutes,node_orderroutes,node_formroutes,node_enquiryroutes,node_authcontroller,node_publiccontroller,node_admincontroller,node_dealercontroller,node_ordercontroller,node_enquirycontroller,node_formcontroller,node_authmiddleware,node_upload toneAmber
class node_products,node_orders,node_user,node_contentdata,node_productenquiry,node_dealerdata toneMint
class node_visitor,node_dealer,node_admin toneIndigo
```

## Components

### Web experience

- [Application routes](https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Home page](https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/pages/public/Home.jsx): `frontend/src/pages/public/Home.jsx`
- [Shopping pages](https://github.com/uttkarsh779/roadaxe/tree/main/frontend/src/pages/public): `frontend/src/pages/public`
- [Checkout and payment](https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/pages/public/Checkout.jsx): `frontend/src/pages/public/Checkout.jsx`
- [Editorial pages](https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/pages/public/BlogList.jsx): `frontend/src/pages/public/BlogList.jsx`
- [Admin screens](https://github.com/uttkarsh779/roadaxe/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Dealer screens](https://github.com/uttkarsh779/roadaxe/tree/main/frontend/src/pages/dealer): `frontend/src/pages/dealer`
- [Authentication state](https://github.com/uttkarsh779/roadaxe/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`

### API services

- [Express application](https://github.com/uttkarsh779/roadaxe/blob/main/backend/app.js): `backend/app.js`
- [Authentication routes](https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Public routes](https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/publicRoutes.js): `backend/routes/publicRoutes.js`
- [Admin routes](https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Dealer routes](https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/dealerRoutes.js): `backend/routes/dealerRoutes.js`
- [Order routes](https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/orderRoutes.js): `backend/routes/orderRoutes.js`
- [Form routes](https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/formRoutes.js): `backend/routes/formRoutes.js`
- [Enquiry routes](https://github.com/uttkarsh779/roadaxe/blob/main/backend/routes/enquiryRoutes.js): `backend/routes/enquiryRoutes.js`
- [Authentication logic](https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Public catalogue logic](https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/publicController.js): `backend/controllers/publicController.js`
- [Admin management](https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`
- [Dealer operations](https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/dealerController.js): `backend/controllers/dealerController.js`
- [Order and payment logic](https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [Enquiry handling](https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/enquiryController.js): `backend/controllers/enquiryController.js`
- [Form handling](https://github.com/uttkarsh779/roadaxe/blob/main/backend/controllers/formController.js): `backend/controllers/formController.js`
- [Access control](https://github.com/uttkarsh779/roadaxe/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Upload handling](https://github.com/uttkarsh779/roadaxe/blob/main/backend/middleware/uploadMiddleware.js): `backend/middleware/uploadMiddleware.js`

### Business data

- [Product records](https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/Product.js): `backend/models/Product.js`
- [Customer orders](https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/Order.js): `backend/models/Order.js`
- [User accounts](https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/User.js): `backend/models/User.js`
- [Site content records](https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/Article.js): `backend/models/Article.js`
- [Product enquiries](https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/ProductEnquiry.js): `backend/models/ProductEnquiry.js`
- [Dealer order records](https://github.com/uttkarsh779/roadaxe/blob/main/backend/models/DealershipOrder.js): `backend/models/DealershipOrder.js`

### Other components

- **Customer**
- **Dealer**
- **Administrator**

## Connections

- Customer → Application routes: browses
- Dealer → Application routes: opens
- Administrator → Application routes: opens
- Application routes → Home page: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Shopping pages: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Checkout and payment: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Editorial pages: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Admin screens: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Dealer screens: routes to (evidence: `frontend/src/App.jsx`)
- Application routes → Authentication state: wraps with (evidence: `frontend/src/App.jsx`)
- Express application → Authentication routes: mounts (evidence: `backend/app.js`)
- Express application → Public routes: mounts (evidence: `backend/app.js`)
- Express application → Admin routes: mounts (evidence: `backend/app.js`)
- Express application → Dealer routes: mounts (evidence: `backend/app.js`)
- Express application → Order routes: mounts (evidence: `backend/app.js`)
- Express application → Form routes: mounts (evidence: `backend/app.js`)
- Express application → Enquiry routes: mounts (evidence: `backend/app.js`)
- Authentication routes → Authentication logic: dispatches (evidence: `backend/routes/authRoutes.js`)
- Public routes → Public catalogue logic: dispatches (evidence: `backend/routes/publicRoutes.js`)
- Admin routes → Admin management: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Order and payment logic: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Enquiry handling: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Access control: protects (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Upload handling: uses (evidence: `backend/routes/adminRoutes.js`)
- Dealer routes → Dealer operations: dispatches (evidence: `backend/routes/dealerRoutes.js`)
- Dealer routes → Access control: protects (evidence: `backend/routes/dealerRoutes.js`)
- Order routes → Order and payment logic: dispatches (evidence: `backend/routes/orderRoutes.js`)
- Order routes → Access control: protects (evidence: `backend/routes/orderRoutes.js`)
- Form routes → Form handling: dispatches (evidence: `backend/routes/formRoutes.js`)
- Form routes → Upload handling: uses (evidence: `backend/routes/formRoutes.js`)
- Enquiry routes → Enquiry handling: dispatches (evidence: `backend/routes/enquiryRoutes.js`)
- Access control → User accounts: loads account (evidence: `backend/middleware/authMiddleware.js`)
- Public catalogue logic → Product records: reads (evidence: `backend/controllers/publicController.js`)
- Public catalogue logic → Site content records: reads (evidence: `backend/controllers/publicController.js`)
- Order and payment logic → Product records: reads (evidence: `backend/controllers/orderController.js`)
- Order and payment logic → Customer orders: creates and updates (evidence: `backend/controllers/orderController.js`)
- Admin management → Product records: manages (evidence: `backend/controllers/adminController.js`)
- Admin management → Site content records: manages (evidence: `backend/controllers/adminController.js`)
- Admin management → Customer orders: manages (evidence: `backend/controllers/adminController.js`)
- Dealer operations → Dealer order records: uses (evidence: `backend/controllers/dealerController.js`)
- Enquiry handling → Product enquiries: stores and lists (evidence: `backend/controllers/enquiryController.js`)
