# rrezoncurraj/ai-resume architecture

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

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

## Overview

Hireon is an AI resume analyzer. The main user journey is to upload a PDF, have it analyzed and scored, then review the score breakdown and improvement feedback; users can also sign in and revisit stored resumes. The graph includes the documented PDF conversion, AI analysis, ATS scoring, and persistence capabilities. Several route implementations were not excerpted, so their internal calls are not asserted; dashed, evidence-free links mark unverified workflow connections.

Main entry points: [`app/routes/upload.tsx`](https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/upload.tsx) (Resume Upload), [`app/routes/resume.tsx`](https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/resume.tsx) (Resume Review), [`app/lib/puter.ts`](https://github.com/rrezoncurraj/ai-resume/blob/main/app/lib/puter.ts) (AI Analysis), [`app/root.tsx`](https://github.com/rrezoncurraj/ai-resume/blob/main/app/root.tsx) (Application Shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_app["Application Shell<br/>[root.tsx]"]
  node_auth["Authentication<br/>[auth.tsx]"]
  node_dashboard["Resume Dashboard<br/>[home.tsx]"]
  node_resumeitem["Resume Card<br/>[ResumeCard.tsx]"]
end

subgraph group_workflow["Resume Workflow"]
  node_upload["Resume Upload<br/>[upload.tsx]"]
  node_uploader["PDF Uploader<br/>[FileUploader.tsx]"]
  node_conversion["PDF Preview<br/>[pdf2img.ts]"]
  node_analysis["AI Analysis<br/>[puter.ts]"]
  node_prompts["Analysis Prompts<br/>[index.ts]"]
end

subgraph group_services["Puter Services"]
  node_cleanup["Data Wipe<br/>[wipe.tsx]"]
  node_puter["Puter Platform"]
  node_storage[("Resume Storage")]
  node_ai["Claude AI"]
end

subgraph group_review["Analysis Results"]
  node_resume["Resume Review<br/>[resume.tsx]"]
  node_summary["Score Summary<br/>[Summary.tsx]"]
  node_scoreparts["Score Visuals<br/>[ScoreGauge.tsx]"]
  node_details["Feedback Details<br/>[Details.tsx]"]
  node_accordion["Feedback Accordion<br/>[Accordion.tsx]"]
  node_ats["ATS Assessment<br/>[ATS.tsx]"]
end

node_user(("Resume Seeker"))

node_user -->|"uses"| node_app
node_app -->|"initializes"| node_puter
node_user -.->|"submits PDF"| node_upload
node_upload -.->|"offers upload"| node_uploader
node_upload -.->|"previews PDF"| node_conversion
node_upload -.->|"requests analysis"| node_analysis
node_prompts -.->|"guides analysis"| node_analysis
node_analysis -->|"calls services"| node_puter
node_puter -->|"runs analysis"| node_ai
node_analysis -.->|"persists results"| node_storage
node_puter -->|"stores files"| node_storage
node_user -.->|"signs in"| node_auth
node_user -.->|"views resumes"| node_dashboard
node_dashboard -.->|"shows resumes"| node_resumeitem
node_resumeitem -->|"reads preview"| node_storage
node_user -.->|"opens review"| node_resume
node_resume -.->|"presents scores"| node_summary
node_summary -->|"renders gauges"| node_scoreparts
node_resume -.->|"presents feedback"| node_details
node_details -->|"renders categories"| node_accordion
node_resume -.->|"shows ATS score"| node_ats
node_user -.->|"wipes data"| node_cleanup
node_cleanup -.->|"deletes data"| node_storage

click node_app "https://github.com/rrezoncurraj/ai-resume/blob/main/app/root.tsx"
click node_auth "https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/auth.tsx"
click node_dashboard "https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/home.tsx"
click node_upload "https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/upload.tsx"
click node_uploader "https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/FileUploader.tsx"
click node_conversion "https://github.com/rrezoncurraj/ai-resume/blob/main/app/lib/pdf2img.ts"
click node_analysis "https://github.com/rrezoncurraj/ai-resume/blob/main/app/lib/puter.ts"
click node_prompts "https://github.com/rrezoncurraj/ai-resume/blob/main/constans/index.ts"
click node_resume "https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/resume.tsx"
click node_summary "https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/Summary.tsx"
click node_scoreparts "https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/ScoreGauge.tsx"
click node_details "https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/Details.tsx"
click node_accordion "https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/Accordion.tsx"
click node_ats "https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/ATS.tsx"
click node_resumeitem "https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/ResumeCard.tsx"
click node_cleanup "https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/wipe.tsx"

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_app,node_auth,node_dashboard,node_resumeitem toneBlue
class node_upload,node_uploader,node_conversion,node_analysis,node_prompts toneAmber
class node_cleanup,node_puter,node_storage,node_ai toneMint
class node_resume,node_summary,node_scoreparts,node_details,node_accordion,node_ats toneRose
class node_user toneIndigo
```

## Components

### User Experience

- [Application Shell](https://github.com/rrezoncurraj/ai-resume/blob/main/app/root.tsx): `app/root.tsx`
- [Authentication](https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/auth.tsx): `app/routes/auth.tsx`
- [Resume Dashboard](https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/home.tsx): `app/routes/home.tsx`
- [Resume Card](https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/ResumeCard.tsx): `app/components/ResumeCard.tsx`

### Resume Workflow

- [Resume Upload](https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/upload.tsx): `app/routes/upload.tsx`
- [PDF Uploader](https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/FileUploader.tsx): `app/components/FileUploader.tsx`
- [PDF Preview](https://github.com/rrezoncurraj/ai-resume/blob/main/app/lib/pdf2img.ts): `app/lib/pdf2img.ts`
- [AI Analysis](https://github.com/rrezoncurraj/ai-resume/blob/main/app/lib/puter.ts): `app/lib/puter.ts`
- [Analysis Prompts](https://github.com/rrezoncurraj/ai-resume/blob/main/constans/index.ts): `constans/index.ts`

### Puter Services

- [Data Wipe](https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/wipe.tsx): `app/routes/wipe.tsx`
- **Puter Platform**
- **Resume Storage**
- **Claude AI**

### Analysis Results

- [Resume Review](https://github.com/rrezoncurraj/ai-resume/blob/main/app/routes/resume.tsx): `app/routes/resume.tsx`
- [Score Summary](https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/Summary.tsx): `app/components/Summary.tsx`
- [Score Visuals](https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/ScoreGauge.tsx): `app/components/ScoreGauge.tsx`
- [Feedback Details](https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/Details.tsx): `app/components/Details.tsx`
- [Feedback Accordion](https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/Accordion.tsx): `app/components/Accordion.tsx`
- [ATS Assessment](https://github.com/rrezoncurraj/ai-resume/blob/main/app/components/ATS.tsx): `app/components/ATS.tsx`

### Other components

- **Resume Seeker**

## Connections

- Resume Seeker → Application Shell: uses (evidence: `README.md`)
- Application Shell → Puter Platform: initializes (evidence: `app/root.tsx`)
- Resume Seeker → Resume Upload: submits PDF
- Resume Upload → PDF Uploader: offers upload
- Resume Upload → PDF Preview: previews PDF (evidence: `README.md`)
- Resume Upload → AI Analysis: requests analysis
- Analysis Prompts → AI Analysis: guides analysis (evidence: `README.md`)
- AI Analysis → Puter Platform: calls services (evidence: `app/lib/puter.ts`)
- Puter Platform → Claude AI: runs analysis (evidence: `README.md`)
- AI Analysis → Resume Storage: persists results (evidence: `README.md`)
- Puter Platform → Resume Storage: stores files (evidence: `README.md`)
- Resume Seeker → Authentication: signs in (evidence: `README.md`)
- Resume Seeker → Resume Dashboard: views resumes (evidence: `README.md`)
- Resume Dashboard → Resume Card: shows resumes
- Resume Card → Resume Storage: reads preview (evidence: `app/components/ResumeCard.tsx`)
- Resume Seeker → Resume Review: opens review
- Resume Review → Score Summary: presents scores (evidence: `README.md`)
- Score Summary → Score Visuals: renders gauges (evidence: `app/components/Summary.tsx`)
- Resume Review → Feedback Details: presents feedback (evidence: `README.md`)
- Feedback Details → Feedback Accordion: renders categories (evidence: `app/components/Details.tsx`)
- Resume Review → ATS Assessment: shows ATS score (evidence: `README.md`)
- Resume Seeker → Data Wipe: wipes data
- Data Wipe → Resume Storage: deletes data (evidence: `README.md`)
