How kaditya2006/instantseva works
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: api.js HTTP API client · App.jsx React application · bookingController.js Booking lifecycle · adminController.js Admin operations
Components 27
Web experience
- React application
frontend/src/App.jsx - Service discovery
frontend/src/pages/Search.jsx - Customer dashboard
frontend/src/pages/Dashboard.jsx - Worker dashboard
frontend/src/pages/WorkerDashboard.jsx - Admin dashboard
frontend/src/pages/AdminDashboard.jsx - Chat interface
frontend/src/pages/Chat.jsx - HTTP API client
frontend/src/services/api.js - Multilingual support
frontend/src/i18n/languages.js
Identity and access
- Authentication context
frontend/src/context/AuthContext.jsx - Auth endpoints
backend/routes/authRoutes.js - Account workflows
backend/controllers/authController.js - Authorization middleware
backend/middleware/authMiddleware.js
Marketplace operations
- Worker profiles and KYC
backend/models/WorkerProfile.js - Worker discovery
backend/controllers/marketplaceController.js - Booking endpoints
backend/routes/bookingRoutes.js - Booking lifecycle
backend/controllers/bookingController.js - Booking rules
backend/utils/bookingRules.js - Admin operations
backend/controllers/adminController.js - Location services
backend/services/locationService.js
Communication
- Chat endpoints
backend/routes/chatRoutes.js - Chat and messaging
backend/controllers/chatController.js - Notification service
backend/utils/createNotification.js
Data and services
- Bookings and reviews
backend/models/Booking.js - Chats and messages
backend/models/Chat.js - User records
backend/models/User.js
Other components
- Customer / worker / admin
- MongoDB / email / cloud media
Connections 39
- Customer / worker / admin → React application: uses
README.md - React application → Service discovery: routes to
frontend/src/App.jsx - React application → Customer dashboard: routes to
frontend/src/App.jsx - React application → Worker dashboard: routes to
frontend/src/App.jsx - React application → Admin dashboard: routes to
frontend/src/App.jsx - React application → Chat interface: routes to
frontend/src/App.jsx - React application → Authentication context: provides context
frontend/src/App.jsx - Authentication context → HTTP API client: calls
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
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
backend/controllers/authController.js - Booking endpoints → Authorization middleware: protects routes
backend/routes/bookingRoutes.js - Booking endpoints → Booking lifecycle: routes to
backend/routes/bookingRoutes.js - Chat endpoints → Authorization middleware: protects routes
backend/routes/chatRoutes.js - Chat endpoints → Chat and messaging: routes to
backend/routes/chatRoutes.js - Booking lifecycle → Bookings and reviews: reads and writes
backend/controllers/bookingController.js - Booking lifecycle → Booking rules: checks rules
backend/controllers/bookingController.js - Booking lifecycle → Worker profiles and KYC: updates availability
backend/controllers/bookingController.js - Booking lifecycle → Notification service: creates notifications
backend/controllers/bookingController.js - Admin operations → User records: manages users
backend/controllers/adminController.js - Admin operations → Worker profiles and KYC: reviews profiles
backend/controllers/adminController.js - Admin operations → Bookings and reviews: reads bookings
backend/controllers/adminController.js - Admin operations → Notification service: creates notifications
backend/controllers/adminController.js - Chat and messaging → Chats and messages: reads and writes
backend/controllers/chatController.js - Chat and messaging → Worker profiles and KYC: reads worker details
backend/controllers/chatController.js - Chat and messaging → Notification service: notifies participants
backend/controllers/chatController.js - Account workflows → User records: manages accounts
backend/controllers/authController.js - Authorization middleware → User records: loads user
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