How piyush-raj-07/job-portal works
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: index.js Express API · App.jsx React application · application.controller.js Applications · resume.controller.js Resume management
Components 32
Candidate and recruiter client
- React application
client/src/App.jsx - Job discovery
client/src/components/Jobs.jsx - Job details and apply
client/src/components/JobDescription.jsx - Recruiter workspace
client/src/components/admin - Profile and applications
client/src/components/Profile.jsx - Resume builder
client/src/components/resume/ResumeBuilder.jsx - Saved resumes
client/src/components/resume/MyResumes.jsx - Session refresh
client/src/hooks/useCheckAuth.jsx
Portal API
- Express API
backend/index.js - Accounts and verification
backend/controllers/user.controller.js - Job management
backend/controllers/job.controller.js - Company management
backend/controllers/company.controller.js - Applications
backend/controllers/application.controller.js - Resume management
backend/controllers/resume.controller.js - JWT authorization
backend/middlewares/auth.middleware.js - AI service bridge
backend/services/aiService.js
Portal data and integrations
- MongoDB
- Cloudinary uploads
backend/utils/cloudinary.js - Email delivery
backend/utils/sendEmail.js - Job records
backend/models/job.model.js - Application records
backend/models/application.model.js - Resume records
backend/models/resume.model.js - User records
backend/models/user.model.js - Company records
backend/models/company.model.js
AI resume service
- Resume AI endpoints
backend/ai-service/app/routes/resume_routes.py - AI resume agents
backend/ai-service/app/agents - Resume request models
backend/ai-service/app/schemas/resume_schema.py - Review scoring rubric
backend/ai-service/app/services/rubric.py - Groq language model
- LLM client
backend/ai-service/app/services/llm_service.py
Other components
- Candidate
- Recruiter
Connections 40
- Candidate → React application: uses
README.md - Recruiter → React application: uses
README.md - React application → Job discovery: routes to
client/src/App.jsx - React application → Job details and apply: routes to
client/src/App.jsx - React application → Recruiter workspace: routes to
client/src/App.jsx - React application → Resume builder: routes to
client/src/App.jsx - React application → Saved resumes: routes to
client/src/App.jsx - React application → Profile and applications: routes to
client/src/App.jsx - React application → Session refresh: checks session
client/src/App.jsx - Job discovery → Express API: requests jobs
README.md - Job details and apply → Express API: applies to jobs
README.md - Recruiter workspace → Express API: manages listings
README.md - Profile and applications → Express API: updates and tracks
README.md - Resume builder → Express API: saves resumes
README.md - Saved resumes → Express API: manages resumes
README.md - Express API → Accounts and verification: routes to
backend/index.js - Express API → Job management: routes to
backend/index.js - Express API → Company management: routes to
backend/index.js - Express API → Applications: routes to
backend/index.js - Express API → Resume management: routes to
backend/index.js - Applications → Job records: checks job
backend/controllers/application.controller.js - Applications → Application records: creates and queries
backend/controllers/application.controller.js - Applications → User records: loads applicant
backend/controllers/application.controller.js - Applications → Cloudinary uploads: uploads resume
backend/controllers/application.controller.js - Applications → Email delivery: sends status notice
backend/controllers/application.controller.js - Job management → Job records: manages jobs
backend/controllers/job.controller.js - Company management → Company records: manages companies
backend/controllers/company.controller.js - Company management → Cloudinary uploads: uploads company media
backend/controllers/company.controller.js - Accounts and verification → User records: manages accounts
backend/controllers/user.controller.js - Accounts and verification → Email delivery: sends verification
backend/controllers/user.controller.js - JWT authorization → User records: loads user
backend/middlewares/auth.middleware.js - Resume management → Resume records: manages resumes
backend/controllers/resume.controller.js - Resume management → Job records: loads job for match
backend/controllers/resume.controller.js - Resume management → AI service bridge: requests AI
backend/controllers/resume.controller.js - AI service bridge → Resume AI endpoints: calls service
- Resume AI endpoints → AI resume agents: dispatches tasks
backend/ai-service/app/routes/resume_routes.py - Resume AI endpoints → Resume request models: validates payloads
backend/ai-service/app/routes/resume_routes.py - AI resume agents → LLM client: requests completions
backend/ai-service/app/agents/reviewer.py - AI resume agents → Review scoring rubric: scores reviews
backend/ai-service/app/agents/reviewer.py - LLM client → Groq language model: invokes model
backend/ai-service/app/services/llm_service.py