How geethu27/ai-resume-screening works
Resume Screening System is a deterministic recruiter tool: a recruiter manages job requirements, uploads resumes, screens candidates, and reviews ranked results and score breakdowns. The React interface calls a Flask REST API; upload processing extracts resume text and entities, then screening compares skills, scores candidates, assigns statuses, and persists results. The README documents the principal workflow and capabilities; sampled source confirms key calls and storage behavior. Some route and UI internals are unsampled, so only documented relationships are shown for them.
Main entry points: app.py Flask application · App.jsx Application shell · resume_routes.py Resume endpoints · api.js API client
Components 24
Recruiter interface
- Application shell
frontend/src/App.jsx - Dashboard
frontend/src/pages/Dashboard.jsx - Job management
frontend/src/pages/Jobs.jsx - Resume upload
frontend/src/pages/ResumeUpload.jsx - Screening review
frontend/src/pages/Screening.jsx - Candidate records
frontend/src/pages/Candidates.jsx - Detail modal
frontend/src/components/Modal.jsx - Score badge
frontend/src/components/ScoreBadge.jsx - API client
frontend/src/services/api.js
REST API
- Flask application
backend/app.py - Recruiter authentication
backend/routes/auth_routes.py - Job endpoints
backend/routes/job_routes.py - Resume endpoints
backend/routes/resume_routes.py - Screening endpoints
backend/routes/screening_routes.py - Candidate endpoints
backend/routes/candidate_routes.py
Screening pipeline
- File validation
backend/utils/file_handler.py - Resume text parser
backend/services/resume_parser.py - Text preprocessing
backend/services/text_preprocessor.py - Entity extraction
backend/services/skill_extractor.py - Requirements matcher
backend/services/matching_engine.py - Deterministic scoring
backend/services/scoring_engine.py - Candidate ranking
backend/services/ranking_engine.py
Persistence
- Application database
backend/models/database.py
Other components
- Recruiter
Connections 36
- Recruiter → Application shell: uses
README.md - Application shell → Dashboard: routes to
frontend/src/App.jsx - Application shell → Job management: routes to
frontend/src/App.jsx - Application shell → Resume upload: routes to
frontend/src/App.jsx - Application shell → Screening review: routes to
frontend/src/App.jsx - Application shell → Candidate records: routes to
frontend/src/App.jsx - Screening review → Detail modal: renders
frontend/src/pages/Screening.jsx - Screening review → Score badge: renders
frontend/src/pages/Screening.jsx - Candidate records → Detail modal: renders
frontend/src/pages/Candidates.jsx - Candidate records → Score badge: renders
frontend/src/pages/Candidates.jsx - Dashboard → API client: requests data
frontend/src/pages/Dashboard.jsx - Job management → API client: requests jobs
frontend/src/pages/Jobs.jsx - Resume upload → API client: uploads resumes
frontend/src/services/api.js - Screening review → API client: requests screening
frontend/src/pages/Screening.jsx - Candidate records → API client: requests candidates
frontend/src/pages/Candidates.jsx - API client → Flask application: sends HTTP
README.md - Flask application → Recruiter authentication: registers routes
backend/app.py - Flask application → Job endpoints: registers routes
backend/app.py - Flask application → Resume endpoints: registers routes
backend/app.py - Flask application → Screening endpoints: registers routes
backend/app.py - Flask application → Candidate endpoints: registers routes
backend/app.py - Resume endpoints → File validation: saves upload
backend/routes/resume_routes.py - Resume endpoints → Resume text parser: parses resume
backend/routes/resume_routes.py - Resume endpoints → Text preprocessing: preprocesses text
backend/routes/resume_routes.py - Resume endpoints → Entity extraction: extracts entities
backend/routes/resume_routes.py - Screening endpoints → Requirements matcher: matches skills
backend/routes/screening_routes.py - Screening endpoints → Deterministic scoring: calculates score
backend/routes/screening_routes.py - Screening endpoints → Candidate ranking: ranks candidates
backend/routes/screening_routes.py - Screening endpoints → Application database: reads and writes
backend/routes/screening_routes.py - Resume endpoints → Application database: stores records
backend/routes/resume_routes.py - Job endpoints → Application database: stores jobs
backend/routes/job_routes.py - Recruiter authentication → Application database: checks credentials
backend/routes/auth_routes.py - Candidate endpoints → Application database: reads candidates
backend/routes/candidate_routes.py - Flask application → Application database: initializes
backend/app.py - Requirements matcher → Deterministic scoring: supplies match result
README.md - Deterministic scoring → Candidate ranking: scores before ranking
README.md