# mdreehal18/gigverse-freelancers.com architecture

> Architecture diagram of the GitHub repository mdreehal18/gigverse-freelancers.com, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mdreehal18/gigverse-freelancers.com
- Repository: https://github.com/mdreehal18/gigverse-freelancers.com

## Overview

GigVerse is a MERN freelancing marketplace. Clients and freelancers enter through the React app, authenticate, then clients post/manage jobs while freelancers browse and bid; accepting a bid creates a contract, with messaging and profiles supporting collaboration. The graph preserves these domain stages and the backend’s route/controller/model layers. README documents search/recommendations and real-time communication, but sampled files do not establish the recommendation implementation or real-time transport; message handling is shown without evidence of real-time delivery.

Main entry points: [`frontend/src/App.jsx`](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/App.jsx) (Route application), [`backend/server.js`](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/server.js) (Express server), [`frontend/src/api.jsx`](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/api.jsx) (HTTP API client), [`backend/routes/userRoutes.js`](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/userRoutes.js) (User routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React experience"]
  node_app["Route application<br/>[App.jsx]"]
  node_auth_ui["Auth state<br/>[AuthContext.jsx]"]
  node_api_client["HTTP API client<br/>[api.jsx]"]
  node_jobs_ui["Job discovery<br/>[Jobs.jsx]"]
  node_job_detail_ui["Job proposals<br/>[JobDetailed.jsx]"]
  node_bids_ui["Bid tracking<br/>[Bids.jsx]"]
  node_contracts_ui["Contract tracking<br/>[Contracts.jsx]"]
  node_contract_detail_ui["Contract detail<br/>[ContractDetail.jsx]"]
  node_profile_ui["Profile management<br/>[Profile.jsx]"]
  node_chat_ui["Messaging interface<br/>[ChatBox.jsx]"]
end

subgraph group_api["REST API"]
  node_server["Express server<br/>[server.js]"]
  node_user_routes["User routes<br/>[userRoutes.js]"]
  node_job_routes["Job routes<br/>[jobRoutes.js]"]
  node_bid_routes["Bid routes<br/>[bidRoutes.js]"]
  node_contract_routes["Contract routes<br/>[contracts.js]"]
  node_message_routes["Message routes<br/>[messagesRoutes.js]"]
  node_auth_middleware["JWT authorization<br/>[authMiddleware.js]"]
  node_validation["Input validation"]
end

subgraph group_domain["Marketplace domain"]
  node_user_controller["User accounts<br/>[userController.js]"]
  node_job_controller["Project management<br/>[jobController.js]"]
  node_bid_controller["Proposals and acceptance<br/>[bidController.js]"]
  node_contract_controller["Contract management"]
  node_message_controller["Message handling"]
end

subgraph group_persistence["MongoDB records"]
  node_user_model[("User records<br/>[User.js]")]
  node_job_model[("Job records<br/>[Job.js]")]
  node_bid_model[("Bid records<br/>[bidModel.js]")]
  node_contract_model[("Contract records<br/>[Contract.js]")]
  node_message_model[("Message records<br/>[Message.js]")]
end

node_visitor(("Client or freelancer"))
node_mongo[("MongoDB")]

node_visitor -->|"uses"| node_app
node_app -->|"reads auth"| node_auth_ui
node_app -->|"routes to"| node_jobs_ui
node_app -->|"routes to"| node_job_detail_ui
node_app -->|"routes to"| node_bids_ui
node_app -->|"routes to"| node_contracts_ui
node_app -->|"routes to"| node_contract_detail_ui
node_app -->|"routes to"| node_profile_ui
node_auth_ui -->|"sets auth token"| node_api_client
node_jobs_ui -->|"uses requests"| node_api_client
node_job_detail_ui -->|"uses requests"| node_api_client
node_contracts_ui -->|"uses requests"| node_api_client
node_contract_detail_ui -->|"uses requests"| node_api_client
node_profile_ui -->|"uses requests"| node_api_client
node_chat_ui -->|"uses requests"| node_api_client
node_api_client -.->|"HTTP requests"| node_server
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_job_routes
node_server -->|"mounts"| node_bid_routes
node_server -->|"mounts"| node_contract_routes
node_server -->|"mounts"| node_message_routes
node_user_routes -->|"dispatches"| node_user_controller
node_job_routes -->|"dispatches"| node_job_controller
node_bid_routes -->|"dispatches"| node_bid_controller
node_contract_routes -->|"dispatches"| node_contract_controller
node_message_routes -->|"dispatches"| node_message_controller
node_user_routes -->|"protects routes"| node_auth_middleware
node_job_routes -->|"protects routes"| node_auth_middleware
node_bid_routes -->|"protects routes"| node_auth_middleware
node_user_routes -->|"validates input"| node_validation
node_job_routes -->|"validates input"| node_validation
node_bid_routes -->|"validates input"| node_validation
node_auth_middleware -->|"loads user"| node_user_model
node_user_controller -->|"manages users"| node_user_model
node_job_controller -->|"manages jobs"| node_job_model
node_bid_controller -->|"manages bids"| node_bid_model
node_bid_controller -->|"updates job"| node_job_model
node_bid_controller -->|"creates contract"| node_contract_model
node_contract_controller -->|"manages contracts"| node_contract_model
node_message_controller -->|"manages messages"| node_message_model
node_server -->|"connects"| node_mongo
node_user_model -.->|"persists"| node_mongo
node_job_model -.->|"persists"| node_mongo
node_bid_model -.->|"persists"| node_mongo
node_contract_model -.->|"persists"| node_mongo
node_message_model -.->|"persists"| node_mongo
node_visitor -.->|"searches recommendations"| node_visitor

click node_app "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/App.jsx"
click node_auth_ui "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/AuthContext.jsx"
click node_api_client "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/api.jsx"
click node_jobs_ui "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/Jobs.jsx"
click node_job_detail_ui "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/JobDetailed.jsx"
click node_bids_ui "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/Bids.jsx"
click node_contracts_ui "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/Contracts.jsx"
click node_contract_detail_ui "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/components/ContractDetail.jsx"
click node_profile_ui "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/Profile.jsx"
click node_chat_ui "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/components/ChatBox.jsx"
click node_server "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/server.js"
click node_user_routes "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/userRoutes.js"
click node_job_routes "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/jobRoutes.js"
click node_bid_routes "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/bidRoutes.js"
click node_contract_routes "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/contracts.js"
click node_message_routes "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/messagesRoutes.js"
click node_auth_middleware "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/middleware/authMiddleware.js"
click node_validation "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/middleware/validationMiddleware.js"
click node_user_controller "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/userController.js"
click node_job_controller "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/jobController.js"
click node_bid_controller "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/bidController.js"
click node_contract_controller "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/contractController.js"
click node_message_controller "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/messagesController.js"
click node_user_model "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/User.js"
click node_job_model "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/Job.js"
click node_bid_model "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/bidModel.js"
click node_contract_model "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/Contract.js"
click node_message_model "https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/Message.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_auth_ui,node_api_client,node_jobs_ui,node_job_detail_ui,node_bids_ui,node_contracts_ui,node_contract_detail_ui,node_profile_ui,node_chat_ui,node_visitor toneBlue
class node_server,node_user_routes,node_job_routes,node_bid_routes,node_contract_routes,node_message_routes,node_auth_middleware,node_validation,node_mongo toneAmber
class node_user_controller,node_job_controller,node_bid_controller,node_contract_controller,node_message_controller toneMint
class node_user_model,node_job_model,node_bid_model,node_contract_model,node_message_model toneRose
```

## Components

### React experience

- [Route application](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth state](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/AuthContext.jsx): `frontend/src/AuthContext.jsx`
- [HTTP API client](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/api.jsx): `frontend/src/api.jsx`
- [Job discovery](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/Jobs.jsx): `frontend/src/pages/Jobs.jsx`
- [Job proposals](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/JobDetailed.jsx): `frontend/src/pages/JobDetailed.jsx`
- [Bid tracking](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/Bids.jsx): `frontend/src/pages/Bids.jsx`
- [Contract tracking](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/Contracts.jsx): `frontend/src/pages/Contracts.jsx`
- [Contract detail](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/components/ContractDetail.jsx): `frontend/src/components/ContractDetail.jsx`
- [Profile management](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`
- [Messaging interface](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/frontend/src/components/ChatBox.jsx): `frontend/src/components/ChatBox.jsx`

### REST API

- [Express server](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/server.js): `backend/server.js`
- [User routes](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [Job routes](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/jobRoutes.js): `backend/routes/jobRoutes.js`
- [Bid routes](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/bidRoutes.js): `backend/routes/bidRoutes.js`
- [Contract routes](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/contracts.js): `backend/routes/contracts.js`
- [Message routes](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/routes/messagesRoutes.js): `backend/routes/messagesRoutes.js`
- [JWT authorization](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Input validation](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/middleware/validationMiddleware.js): `backend/middleware/validationMiddleware.js`

### Marketplace domain

- [User accounts](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Project management](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/jobController.js): `backend/controllers/jobController.js`
- [Proposals and acceptance](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/bidController.js): `backend/controllers/bidController.js`
- [Contract management](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/contractController.js): `backend/controllers/contractController.js`
- [Message handling](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/controllers/messagesController.js): `backend/controllers/messagesController.js`

### MongoDB records

- [User records](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/User.js): `backend/models/User.js`
- [Job records](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/Job.js): `backend/models/Job.js`
- [Bid records](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/bidModel.js): `backend/models/bidModel.js`
- [Contract records](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/Contract.js): `backend/models/Contract.js`
- [Message records](https://github.com/mdreehal18/gigverse-freelancers.com/blob/main/backend/models/Message.js): `backend/models/Message.js`

### Other components

- **Client or freelancer**
- **MongoDB**

## Connections

- Client or freelancer → Route application: uses (evidence: `README.md`)
- Route application → Auth state: reads auth (evidence: `frontend/src/App.jsx`)
- Route application → Job discovery: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Job proposals: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Bid tracking: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Contract tracking: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Contract detail: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Profile management: routes to (evidence: `frontend/src/App.jsx`)
- Auth state → HTTP API client: sets auth token (evidence: `frontend/src/AuthContext.jsx`)
- Job discovery → HTTP API client: uses requests (evidence: `frontend/src/pages/Jobs.jsx`)
- Job proposals → HTTP API client: uses requests (evidence: `frontend/src/pages/JobDetailed.jsx`)
- Contract tracking → HTTP API client: uses requests (evidence: `frontend/src/pages/Contracts.jsx`)
- Contract detail → HTTP API client: uses requests (evidence: `frontend/src/components/ContractDetail.jsx`)
- Profile management → HTTP API client: uses requests (evidence: `frontend/src/pages/Profile.jsx`)
- Messaging interface → HTTP API client: uses requests (evidence: `frontend/src/components/ChatBox.jsx`)
- HTTP API client → Express server: HTTP requests (evidence: `README.md`)
- Express server → User routes: mounts (evidence: `backend/server.js`)
- Express server → Job routes: mounts (evidence: `backend/server.js`)
- Express server → Bid routes: mounts (evidence: `backend/server.js`)
- Express server → Contract routes: mounts (evidence: `backend/server.js`)
- Express server → Message routes: mounts (evidence: `backend/server.js`)
- User routes → User accounts: dispatches (evidence: `backend/routes/userRoutes.js`)
- Job routes → Project management: dispatches (evidence: `backend/routes/jobRoutes.js`)
- Bid routes → Proposals and acceptance: dispatches (evidence: `backend/routes/bidRoutes.js`)
- Contract routes → Contract management: dispatches (evidence: `backend/routes/contracts.js`)
- Message routes → Message handling: dispatches (evidence: `backend/routes/messagesRoutes.js`)
- User routes → JWT authorization: protects routes (evidence: `backend/routes/userRoutes.js`)
- Job routes → JWT authorization: protects routes (evidence: `backend/routes/jobRoutes.js`)
- Bid routes → JWT authorization: protects routes (evidence: `backend/routes/bidRoutes.js`)
- User routes → Input validation: validates input (evidence: `backend/routes/userRoutes.js`)
- Job routes → Input validation: validates input (evidence: `backend/routes/jobRoutes.js`)
- Bid routes → Input validation: validates input (evidence: `backend/routes/bidRoutes.js`)
- JWT authorization → User records: loads user (evidence: `backend/middleware/authMiddleware.js`)
- User accounts → User records: manages users (evidence: `backend/controllers/userController.js`)
- Project management → Job records: manages jobs (evidence: `backend/controllers/jobController.js`)
- Proposals and acceptance → Bid records: manages bids (evidence: `backend/controllers/bidController.js`)
- Proposals and acceptance → Job records: updates job (evidence: `backend/controllers/bidController.js`)
- Proposals and acceptance → Contract records: creates contract (evidence: `backend/controllers/bidController.js`)
- Contract management → Contract records: manages contracts (evidence: `backend/controllers/contractController.js`)
- Message handling → Message records: manages messages (evidence: `backend/controllers/messagesController.js`)
- Express server → MongoDB: connects (evidence: `backend/server.js`)
- User records → MongoDB: persists
- Job records → MongoDB: persists
- Bid records → MongoDB: persists
- Contract records → MongoDB: persists
- Message records → MongoDB: persists
- Client or freelancer → Client or freelancer: searches recommendations (evidence: `README.md`)
