# awdhesh-student/ats_pro architecture

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

- Interactive diagram: https://gitdiagram.com/awdhesh-student/ats_pro
- Repository: https://github.com/awdhesh-student/ats_pro

## Overview

Friendly ATS is a resume-to-job-description analysis app. A job seeker submits a PDF and job details; the upload route stores the PDF and a converted image, requests AI feedback, saves the analysis, then navigates to a report. The README also documents sign-in, resume history, detailed category feedback, and cloud storage. The upload flow and UI composition are evidenced by excerpts; dashboard/report wiring and some service details are documented but their route implementations were not sampled.

Main entry points: [`app/routes/upload.tsx`](https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/upload.tsx) (Resume submission), [`app/lib/puter.ts`](https://github.com/awdhesh-student/ats_pro/blob/master/app/lib/puter.ts) (Puter service adapter), [`app/routes.ts`](https://github.com/awdhesh-student/ats_pro/blob/master/app/routes.ts) (Route definitions), [`app/routes/resume.tsx`](https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/resume.tsx) (Resume report route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_routeconfig["Route definitions<br/>[routes.ts]"]
  node_home["Resume dashboard<br/>[home.tsx]"]
  node_auth["Authentication page<br/>[auth.tsx]"]
  node_appshell["App shell<br/>[root.tsx]"]
end

subgraph group_workflow["Resume workflow"]
  node_upload["Resume submission<br/>[upload.tsx]"]
  node_uploader["PDF picker<br/>[FileUploader.tsx]"]
  node_pdfconvert["PDF image conversion<br/>[pdfToimg.ts]"]
  node_instructions["Analysis instructions<br/>[index.ts]"]
end

subgraph group_services["Cloud services"]
  node_puteradapter["Puter service adapter<br/>[puter.ts]"]
  node_cloudfiles[("Cloud file storage")]
  node_cloudkv[("Cloud metadata store")]
  node_ai["AI analysis"]
  node_puteridentity["Puter authentication"]
end

subgraph group_reports["Analysis reports"]
  node_resume["Resume report route<br/>[resume.tsx]"]
  node_summary["Score summary<br/>[Summary.tsx]"]
  node_scoregauge["Overall score gauge<br/>[ScoreGauge.tsx]"]
  node_scorebadge["Category score badge<br/>[ScoreBadge.tsx]"]
  node_details["Feedback details<br/>[Details.tsx]"]
  node_accordion["Expandable categories<br/>[Accordion.tsx]"]
end

node_jobseeker(("Job seeker"))

node_jobseeker -.->|"views history"| node_home
node_jobseeker -.->|"submits resume"| node_upload
node_routeconfig -->|"routes to"| node_home
node_routeconfig -->|"routes to"| node_auth
node_routeconfig -->|"routes to"| node_upload
node_routeconfig -->|"routes to"| node_resume
node_appshell -->|"initializes"| node_puteradapter
node_auth -->|"uses auth"| node_puteradapter
node_upload -->|"renders"| node_uploader
node_upload -->|"converts PDF"| node_pdfconvert
node_upload -->|"prepares prompt"| node_instructions
node_upload -->|"calls services"| node_puteradapter
node_puteradapter -->|"reads and writes"| node_cloudfiles
node_puteradapter -->|"reads and writes"| node_cloudkv
node_puteradapter -->|"requests analysis"| node_ai
node_puteradapter -->|"checks identity"| node_puteridentity
node_upload -->|"navigates to"| node_resume
node_resume -.->|"presents scores"| node_summary
node_resume -.->|"presents feedback"| node_details
node_summary -->|"renders"| node_scoregauge
node_summary -->|"renders"| node_scorebadge
node_details -->|"uses"| node_accordion

click node_routeconfig "https://github.com/awdhesh-student/ats_pro/blob/master/app/routes.ts"
click node_home "https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/home.tsx"
click node_auth "https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/auth.tsx"
click node_appshell "https://github.com/awdhesh-student/ats_pro/blob/master/app/root.tsx"
click node_upload "https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/upload.tsx"
click node_uploader "https://github.com/awdhesh-student/ats_pro/blob/master/app/components/FileUploader.tsx"
click node_pdfconvert "https://github.com/awdhesh-student/ats_pro/blob/master/app/lib/pdfToimg.ts"
click node_instructions "https://github.com/awdhesh-student/ats_pro/blob/master/constants/index.ts"
click node_puteradapter "https://github.com/awdhesh-student/ats_pro/blob/master/app/lib/puter.ts"
click node_resume "https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/resume.tsx"
click node_summary "https://github.com/awdhesh-student/ats_pro/blob/master/app/components/Summary.tsx"
click node_scoregauge "https://github.com/awdhesh-student/ats_pro/blob/master/app/components/ScoreGauge.tsx"
click node_scorebadge "https://github.com/awdhesh-student/ats_pro/blob/master/app/components/ScoreBadge.tsx"
click node_details "https://github.com/awdhesh-student/ats_pro/blob/master/app/components/Details.tsx"
click node_accordion "https://github.com/awdhesh-student/ats_pro/blob/master/app/components/Accordion.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_routeconfig,node_home,node_auth,node_appshell toneBlue
class node_upload,node_uploader,node_pdfconvert,node_instructions toneAmber
class node_puteradapter,node_cloudfiles,node_cloudkv,node_ai,node_puteridentity toneMint
class node_resume,node_summary,node_scoregauge,node_scorebadge,node_details,node_accordion toneRose
class node_jobseeker toneIndigo
```

## Components

### App entry

- [Route definitions](https://github.com/awdhesh-student/ats_pro/blob/master/app/routes.ts): `app/routes.ts`
- [Resume dashboard](https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/home.tsx): `app/routes/home.tsx`
- [Authentication page](https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/auth.tsx): `app/routes/auth.tsx`
- [App shell](https://github.com/awdhesh-student/ats_pro/blob/master/app/root.tsx): `app/root.tsx`

### Resume workflow

- [Resume submission](https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/upload.tsx): `app/routes/upload.tsx`
- [PDF picker](https://github.com/awdhesh-student/ats_pro/blob/master/app/components/FileUploader.tsx): `app/components/FileUploader.tsx`
- [PDF image conversion](https://github.com/awdhesh-student/ats_pro/blob/master/app/lib/pdfToimg.ts): `app/lib/pdfToimg.ts`
- [Analysis instructions](https://github.com/awdhesh-student/ats_pro/blob/master/constants/index.ts): `constants/index.ts`

### Cloud services

- [Puter service adapter](https://github.com/awdhesh-student/ats_pro/blob/master/app/lib/puter.ts): `app/lib/puter.ts`
- **Cloud file storage**
- **Cloud metadata store**
- **AI analysis**
- **Puter authentication**

### Analysis reports

- [Resume report route](https://github.com/awdhesh-student/ats_pro/blob/master/app/routes/resume.tsx): `app/routes/resume.tsx`
- [Score summary](https://github.com/awdhesh-student/ats_pro/blob/master/app/components/Summary.tsx): `app/components/Summary.tsx`
- [Overall score gauge](https://github.com/awdhesh-student/ats_pro/blob/master/app/components/ScoreGauge.tsx): `app/components/ScoreGauge.tsx`
- [Category score badge](https://github.com/awdhesh-student/ats_pro/blob/master/app/components/ScoreBadge.tsx): `app/components/ScoreBadge.tsx`
- [Feedback details](https://github.com/awdhesh-student/ats_pro/blob/master/app/components/Details.tsx): `app/components/Details.tsx`
- [Expandable categories](https://github.com/awdhesh-student/ats_pro/blob/master/app/components/Accordion.tsx): `app/components/Accordion.tsx`

### Other components

- **Job seeker**

## Connections

- Job seeker → Resume dashboard: views history (evidence: `README.md`)
- Job seeker → Resume submission: submits resume (evidence: `README.md`)
- Route definitions → Resume dashboard: routes to (evidence: `app/routes.ts`)
- Route definitions → Authentication page: routes to (evidence: `app/routes.ts`)
- Route definitions → Resume submission: routes to (evidence: `app/routes.ts`)
- Route definitions → Resume report route: routes to (evidence: `app/routes.ts`)
- App shell → Puter service adapter: initializes (evidence: `app/root.tsx`)
- Authentication page → Puter service adapter: uses auth (evidence: `app/routes/auth.tsx`)
- Resume submission → PDF picker: renders (evidence: `app/routes/upload.tsx`)
- Resume submission → PDF image conversion: converts PDF (evidence: `app/routes/upload.tsx`)
- Resume submission → Analysis instructions: prepares prompt (evidence: `app/routes/upload.tsx`)
- Resume submission → Puter service adapter: calls services (evidence: `app/routes/upload.tsx`)
- Puter service adapter → Cloud file storage: reads and writes (evidence: `app/lib/puter.ts`)
- Puter service adapter → Cloud metadata store: reads and writes (evidence: `app/lib/puter.ts`)
- Puter service adapter → AI analysis: requests analysis (evidence: `app/lib/puter.ts`)
- Puter service adapter → Puter authentication: checks identity (evidence: `app/lib/puter.ts`)
- Resume submission → Resume report route: navigates to (evidence: `app/routes/upload.tsx`)
- Resume report route → Score summary: presents scores (evidence: `README.md`)
- Resume report route → Feedback details: presents feedback (evidence: `README.md`)
- Score summary → Overall score gauge: renders (evidence: `app/components/Summary.tsx`)
- Score summary → Category score badge: renders (evidence: `app/components/Summary.tsx`)
- Feedback details → Expandable categories: uses (evidence: `app/components/Details.tsx`)
