# ishan-gijavanekar/major-project architecture

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

- Interactive diagram: https://gitdiagram.com/ishan-gijavanekar/major-project
- Repository: https://github.com/ishan-gijavanekar/major-project

## Overview

GigScape is a role-based freelance marketplace: clients publish jobs and review proposals, freelancers apply and complete contract milestones, and the platform supports messaging, payments, reviews, profiles, and skills quizzes. The browser routes users to role-specific pages and frontend stores; the Express backend mounts API routes and uses controllers for domain operations. The excerpts support several frontend-to-store and backend-routing relationships, but do not show the complete HTTP wiring or most domain controllers, so those connections are omitted. RecommendationSystem/main.py is present, but its role and integration are unclear.

Main entry points: [`backend/src/controllers/review.js`](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/controllers/review.js) (Review operations), [`frontend/src/App.jsx`](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/App.jsx) (Role-based UI), [`backend/src/index.js`](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/index.js) (Express API), [`backend/src/routes/user.js`](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/routes/user.js) (User routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Role-based UI<br/>[App.jsx]"]
  node_dashboard["Client dashboard"]
  node_authstate["Authentication state<br/>[authStore.jsx]"]
  node_reviewstate["Review state<br/>[reviewStore.jsx]"]
  node_axios["API client<br/>[axios.js]"]
end

subgraph group_marketplace["Marketplace workflow"]
  node_clientjobs["Client jobs<br/>[AllAboutsJobs.jsx]"]
  node_proposals["Proposal management<br/>[GetAllPropsal.jsx]"]
  node_freelancerjobs["Freelancer jobs"]
  node_contracts["Contracts<br/>[contractStore.jsx]"]
  node_milestones["Milestones"]
  node_jobcontroller["Job operations<br/>[jobs.js]"]
  node_jobstore[("Job records<br/>[job.js]")]
  node_contractstore[("Contract records<br/>[contract.js]")]
  node_recommendation["Recommendation script<br/>[main.py]"]
end

subgraph group_collaboration["Collaboration and trust"]
  node_reviews["Reviews<br/>[GetAllReviews.jsx]"]
  node_chat["Chat<br/>[ChatPage.jsx]"]
  node_profiles["Role profiles<br/>[ClientProfile.jsx]"]
  node_quizzes["Skills quizzes<br/>[QuizList.jsx]"]
  node_reviewcontroller["Review operations<br/>[review.js]"]
  node_reviewrecords[("Review records<br/>[Reviews.js]")]
end

subgraph group_platform["Platform services"]
  node_api["Express API<br/>[index.js]"]
  node_userroute["User routes<br/>[user.js]"]
  node_jobroute["Job routes<br/>[job.js]"]
  node_reviewroute["Review routes<br/>[review.js]"]
  node_authmw["JWT authentication<br/>[auth.js]"]
  node_usercontroller["User operations<br/>[user.js]"]
  node_userstore[("User records<br/>[user.js]")]
  node_email["Email delivery<br/>[email.js]"]
end

node_visitor(("User"))

node_visitor -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_clientjobs
node_webapp -->|"routes to"| node_proposals
node_webapp -->|"routes to"| node_dashboard
node_clientjobs -->|"opens proposals"| node_proposals
node_proposals -->|"uses"| node_contracts
node_milestones -->|"uses"| node_contracts
node_reviews -->|"uses"| node_reviewstate
node_dashboard -->|"uses"| node_authstate
node_authstate -->|"sends requests"| node_axios
node_reviewstate -->|"sends requests"| node_axios
node_contracts -->|"sends requests"| node_axios
node_api -->|"mounts"| node_userroute
node_api -->|"mounts"| node_jobroute
node_api -->|"mounts"| node_reviewroute
node_userroute -->|"dispatches"| node_usercontroller
node_jobroute -->|"dispatches"| node_jobcontroller
node_reviewroute -->|"dispatches"| node_reviewcontroller
node_userroute -->|"protects routes"| node_authmw
node_jobroute -->|"protects routes"| node_authmw
node_reviewroute -->|"protects routes"| node_authmw
node_usercontroller -->|"queries"| node_userstore
node_usercontroller -->|"sends email"| node_email
node_reviewcontroller -->|"queries"| node_userstore
node_reviewcontroller -->|"queries"| node_jobstore
node_reviewcontroller -->|"queries"| node_contractstore
node_reviewcontroller -->|"queries"| node_reviewrecords

click node_webapp "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/App.jsx"
click node_clientjobs "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Jobs/AllAboutsJobs.jsx"
click node_proposals "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Proposal/GetAllPropsal.jsx"
click node_freelancerjobs "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Freelancer/Jobs/GetAllFreelancerJobs.jsx"
click node_contracts "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/stores/contractStore.jsx"
click node_milestones "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Freelancer/Milestone/FreelancerMilestonePage.jsx"
click node_reviews "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Review/GetAllReviews.jsx"
click node_chat "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/general/ChatPage.jsx"
click node_profiles "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Profile/ClientProfile.jsx"
click node_quizzes "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Freelancer/Quiz/QuizList.jsx"
click node_dashboard "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Client-HomePage/ClientDashboard.jsx"
click node_authstate "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/stores/authStore.jsx"
click node_reviewstate "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/stores/reviewStore.jsx"
click node_axios "https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/api/axios.js"
click node_api "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/index.js"
click node_userroute "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/routes/user.js"
click node_jobroute "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/routes/job.js"
click node_reviewroute "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/routes/review.js"
click node_authmw "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/middlewares/auth.js"
click node_usercontroller "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/controllers/user.js"
click node_jobcontroller "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/controllers/jobs.js"
click node_reviewcontroller "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/controllers/review.js"
click node_userstore "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/models/user.js"
click node_jobstore "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/models/job.js"
click node_contractstore "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/models/contract.js"
click node_reviewrecords "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/models/Reviews.js"
click node_email "https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/utils/email.js"
click node_recommendation "https://github.com/ishan-gijavanekar/major-project/blob/main/RecommendationSystem/main.py"

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_dashboard,node_authstate,node_reviewstate,node_axios,node_visitor toneBlue
class node_clientjobs,node_proposals,node_freelancerjobs,node_contracts,node_milestones,node_jobcontroller,node_jobstore,node_contractstore,node_recommendation toneAmber
class node_reviews,node_chat,node_profiles,node_quizzes,node_reviewcontroller,node_reviewrecords toneMint
class node_api,node_userroute,node_jobroute,node_reviewroute,node_authmw,node_usercontroller,node_userstore,node_email toneRose
```

## Components

### Web application

- [Role-based UI](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Client dashboard](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Client-HomePage/ClientDashboard.jsx): `frontend/src/pages/Client/Client-HomePage/ClientDashboard.jsx`
- [Authentication state](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/stores/authStore.jsx): `frontend/src/stores/authStore.jsx`
- [Review state](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/stores/reviewStore.jsx): `frontend/src/stores/reviewStore.jsx`
- [API client](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### Marketplace workflow

- [Client jobs](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Jobs/AllAboutsJobs.jsx): `frontend/src/pages/Client/Jobs/AllAboutsJobs.jsx`
- [Proposal management](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Proposal/GetAllPropsal.jsx): `frontend/src/pages/Client/Proposal/GetAllPropsal.jsx`
- [Freelancer jobs](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Freelancer/Jobs/GetAllFreelancerJobs.jsx): `frontend/src/pages/Freelancer/Jobs/GetAllFreelancerJobs.jsx`
- [Contracts](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/stores/contractStore.jsx): `frontend/src/stores/contractStore.jsx`
- [Milestones](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Freelancer/Milestone/FreelancerMilestonePage.jsx): `frontend/src/pages/Freelancer/Milestone/FreelancerMilestonePage.jsx`
- [Job operations](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/controllers/jobs.js): `backend/src/controllers/jobs.js`
- [Job records](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/models/job.js): `backend/src/models/job.js`
- [Contract records](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/models/contract.js): `backend/src/models/contract.js`
- [Recommendation script](https://github.com/ishan-gijavanekar/major-project/blob/main/RecommendationSystem/main.py): `RecommendationSystem/main.py`

### Collaboration and trust

- [Reviews](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Review/GetAllReviews.jsx): `frontend/src/pages/Client/Review/GetAllReviews.jsx`
- [Chat](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/general/ChatPage.jsx): `frontend/src/pages/general/ChatPage.jsx`
- [Role profiles](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Client/Profile/ClientProfile.jsx): `frontend/src/pages/Client/Profile/ClientProfile.jsx`
- [Skills quizzes](https://github.com/ishan-gijavanekar/major-project/blob/main/frontend/src/pages/Freelancer/Quiz/QuizList.jsx): `frontend/src/pages/Freelancer/Quiz/QuizList.jsx`
- [Review operations](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/controllers/review.js): `backend/src/controllers/review.js`
- [Review records](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/models/Reviews.js): `backend/src/models/Reviews.js`

### Platform services

- [Express API](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/index.js): `backend/src/index.js`
- [User routes](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/routes/user.js): `backend/src/routes/user.js`
- [Job routes](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/routes/job.js): `backend/src/routes/job.js`
- [Review routes](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/routes/review.js): `backend/src/routes/review.js`
- [JWT authentication](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/middlewares/auth.js): `backend/src/middlewares/auth.js`
- [User operations](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/controllers/user.js): `backend/src/controllers/user.js`
- [User records](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/models/user.js): `backend/src/models/user.js`
- [Email delivery](https://github.com/ishan-gijavanekar/major-project/blob/main/backend/src/utils/email.js): `backend/src/utils/email.js`

### Other components

- **User**

## Connections

- User → Role-based UI: uses (evidence: `frontend/src/App.jsx`)
- Role-based UI → Client jobs: routes to (evidence: `frontend/src/App.jsx`)
- Role-based UI → Proposal management: routes to (evidence: `frontend/src/App.jsx`)
- Role-based UI → Client dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Client jobs → Proposal management: opens proposals (evidence: `frontend/src/pages/Client/Jobs/AllAboutsJobs.jsx`)
- Proposal management → Contracts: uses (evidence: `frontend/src/pages/Client/Proposal/GetAllPropsal.jsx`)
- Milestones → Contracts: uses (evidence: `frontend/src/pages/Freelancer/Milestone/FreelancerMilestonePage.jsx`)
- Reviews → Review state: uses (evidence: `frontend/src/pages/Client/Review/GetAllReviews.jsx`)
- Client dashboard → Authentication state: uses (evidence: `frontend/src/pages/Client/Client-HomePage/ClientDashboard.jsx`)
- Authentication state → API client: sends requests (evidence: `frontend/src/stores/authStore.jsx`)
- Review state → API client: sends requests (evidence: `frontend/src/stores/reviewStore.jsx`)
- Contracts → API client: sends requests (evidence: `frontend/src/stores/contractStore.jsx`)
- Express API → User routes: mounts (evidence: `backend/src/index.js`)
- Express API → Job routes: mounts (evidence: `backend/src/index.js`)
- Express API → Review routes: mounts (evidence: `backend/src/index.js`)
- User routes → User operations: dispatches (evidence: `backend/src/routes/user.js`)
- Job routes → Job operations: dispatches (evidence: `backend/src/routes/job.js`)
- Review routes → Review operations: dispatches (evidence: `backend/src/routes/review.js`)
- User routes → JWT authentication: protects routes (evidence: `backend/src/routes/user.js`)
- Job routes → JWT authentication: protects routes (evidence: `backend/src/routes/job.js`)
- Review routes → JWT authentication: protects routes (evidence: `backend/src/routes/review.js`)
- User operations → User records: queries (evidence: `backend/src/controllers/user.js`)
- User operations → Email delivery: sends email (evidence: `backend/src/controllers/user.js`)
- Review operations → User records: queries (evidence: `backend/src/controllers/review.js`)
- Review operations → Job records: queries (evidence: `backend/src/controllers/review.js`)
- Review operations → Contract records: queries (evidence: `backend/src/controllers/review.js`)
- Review operations → Review records: queries (evidence: `backend/src/controllers/review.js`)
