How gauravgavhale2002/agenticai_hr_candidate-portal works
TalentFlow AI combines a React candidate portal and HR dashboard with a Spring Boot recruitment API. Candidates register with a profile, skills, and PDF resume, then can sign in to view hiring progress; HR reviews candidates, accesses resumes, and updates hiring stages. The source excerpts show controller-to-service calls and some service-to-repository interactions. The README documents in-memory H2 storage; connections not evidenced in the excerpts are omitted or marked unverified.
Main entry points: HrController.java HR workflow API · App.tsx Candidate and HR UI · AuthService.java Registration and hiring stages · JobApplicationService.java Job applications
Components 17
User experience
- Candidate and HR UI
frontend/src/App.tsx
API endpoints
- Registration and login API
backend/src/main/java/com/talentflow/controller/AuthController.java - Candidate profile API
backend/src/main/java/com/talentflow/controller/CandidateController.java - HR workflow API
backend/src/main/java/com/talentflow/controller/HrController.java
Recruitment workflow
- Registration and hiring stages
backend/src/main/java/com/talentflow/service/AuthService.java - Resume screening
backend/src/main/java/com/talentflow/service/ResumeScreeningAgent.java - Resume file storage
backend/src/main/java/com/talentflow/service/ResumeStorageService.java - Candidate profiles
backend/src/main/java/com/talentflow/service/CandidateService.java - Job applications
backend/src/main/java/com/talentflow/service/JobApplicationService.java - Job listings
backend/src/main/java/com/talentflow/service/JobService.java
Persistence
- Candidate records
backend/src/main/java/com/talentflow/repository/CandidateRepository.java - User records
backend/src/main/java/com/talentflow/repository/UserRepository.java - Application records
backend/src/main/java/com/talentflow/repository/JobApplicationRepository.java - Job records
backend/src/main/java/com/talentflow/repository/JobRepository.java - In-memory H2 database
Other components
- Candidate
- HR administrator
Connections 22
- Candidate → Candidate and HR UI: uses portal
README.md - HR administrator → Candidate and HR UI: uses dashboard
README.md - Candidate and HR UI → Registration and login API: submits registration
- Candidate and HR UI → HR workflow API: requests HR workflow
- Candidate and HR UI → Registration and login API: requests candidate login
- Registration and login API → Registration and hiring stages: registers and logs in
backend/src/main/java/com/talentflow/controller/AuthController.java - Candidate profile API → Candidate profiles: creates and reads profiles
backend/src/main/java/com/talentflow/controller/CandidateController.java - HR workflow API → Registration and hiring stages: lists and updates candidates
backend/src/main/java/com/talentflow/controller/HrController.java - HR workflow API → Job applications: submits and reads applications
backend/src/main/java/com/talentflow/controller/HrController.java - HR workflow API → Registration and hiring stages: loads resume metadata
backend/src/main/java/com/talentflow/controller/HrController.java - HR workflow API → Resume file storage: resolves resume file
backend/src/main/java/com/talentflow/controller/HrController.java - Registration and hiring stages → Resume screening: analyzes resume
backend/src/main/java/com/talentflow/service/AuthService.java - Registration and hiring stages → Resume file storage: validates and stores resume
backend/src/main/java/com/talentflow/service/AuthService.java - Candidate profiles → Candidate records: saves and queries
backend/src/main/java/com/talentflow/service/CandidateService.java - Candidate profiles → User records: loads user
backend/src/main/java/com/talentflow/service/CandidateService.java - Job applications → Candidate records: loads candidate
backend/src/main/java/com/talentflow/service/JobApplicationService.java - Job applications → Job records: loads job
backend/src/main/java/com/talentflow/service/JobApplicationService.java - Job applications → Application records: saves and queries
backend/src/main/java/com/talentflow/service/JobApplicationService.java - Candidate records → In-memory H2 database: persists records
- User records → In-memory H2 database: persists records
- Application records → In-memory H2 database: persists records
- Job records → In-memory H2 database: persists records