# surendrakumarpatel/jobportal-yt architecture

> Architecture diagram of the GitHub repository surendrakumarpatel/jobportal-yt, 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/surendrakumarpatel/jobportal-yt
- Repository: https://github.com/surendrakumarpatel/jobportal-yt

## Overview

JobPortal supports student job discovery, applications, profiles and recruiter management of companies, jobs and applicants. The frontend routes users into these workflows; the backend exposes authenticated API routes, applies controller logic and persists users, companies, jobs and applications. The application and job controller excerpts show the application lifecycle and job operations. Most frontend data-fetching components and several backend modules were not excerpted, so their unverified runtime connections are omitted; documented-by-index imports are used only where they establish wiring.

Main entry points: [`frontend/src/App.jsx`](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/App.jsx) (Route application), [`backend/index.js`](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/index.js) (Express API), [`frontend/src/components/shared/Navbar.jsx`](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/shared/Navbar.jsx) (Navigation and logout), [`backend/controllers/user.controller.js`](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/user.controller.js) (User operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_app["Route application<br/>[App.jsx]"]
  node_home["Home experience<br/>[Home.jsx]"]
  node_jobbrowse["Job browsing<br/>[Jobs.jsx]"]
  node_jobdetail["Job detail<br/>[JobDescription.jsx]"]
  node_profile["Student profile<br/>[Profile.jsx]"]
  node_authui["Sign-in and signup"]
  node_recruiterui["Recruiter workspace"]
  node_navbar["Navigation and logout<br/>[Navbar.jsx]"]
end

subgraph group_identity["Identity and companies"]
  node_authroutes["User routes<br/>[user.route.js]"]
  node_companyroutes["Company routes<br/>[company.route.js]"]
  node_usercontroller["User operations<br/>[user.controller.js]"]
  node_companycontroller["Company operations"]
  node_userstore[("User records<br/>[user.model.js]")]
  node_companystore[("Company records<br/>[company.model.js]")]
end

subgraph group_jobs["Job discovery and hiring"]
  node_jobroutes["Job routes<br/>[job.route.js]"]
  node_applicationroutes["Application routes"]
  node_jobcontroller["Job operations<br/>[job.controller.js]"]
  node_applicationcontroller["Application operations"]
  node_jobstore[("Job records<br/>[job.model.js]")]
  node_applicationstore[("Application records")]
end

subgraph group_platform["Backend platform"]
  node_api["Express API<br/>[index.js]"]
  node_authguard["JWT authentication<br/>[isAuthenticated.js]"]
  node_fileupload["Image processing<br/>[mutler.js]"]
  node_datauri["File URI conversion<br/>[datauri.js]"]
  node_cloudinary["Cloudinary media<br/>[cloudinary.js]"]
  node_database[("MongoDB connection<br/>[db.js]")]
end

node_actor(("Portal user"))

node_actor -->|"uses routes"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_jobbrowse
node_app -->|"routes to"| node_jobdetail
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_recruiterui
node_home -->|"renders"| node_navbar
node_jobbrowse -->|"renders"| node_navbar
node_profile -->|"renders"| node_navbar
node_recruiterui -->|"renders"| node_navbar
node_navbar -->|"requests logout"| node_authroutes
node_api -->|"connects"| node_database
node_api -->|"mounts routes"| node_authroutes
node_api -->|"mounts routes"| node_companyroutes
node_api -->|"mounts routes"| node_jobroutes
node_api -->|"mounts routes"| node_applicationroutes
node_authroutes -->|"dispatches"| node_usercontroller
node_companyroutes -->|"dispatches"| node_companycontroller
node_jobroutes -->|"dispatches"| node_jobcontroller
node_applicationroutes -->|"dispatches"| node_applicationcontroller
node_authroutes -->|"guards requests"| node_authguard
node_companyroutes -->|"guards requests"| node_authguard
node_jobroutes -->|"guards requests"| node_authguard
node_applicationroutes -->|"guards requests"| node_authguard
node_usercontroller -->|"reads and writes"| node_userstore
node_companycontroller -->|"reads and writes"| node_companystore
node_jobcontroller -->|"reads and writes"| node_jobstore
node_applicationcontroller -->|"reads and writes"| node_applicationstore
node_applicationcontroller -->|"reads and updates"| node_jobstore
node_usercontroller -->|"converts uploads"| node_datauri
node_companycontroller -->|"converts uploads"| node_datauri
node_usercontroller -->|"uploads media"| node_cloudinary
node_companycontroller -->|"uploads media"| node_cloudinary

click node_app "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/Home.jsx"
click node_jobbrowse "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/Jobs.jsx"
click node_jobdetail "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/JobDescription.jsx"
click node_profile "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/Profile.jsx"
click node_authui "https://github.com/surendrakumarpatel/jobportal-yt/tree/main/frontend/src/components/auth"
click node_recruiterui "https://github.com/surendrakumarpatel/jobportal-yt/tree/main/frontend/src/components/admin"
click node_navbar "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/shared/Navbar.jsx"
click node_api "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/index.js"
click node_authroutes "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/routes/user.route.js"
click node_companyroutes "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/routes/company.route.js"
click node_jobroutes "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/routes/job.route.js"
click node_applicationroutes "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/routes/application.route.js"
click node_authguard "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/middlewares/isAuthenticated.js"
click node_usercontroller "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/user.controller.js"
click node_companycontroller "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/company.controller.js"
click node_jobcontroller "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/job.controller.js"
click node_applicationcontroller "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/application.controller.js"
click node_userstore "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/models/user.model.js"
click node_companystore "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/models/company.model.js"
click node_jobstore "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/models/job.model.js"
click node_applicationstore "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/models/application.model.js"
click node_fileupload "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/middlewares/mutler.js"
click node_datauri "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/utils/datauri.js"
click node_cloudinary "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/utils/cloudinary.js"
click node_database "https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/utils/db.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_home,node_jobbrowse,node_jobdetail,node_profile,node_authui,node_recruiterui,node_navbar,node_actor toneBlue
class node_authroutes,node_companyroutes,node_usercontroller,node_companycontroller,node_userstore,node_companystore toneAmber
class node_jobroutes,node_applicationroutes,node_jobcontroller,node_applicationcontroller,node_jobstore,node_applicationstore toneMint
class node_api,node_authguard,node_fileupload,node_datauri,node_cloudinary,node_database toneRose
```

## Components

### Frontend experience

- [Route application](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Home experience](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/Home.jsx): `frontend/src/components/Home.jsx`
- [Job browsing](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/Jobs.jsx): `frontend/src/components/Jobs.jsx`
- [Job detail](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/JobDescription.jsx): `frontend/src/components/JobDescription.jsx`
- [Student profile](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/Profile.jsx): `frontend/src/components/Profile.jsx`
- [Sign-in and signup](https://github.com/surendrakumarpatel/jobportal-yt/tree/main/frontend/src/components/auth): `frontend/src/components/auth`
- [Recruiter workspace](https://github.com/surendrakumarpatel/jobportal-yt/tree/main/frontend/src/components/admin): `frontend/src/components/admin`
- [Navigation and logout](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/frontend/src/components/shared/Navbar.jsx): `frontend/src/components/shared/Navbar.jsx`

### Identity and companies

- [User routes](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/routes/user.route.js): `backend/routes/user.route.js`
- [Company routes](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/routes/company.route.js): `backend/routes/company.route.js`
- [User operations](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/user.controller.js): `backend/controllers/user.controller.js`
- [Company operations](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/company.controller.js): `backend/controllers/company.controller.js`
- [User records](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/models/user.model.js): `backend/models/user.model.js`
- [Company records](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/models/company.model.js): `backend/models/company.model.js`

### Job discovery and hiring

- [Job routes](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/routes/job.route.js): `backend/routes/job.route.js`
- [Application routes](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/routes/application.route.js): `backend/routes/application.route.js`
- [Job operations](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/job.controller.js): `backend/controllers/job.controller.js`
- [Application operations](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/controllers/application.controller.js): `backend/controllers/application.controller.js`
- [Job records](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/models/job.model.js): `backend/models/job.model.js`
- [Application records](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/models/application.model.js): `backend/models/application.model.js`

### Backend platform

- [Express API](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/index.js): `backend/index.js`
- [JWT authentication](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/middlewares/isAuthenticated.js): `backend/middlewares/isAuthenticated.js`
- [Image processing](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/middlewares/mutler.js): `backend/middlewares/mutler.js`
- [File URI conversion](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/utils/datauri.js): `backend/utils/datauri.js`
- [Cloudinary media](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/utils/cloudinary.js): `backend/utils/cloudinary.js`
- [MongoDB connection](https://github.com/surendrakumarpatel/jobportal-yt/blob/main/backend/utils/db.js): `backend/utils/db.js`

### Other components

- **Portal user**

## Connections

- Portal user → Route application: uses routes (evidence: `frontend/src/App.jsx`)
- Route application → Home experience: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Job browsing: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Job detail: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Student profile: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Sign-in and signup: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Recruiter workspace: routes to (evidence: `frontend/src/App.jsx`)
- Home experience → Navigation and logout: renders (evidence: `frontend/src/components/Home.jsx`)
- Job browsing → Navigation and logout: renders (evidence: `frontend/src/components/Jobs.jsx`)
- Student profile → Navigation and logout: renders (evidence: `frontend/src/components/Profile.jsx`)
- Recruiter workspace → Navigation and logout: renders (evidence: `frontend/src/components/admin/AdminJobs.jsx`)
- Navigation and logout → User routes: requests logout (evidence: `frontend/src/components/shared/Navbar.jsx`)
- Express API → MongoDB connection: connects (evidence: `backend/index.js`)
- Express API → User routes: mounts routes (evidence: `backend/index.js`)
- Express API → Company routes: mounts routes (evidence: `backend/index.js`)
- Express API → Job routes: mounts routes (evidence: `backend/index.js`)
- Express API → Application routes: mounts routes (evidence: `backend/index.js`)
- User routes → User operations: dispatches (evidence: `backend/routes/user.route.js`)
- Company routes → Company operations: dispatches (evidence: `backend/routes/company.route.js`)
- Job routes → Job operations: dispatches (evidence: `backend/routes/job.route.js`)
- Application routes → Application operations: dispatches (evidence: `backend/routes/application.route.js`)
- User routes → JWT authentication: guards requests (evidence: `backend/routes/user.route.js`)
- Company routes → JWT authentication: guards requests (evidence: `backend/routes/company.route.js`)
- Job routes → JWT authentication: guards requests (evidence: `backend/routes/job.route.js`)
- Application routes → JWT authentication: guards requests (evidence: `backend/routes/application.route.js`)
- User operations → User records: reads and writes (evidence: `backend/controllers/user.controller.js`)
- Company operations → Company records: reads and writes (evidence: `backend/controllers/company.controller.js`)
- Job operations → Job records: reads and writes (evidence: `backend/controllers/job.controller.js`)
- Application operations → Application records: reads and writes (evidence: `backend/controllers/application.controller.js`)
- Application operations → Job records: reads and updates (evidence: `backend/controllers/application.controller.js`)
- User operations → File URI conversion: converts uploads (evidence: `backend/controllers/user.controller.js`)
- Company operations → File URI conversion: converts uploads (evidence: `backend/controllers/company.controller.js`)
- User operations → Cloudinary media: uploads media (evidence: `backend/controllers/user.controller.js`)
- Company operations → Cloudinary media: uploads media (evidence: `backend/controllers/company.controller.js`)
