# piyush-raj-07/job-portal architecture

> Architecture diagram of the GitHub repository piyush-raj-07/job-portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/piyush-raj-07/job-portal
- Repository: https://github.com/piyush-raj-07/job-portal

## Overview

Job Portal lets candidates discover jobs, apply, manage profiles and resumes, while recruiters manage companies, jobs and applicants. Its main flow runs from the React client through Express routes/controllers to MongoDB; application and resume features add uploads and optional AI assistance. The README documents the major user-facing capabilities, while source excerpts and the SOURCE INDEX support selected runtime connections; unsampled UI and backend details are represented only at subsystem level.

Main entry points: [`backend/index.js`](https://github.com/piyush-raj-07/job-portal/blob/main/backend/index.js) (Express API), [`client/src/App.jsx`](https://github.com/piyush-raj-07/job-portal/blob/main/client/src/App.jsx) (React application), [`backend/controllers/application.controller.js`](https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/application.controller.js) (Applications), [`backend/controllers/resume.controller.js`](https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/resume.controller.js) (Resume management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Candidate and recruiter client"]
  node_client_app["React application<br/>[App.jsx]"]
  node_job_discovery["Job discovery<br/>[Jobs.jsx]"]
  node_job_detail["Job details and apply<br/>[JobDescription.jsx]"]
  node_recruiter_ui["Recruiter workspace"]
  node_profile_ui["Profile and applications<br/>[Profile.jsx]"]
  node_resume_ui["Resume builder<br/>[ResumeBuilder.jsx]"]
  node_resume_library["Saved resumes<br/>[MyResumes.jsx]"]
  node_session["Session refresh<br/>[useCheckAuth.jsx]"]
end

subgraph group_api["Portal API"]
  node_api_entry["Express API<br/>[index.js]"]
  node_user_flow["Accounts and verification<br/>[user.controller.js]"]
  node_job_flow["Job management<br/>[job.controller.js]"]
  node_company_flow["Company management"]
  node_application_flow["Applications"]
  node_resume_flow["Resume management"]
  node_auth_guard["JWT authorization<br/>[auth.middleware.js]"]
  node_ai_bridge["AI service bridge<br/>[aiService.js]"]
end

subgraph group_data["Portal data and integrations"]
  node_mongo[("MongoDB")]
  node_upload_store["Cloudinary uploads<br/>[cloudinary.js]"]
  node_email["Email delivery<br/>[sendEmail.js]"]
  node_job_model[("Job records<br/>[job.model.js]")]
  node_application_model[("Application records")]
  node_resume_model[("Resume records<br/>[resume.model.js]")]
  node_user_model[("User records<br/>[user.model.js]")]
  node_company_model[("Company records<br/>[company.model.js]")]
end

subgraph group_ai["AI resume service"]
  node_ai_routes["Resume AI endpoints<br/>[resume_routes.py]"]
  node_resume_agents["AI resume agents"]
  node_resume_schema["Resume request models<br/>[resume_schema.py]"]
  node_review_rubric["Review scoring rubric<br/>[rubric.py]"]
  node_llm["Groq language model"]
  node_llm_client["LLM client<br/>[llm_service.py]"]
end

node_candidate(("Candidate"))
node_recruiter(("Recruiter"))

node_candidate -->|"uses"| node_client_app
node_recruiter -->|"uses"| node_client_app
node_client_app -->|"routes to"| node_job_discovery
node_client_app -->|"routes to"| node_job_detail
node_client_app -->|"routes to"| node_recruiter_ui
node_client_app -->|"routes to"| node_resume_ui
node_client_app -->|"routes to"| node_resume_library
node_client_app -->|"routes to"| node_profile_ui
node_client_app -->|"checks session"| node_session
node_job_discovery -->|"requests jobs"| node_api_entry
node_job_detail -->|"applies to jobs"| node_api_entry
node_recruiter_ui -->|"manages listings"| node_api_entry
node_profile_ui -->|"updates and tracks"| node_api_entry
node_resume_ui -->|"saves resumes"| node_api_entry
node_resume_library -->|"manages resumes"| node_api_entry
node_api_entry -->|"routes to"| node_user_flow
node_api_entry -->|"routes to"| node_job_flow
node_api_entry -->|"routes to"| node_company_flow
node_api_entry -->|"routes to"| node_application_flow
node_api_entry -->|"routes to"| node_resume_flow
node_application_flow -->|"checks job"| node_job_model
node_application_flow -->|"creates and queries"| node_application_model
node_application_flow -->|"loads applicant"| node_user_model
node_application_flow -->|"uploads resume"| node_upload_store
node_application_flow -->|"sends status notice"| node_email
node_job_flow -->|"manages jobs"| node_job_model
node_company_flow -->|"manages companies"| node_company_model
node_company_flow -->|"uploads company media"| node_upload_store
node_user_flow -->|"manages accounts"| node_user_model
node_user_flow -->|"sends verification"| node_email
node_auth_guard -->|"loads user"| node_user_model
node_resume_flow -->|"manages resumes"| node_resume_model
node_resume_flow -->|"loads job for match"| node_job_model
node_resume_flow -->|"requests AI"| node_ai_bridge
node_ai_bridge -.->|"calls service"| node_ai_routes
node_ai_routes -->|"dispatches tasks"| node_resume_agents
node_ai_routes -->|"validates payloads"| node_resume_schema
node_resume_agents -->|"requests completions"| node_llm_client
node_resume_agents -->|"scores reviews"| node_review_rubric
node_llm_client -->|"invokes model"| node_llm

click node_client_app "https://github.com/piyush-raj-07/job-portal/blob/main/client/src/App.jsx"
click node_job_discovery "https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/Jobs.jsx"
click node_job_detail "https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/JobDescription.jsx"
click node_recruiter_ui "https://github.com/piyush-raj-07/job-portal/tree/main/client/src/components/admin"
click node_profile_ui "https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/Profile.jsx"
click node_resume_ui "https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/resume/ResumeBuilder.jsx"
click node_resume_library "https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/resume/MyResumes.jsx"
click node_session "https://github.com/piyush-raj-07/job-portal/blob/main/client/src/hooks/useCheckAuth.jsx"
click node_api_entry "https://github.com/piyush-raj-07/job-portal/blob/main/backend/index.js"
click node_user_flow "https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/user.controller.js"
click node_job_flow "https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/job.controller.js"
click node_company_flow "https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/company.controller.js"
click node_application_flow "https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/application.controller.js"
click node_resume_flow "https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/resume.controller.js"
click node_auth_guard "https://github.com/piyush-raj-07/job-portal/blob/main/backend/middlewares/auth.middleware.js"
click node_upload_store "https://github.com/piyush-raj-07/job-portal/blob/main/backend/utils/cloudinary.js"
click node_email "https://github.com/piyush-raj-07/job-portal/blob/main/backend/utils/sendEmail.js"
click node_ai_bridge "https://github.com/piyush-raj-07/job-portal/blob/main/backend/services/aiService.js"
click node_ai_routes "https://github.com/piyush-raj-07/job-portal/blob/main/backend/ai-service/app/routes/resume_routes.py"
click node_resume_agents "https://github.com/piyush-raj-07/job-portal/tree/main/backend/ai-service/app/agents"
click node_resume_schema "https://github.com/piyush-raj-07/job-portal/blob/main/backend/ai-service/app/schemas/resume_schema.py"
click node_review_rubric "https://github.com/piyush-raj-07/job-portal/blob/main/backend/ai-service/app/services/rubric.py"
click node_llm_client "https://github.com/piyush-raj-07/job-portal/blob/main/backend/ai-service/app/services/llm_service.py"
click node_job_model "https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/job.model.js"
click node_application_model "https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/application.model.js"
click node_resume_model "https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/resume.model.js"
click node_user_model "https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/user.model.js"
click node_company_model "https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/company.model.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_client_app,node_job_discovery,node_job_detail,node_recruiter_ui,node_profile_ui,node_resume_ui,node_resume_library,node_session toneBlue
class node_api_entry,node_user_flow,node_job_flow,node_company_flow,node_application_flow,node_resume_flow,node_auth_guard,node_ai_bridge toneAmber
class node_mongo,node_upload_store,node_email,node_job_model,node_application_model,node_resume_model,node_user_model,node_company_model toneMint
class node_ai_routes,node_resume_agents,node_resume_schema,node_review_rubric,node_llm,node_llm_client toneRose
class node_candidate,node_recruiter toneIndigo
```

## Components

### Candidate and recruiter client

- [React application](https://github.com/piyush-raj-07/job-portal/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Job discovery](https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/Jobs.jsx): `client/src/components/Jobs.jsx`
- [Job details and apply](https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/JobDescription.jsx): `client/src/components/JobDescription.jsx`
- [Recruiter workspace](https://github.com/piyush-raj-07/job-portal/tree/main/client/src/components/admin): `client/src/components/admin`
- [Profile and applications](https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/Profile.jsx): `client/src/components/Profile.jsx`
- [Resume builder](https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/resume/ResumeBuilder.jsx): `client/src/components/resume/ResumeBuilder.jsx`
- [Saved resumes](https://github.com/piyush-raj-07/job-portal/blob/main/client/src/components/resume/MyResumes.jsx): `client/src/components/resume/MyResumes.jsx`
- [Session refresh](https://github.com/piyush-raj-07/job-portal/blob/main/client/src/hooks/useCheckAuth.jsx): `client/src/hooks/useCheckAuth.jsx`

### Portal API

- [Express API](https://github.com/piyush-raj-07/job-portal/blob/main/backend/index.js): `backend/index.js`
- [Accounts and verification](https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/user.controller.js): `backend/controllers/user.controller.js`
- [Job management](https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/job.controller.js): `backend/controllers/job.controller.js`
- [Company management](https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/company.controller.js): `backend/controllers/company.controller.js`
- [Applications](https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/application.controller.js): `backend/controllers/application.controller.js`
- [Resume management](https://github.com/piyush-raj-07/job-portal/blob/main/backend/controllers/resume.controller.js): `backend/controllers/resume.controller.js`
- [JWT authorization](https://github.com/piyush-raj-07/job-portal/blob/main/backend/middlewares/auth.middleware.js): `backend/middlewares/auth.middleware.js`
- [AI service bridge](https://github.com/piyush-raj-07/job-portal/blob/main/backend/services/aiService.js): `backend/services/aiService.js`

### Portal data and integrations

- **MongoDB**
- [Cloudinary uploads](https://github.com/piyush-raj-07/job-portal/blob/main/backend/utils/cloudinary.js): `backend/utils/cloudinary.js`
- [Email delivery](https://github.com/piyush-raj-07/job-portal/blob/main/backend/utils/sendEmail.js): `backend/utils/sendEmail.js`
- [Job records](https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/job.model.js): `backend/models/job.model.js`
- [Application records](https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/application.model.js): `backend/models/application.model.js`
- [Resume records](https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/resume.model.js): `backend/models/resume.model.js`
- [User records](https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/user.model.js): `backend/models/user.model.js`
- [Company records](https://github.com/piyush-raj-07/job-portal/blob/main/backend/models/company.model.js): `backend/models/company.model.js`

### AI resume service

- [Resume AI endpoints](https://github.com/piyush-raj-07/job-portal/blob/main/backend/ai-service/app/routes/resume_routes.py): `backend/ai-service/app/routes/resume_routes.py`
- [AI resume agents](https://github.com/piyush-raj-07/job-portal/tree/main/backend/ai-service/app/agents): `backend/ai-service/app/agents`
- [Resume request models](https://github.com/piyush-raj-07/job-portal/blob/main/backend/ai-service/app/schemas/resume_schema.py): `backend/ai-service/app/schemas/resume_schema.py`
- [Review scoring rubric](https://github.com/piyush-raj-07/job-portal/blob/main/backend/ai-service/app/services/rubric.py): `backend/ai-service/app/services/rubric.py`
- **Groq language model**
- [LLM client](https://github.com/piyush-raj-07/job-portal/blob/main/backend/ai-service/app/services/llm_service.py): `backend/ai-service/app/services/llm_service.py`

### Other components

- **Candidate**
- **Recruiter**

## Connections

- Candidate → React application: uses (evidence: `README.md`)
- Recruiter → React application: uses (evidence: `README.md`)
- React application → Job discovery: routes to (evidence: `client/src/App.jsx`)
- React application → Job details and apply: routes to (evidence: `client/src/App.jsx`)
- React application → Recruiter workspace: routes to (evidence: `client/src/App.jsx`)
- React application → Resume builder: routes to (evidence: `client/src/App.jsx`)
- React application → Saved resumes: routes to (evidence: `client/src/App.jsx`)
- React application → Profile and applications: routes to (evidence: `client/src/App.jsx`)
- React application → Session refresh: checks session (evidence: `client/src/App.jsx`)
- Job discovery → Express API: requests jobs (evidence: `README.md`)
- Job details and apply → Express API: applies to jobs (evidence: `README.md`)
- Recruiter workspace → Express API: manages listings (evidence: `README.md`)
- Profile and applications → Express API: updates and tracks (evidence: `README.md`)
- Resume builder → Express API: saves resumes (evidence: `README.md`)
- Saved resumes → Express API: manages resumes (evidence: `README.md`)
- Express API → Accounts and verification: routes to (evidence: `backend/index.js`)
- Express API → Job management: routes to (evidence: `backend/index.js`)
- Express API → Company management: routes to (evidence: `backend/index.js`)
- Express API → Applications: routes to (evidence: `backend/index.js`)
- Express API → Resume management: routes to (evidence: `backend/index.js`)
- Applications → Job records: checks job (evidence: `backend/controllers/application.controller.js`)
- Applications → Application records: creates and queries (evidence: `backend/controllers/application.controller.js`)
- Applications → User records: loads applicant (evidence: `backend/controllers/application.controller.js`)
- Applications → Cloudinary uploads: uploads resume (evidence: `backend/controllers/application.controller.js`)
- Applications → Email delivery: sends status notice (evidence: `backend/controllers/application.controller.js`)
- Job management → Job records: manages jobs (evidence: `backend/controllers/job.controller.js`)
- Company management → Company records: manages companies (evidence: `backend/controllers/company.controller.js`)
- Company management → Cloudinary uploads: uploads company media (evidence: `backend/controllers/company.controller.js`)
- Accounts and verification → User records: manages accounts (evidence: `backend/controllers/user.controller.js`)
- Accounts and verification → Email delivery: sends verification (evidence: `backend/controllers/user.controller.js`)
- JWT authorization → User records: loads user (evidence: `backend/middlewares/auth.middleware.js`)
- Resume management → Resume records: manages resumes (evidence: `backend/controllers/resume.controller.js`)
- Resume management → Job records: loads job for match (evidence: `backend/controllers/resume.controller.js`)
- Resume management → AI service bridge: requests AI (evidence: `backend/controllers/resume.controller.js`)
- AI service bridge → Resume AI endpoints: calls service
- Resume AI endpoints → AI resume agents: dispatches tasks (evidence: `backend/ai-service/app/routes/resume_routes.py`)
- Resume AI endpoints → Resume request models: validates payloads (evidence: `backend/ai-service/app/routes/resume_routes.py`)
- AI resume agents → LLM client: requests completions (evidence: `backend/ai-service/app/agents/reviewer.py`)
- AI resume agents → Review scoring rubric: scores reviews (evidence: `backend/ai-service/app/agents/reviewer.py`)
- LLM client → Groq language model: invokes model (evidence: `backend/ai-service/app/services/llm_service.py`)
