# rahulchauhan25/ai-resume-ats architecture

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

- Interactive diagram: https://gitdiagram.com/rahulchauhan25/ai-resume-ats
- Repository: https://github.com/rahulchauhan25/ai-resume-ats

## Overview

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: [`backend/api/routes.py`](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/api/routes.py) (API routes), [`backend/services/resume_analyzer.py`](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/resume_analyzer.py) (Analysis orchestrator), [`frontend/streamlit_app.py`](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/streamlit_app.py) (App shell), [`frontend/views/scorer.py`](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/views/scorer.py) (Scoring view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User experience"]
  node_streamlit["App shell<br/>[streamlit_app.py]"]
  node_auth_ui["Sign-in<br/>[supabase_client.py]"]
  node_scorer_view["Scoring view<br/>[scorer.py]"]
  node_history_view["History view<br/>[history.py]"]
  node_resources_view["Resources view<br/>[resources.py]"]
  node_dashboard["Results dashboard<br/>[dashboard.py]"]
  node_api_client["API client<br/>[api_client.py]"]
end

subgraph group_api["API and identity"]
  node_fastapi["FastAPI app<br/>[main.py]"]
  node_routes["API routes<br/>[routes.py]"]
  node_auth["Token verification<br/>[auth.py]"]
  node_schemas["Response schemas<br/>[schemas.py]"]
  node_config["Runtime config<br/>[config.py]"]
end

subgraph group_analysis["Resume analysis"]
  node_file_utils["File handling<br/>[file_utils.py]"]
  node_resume_parser["Resume parsing<br/>[resume_parser.py]"]
  node_analyzer["Analysis orchestrator<br/>[resume_analyzer.py]"]
  node_ats_scorer["ATS scoring<br/>[ats_scorer.py]"]
  node_jd_matcher["JD comparison<br/>[jd_matcher.py]"]
  node_feedback["Issue feedback<br/>[feedback_engine.py]"]
  node_groq["LLM suggestions<br/>[groq_parser.py]"]
  node_recommendations["Recommendations"]
  node_matching["Keyword matching<br/>[matching.py]"]
end

subgraph group_data["Persistence and reports"]
  node_database[("Analysis history<br/>[supabase_db.py]")]
  node_supabase[("Supabase services")]
  node_report["Report generation"]
  node_pdf["PDF export<br/>[pdf_export.py]"]
  node_templates["Report templates"]
end

node_user(("Applicant"))

node_user -->|"uses"| node_streamlit
node_streamlit -->|"routes to"| node_scorer_view
node_streamlit -->|"routes to"| node_history_view
node_streamlit -->|"routes to"| node_resources_view
node_streamlit -->|"uses"| node_auth_ui
node_scorer_view -->|"submits analysis"| node_api_client
node_scorer_view -->|"renders results"| node_dashboard
node_history_view -->|"requests history"| node_api_client
node_api_client -->|"calls API"| node_routes
node_fastapi -->|"registers routes"| node_routes
node_routes -->|"requires identity"| node_auth
node_routes -->|"uses file handling"| node_file_utils
node_routes -->|"parses upload"| node_resume_parser
node_routes -->|"requests analysis"| node_analyzer
node_routes -->|"formats response"| node_schemas
node_analyzer -->|"calls scoring"| node_ats_scorer
node_analyzer -->|"compares JD"| node_jd_matcher
node_analyzer -->|"analyzes issues"| node_feedback
node_analyzer -->|"requests suggestions"| node_groq
node_analyzer -->|"uses models"| node_schemas
node_ats_scorer -->|"uses matching"| node_matching
node_jd_matcher -->|"uses matching"| node_matching
node_routes -->|"saves and fetches"| node_database
node_database -->|"persists history"| node_supabase
node_routes -->|"builds reports"| node_report
node_routes -->|"exports PDF"| node_pdf
node_report -.->|"renders HTML"| node_templates
node_auth -->|"reads credentials"| node_config
node_auth -->|"verifies JWT"| node_supabase
node_config -->|"configures access"| node_supabase
node_analyzer -.->|"provides recommendations"| node_recommendations

click node_streamlit "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/streamlit_app.py"
click node_auth_ui "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/services/supabase_client.py"
click node_scorer_view "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/views/scorer.py"
click node_history_view "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/views/history.py"
click node_resources_view "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/views/resources.py"
click node_dashboard "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/components/dashboard.py"
click node_api_client "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/services/api_client.py"
click node_fastapi "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/main.py"
click node_routes "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/api/routes.py"
click node_auth "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/api/auth.py"
click node_schemas "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/models/schemas.py"
click node_file_utils "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/utils/file_utils.py"
click node_resume_parser "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/resume_parser.py"
click node_analyzer "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/resume_analyzer.py"
click node_ats_scorer "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/ats_scorer.py"
click node_jd_matcher "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/jd_matcher.py"
click node_feedback "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/feedback_engine.py"
click node_groq "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/groq_parser.py"
click node_recommendations "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/recommendation_engine.py"
click node_matching "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/utils/matching.py"
click node_database "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/database/supabase_db.py"
click node_report "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/report_generator.py"
click node_pdf "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/pdf_export.py"
click node_templates "https://github.com/rahulchauhan25/ai-resume-ats/tree/main/backend/templates"
click node_config "https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/core/config.py"

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_streamlit,node_auth_ui,node_scorer_view,node_history_view,node_resources_view,node_dashboard,node_api_client toneBlue
class node_fastapi,node_routes,node_auth,node_schemas,node_config toneAmber
class node_file_utils,node_resume_parser,node_analyzer,node_ats_scorer,node_jd_matcher,node_feedback,node_groq,node_recommendations,node_matching toneMint
class node_database,node_supabase,node_report,node_pdf,node_templates toneRose
class node_user toneIndigo
```

## Components

### User experience

- [App shell](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/streamlit_app.py): `frontend/streamlit_app.py`
- [Sign-in](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/services/supabase_client.py): `frontend/services/supabase_client.py`
- [Scoring view](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/views/scorer.py): `frontend/views/scorer.py`
- [History view](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/views/history.py): `frontend/views/history.py`
- [Resources view](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/views/resources.py): `frontend/views/resources.py`
- [Results dashboard](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/components/dashboard.py): `frontend/components/dashboard.py`
- [API client](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/frontend/services/api_client.py): `frontend/services/api_client.py`

### API and identity

- [FastAPI app](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/main.py): `backend/main.py`
- [API routes](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/api/routes.py): `backend/api/routes.py`
- [Token verification](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/api/auth.py): `backend/api/auth.py`
- [Response schemas](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/models/schemas.py): `backend/models/schemas.py`
- [Runtime config](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/core/config.py): `backend/core/config.py`

### Resume analysis

- [File handling](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/utils/file_utils.py): `backend/utils/file_utils.py`
- [Resume parsing](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/resume_parser.py): `backend/services/resume_parser.py`
- [Analysis orchestrator](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/resume_analyzer.py): `backend/services/resume_analyzer.py`
- [ATS scoring](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/ats_scorer.py): `backend/services/ats_scorer.py`
- [JD comparison](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/jd_matcher.py): `backend/services/jd_matcher.py`
- [Issue feedback](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/feedback_engine.py): `backend/services/feedback_engine.py`
- [LLM suggestions](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/groq_parser.py): `backend/services/groq_parser.py`
- [Recommendations](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/recommendation_engine.py): `backend/services/recommendation_engine.py`
- [Keyword matching](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/utils/matching.py): `backend/utils/matching.py`

### Persistence and reports

- [Analysis history](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/database/supabase_db.py): `backend/database/supabase_db.py`
- **Supabase services**
- [Report generation](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/report_generator.py): `backend/services/report_generator.py`
- [PDF export](https://github.com/rahulchauhan25/ai-resume-ats/blob/main/backend/services/pdf_export.py): `backend/services/pdf_export.py`
- [Report templates](https://github.com/rahulchauhan25/ai-resume-ats/tree/main/backend/templates): `backend/templates`

### Other components

- **Applicant**

## Connections

- Applicant → App shell: uses (evidence: `README.md`)
- App shell → Scoring view: routes to (evidence: `frontend/streamlit_app.py`)
- App shell → History view: routes to (evidence: `frontend/streamlit_app.py`)
- App shell → Resources view: routes to (evidence: `frontend/streamlit_app.py`)
- App shell → Sign-in: uses (evidence: `frontend/streamlit_app.py`)
- Scoring view → API client: submits analysis (evidence: `frontend/views/scorer.py`)
- Scoring view → Results dashboard: renders results (evidence: `frontend/views/scorer.py`)
- History view → API client: requests history (evidence: `frontend/views/history.py`)
- API client → API routes: calls API (evidence: `frontend/services/api_client.py`)
- FastAPI app → API routes: registers routes (evidence: `backend/main.py`)
- API routes → Token verification: requires identity (evidence: `backend/api/routes.py`)
- API routes → File handling: uses file handling (evidence: `backend/api/routes.py`)
- API routes → Resume parsing: parses upload (evidence: `backend/api/routes.py`)
- API routes → Analysis orchestrator: requests analysis (evidence: `backend/api/routes.py`)
- API routes → Response schemas: formats response (evidence: `backend/api/routes.py`)
- Analysis orchestrator → ATS scoring: calls scoring (evidence: `backend/services/resume_analyzer.py`)
- Analysis orchestrator → JD comparison: compares JD (evidence: `backend/services/resume_analyzer.py`)
- Analysis orchestrator → Issue feedback: analyzes issues (evidence: `backend/services/resume_analyzer.py`)
- Analysis orchestrator → LLM suggestions: requests suggestions (evidence: `backend/services/resume_analyzer.py`)
- Analysis orchestrator → Response schemas: uses models (evidence: `backend/services/resume_analyzer.py`)
- ATS scoring → Keyword matching: uses matching (evidence: `backend/services/ats_scorer.py`)
- JD comparison → Keyword matching: uses matching (evidence: `backend/services/jd_matcher.py`)
- API routes → Analysis history: saves and fetches (evidence: `backend/api/routes.py`)
- Analysis history → Supabase services: persists history (evidence: `README.md`)
- API routes → Report generation: builds reports (evidence: `backend/api/routes.py`)
- API routes → PDF export: exports PDF (evidence: `backend/api/routes.py`)
- Report generation → Report templates: renders HTML
- Token verification → Runtime config: reads credentials (evidence: `backend/api/auth.py`)
- Token verification → Supabase services: verifies JWT (evidence: `backend/api/auth.py`)
- Runtime config → Supabase services: configures access (evidence: `backend/core/config.py`)
- Analysis orchestrator → Recommendations: provides recommendations
