How dineshrajbhar-cloud/ai-powered-jobportal works
This is a full-stack recruitment portal: candidates browse jobs, apply with resumes, track application status, and use AI resume matching; recruiters manage postings and applicants. The React frontend calls a Spring Boot API for authentication and portal operations. Resume matching is documented as a separate FastAPI service that extracts PDF text, fetches jobs, and uses Groq to return matches. The README documents the service boundaries; several backend and frontend implementation details were not sampled, so those links are cited to the README or left unasserted.
Main entry points: api.js API client · App.jsx React app · repositories JPA repositories · main.py AI endpoints
Components 26
Web application
- React app
jobportal-frontend/src/App.jsx - Candidate workflows
jobportal-frontend/src/pages/candidate - Recruiter workflows
jobportal-frontend/src/pages/recruiter - Resume matcher
jobportal-frontend/src/pages/ResumeMatcher.jsx - API client
jobportal-frontend/src/lib/api.js - Job client
jobportal-frontend/src/services/jobService.js - Application client
jobportal-frontend/src/services/applicationService.js - AI client
jobportal-frontend/src/services/aiService.js
Identity and access
- Auth context
jobportal-frontend/src/context/AuthContext.jsx - Auth client
jobportal-frontend/src/services/authService.js - Auth API
src/main/java/com/dinesh/jobportal/controller/AuthController.java - Authentication service
src/main/java/com/dinesh/jobportal/serviceImpl/AuthServiceImpl.java
Recruitment backend
- Job API
src/main/java/com/dinesh/jobportal/controller/JobController.java - Job service
src/main/java/com/dinesh/jobportal/serviceImpl/JobServiceImpl.java - Application API
src/main/java/com/dinesh/jobportal/controller/ApplicationController.java - Application service
src/main/java/com/dinesh/jobportal/serviceImpl/ApplicationServiceImpl.java - Dashboards
src/main/java/com/dinesh/jobportal/serviceImpl/DashboardServiceImpl.java
AI matching
- AI bridge
src/main/java/com/dinesh/jobportal/serviceImpl/AiServiceImpl.java - AI endpoints
ai-service/main.py - PDF extraction
ai-service/main.py - Job fetcher
ai-service/job_service.py - Groq integration
ai-service/groq_service.py
Persistent data
- MySQL
- JPA repositories
src/main/java/com/dinesh/jobportal/repositories
Other components
- Candidate
- Recruiter
Connections 30
- Candidate → React app: uses
README.md - Recruiter → React app: uses
README.md - React app → Candidate workflows: routes to
jobportal-frontend/src/App.jsx - React app → Recruiter workflows: routes to
jobportal-frontend/src/App.jsx - Candidate workflows → Application client: manages applications
- Recruiter workflows → Application client: manages applicants
- Auth context → Auth client: uses
jobportal-frontend/src/context/AuthContext.jsx - Auth client → API client: requests
jobportal-frontend/src/services/authService.js - Job client → API client: requests
jobportal-frontend/src/services/jobService.js - Application client → API client: requests
jobportal-frontend/src/services/applicationService.js - AI client → API client: requests
- React app → Auth context: provides auth
jobportal-frontend/src/main.jsx - API client → Auth API: calls REST API
README.md - API client → Job API: calls REST API
README.md - API client → Application API: calls REST API
README.md - Auth API → Authentication service: delegates
- Authentication service → JPA repositories: reads and saves
src/main/java/com/dinesh/jobportal/serviceImpl/AuthServiceImpl.java - Job API → Job service: delegates
src/main/java/com/dinesh/jobportal/controller/JobController.java - Application API → Application service: delegates
src/main/java/com/dinesh/jobportal/controller/ApplicationController.java - Job service → JPA repositories: accesses jobs
- Application service → JPA repositories: accesses applications
- Dashboards → JPA repositories: aggregates data
- JPA repositories → MySQL: persists records
README.md - Resume matcher → AI client: requests matching
jobportal-frontend/src/pages/ResumeMatcher.jsx - AI bridge → AI endpoints: forwards resume
README.md - AI endpoints → PDF extraction: extracts text
ai-service/main.py - AI endpoints → Job fetcher: fetches jobs
ai-service/main.py - AI endpoints → Groq integration: requests analysis
ai-service/main.py - Job fetcher → Job API: fetches available jobs
README.md - Groq integration → Candidate: returns match results
README.md