# umamage/resume-boost architecture

> Architecture diagram of the GitHub repository umamage/resume-boost, 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/umamage/resume-boost
- Repository: https://github.com/umamage/resume-boost

## Overview

ResumeScan supports account access, resume scoring and suggestions, job recommendations, and job applications. The principal flow is a user entering through the web app, authenticating or using the dashboard, then uploading a resume and viewing scores and job opportunities. The backend exposes separate auth, resume, and jobs endpoints; its SQL models persist users and jobs. Source excerpts establish backend routing and database relationships, but do not show the frontend API calls, so those connections are marked unverified.

Main entry points: [`frontend/src/App.tsx`](https://github.com/umamage/resume-boost/blob/main/frontend/src/App.tsx) (Page router), [`frontend/src/services/api.ts`](https://github.com/umamage/resume-boost/blob/main/frontend/src/services/api.ts) (API client), [`backend/app/api/auth.py`](https://github.com/umamage/resume-boost/blob/main/backend/app/api/auth.py) (Authentication), [`backend/app/api/jobs.py`](https://github.com/umamage/resume-boost/blob/main/backend/app/api/jobs.py) (Jobs and apply)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webentry["Web entry<br/>[main.tsx]"]
  node_router["Page router<br/>[App.tsx]"]
  node_landing["Landing page<br/>[Index.tsx]"]
  node_authpage["Sign-in forms<br/>[Auth.tsx]"]
  node_authstate["Auth state<br/>[AuthContext.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_upload["Resume upload<br/>[ResumeUpload.tsx]"]
  node_scoreview["Score display<br/>[ScoreCircle.tsx]"]
  node_jobcard["Job listing<br/>[JobCard.tsx]"]
  node_clientapi["API client<br/>[api.ts]"]
end

subgraph group_api["Backend API"]
  node_app["API application<br/>[main.py]"]
  node_authapi["Authentication<br/>[auth.py]"]
  node_resumeapi["Resume analysis<br/>[resume.py]"]
  node_jobsapi["Jobs and apply<br/>[jobs.py]"]
end

subgraph group_data["Domain and storage"]
  node_contracts["API contracts<br/>[models.py]"]
  node_orm["SQL entities<br/>[sql_models.py]"]
  node_database[("SQL database<br/>[database.py]")]
end

node_user(("Job seeker"))

node_user -->|"opens app"| node_webentry
node_webentry -->|"renders"| node_router
node_router -->|"routes to"| node_landing
node_router -->|"routes to"| node_authpage
node_router -->|"routes to"| node_dashboard
node_landing -->|"links to signup"| node_router
node_authpage -->|"uses auth"| node_authstate
node_authstate -.->|"may call"| node_clientapi
node_dashboard -.->|"may render"| node_upload
node_dashboard -.->|"may render"| node_scoreview
node_dashboard -.->|"may render"| node_jobcard
node_upload -.->|"may submit"| node_clientapi
node_clientapi -.->|"may request analysis"| node_resumeapi
node_clientapi -.->|"may request jobs"| node_jobsapi
node_clientapi -.->|"may authenticate"| node_authapi
node_app -->|"mounts router"| node_authapi
node_app -->|"mounts router"| node_resumeapi
node_app -->|"mounts router"| node_jobsapi
node_app -->|"creates tables"| node_database
node_authapi -->|"uses schemas"| node_contracts
node_authapi -->|"queries users"| node_orm
node_authapi -->|"gets sessions"| node_database
node_resumeapi -->|"returns score"| node_contracts
node_jobsapi -->|"uses schemas"| node_contracts
node_jobsapi -->|"queries jobs"| node_orm
node_jobsapi -->|"gets sessions"| node_database
node_orm -->|"uses base"| node_database

click node_webentry "https://github.com/umamage/resume-boost/blob/main/frontend/src/main.tsx"
click node_router "https://github.com/umamage/resume-boost/blob/main/frontend/src/App.tsx"
click node_landing "https://github.com/umamage/resume-boost/blob/main/frontend/src/pages/Index.tsx"
click node_authpage "https://github.com/umamage/resume-boost/blob/main/frontend/src/pages/Auth.tsx"
click node_authstate "https://github.com/umamage/resume-boost/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_dashboard "https://github.com/umamage/resume-boost/blob/main/frontend/src/pages/Dashboard.tsx"
click node_upload "https://github.com/umamage/resume-boost/blob/main/frontend/src/components/ResumeUpload.tsx"
click node_scoreview "https://github.com/umamage/resume-boost/blob/main/frontend/src/components/ScoreCircle.tsx"
click node_jobcard "https://github.com/umamage/resume-boost/blob/main/frontend/src/components/JobCard.tsx"
click node_clientapi "https://github.com/umamage/resume-boost/blob/main/frontend/src/services/api.ts"
click node_app "https://github.com/umamage/resume-boost/blob/main/backend/app/main.py"
click node_authapi "https://github.com/umamage/resume-boost/blob/main/backend/app/api/auth.py"
click node_resumeapi "https://github.com/umamage/resume-boost/blob/main/backend/app/api/resume.py"
click node_jobsapi "https://github.com/umamage/resume-boost/blob/main/backend/app/api/jobs.py"
click node_contracts "https://github.com/umamage/resume-boost/blob/main/backend/app/models.py"
click node_orm "https://github.com/umamage/resume-boost/blob/main/backend/app/sql_models.py"
click node_database "https://github.com/umamage/resume-boost/blob/main/backend/app/database.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_webentry,node_router,node_landing,node_authpage,node_authstate,node_dashboard,node_upload,node_scoreview,node_jobcard,node_clientapi toneBlue
class node_app,node_authapi,node_resumeapi,node_jobsapi toneAmber
class node_contracts,node_orm,node_database toneMint
class node_user toneIndigo
```

## Components

### Web experience

- [Web entry](https://github.com/umamage/resume-boost/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [Page router](https://github.com/umamage/resume-boost/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Landing page](https://github.com/umamage/resume-boost/blob/main/frontend/src/pages/Index.tsx): `frontend/src/pages/Index.tsx`
- [Sign-in forms](https://github.com/umamage/resume-boost/blob/main/frontend/src/pages/Auth.tsx): `frontend/src/pages/Auth.tsx`
- [Auth state](https://github.com/umamage/resume-boost/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [Dashboard](https://github.com/umamage/resume-boost/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Resume upload](https://github.com/umamage/resume-boost/blob/main/frontend/src/components/ResumeUpload.tsx): `frontend/src/components/ResumeUpload.tsx`
- [Score display](https://github.com/umamage/resume-boost/blob/main/frontend/src/components/ScoreCircle.tsx): `frontend/src/components/ScoreCircle.tsx`
- [Job listing](https://github.com/umamage/resume-boost/blob/main/frontend/src/components/JobCard.tsx): `frontend/src/components/JobCard.tsx`
- [API client](https://github.com/umamage/resume-boost/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Backend API

- [API application](https://github.com/umamage/resume-boost/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/umamage/resume-boost/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`
- [Resume analysis](https://github.com/umamage/resume-boost/blob/main/backend/app/api/resume.py): `backend/app/api/resume.py`
- [Jobs and apply](https://github.com/umamage/resume-boost/blob/main/backend/app/api/jobs.py): `backend/app/api/jobs.py`

### Domain and storage

- [API contracts](https://github.com/umamage/resume-boost/blob/main/backend/app/models.py): `backend/app/models.py`
- [SQL entities](https://github.com/umamage/resume-boost/blob/main/backend/app/sql_models.py): `backend/app/sql_models.py`
- [SQL database](https://github.com/umamage/resume-boost/blob/main/backend/app/database.py): `backend/app/database.py`

### Other components

- **Job seeker**

## Connections

- Job seeker → Web entry: opens app (evidence: `frontend/src/main.tsx`)
- Web entry → Page router: renders (evidence: `frontend/src/main.tsx`)
- Page router → Landing page: routes to (evidence: `frontend/src/App.tsx`)
- Page router → Sign-in forms: routes to (evidence: `frontend/src/App.tsx`)
- Page router → Dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Landing page → Page router: links to signup (evidence: `frontend/src/pages/Index.tsx`)
- Sign-in forms → Auth state: uses auth (evidence: `frontend/src/pages/Auth.tsx`)
- Auth state → API client: may call
- Dashboard → Resume upload: may render
- Dashboard → Score display: may render
- Dashboard → Job listing: may render
- Resume upload → API client: may submit
- API client → Resume analysis: may request analysis
- API client → Jobs and apply: may request jobs
- API client → Authentication: may authenticate
- API application → Authentication: mounts router (evidence: `backend/app/main.py`)
- API application → Resume analysis: mounts router (evidence: `backend/app/main.py`)
- API application → Jobs and apply: mounts router (evidence: `backend/app/main.py`)
- API application → SQL database: creates tables (evidence: `backend/app/main.py`)
- Authentication → API contracts: uses schemas (evidence: `backend/app/api/auth.py`)
- Authentication → SQL entities: queries users (evidence: `backend/app/api/auth.py`)
- Authentication → SQL database: gets sessions (evidence: `backend/app/api/auth.py`)
- Resume analysis → API contracts: returns score (evidence: `backend/app/api/resume.py`)
- Jobs and apply → API contracts: uses schemas (evidence: `backend/app/api/jobs.py`)
- Jobs and apply → SQL entities: queries jobs (evidence: `backend/app/api/jobs.py`)
- Jobs and apply → SQL database: gets sessions (evidence: `backend/app/api/jobs.py`)
- SQL entities → SQL database: uses base (evidence: `backend/app/sql_models.py`)
