# gndeeksha/ai-based-resume-screening-system-using-java architecture

> Architecture diagram of the GitHub repository gndeeksha/ai-based-resume-screening-system-using-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gndeeksha/ai-based-resume-screening-system-using-java
- Repository: https://github.com/gndeeksha/ai-based-resume-screening-system-using-java

## Overview

This is a recruiter-facing resume screening application: recruiters register or log in, define a job, upload resumes, review extracted candidate data and ATS-ranked results, change candidate status, and view dashboard counts. The graph follows documented capabilities and sampled controller/UI calls; resume parsing and scoring are shown where source confirms them. Other screens and services are represented from the README and source index, so unsampled relationships are omitted rather than inferred.

Main entry points: [`frontend/src/services/api.js`](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/services/api.js) (HTTP client), [`frontend/src/App.js`](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/App.js) (Page routing), [`backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java`](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java) (Resume intake API), [`backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java`](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java) (Candidate API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Recruiter interface"]
  node_app["Page routing<br/>[App.js]"]
  node_authui["Account screens<br/>[Login.js]"]
  node_jobui["Job editor<br/>[JobDescription.js]"]
  node_uploadui["Resume upload<br/>[UploadResume.js]"]
  node_rankingui["Candidate ranking"]
  node_dashboardui["Analytics dashboard<br/>[Dashboard.js]"]
  node_api_client["HTTP client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_authapi["Authentication API"]
  node_jobapi["Job API<br/>[JobController.java]"]
  node_resumeapi["Resume intake API"]
  node_atsapi["Candidate API<br/>[ATSController.java]"]
end

subgraph group_domain["Screening logic"]
  node_authservice["Account service<br/>[AuthService.java]"]
  node_parser["Text extraction"]
  node_skills["Skill extraction<br/>[NLPService.java]"]
  node_similarity["TF-IDF similarity<br/>[TFIDFService.java]"]
  node_score["Rule-based scoring<br/>[ATSCalculator.java]"]
end

subgraph group_data["Domain data"]
  node_jobs[("Job records")]
  node_resumes[("Resume records<br/>[Resume.java]")]
  node_users[("User records<br/>[User.java]")]
  node_jobrepo["Job repository<br/>[JobRepository.java]"]
  node_resumerepo["Resume repository"]
  node_userrepo["User repository"]
end

node_recruiter(("Recruiter"))

node_recruiter -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_jobui
node_app -->|"routes to"| node_uploadui
node_app -->|"routes to"| node_rankingui
node_app -->|"routes to"| node_dashboardui
node_authui -->|"requests via"| node_api_client
node_jobui -->|"requests via"| node_api_client
node_uploadui -->|"requests via"| node_api_client
node_rankingui -->|"requests via"| node_api_client
node_dashboardui -->|"requests via"| node_api_client
node_api_client -.->|"calls"| node_authapi
node_api_client -.->|"calls"| node_jobapi
node_api_client -.->|"calls"| node_resumeapi
node_api_client -.->|"calls"| node_atsapi
node_authapi -->|"delegates"| node_authservice
node_authservice -->|"checks and saves"| node_userrepo
node_userrepo -->|"persists"| node_users
node_jobapi -->|"uses"| node_jobrepo
node_jobrepo -->|"persists"| node_jobs
node_resumeapi -->|"loads job"| node_jobrepo
node_resumeapi -->|"extracts text"| node_parser
node_resumeapi -->|"extracts skills"| node_skills
node_resumeapi -->|"saves resumes"| node_resumerepo
node_resumerepo -->|"persists"| node_resumes
node_atsapi -->|"loads and updates"| node_resumerepo
node_atsapi -->|"loads job"| node_jobrepo
node_atsapi -->|"calculates match"| node_similarity
node_atsapi -->|"calculates rules"| node_score

click node_app "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/App.js"
click node_authui "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/Login.js"
click node_jobui "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/JobDescription.js"
click node_uploadui "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/UploadResume.js"
click node_rankingui "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/CandidateRanking.js"
click node_dashboardui "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/Dashboard.js"
click node_api_client "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/services/api.js"
click node_authapi "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/AuthController.java"
click node_jobapi "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/JobController.java"
click node_resumeapi "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java"
click node_atsapi "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java"
click node_authservice "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/service/AuthService.java"
click node_parser "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java"
click node_skills "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/service/NLPService.java"
click node_similarity "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/service/TFIDFService.java"
click node_score "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/service/ATSCalculator.java"
click node_jobs "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/model/JobDescription.java"
click node_resumes "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/model/Resume.java"
click node_users "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/model/User.java"
click node_jobrepo "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/repository/JobRepository.java"
click node_resumerepo "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/repository/ResumeRepository.java"
click node_userrepo "https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/repository/UserRepository.java"

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_app,node_authui,node_jobui,node_uploadui,node_rankingui,node_dashboardui,node_api_client toneBlue
class node_authapi,node_jobapi,node_resumeapi,node_atsapi toneAmber
class node_authservice,node_parser,node_skills,node_similarity,node_score toneMint
class node_jobs,node_resumes,node_users,node_jobrepo,node_resumerepo,node_userrepo toneRose
class node_recruiter toneIndigo
```

## Components

### Recruiter interface

- [Page routing](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Account screens](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/Login.js): `frontend/src/pages/Login.js`
- [Job editor](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/JobDescription.js): `frontend/src/pages/JobDescription.js`
- [Resume upload](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/UploadResume.js): `frontend/src/pages/UploadResume.js`
- [Candidate ranking](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/CandidateRanking.js): `frontend/src/pages/CandidateRanking.js`
- [Analytics dashboard](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/pages/Dashboard.js): `frontend/src/pages/Dashboard.js`
- [HTTP client](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Backend API

- [Authentication API](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/AuthController.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/AuthController.java`
- [Job API](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/JobController.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/JobController.java`
- [Resume intake API](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java`
- [Candidate API](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java`

### Screening logic

- [Account service](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/service/AuthService.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/service/AuthService.java`
- [Text extraction](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java`
- [Skill extraction](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/service/NLPService.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/service/NLPService.java`
- [TF-IDF similarity](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/service/TFIDFService.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/service/TFIDFService.java`
- [Rule-based scoring](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/service/ATSCalculator.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/service/ATSCalculator.java`

### Domain data

- [Job records](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/model/JobDescription.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/model/JobDescription.java`
- [Resume records](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/model/Resume.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/model/Resume.java`
- [User records](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/model/User.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/model/User.java`
- [Job repository](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/repository/JobRepository.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/repository/JobRepository.java`
- [Resume repository](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/repository/ResumeRepository.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/repository/ResumeRepository.java`
- [User repository](https://github.com/gndeeksha/ai-based-resume-screening-system-using-java/blob/main/backend/resumescreening/src/main/java/com/ats/resumescreening/repository/UserRepository.java): `backend/resumescreening/src/main/java/com/ats/resumescreening/repository/UserRepository.java`

### Other components

- **Recruiter**

## Connections

- Recruiter → Page routing: uses (evidence: `README.md`)
- Page routing → Account screens: routes to (evidence: `frontend/src/App.js`)
- Page routing → Job editor: routes to (evidence: `frontend/src/App.js`)
- Page routing → Resume upload: routes to (evidence: `frontend/src/App.js`)
- Page routing → Candidate ranking: routes to (evidence: `frontend/src/App.js`)
- Page routing → Analytics dashboard: routes to (evidence: `frontend/src/App.js`)
- Account screens → HTTP client: requests via (evidence: `frontend/src/pages/Login.js`)
- Job editor → HTTP client: requests via (evidence: `frontend/src/pages/JobDescription.js`)
- Resume upload → HTTP client: requests via (evidence: `frontend/src/pages/UploadResume.js`)
- Candidate ranking → HTTP client: requests via (evidence: `frontend/src/pages/CandidateRanking.js`)
- Analytics dashboard → HTTP client: requests via (evidence: `frontend/src/pages/Dashboard.js`)
- HTTP client → Authentication API: calls
- HTTP client → Job API: calls
- HTTP client → Resume intake API: calls
- HTTP client → Candidate API: calls
- Authentication API → Account service: delegates (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/AuthController.java`)
- Account service → User repository: checks and saves (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/service/AuthService.java`)
- User repository → User records: persists (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/repository/UserRepository.java`)
- Job API → Job repository: uses (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/JobController.java`)
- Job repository → Job records: persists (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/repository/JobRepository.java`)
- Resume intake API → Job repository: loads job (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java`)
- Resume intake API → Text extraction: extracts text (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java`)
- Resume intake API → Skill extraction: extracts skills (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java`)
- Resume intake API → Resume repository: saves resumes (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ResumeController.java`)
- Resume repository → Resume records: persists (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/repository/ResumeRepository.java`)
- Candidate API → Resume repository: loads and updates (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java`)
- Candidate API → Job repository: loads job (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java`)
- Candidate API → TF-IDF similarity: calculates match (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java`)
- Candidate API → Rule-based scoring: calculates rules (evidence: `backend/resumescreening/src/main/java/com/ats/resumescreening/controller/ATSController.java`)
