# harshith142/jd-resume-changer-mvp architecture

> Architecture diagram of the GitHub repository harshith142/jd-resume-changer-mvp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshith142/jd-resume-changer-mvp
- Repository: https://github.com/harshith142/jd-resume-changer-mvp

## Overview

JD Resume Changer tailors a master LaTeX résumé to a job description and produces downloadable résumé output. The documented primary workflow runs from the Chrome extension to the local FastAPI server, where résumé/JD analysis, matching, generation, ATS checks, and local PDF compilation take place. The repository also contains an optional web dashboard and broader account, résumé, job-description, and API-key management. Some links are documented or visible in sampled files; unsampled web and service internals are represented without inferred call chains.

Main entry points: [`server/app/api/routes/generated_resumes.py`](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/generated_resumes.py) (Generation and downloads), [`server/app/main.py`](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/main.py) (FastAPI application), [`server/app/database.py`](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/database.py) (Database access), [`server/app/api/routes/master_resumes.py`](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/master_resumes.py) (Résumé workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interfaces"]
  node_extension["Chrome extension<br/>[popup.js]"]
  node_options["Extension settings<br/>[options.js]"]
  node_webui["Web dashboard"]
end

subgraph group_api["API and workflows"]
  node_api_server["FastAPI application<br/>[main.py]"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
  node_resume_routes["Résumé workflows<br/>[master_resumes.py]"]
  node_jd_routes["Job description routes"]
  node_generation_routes["Generation and downloads"]
  node_user_routes["User routes<br/>[users.py]"]
  node_key_routes["API key routes<br/>[api_keys.py]"]
end

subgraph group_services["Tailoring services"]
  node_resume_parser["Résumé parser<br/>[resume_parser.py]"]
  node_text_extraction["Text extraction<br/>[extract_text.py]"]
  node_jd_analysis["JD analysis<br/>[jd_analyzer.py]"]
  node_matching["Résumé matching<br/>[matcher.py]"]
  node_generator["Résumé generation"]
  node_sanitizer["LaTeX sanitization<br/>[latex_sanitizer.py]"]
  node_ats["ATS scoring<br/>[ats_scorer.py]"]
end

subgraph group_data["Accounts and data"]
  node_auth_service["Auth and OAuth<br/>[auth.py]"]
  node_encryption["Key encryption<br/>[encryption.py]"]
  node_database[("Database access<br/>[database.py]")]
  node_user_model["User records<br/>[user.py]"]
  node_api_key_model["API key records<br/>[api_key.py]"]
  node_generated_model["Generated résumé records"]
end

node_person(("Résumé user"))
node_external_llm{{"LLM provider"}}
node_pdflatex{{"Local PDF compiler"}}
node_pdf["PDF output"]

node_person -->|"submits JD"| node_extension
node_extension -->|"sends request"| node_api_server
node_options -.->|"stores résumé"| node_person
node_api_server -->|"routes requests"| node_auth_routes
node_api_server -->|"routes requests"| node_user_routes
node_api_server -->|"routes requests"| node_key_routes
node_api_server -->|"routes requests"| node_resume_routes
node_api_server -->|"routes requests"| node_jd_routes
node_api_server -->|"routes requests"| node_generation_routes
node_auth_routes -->|"uses auth"| node_auth_service
node_auth_routes -->|"queries users"| node_database
node_resume_routes -->|"stores résumé"| node_database
node_resume_routes -->|"parses résumé"| node_resume_parser
node_resume_routes -->|"extracts text"| node_text_extraction
node_jd_routes -->|"stores descriptions"| node_database
node_jd_routes -->|"analyzes JD"| node_jd_analysis
node_jd_routes -->|"extracts text"| node_text_extraction
node_generation_routes -->|"loads and saves"| node_database
node_generation_routes -->|"parses résumé"| node_resume_parser
node_generation_routes -->|"analyzes JD"| node_jd_analysis
node_generation_routes -->|"matches content"| node_matching
node_generation_routes -->|"generates résumé"| node_generator
node_generation_routes -->|"sanitizes LaTeX"| node_sanitizer
node_generation_routes -->|"scores output"| node_ats
node_key_routes -->|"stores keys"| node_database
node_key_routes -->|"encrypts keys"| node_encryption
node_auth_service -->|"creates users"| node_user_model
node_generation_routes -->|"persists results"| node_generated_model
node_generator -.->|"requests generation"| node_external_llm
node_resume_parser -->|"requests analysis"| node_external_llm
node_api_server -->|"compiles LaTeX"| node_pdflatex
node_pdflatex -->|"produces PDF"| node_pdf
node_generation_routes -->|"returns results"| node_extension
node_person -.->|"uses dashboard"| node_webui

click node_extension "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/extension/popup.js"
click node_options "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/extension/options.js"
click node_webui "https://github.com/harshith142/jd-resume-changer-mvp/tree/main/web/src/app/(dashboard)"
click node_api_server "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/main.py"
click node_auth_routes "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/auth.py"
click node_resume_routes "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/master_resumes.py"
click node_jd_routes "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/job_descriptions.py"
click node_generation_routes "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/generated_resumes.py"
click node_user_routes "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/users.py"
click node_key_routes "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/api_keys.py"
click node_resume_parser "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/resume_parser.py"
click node_text_extraction "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/extract_text.py"
click node_jd_analysis "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/jd_analyzer.py"
click node_matching "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/matcher.py"
click node_generator "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/resume_generator.py"
click node_sanitizer "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/latex_sanitizer.py"
click node_ats "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/ats_scorer.py"
click node_auth_service "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/auth.py"
click node_encryption "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/encryption.py"
click node_database "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/database.py"
click node_user_model "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/models/user.py"
click node_api_key_model "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/models/api_key.py"
click node_generated_model "https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/models/generated_resume.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_extension,node_options,node_webui,node_person toneBlue
class node_api_server,node_auth_routes,node_resume_routes,node_jd_routes,node_generation_routes,node_user_routes,node_key_routes toneAmber
class node_resume_parser,node_text_extraction,node_jd_analysis,node_matching,node_generator,node_sanitizer,node_ats toneMint
class node_auth_service,node_encryption,node_database,node_user_model,node_api_key_model,node_generated_model toneRose
class node_external_llm,node_pdflatex,node_pdf toneIndigo
```

## Components

### User interfaces

- [Chrome extension](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/extension/popup.js): `extension/popup.js`
- [Extension settings](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/extension/options.js): `extension/options.js`
- [Web dashboard](https://github.com/harshith142/jd-resume-changer-mvp/tree/main/web/src/app/(dashboard)): `web/src/app/(dashboard)`

### API and workflows

- [FastAPI application](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/main.py): `server/app/main.py`
- [Authentication routes](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/auth.py): `server/app/api/routes/auth.py`
- [Résumé workflows](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/master_resumes.py): `server/app/api/routes/master_resumes.py`
- [Job description routes](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/job_descriptions.py): `server/app/api/routes/job_descriptions.py`
- [Generation and downloads](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/generated_resumes.py): `server/app/api/routes/generated_resumes.py`
- [User routes](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/users.py): `server/app/api/routes/users.py`
- [API key routes](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/api/routes/api_keys.py): `server/app/api/routes/api_keys.py`

### Tailoring services

- [Résumé parser](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/resume_parser.py): `server/app/services/resume_parser.py`
- [Text extraction](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/extract_text.py): `server/app/services/extract_text.py`
- [JD analysis](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/jd_analyzer.py): `server/app/services/jd_analyzer.py`
- [Résumé matching](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/matcher.py): `server/app/services/matcher.py`
- [Résumé generation](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/resume_generator.py): `server/app/services/resume_generator.py`
- [LaTeX sanitization](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/latex_sanitizer.py): `server/app/services/latex_sanitizer.py`
- [ATS scoring](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/ats_scorer.py): `server/app/services/ats_scorer.py`

### Accounts and data

- [Auth and OAuth](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/auth.py): `server/app/services/auth.py`
- [Key encryption](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/services/encryption.py): `server/app/services/encryption.py`
- [Database access](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/database.py): `server/app/database.py`
- [User records](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/models/user.py): `server/app/models/user.py`
- [API key records](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/models/api_key.py): `server/app/models/api_key.py`
- [Generated résumé records](https://github.com/harshith142/jd-resume-changer-mvp/blob/main/server/app/models/generated_resume.py): `server/app/models/generated_resume.py`

### Other components

- **Résumé user**
- **LLM provider**
- **Local PDF compiler**
- **PDF output**

## Connections

- Résumé user → Chrome extension: submits JD (evidence: `README.md`)
- Chrome extension → FastAPI application: sends request (evidence: `README.md`)
- Extension settings → Résumé user: stores résumé
- FastAPI application → Authentication routes: routes requests (evidence: `server/app/main.py`)
- FastAPI application → User routes: routes requests (evidence: `server/app/main.py`)
- FastAPI application → API key routes: routes requests (evidence: `server/app/main.py`)
- FastAPI application → Résumé workflows: routes requests (evidence: `server/app/main.py`)
- FastAPI application → Job description routes: routes requests (evidence: `server/app/main.py`)
- FastAPI application → Generation and downloads: routes requests (evidence: `server/app/main.py`)
- Authentication routes → Auth and OAuth: uses auth (evidence: `server/app/api/routes/auth.py`)
- Authentication routes → Database access: queries users (evidence: `server/app/api/routes/auth.py`)
- Résumé workflows → Database access: stores résumé (evidence: `server/app/api/routes/master_resumes.py`)
- Résumé workflows → Résumé parser: parses résumé (evidence: `server/app/api/routes/master_resumes.py`)
- Résumé workflows → Text extraction: extracts text (evidence: `server/app/api/routes/master_resumes.py`)
- Job description routes → Database access: stores descriptions (evidence: `server/app/api/routes/job_descriptions.py`)
- Job description routes → JD analysis: analyzes JD (evidence: `server/app/api/routes/job_descriptions.py`)
- Job description routes → Text extraction: extracts text (evidence: `server/app/api/routes/job_descriptions.py`)
- Generation and downloads → Database access: loads and saves (evidence: `server/app/api/routes/generated_resumes.py`)
- Generation and downloads → Résumé parser: parses résumé (evidence: `server/app/api/routes/generated_resumes.py`)
- Generation and downloads → JD analysis: analyzes JD (evidence: `server/app/api/routes/generated_resumes.py`)
- Generation and downloads → Résumé matching: matches content (evidence: `server/app/api/routes/generated_resumes.py`)
- Generation and downloads → Résumé generation: generates résumé (evidence: `server/app/api/routes/generated_resumes.py`)
- Generation and downloads → LaTeX sanitization: sanitizes LaTeX (evidence: `server/app/api/routes/generated_resumes.py`)
- Generation and downloads → ATS scoring: scores output (evidence: `server/app/api/routes/generated_resumes.py`)
- API key routes → Database access: stores keys (evidence: `server/app/api/routes/api_keys.py`)
- API key routes → Key encryption: encrypts keys (evidence: `server/app/api/routes/api_keys.py`)
- Auth and OAuth → User records: creates users (evidence: `server/app/services/auth.py`)
- Generation and downloads → Generated résumé records: persists results (evidence: `server/app/api/routes/generated_resumes.py`)
- Résumé generation → LLM provider: requests generation
- Résumé parser → LLM provider: requests analysis (evidence: `server/app/services/resume_parser.py`)
- FastAPI application → Local PDF compiler: compiles LaTeX (evidence: `README.md`)
- Local PDF compiler → PDF output: produces PDF (evidence: `README.md`)
- Generation and downloads → Chrome extension: returns results (evidence: `README.md`)
- Résumé user → Web dashboard: uses dashboard
