# rushikeshchitkeswar/jobyatra architecture

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

- Interactive diagram: https://gitdiagram.com/rushikeshchitkeswar/jobyatra
- Repository: https://github.com/rushikeshchitkeswar/jobyatra

## Overview

JobYatra is a job marketplace with candidate, recruiter, and administrator workflows. Users enter through the React application; its routed pages provide job discovery, applications, profile management, recruiter hiring tools, and administration. The Express API exposes role-protected routes whose controllers operate on MongoDB models. Candidate profiles, resumes, applications, interviews, alerts, and recruiter analytics form distinct domain stages. The source excerpts establish backend routing and several controller-to-model links; frontend API usage and some unsampled integrations are not shown, so those connections are omitted.

Main entry points: [`Backend/models/Job.js`](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/Job.js) (Job records), [`Backend/controllers/adminController.js`](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/adminController.js) (Administration), [`Backend/controllers/jobApplicationController.js`](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/jobApplicationController.js) (Application handling), [`Backend/candidate/controllers/candidateController.js`](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/candidate/controllers/candidateController.js) (Candidate services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["React routes<br/>[App.jsx]"]
  node_authstate["Login state<br/>[AuthContext.jsx]"]
  node_webapi["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["Express server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authlogic["Authentication<br/>[authController.js]"]
  node_access["Access control<br/>[authMiddleware.js]"]
  node_users[("User accounts<br/>[User.js]")]
  node_jobroutes["Job routes<br/>[jobRoutes.js]"]
  node_joblogic["Job listings<br/>[jobController.js]"]
  node_jobs[("Job records<br/>[Job.js]")]
end

subgraph group_candidate["Candidate journey"]
  node_applicationlogic["Application handling"]
  node_applications[("Applications<br/>[JobApplication.js]")]
  node_candidate_routes["Candidate routes<br/>[candidateRoutes.js]"]
  node_candidate_logic["Candidate services"]
  node_candidate_profile[("Profile records")]
  node_profile_parts[("Profile details")]
end

subgraph group_hiring["Recruiter hiring"]
  node_recruiter_logic["Recruiter tools"]
  node_recruiter_profile[("Recruiter profiles")]
  node_interviews[("Interview scheduling<br/>[Interview.js]")]
end

subgraph group_operations["Platform operations"]
  node_admin_logic["Administration<br/>[adminController.js]"]
  node_notifications[("Notifications<br/>[Notification.js]")]
  node_cloudinary["File storage config<br/>[cloudinary.js]"]
end

node_visitor(("Marketplace users"))

node_visitor -->|"uses"| node_webapp
node_webapp -->|"reads session"| node_authstate
node_webapp -.-> node_webapi
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_jobroutes
node_authroutes -->|"routes requests"| node_authlogic
node_authlogic -->|"reads and writes"| node_users
node_authroutes -->|"protects routes"| node_access
node_access -->|"loads account"| node_users
node_jobroutes -->|"routes requests"| node_joblogic
node_joblogic -->|"reads and writes"| node_jobs
node_jobroutes -->|"routes submissions"| node_applicationlogic
node_applicationlogic -->|"creates applications"| node_applications
node_applicationlogic -->|"loads job"| node_jobs
node_server -->|"mounts routes"| node_candidate_routes
node_candidate_routes -->|"routes requests"| node_candidate_logic
node_candidate_logic -->|"reads and writes"| node_candidate_profile
node_candidate_logic -->|"manages details"| node_profile_parts
node_candidate_logic -->|"finds recommendations"| node_jobs
node_recruiter_logic -->|"queries listings"| node_jobs
node_recruiter_logic -->|"aggregates pipeline"| node_applications
node_recruiter_logic -->|"updates profile"| node_recruiter_profile
node_admin_logic -->|"manages accounts"| node_users
node_admin_logic -->|"manages listings"| node_jobs
node_admin_logic -->|"counts applications"| node_applications
node_admin_logic -->|"uses notifications"| node_notifications
node_applicationlogic -->|"uploads resume"| node_cloudinary

click node_webapp "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Frontend/src/App.jsx"
click node_authstate "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Frontend/src/context/AuthContext.jsx"
click node_webapi "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Frontend/src/api/api.js"
click node_server "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/server.js"
click node_authroutes "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/routes/authRoutes.js"
click node_authlogic "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/authController.js"
click node_access "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/middleware/authMiddleware.js"
click node_users "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/User.js"
click node_jobroutes "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/routes/jobRoutes.js"
click node_joblogic "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/jobController.js"
click node_jobs "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/Job.js"
click node_applicationlogic "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/jobApplicationController.js"
click node_applications "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/JobApplication.js"
click node_candidate_routes "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/candidate/routes/candidateRoutes.js"
click node_candidate_logic "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/candidate/controllers/candidateController.js"
click node_candidate_profile "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/modules/candidate/profile/models/candidateProfile.model.js"
click node_profile_parts "https://github.com/rushikeshchitkeswar/jobyatra/tree/main/Backend/modules/candidate/profile/models"
click node_recruiter_logic "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/recruiterController.js"
click node_recruiter_profile "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/RecruiterProfile.js"
click node_interviews "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/Interview.js"
click node_admin_logic "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/adminController.js"
click node_notifications "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/Notification.js"
click node_cloudinary "https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/config/cloudinary.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_authstate,node_webapi,node_visitor toneBlue
class node_server,node_authroutes,node_authlogic,node_access,node_users,node_jobroutes,node_joblogic,node_jobs toneAmber
class node_applicationlogic,node_applications,node_candidate_routes,node_candidate_logic,node_candidate_profile,node_profile_parts toneMint
class node_recruiter_logic,node_recruiter_profile,node_interviews toneRose
class node_admin_logic,node_notifications,node_cloudinary toneIndigo
```

## Components

### Web application

- [React routes](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Login state](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Frontend/src/context/AuthContext.jsx): `Frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Frontend/src/api/api.js): `Frontend/src/api/api.js`

### API and access

- [Express server](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/server.js): `Backend/server.js`
- [Auth routes](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/routes/authRoutes.js): `Backend/routes/authRoutes.js`
- [Authentication](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/authController.js): `Backend/controllers/authController.js`
- [Access control](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/middleware/authMiddleware.js): `Backend/middleware/authMiddleware.js`
- [User accounts](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/User.js): `Backend/models/User.js`
- [Job routes](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/routes/jobRoutes.js): `Backend/routes/jobRoutes.js`
- [Job listings](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/jobController.js): `Backend/controllers/jobController.js`
- [Job records](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/Job.js): `Backend/models/Job.js`

### Candidate journey

- [Application handling](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/jobApplicationController.js): `Backend/controllers/jobApplicationController.js`
- [Applications](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/JobApplication.js): `Backend/models/JobApplication.js`
- [Candidate routes](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/candidate/routes/candidateRoutes.js): `Backend/candidate/routes/candidateRoutes.js`
- [Candidate services](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/candidate/controllers/candidateController.js): `Backend/candidate/controllers/candidateController.js`
- [Profile records](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/modules/candidate/profile/models/candidateProfile.model.js): `Backend/modules/candidate/profile/models/candidateProfile.model.js`
- [Profile details](https://github.com/rushikeshchitkeswar/jobyatra/tree/main/Backend/modules/candidate/profile/models): `Backend/modules/candidate/profile/models`

### Recruiter hiring

- [Recruiter tools](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/recruiterController.js): `Backend/controllers/recruiterController.js`
- [Recruiter profiles](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/RecruiterProfile.js): `Backend/models/RecruiterProfile.js`
- [Interview scheduling](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/Interview.js): `Backend/models/Interview.js`

### Platform operations

- [Administration](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/controllers/adminController.js): `Backend/controllers/adminController.js`
- [Notifications](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/models/Notification.js): `Backend/models/Notification.js`
- [File storage config](https://github.com/rushikeshchitkeswar/jobyatra/blob/main/Backend/config/cloudinary.js): `Backend/config/cloudinary.js`

### Other components

- **Marketplace users**

## Connections

- Marketplace users → React routes: uses (evidence: `Frontend/src/App.jsx`)
- React routes → Login state: reads session (evidence: `Frontend/src/App.jsx`)
- React routes → API client
- Express server → Auth routes: mounts routes (evidence: `Backend/server.js`)
- Express server → Job routes: mounts routes (evidence: `Backend/server.js`)
- Auth routes → Authentication: routes requests (evidence: `Backend/routes/authRoutes.js`)
- Authentication → User accounts: reads and writes (evidence: `Backend/controllers/authController.js`)
- Auth routes → Access control: protects routes (evidence: `Backend/routes/authRoutes.js`)
- Access control → User accounts: loads account (evidence: `Backend/middleware/authMiddleware.js`)
- Job routes → Job listings: routes requests (evidence: `Backend/routes/jobRoutes.js`)
- Job listings → Job records: reads and writes (evidence: `Backend/controllers/jobController.js`)
- Job routes → Application handling: routes submissions (evidence: `Backend/routes/jobRoutes.js`)
- Application handling → Applications: creates applications (evidence: `Backend/controllers/jobApplicationController.js`)
- Application handling → Job records: loads job (evidence: `Backend/controllers/jobApplicationController.js`)
- Express server → Candidate routes: mounts routes (evidence: `Backend/server.js`)
- Candidate routes → Candidate services: routes requests (evidence: `Backend/candidate/routes/candidateRoutes.js`)
- Candidate services → Profile records: reads and writes (evidence: `Backend/candidate/controllers/candidateController.js`)
- Candidate services → Profile details: manages details (evidence: `Backend/candidate/controllers/candidateController.js`)
- Candidate services → Job records: finds recommendations (evidence: `Backend/candidate/controllers/candidateController.js`)
- Recruiter tools → Job records: queries listings (evidence: `Backend/controllers/recruiterController.js`)
- Recruiter tools → Applications: aggregates pipeline (evidence: `Backend/controllers/recruiterController.js`)
- Recruiter tools → Recruiter profiles: updates profile (evidence: `Backend/controllers/recruiterController.js`)
- Administration → User accounts: manages accounts (evidence: `Backend/controllers/adminController.js`)
- Administration → Job records: manages listings (evidence: `Backend/controllers/adminController.js`)
- Administration → Applications: counts applications (evidence: `Backend/controllers/adminController.js`)
- Administration → Notifications: uses notifications (evidence: `Backend/controllers/adminController.js`)
- Application handling → File storage config: uploads resume (evidence: `Backend/controllers/jobApplicationController.js`)
