# okay-mahima/resumate architecture

> Architecture diagram of the GitHub repository okay-mahima/resumate, 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/okay-mahima/resumate
- Repository: https://github.com/okay-mahima/resumate

## Overview

Resumate is a resume-analysis web app. A candidate uploads a PDF through the dashboard; the backend extracts text, asks Groq for structured resume analysis, and returns results for display. The dashboard also supports job-description matching and resume-grounded chat. Chat history and the uploaded resume are maintained by the backend. The day5 folder contains a separate parsing prototype. Backend excerpts are partial, so some frontend/API relationships rely on README documentation rather than sampled call sites.

Main entry points: [`project/backend/main.py`](https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py) (FastAPI service), [`project/frontend/src/App.jsx`](https://github.com/okay-mahima/resumate/blob/main/project/frontend/src/App.jsx) (Resume dashboard), [`project/day5/resume_parser.py`](https://github.com/okay-mahima/resumate/blob/main/project/day5/resume_parser.py) (Structured parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Candidate dashboard"]
  node_dashboard["Resume dashboard<br/>[App.jsx]"]
end

subgraph group_backend["Resume services"]
  node_api["FastAPI service<br/>[main.py]"]
  node_pdftext["PDF text extraction<br/>[main.py]"]
  node_resumeai["Resume analysis<br/>[main.py]"]
  node_uploaded[("Uploaded resume<br/>[main.py]")]
  node_jdmatch["Job matching<br/>[main.py]"]
  node_resumechat["Resume chat<br/>[main.py]"]
  node_history[("Chat history<br/>[main.py]")]
end

subgraph group_prototype["Parsing prototype"]
  node_prototypeparser["Structured parser<br/>[resume_parser.py]"]
end

node_candidate(("Candidate"))
node_groq["Groq model API"]

node_candidate -->|"uses"| node_dashboard
node_dashboard -->|"uploads PDF"| node_api
node_api -->|"writes resume"| node_uploaded
node_api -->|"extracts text"| node_pdftext
node_api -->|"analyzes resume"| node_resumeai
node_resumeai -->|"requests extraction"| node_groq
node_dashboard -->|"requests match"| node_api
node_api -->|"routes match"| node_jdmatch
node_jdmatch -->|"reads resume"| node_uploaded
node_jdmatch -->|"requests comparison"| node_groq
node_dashboard -->|"sends questions"| node_api
node_api -->|"routes chat"| node_resumechat
node_resumechat -->|"reads resume"| node_uploaded
node_resumechat -->|"requests answer"| node_groq
node_resumechat -->|"updates history"| node_history
node_dashboard -.->|"retrieves history"| node_api
node_prototypeparser -->|"requests parsing"| node_groq
node_prototypeparser -->|"extracts PDF text"| node_pdftext

click node_dashboard "https://github.com/okay-mahima/resumate/blob/main/project/frontend/src/App.jsx"
click node_api "https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py"
click node_pdftext "https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py"
click node_resumeai "https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py"
click node_uploaded "https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py"
click node_jdmatch "https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py"
click node_resumechat "https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py"
click node_history "https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py"
click node_prototypeparser "https://github.com/okay-mahima/resumate/blob/main/project/day5/resume_parser.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_dashboard toneBlue
class node_api,node_pdftext,node_resumeai,node_uploaded,node_jdmatch,node_resumechat,node_history toneAmber
class node_prototypeparser,node_groq toneMint
class node_candidate toneIndigo
```

## Components

### Candidate dashboard

- [Resume dashboard](https://github.com/okay-mahima/resumate/blob/main/project/frontend/src/App.jsx): `project/frontend/src/App.jsx`

### Resume services

- [FastAPI service](https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py): `project/backend/main.py`
- [PDF text extraction](https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py): `project/backend/main.py`
- [Resume analysis](https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py): `project/backend/main.py`
- [Uploaded resume](https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py): `project/backend/main.py`
- [Job matching](https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py): `project/backend/main.py`
- [Resume chat](https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py): `project/backend/main.py`
- [Chat history](https://github.com/okay-mahima/resumate/blob/main/project/backend/main.py): `project/backend/main.py`

### Parsing prototype

- [Structured parser](https://github.com/okay-mahima/resumate/blob/main/project/day5/resume_parser.py): `project/day5/resume_parser.py`

### Other components

- **Candidate**
- **Groq model API**

## Connections

- Candidate → Resume dashboard: uses (evidence: `README.md`)
- Resume dashboard → FastAPI service: uploads PDF (evidence: `README.md`)
- FastAPI service → Uploaded resume: writes resume (evidence: `project/backend/main.py`)
- FastAPI service → PDF text extraction: extracts text (evidence: `project/backend/main.py`)
- FastAPI service → Resume analysis: analyzes resume (evidence: `README.md`)
- Resume analysis → Groq model API: requests extraction (evidence: `project/backend/main.py`)
- Resume dashboard → FastAPI service: requests match (evidence: `README.md`)
- FastAPI service → Job matching: routes match (evidence: `README.md`)
- Job matching → Uploaded resume: reads resume (evidence: `project/backend/main.py`)
- Job matching → Groq model API: requests comparison (evidence: `project/backend/main.py`)
- Resume dashboard → FastAPI service: sends questions (evidence: `project/frontend/src/App.jsx`)
- FastAPI service → Resume chat: routes chat (evidence: `README.md`)
- Resume chat → Uploaded resume: reads resume (evidence: `project/backend/main.py`)
- Resume chat → Groq model API: requests answer (evidence: `project/backend/main.py`)
- Resume chat → Chat history: updates history (evidence: `project/backend/main.py`)
- Resume dashboard → FastAPI service: retrieves history
- Structured parser → Groq model API: requests parsing (evidence: `project/day5/resume_parser.py`)
- Structured parser → PDF text extraction: extracts PDF text (evidence: `project/day5/resume_parser.py`)
