How rahulchauhan25/ai-resume-ats works
ATS Resume Scorer is a Streamlit/FastAPI web app whose main workflow takes an uploaded resume and optional job description, analyzes their fit, and presents a score with improvement feedback. Users can also sign in, revisit or delete saved analyses, and export reports. The graph preserves the documented NLP, recommendations, PDF, and history capabilities; some implementation detail is supported only by the source index or README, so those relationships are cited there rather than treated as inspected code.
Main entry points: routes.py API routes · resume_analyzer.py Analysis orchestrator · streamlit_app.py App shell · scorer.py Scoring view
Components 27
User experience
- App shell
frontend/streamlit_app.py - Sign-in
frontend/services/supabase_client.py - Scoring view
frontend/views/scorer.py - History view
frontend/views/history.py - Resources view
frontend/views/resources.py - Results dashboard
frontend/components/dashboard.py - API client
frontend/services/api_client.py
API and identity
- FastAPI app
backend/main.py - API routes
backend/api/routes.py - Token verification
backend/api/auth.py - Response schemas
backend/models/schemas.py - Runtime config
backend/core/config.py
Resume analysis
- File handling
backend/utils/file_utils.py - Resume parsing
backend/services/resume_parser.py - Analysis orchestrator
backend/services/resume_analyzer.py - ATS scoring
backend/services/ats_scorer.py - JD comparison
backend/services/jd_matcher.py - Issue feedback
backend/services/feedback_engine.py - LLM suggestions
backend/services/groq_parser.py - Recommendations
backend/services/recommendation_engine.py - Keyword matching
backend/utils/matching.py
Persistence and reports
- Analysis history
backend/database/supabase_db.py - Supabase services
- Report generation
backend/services/report_generator.py - PDF export
backend/services/pdf_export.py - Report templates
backend/templates
Other components
- Applicant
Connections 31
- Applicant → App shell: uses
README.md - App shell → Scoring view: routes to
frontend/streamlit_app.py - App shell → History view: routes to
frontend/streamlit_app.py - App shell → Resources view: routes to
frontend/streamlit_app.py - App shell → Sign-in: uses
frontend/streamlit_app.py - Scoring view → API client: submits analysis
frontend/views/scorer.py - Scoring view → Results dashboard: renders results
frontend/views/scorer.py - History view → API client: requests history
frontend/views/history.py - API client → API routes: calls API
frontend/services/api_client.py - FastAPI app → API routes: registers routes
backend/main.py - API routes → Token verification: requires identity
backend/api/routes.py - API routes → File handling: uses file handling
backend/api/routes.py - API routes → Resume parsing: parses upload
backend/api/routes.py - API routes → Analysis orchestrator: requests analysis
backend/api/routes.py - API routes → Response schemas: formats response
backend/api/routes.py - Analysis orchestrator → ATS scoring: calls scoring
backend/services/resume_analyzer.py - Analysis orchestrator → JD comparison: compares JD
backend/services/resume_analyzer.py - Analysis orchestrator → Issue feedback: analyzes issues
backend/services/resume_analyzer.py - Analysis orchestrator → LLM suggestions: requests suggestions
backend/services/resume_analyzer.py - Analysis orchestrator → Response schemas: uses models
backend/services/resume_analyzer.py - ATS scoring → Keyword matching: uses matching
backend/services/ats_scorer.py - JD comparison → Keyword matching: uses matching
backend/services/jd_matcher.py - API routes → Analysis history: saves and fetches
backend/api/routes.py - Analysis history → Supabase services: persists history
README.md - API routes → Report generation: builds reports
backend/api/routes.py - API routes → PDF export: exports PDF
backend/api/routes.py - Report generation → Report templates: renders HTML
- Token verification → Runtime config: reads credentials
backend/api/auth.py - Token verification → Supabase services: verifies JWT
backend/api/auth.py - Runtime config → Supabase services: configures access
backend/core/config.py - Analysis orchestrator → Recommendations: provides recommendations