# aryanm66/test architecture

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

- Interactive diagram: https://gitdiagram.com/aryanm66/test
- Repository: https://github.com/aryanm66/test

## Overview

ATS Resume Scorer lets a signed-in user upload a resume and optionally provide a job description, then returns a scored analysis with comparison details and improvement suggestions. The main path runs from Streamlit’s scorer view through the API client to FastAPI’s analysis route and backend analysis services; results are displayed in a dashboard. Separate capabilities include account authentication, saved analysis history, and PDF reports. The graph also includes documented recommendation and scoring subsystems. Some backend details are represented from the source index and README rather than inspected excerpts, so uncertain internal links are omitted.

Main entry points: [`backend/api/routes.py`](https://github.com/aryanm66/test/blob/main/backend/api/routes.py) (Analysis and history routes), [`backend/services/resume_analyzer.py`](https://github.com/aryanm66/test/blob/main/backend/services/resume_analyzer.py) (Resume analysis), [`frontend/streamlit_app.py`](https://github.com/aryanm66/test/blob/main/frontend/streamlit_app.py) (App navigation), [`frontend/views/scorer.py`](https://github.com/aryanm66/test/blob/main/frontend/views/scorer.py) (Scorer view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Streamlit app"]
  node_streamlit["App navigation<br/>[streamlit_app.py]"]
  node_scorer_view["Scorer view<br/>[scorer.py]"]
  node_api_client["API client<br/>[api_client.py]"]
  node_dashboard["Results dashboard<br/>[dashboard.py]"]
  node_history_view["History view<br/>[history.py]"]
  node_auth_client["Supabase sign-in<br/>[supabase_client.py]"]
end

subgraph group_api["API and access"]
  node_fastapi["API application<br/>[main.py]"]
  node_routes["Analysis and history routes<br/>[routes.py]"]
  node_auth["JWT verification<br/>[auth.py]"]
  node_schemas["Response schemas<br/>[schemas.py]"]
end

subgraph group_analysis["Resume analysis"]
  node_parser["Resume parsing<br/>[resume_parser.py]"]
  node_analyzer["Resume analysis<br/>[resume_analyzer.py]"]
  node_ats_scorer["ATS scoring<br/>[ats_scorer.py]"]
  node_jd_matcher["JD matching<br/>[jd_matcher.py]"]
  node_feedback["Issue feedback<br/>[feedback_engine.py]"]
  node_groq["LLM parsing<br/>[groq_parser.py]"]
  node_recommendations["Recommendations"]
end

subgraph group_account["Accounts and history"]
  node_database[("Analysis history store<br/>[supabase_db.py]")]
  node_supabase[("Supabase")]
end

subgraph group_reports["Reports"]
  node_report_generator["Report generation"]
  node_pdf_export["PDF export<br/>[pdf_export.py]"]
end

node_user(("Job seeker"))

node_user -->|"uses"| node_streamlit
node_streamlit -->|"routes to"| node_scorer_view
node_streamlit -->|"routes to"| node_history_view
node_streamlit -->|"uses"| node_auth_client
node_scorer_view -->|"submits analysis"| node_api_client
node_api_client -->|"sends HTTP requests"| node_fastapi
node_fastapi -->|"registers routes"| node_routes
node_routes -->|"authenticates requests"| node_auth
node_routes -->|"parses upload"| node_parser
node_routes -->|"requests analysis"| node_analyzer
node_analyzer -->|"uses"| node_ats_scorer
node_analyzer -->|"uses"| node_jd_matcher
node_analyzer -->|"uses"| node_feedback
node_analyzer -->|"uses"| node_groq
node_routes -->|"formats response"| node_schemas
node_routes -->|"saves and fetches"| node_database
node_database -.->|"stores records"| node_supabase
node_auth_client -->|"authenticates"| node_supabase
node_history_view -->|"requests history"| node_api_client
node_scorer_view -->|"renders results"| node_dashboard
node_routes -->|"builds reports"| node_report_generator
node_routes -->|"exports PDF"| node_pdf_export
node_dashboard -.->|"displays recommendations"| node_recommendations

click node_streamlit "https://github.com/aryanm66/test/blob/main/frontend/streamlit_app.py"
click node_scorer_view "https://github.com/aryanm66/test/blob/main/frontend/views/scorer.py"
click node_api_client "https://github.com/aryanm66/test/blob/main/frontend/services/api_client.py"
click node_dashboard "https://github.com/aryanm66/test/blob/main/frontend/components/dashboard.py"
click node_history_view "https://github.com/aryanm66/test/blob/main/frontend/views/history.py"
click node_auth_client "https://github.com/aryanm66/test/blob/main/frontend/services/supabase_client.py"
click node_fastapi "https://github.com/aryanm66/test/blob/main/backend/main.py"
click node_routes "https://github.com/aryanm66/test/blob/main/backend/api/routes.py"
click node_auth "https://github.com/aryanm66/test/blob/main/backend/api/auth.py"
click node_schemas "https://github.com/aryanm66/test/blob/main/backend/models/schemas.py"
click node_parser "https://github.com/aryanm66/test/blob/main/backend/services/resume_parser.py"
click node_analyzer "https://github.com/aryanm66/test/blob/main/backend/services/resume_analyzer.py"
click node_ats_scorer "https://github.com/aryanm66/test/blob/main/backend/services/ats_scorer.py"
click node_jd_matcher "https://github.com/aryanm66/test/blob/main/backend/services/jd_matcher.py"
click node_feedback "https://github.com/aryanm66/test/blob/main/backend/services/feedback_engine.py"
click node_groq "https://github.com/aryanm66/test/blob/main/backend/services/groq_parser.py"
click node_recommendations "https://github.com/aryanm66/test/blob/main/backend/services/recommendation_engine.py"
click node_database "https://github.com/aryanm66/test/blob/main/backend/database/supabase_db.py"
click node_report_generator "https://github.com/aryanm66/test/blob/main/backend/services/report_generator.py"
click node_pdf_export "https://github.com/aryanm66/test/blob/main/backend/services/pdf_export.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_scorer_view,node_api_client,node_dashboard,node_history_view,node_auth_client toneBlue
class node_fastapi,node_routes,node_auth,node_schemas toneAmber
class node_parser,node_analyzer,node_ats_scorer,node_jd_matcher,node_feedback,node_groq,node_recommendations toneMint
class node_database,node_supabase toneRose
class node_report_generator,node_pdf_export,node_user toneIndigo
```

## Components

### Streamlit app

- [App navigation](https://github.com/aryanm66/test/blob/main/frontend/streamlit_app.py): `frontend/streamlit_app.py`
- [Scorer view](https://github.com/aryanm66/test/blob/main/frontend/views/scorer.py): `frontend/views/scorer.py`
- [API client](https://github.com/aryanm66/test/blob/main/frontend/services/api_client.py): `frontend/services/api_client.py`
- [Results dashboard](https://github.com/aryanm66/test/blob/main/frontend/components/dashboard.py): `frontend/components/dashboard.py`
- [History view](https://github.com/aryanm66/test/blob/main/frontend/views/history.py): `frontend/views/history.py`
- [Supabase sign-in](https://github.com/aryanm66/test/blob/main/frontend/services/supabase_client.py): `frontend/services/supabase_client.py`

### API and access

- [API application](https://github.com/aryanm66/test/blob/main/backend/main.py): `backend/main.py`
- [Analysis and history routes](https://github.com/aryanm66/test/blob/main/backend/api/routes.py): `backend/api/routes.py`
- [JWT verification](https://github.com/aryanm66/test/blob/main/backend/api/auth.py): `backend/api/auth.py`
- [Response schemas](https://github.com/aryanm66/test/blob/main/backend/models/schemas.py): `backend/models/schemas.py`

### Resume analysis

- [Resume parsing](https://github.com/aryanm66/test/blob/main/backend/services/resume_parser.py): `backend/services/resume_parser.py`
- [Resume analysis](https://github.com/aryanm66/test/blob/main/backend/services/resume_analyzer.py): `backend/services/resume_analyzer.py`
- [ATS scoring](https://github.com/aryanm66/test/blob/main/backend/services/ats_scorer.py): `backend/services/ats_scorer.py`
- [JD matching](https://github.com/aryanm66/test/blob/main/backend/services/jd_matcher.py): `backend/services/jd_matcher.py`
- [Issue feedback](https://github.com/aryanm66/test/blob/main/backend/services/feedback_engine.py): `backend/services/feedback_engine.py`
- [LLM parsing](https://github.com/aryanm66/test/blob/main/backend/services/groq_parser.py): `backend/services/groq_parser.py`
- [Recommendations](https://github.com/aryanm66/test/blob/main/backend/services/recommendation_engine.py): `backend/services/recommendation_engine.py`

### Accounts and history

- [Analysis history store](https://github.com/aryanm66/test/blob/main/backend/database/supabase_db.py): `backend/database/supabase_db.py`
- **Supabase**

### Reports

- [Report generation](https://github.com/aryanm66/test/blob/main/backend/services/report_generator.py): `backend/services/report_generator.py`
- [PDF export](https://github.com/aryanm66/test/blob/main/backend/services/pdf_export.py): `backend/services/pdf_export.py`

### Other components

- **Job seeker**

## Connections

- Job seeker → App navigation: uses (evidence: `README.md`)
- App navigation → Scorer view: routes to (evidence: `frontend/streamlit_app.py`)
- App navigation → History view: routes to (evidence: `frontend/streamlit_app.py`)
- App navigation → Supabase sign-in: uses (evidence: `frontend/streamlit_app.py`)
- Scorer view → API client: submits analysis (evidence: `frontend/views/scorer.py`)
- API client → API application: sends HTTP requests (evidence: `frontend/services/api_client.py`)
- API application → Analysis and history routes: registers routes (evidence: `backend/main.py`)
- Analysis and history routes → JWT verification: authenticates requests (evidence: `backend/api/routes.py`)
- Analysis and history routes → Resume parsing: parses upload (evidence: `backend/api/routes.py`)
- Analysis and history routes → Resume analysis: requests analysis (evidence: `backend/api/routes.py`)
- Resume analysis → ATS scoring: uses (evidence: `backend/services/resume_analyzer.py`)
- Resume analysis → JD matching: uses (evidence: `backend/services/resume_analyzer.py`)
- Resume analysis → Issue feedback: uses (evidence: `backend/services/resume_analyzer.py`)
- Resume analysis → LLM parsing: uses (evidence: `backend/services/resume_analyzer.py`)
- Analysis and history routes → Response schemas: formats response (evidence: `backend/api/routes.py`)
- Analysis and history routes → Analysis history store: saves and fetches (evidence: `backend/api/routes.py`)
- Analysis history store → Supabase: stores records
- Supabase sign-in → Supabase: authenticates (evidence: `frontend/services/supabase_client.py`)
- History view → API client: requests history (evidence: `frontend/views/history.py`)
- Scorer view → Results dashboard: renders results (evidence: `frontend/views/scorer.py`)
- Analysis and history routes → Report generation: builds reports (evidence: `backend/api/routes.py`)
- Analysis and history routes → PDF export: exports PDF (evidence: `backend/api/routes.py`)
- Results dashboard → Recommendations: displays recommendations
