# kaditya2006/instantseva architecture

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

- Interactive diagram: https://gitdiagram.com/kaditya2006/instantseva
- Repository: https://github.com/kaditya2006/instantseva

## Overview

InstantSeva is a hyperlocal services marketplace: customers discover workers, book and track jobs, then communicate and review; workers manage profiles, KYC and jobs, while admins approve accounts and oversee activity. The React app routes users through role-aware pages and calls an Express API, whose controllers coordinate marketplace rules and MongoDB-backed records. Chat, location discovery, multilingual support and notifications are documented capabilities; some implementation links are omitted or marked unverified because their source was not excerpted.

Main entry points: [`frontend/src/services/api.js`](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/services/api.js) (HTTP API client), [`frontend/src/App.jsx`](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/App.jsx) (React application), [`backend/controllers/bookingController.js`](https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/bookingController.js) (Booking lifecycle), [`backend/controllers/adminController.js`](https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/adminController.js) (Admin operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_webapp["React application<br/>[App.jsx]"]
  node_discovery["Service discovery<br/>[Search.jsx]"]
  node_bookingui["Customer dashboard<br/>[Dashboard.jsx]"]
  node_workerui["Worker dashboard"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_chatui["Chat interface<br/>[Chat.jsx]"]
  node_api["HTTP API client<br/>[api.js]"]
  node_language["Multilingual support<br/>[languages.js]"]
end

subgraph group_identity["Identity and access"]
  node_authui["Authentication context<br/>[AuthContext.jsx]"]
  node_authroutes["Auth endpoints<br/>[authRoutes.js]"]
  node_authcontroller["Account workflows<br/>[authController.js]"]
  node_access["Authorization middleware<br/>[authMiddleware.js]"]
end

subgraph group_marketplace["Marketplace operations"]
  node_workerprofile[("Worker profiles and KYC<br/>[WorkerProfile.js]")]
  node_marketplacecontroller["Worker discovery"]
  node_bookingroutes["Booking endpoints<br/>[bookingRoutes.js]"]
  node_bookingcontroller["Booking lifecycle"]
  node_bookingrules["Booking rules<br/>[bookingRules.js]"]
  node_admincontroller["Admin operations<br/>[adminController.js]"]
  node_location["Location services<br/>[locationService.js]"]
end

subgraph group_communications["Communication"]
  node_chatroutes["Chat endpoints<br/>[chatRoutes.js]"]
  node_chatcontroller["Chat and messaging<br/>[chatController.js]"]
  node_notifications["Notification service"]
end

subgraph group_persistence["Data and services"]
  node_bookingdata[("Bookings and reviews<br/>[Booking.js]")]
  node_chatdata[("Chats and messages<br/>[Chat.js]")]
  node_userrecords[("User records<br/>[User.js]")]
end

node_customer(("Customer / worker / admin"))
node_externalservices[("MongoDB / email / cloud media")]

node_customer -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_discovery
node_webapp -->|"routes to"| node_bookingui
node_webapp -->|"routes to"| node_workerui
node_webapp -->|"routes to"| node_adminui
node_webapp -->|"routes to"| node_chatui
node_webapp -->|"provides context"| node_authui
node_authui -->|"calls"| node_api
node_discovery -.->|"requests data"| node_api
node_bookingui -.->|"requests data"| node_api
node_workerui -->|"requests profile and jobs"| node_api
node_adminui -.->|"requests data"| node_api
node_chatui -.->|"requests messages"| node_api
node_api -.->|"calls API"| node_authroutes
node_api -.->|"calls API"| node_bookingroutes
node_api -.->|"calls API"| node_chatroutes
node_authroutes -->|"routes to"| node_authcontroller
node_bookingroutes -->|"protects routes"| node_access
node_bookingroutes -->|"routes to"| node_bookingcontroller
node_chatroutes -->|"protects routes"| node_access
node_chatroutes -->|"routes to"| node_chatcontroller
node_bookingcontroller -->|"reads and writes"| node_bookingdata
node_bookingcontroller -->|"checks rules"| node_bookingrules
node_bookingcontroller -->|"updates availability"| node_workerprofile
node_bookingcontroller -->|"creates notifications"| node_notifications
node_admincontroller -->|"manages users"| node_userrecords
node_admincontroller -->|"reviews profiles"| node_workerprofile
node_admincontroller -->|"reads bookings"| node_bookingdata
node_admincontroller -->|"creates notifications"| node_notifications
node_chatcontroller -->|"reads and writes"| node_chatdata
node_chatcontroller -->|"reads worker details"| node_workerprofile
node_chatcontroller -->|"notifies participants"| node_notifications
node_authcontroller -->|"manages accounts"| node_userrecords
node_access -->|"loads user"| node_userrecords
node_marketplacecontroller -.->|"discovers workers"| node_workerprofile
node_discovery -.->|"supports languages"| node_language
node_marketplacecontroller -.->|"uses location lookup"| node_location
node_bookingdata -.->|"persists records"| node_externalservices
node_notifications -.->|"may deliver email or push"| node_externalservices

click node_webapp "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/App.jsx"
click node_discovery "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/Search.jsx"
click node_bookingui "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/Dashboard.jsx"
click node_workerui "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/WorkerDashboard.jsx"
click node_adminui "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_chatui "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/Chat.jsx"
click node_authui "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/context/AuthContext.jsx"
click node_authroutes "https://github.com/kaditya2006/instantseva/blob/main/backend/routes/authRoutes.js"
click node_authcontroller "https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/authController.js"
click node_access "https://github.com/kaditya2006/instantseva/blob/main/backend/middleware/authMiddleware.js"
click node_workerprofile "https://github.com/kaditya2006/instantseva/blob/main/backend/models/WorkerProfile.js"
click node_marketplacecontroller "https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/marketplaceController.js"
click node_bookingroutes "https://github.com/kaditya2006/instantseva/blob/main/backend/routes/bookingRoutes.js"
click node_bookingcontroller "https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/bookingController.js"
click node_bookingrules "https://github.com/kaditya2006/instantseva/blob/main/backend/utils/bookingRules.js"
click node_bookingdata "https://github.com/kaditya2006/instantseva/blob/main/backend/models/Booking.js"
click node_admincontroller "https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/adminController.js"
click node_chatroutes "https://github.com/kaditya2006/instantseva/blob/main/backend/routes/chatRoutes.js"
click node_chatcontroller "https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/chatController.js"
click node_chatdata "https://github.com/kaditya2006/instantseva/blob/main/backend/models/Chat.js"
click node_notifications "https://github.com/kaditya2006/instantseva/blob/main/backend/utils/createNotification.js"
click node_userrecords "https://github.com/kaditya2006/instantseva/blob/main/backend/models/User.js"
click node_api "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/services/api.js"
click node_language "https://github.com/kaditya2006/instantseva/blob/main/frontend/src/i18n/languages.js"
click node_location "https://github.com/kaditya2006/instantseva/blob/main/backend/services/locationService.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_webapp,node_discovery,node_bookingui,node_workerui,node_adminui,node_chatui,node_api,node_language toneBlue
class node_authui,node_authroutes,node_authcontroller,node_access,node_externalservices toneAmber
class node_workerprofile,node_marketplacecontroller,node_bookingroutes,node_bookingcontroller,node_bookingrules,node_admincontroller,node_location toneMint
class node_chatroutes,node_chatcontroller,node_notifications,node_customer toneRose
class node_bookingdata,node_chatdata,node_userrecords toneIndigo
```

## Components

### Web experience

- [React application](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Service discovery](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/Search.jsx): `frontend/src/pages/Search.jsx`
- [Customer dashboard](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Worker dashboard](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/WorkerDashboard.jsx): `frontend/src/pages/WorkerDashboard.jsx`
- [Admin dashboard](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Chat interface](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/pages/Chat.jsx): `frontend/src/pages/Chat.jsx`
- [HTTP API client](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Multilingual support](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/i18n/languages.js): `frontend/src/i18n/languages.js`

### Identity and access

- [Authentication context](https://github.com/kaditya2006/instantseva/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Auth endpoints](https://github.com/kaditya2006/instantseva/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Account workflows](https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Authorization middleware](https://github.com/kaditya2006/instantseva/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`

### Marketplace operations

- [Worker profiles and KYC](https://github.com/kaditya2006/instantseva/blob/main/backend/models/WorkerProfile.js): `backend/models/WorkerProfile.js`
- [Worker discovery](https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/marketplaceController.js): `backend/controllers/marketplaceController.js`
- [Booking endpoints](https://github.com/kaditya2006/instantseva/blob/main/backend/routes/bookingRoutes.js): `backend/routes/bookingRoutes.js`
- [Booking lifecycle](https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/bookingController.js): `backend/controllers/bookingController.js`
- [Booking rules](https://github.com/kaditya2006/instantseva/blob/main/backend/utils/bookingRules.js): `backend/utils/bookingRules.js`
- [Admin operations](https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`
- [Location services](https://github.com/kaditya2006/instantseva/blob/main/backend/services/locationService.js): `backend/services/locationService.js`

### Communication

- [Chat endpoints](https://github.com/kaditya2006/instantseva/blob/main/backend/routes/chatRoutes.js): `backend/routes/chatRoutes.js`
- [Chat and messaging](https://github.com/kaditya2006/instantseva/blob/main/backend/controllers/chatController.js): `backend/controllers/chatController.js`
- [Notification service](https://github.com/kaditya2006/instantseva/blob/main/backend/utils/createNotification.js): `backend/utils/createNotification.js`

### Data and services

- [Bookings and reviews](https://github.com/kaditya2006/instantseva/blob/main/backend/models/Booking.js): `backend/models/Booking.js`
- [Chats and messages](https://github.com/kaditya2006/instantseva/blob/main/backend/models/Chat.js): `backend/models/Chat.js`
- [User records](https://github.com/kaditya2006/instantseva/blob/main/backend/models/User.js): `backend/models/User.js`

### Other components

- **Customer / worker / admin**
- **MongoDB / email / cloud media**

## Connections

- Customer / worker / admin → React application: uses (evidence: `README.md`)
- React application → Service discovery: routes to (evidence: `frontend/src/App.jsx`)
- React application → Customer dashboard: routes to (evidence: `frontend/src/App.jsx`)
- React application → Worker dashboard: routes to (evidence: `frontend/src/App.jsx`)
- React application → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- React application → Chat interface: routes to (evidence: `frontend/src/App.jsx`)
- React application → Authentication context: provides context (evidence: `frontend/src/App.jsx`)
- Authentication context → HTTP API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Service discovery → HTTP API client: requests data
- Customer dashboard → HTTP API client: requests data
- Worker dashboard → HTTP API client: requests profile and jobs (evidence: `frontend/src/pages/WorkerDashboard.jsx`)
- Admin dashboard → HTTP API client: requests data
- Chat interface → HTTP API client: requests messages
- HTTP API client → Auth endpoints: calls API
- HTTP API client → Booking endpoints: calls API
- HTTP API client → Chat endpoints: calls API
- Auth endpoints → Account workflows: routes to (evidence: `backend/controllers/authController.js`)
- Booking endpoints → Authorization middleware: protects routes (evidence: `backend/routes/bookingRoutes.js`)
- Booking endpoints → Booking lifecycle: routes to (evidence: `backend/routes/bookingRoutes.js`)
- Chat endpoints → Authorization middleware: protects routes (evidence: `backend/routes/chatRoutes.js`)
- Chat endpoints → Chat and messaging: routes to (evidence: `backend/routes/chatRoutes.js`)
- Booking lifecycle → Bookings and reviews: reads and writes (evidence: `backend/controllers/bookingController.js`)
- Booking lifecycle → Booking rules: checks rules (evidence: `backend/controllers/bookingController.js`)
- Booking lifecycle → Worker profiles and KYC: updates availability (evidence: `backend/controllers/bookingController.js`)
- Booking lifecycle → Notification service: creates notifications (evidence: `backend/controllers/bookingController.js`)
- Admin operations → User records: manages users (evidence: `backend/controllers/adminController.js`)
- Admin operations → Worker profiles and KYC: reviews profiles (evidence: `backend/controllers/adminController.js`)
- Admin operations → Bookings and reviews: reads bookings (evidence: `backend/controllers/adminController.js`)
- Admin operations → Notification service: creates notifications (evidence: `backend/controllers/adminController.js`)
- Chat and messaging → Chats and messages: reads and writes (evidence: `backend/controllers/chatController.js`)
- Chat and messaging → Worker profiles and KYC: reads worker details (evidence: `backend/controllers/chatController.js`)
- Chat and messaging → Notification service: notifies participants (evidence: `backend/controllers/chatController.js`)
- Account workflows → User records: manages accounts (evidence: `backend/controllers/authController.js`)
- Authorization middleware → User records: loads user (evidence: `backend/middleware/authMiddleware.js`)
- Worker discovery → Worker profiles and KYC: discovers workers
- Service discovery → Multilingual support: supports languages
- Worker discovery → Location services: uses location lookup
- Bookings and reviews → MongoDB / email / cloud media: persists records
- Notification service → MongoDB / email / cloud media: may deliver email or push
