How revaldo007/resume-scanner works
This is a full-stack resume analysis and candidate-screening application. A user signs in, defines job requirements, uploads resumes for parsing and NLP extraction, then screens and compares candidates using explainable scores and reviews results in analysis, history, and dashboard views. The graph connects evidenced frontend routes and API calls to backend handlers and processing stages; schema/model storage and authentication are included. Some UI pages and backend implementation details were not excerpted, so their internal links are omitted where evidence is unavailable.
Main entry points: database.py Database session · App.jsx App routes · main.py FastAPI application · screening.py Screening routes
Components 25
Web application
- App routes
frontend/src/App.jsx - Auth session
frontend/src/context/AuthContext.jsx - API client
frontend/src/services/api.js - Login and register
frontend/src/pages/Login.jsx - Job management
frontend/src/pages/Jobs.jsx - Resume upload
frontend/src/pages/ResumeUpload.jsx - Analysis and compare
frontend/src/pages/CandidateComparison.jsx - History and dashboard
frontend/src/pages/ScreeningHistory.jsx
API and workflows
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/routers/auth.py - Job routes
backend/app/routers/jobs.py - Resume routes
backend/app/routers/resumes.py - Screening routes
backend/app/routers/screening.py - Dashboard statistics
backend/app/routers/dashboard.py - Token security
backend/app/utils/security.py
Resume processing
- Document parser
backend/app/services/resume_parser.py - NLP extraction
backend/app/services/nlp_processor.py - Candidate matching
backend/app/services/matching_engine.py
Persistence
- Database session
backend/app/database.py - User records
backend/app/models/user.py - Job requirements
backend/app/models/job.py - Resume records
backend/app/models/resume.py - Screening results
backend/app/models/screening.py
Other components
- User
- SQLite
Connections 42
- User → App routes: uses
README.md - App routes → Login and register: routes to
frontend/src/App.jsx - App routes → Job management: routes to
frontend/src/App.jsx - App routes → Resume upload: routes to
frontend/src/App.jsx - App routes → Analysis and compare: routes to
frontend/src/App.jsx - App routes → History and dashboard: routes to
frontend/src/App.jsx - App routes → Auth session: provides session
frontend/src/App.jsx - Login and register → Auth session: signs in
frontend/src/pages/Login.jsx - Auth session → API client: calls
frontend/src/context/AuthContext.jsx - Job management → API client: calls
- Resume upload → API client: uploads
frontend/src/pages/ResumeUpload.jsx - Analysis and compare → API client: requests results
frontend/src/pages/CandidateComparison.jsx - History and dashboard → API client: requests history
- API client → FastAPI application: HTTP requests
frontend/src/services/api.js - FastAPI application → Authentication routes: registers router
backend/app/main.py - FastAPI application → Job routes: registers router
backend/app/main.py - FastAPI application → Resume routes: registers router
backend/app/main.py - FastAPI application → Screening routes: registers router
backend/app/main.py - FastAPI application → Dashboard statistics: registers router
backend/app/main.py - Authentication routes → Database session: opens session
backend/app/routers/auth.py - Job routes → Database session: opens session
backend/app/routers/jobs.py - Resume routes → Database session: opens session
backend/app/routers/resumes.py - Screening routes → Database session: opens session
backend/app/routers/screening.py - Dashboard statistics → Database session: opens session
backend/app/routers/dashboard.py - Authentication routes → Token security: hashes and tokens
backend/app/routers/auth.py - Authentication routes → User records: queries and writes
backend/app/routers/auth.py - Resume routes → Document parser: parses documents
backend/app/routers/resumes.py - Resume routes → NLP extraction: extracts fields
backend/app/routers/resumes.py - Resume routes → Resume records: stores resume
backend/app/routers/resumes.py - Job routes → Job requirements: manages requirements
backend/app/routers/jobs.py - Screening routes → Candidate matching: scores candidates
backend/app/routers/screening.py - Screening routes → Resume records: loads resume
backend/app/routers/screening.py - Screening routes → Job requirements: loads requirement
backend/app/routers/screening.py - Screening routes → Screening results: records scores
backend/app/routers/screening.py - Dashboard statistics → Resume records: reads
backend/app/routers/dashboard.py - Dashboard statistics → Job requirements: reads
backend/app/routers/dashboard.py - Dashboard statistics → Screening results: reads
backend/app/routers/dashboard.py - Database session → SQLite: connects
backend/app/database.py - Database session → User records: maps
backend/app/models/user.py - Database session → Job requirements: maps
backend/app/models/job.py - Database session → Resume records: maps
backend/app/models/resume.py - Database session → Screening results: maps
backend/app/models/screening.py