# uday-unni/ai-career-coach architecture

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

- Interactive diagram: https://gitdiagram.com/uday-unni/ai-career-coach
- Repository: https://github.com/uday-unni/ai-career-coach

## Overview

Rezumi is an AI-powered job-application coach. Users register, provide a resume and job details, then manage applications and request resume analysis, cover letters, interview preparation, or GitHub profile scans. The frontend routes feature pages through API clients to Django app endpoints; backend app models hold domain records, while AI and repository scanning add analysis stages. The README documents the major features and endpoints; source excerpts/index verify selected frontend calls and GitHub scan internals, but most backend view implementations were not sampled.

Main entry points: [`frontend/src/api/axios.js`](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/axios.js) (HTTP client), [`frontend/src/App.jsx`](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/App.jsx) (Route shell), [`backend/apps/github_scanner/views.py`](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/github_scanner/views.py) (GitHub scan service), [`frontend/src/api/applicationsApi.js`](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/applicationsApi.js) (Application API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Route shell<br/>[App.jsx]"]
  node_authpage["Sign-in / register<br/>[Login.jsx]"]
  node_authstate["Auth state<br/>[authStore.js]"]
  node_http["HTTP client<br/>[axios.js]"]
  node_applicationapi["Application API<br/>[applicationsApi.js]"]
  node_authapi["Auth API<br/>[authApi.js]"]
  node_resumeapi["Resume API<br/>[resumeApi.js]"]
  node_aiapi["AI API<br/>[aiApi.js]"]
  node_githubapi["GitHub API<br/>[githubApi.js]"]
end

subgraph group_career["Career tools"]
  node_applicationpages["Applications views<br/>[Applications.jsx]"]
  node_detail["Application detail"]
  node_kanban["Kanban board<br/>[KanbanBoard.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_resumeui["Resume workspace<br/>[Resume.jsx]"]
  node_githubui["GitHub scanner UI<br/>[GitHub.jsx]"]
end

subgraph group_backend["Backend services"]
  node_applicationservice["Application service<br/>[views.py]"]
  node_applicationdata[("Application records<br/>[models.py]")]
  node_userservice["User service<br/>[views.py]"]
  node_resume["Resume handling<br/>[views.py]"]
  node_resumedata[("Resume records<br/>[models.py]")]
  node_resumeparse["PDF extraction<br/>[utils.py]"]
  node_ai["AI coaching<br/>[views.py]"]
  node_aiclient["AI client<br/>[client.py]"]
  node_github["GitHub scan service<br/>[views.py]"]
  node_scraper["Repository scraper<br/>[scraper.py]"]
  node_githubdata[("Scan results<br/>[models.py]")]
end

subgraph group_integrations["External services"]
  node_groq{{"Groq AI"}}
  node_githubservice{{"GitHub public data"}}
end

node_jobseeker(("Job seeker"))

node_jobseeker -->|"uses"| node_app
node_app -->|"routes to"| node_authpage
node_app -->|"routes to"| node_applicationpages
node_app -->|"routes to"| node_detail
node_app -->|"routes to"| node_kanban
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_resumeui
node_app -->|"routes to"| node_githubui
node_app -->|"checks auth"| node_authstate
node_authpage -->|"calls"| node_authapi
node_authpage -->|"updates"| node_authstate
node_authapi -->|"sends requests"| node_http
node_applicationpages -->|"creates applications"| node_applicationapi
node_detail -->|"manages records"| node_applicationapi
node_detail -->|"requests coaching"| node_aiapi
node_detail -->|"requests scans"| node_githubapi
node_kanban -->|"updates status"| node_applicationapi
node_dashboard -->|"loads applications"| node_applicationapi
node_githubui -->|"requests scan"| node_githubapi
node_resumeui -.->|"uploads resume"| node_resumeapi
node_applicationapi -->|"sends requests"| node_http
node_aiapi -->|"sends requests"| node_http
node_githubapi -->|"sends requests"| node_http
node_resumeapi -.->|"sends requests"| node_http
node_http -->|"calls API"| node_userservice
node_http -->|"calls API"| node_applicationservice
node_http -->|"calls API"| node_resume
node_http -->|"calls API"| node_ai
node_http -->|"calls API"| node_github
node_applicationservice -->|"reads / writes"| node_applicationdata
node_resume -.->|"uses records"| node_resumedata
node_resume -.->|"extracts text"| node_resumeparse
node_ai -.->|"requests generation"| node_aiclient
node_aiclient -->|"calls model"| node_groq
node_github -->|"collects repositories"| node_scraper
node_github -->|"requests analysis"| node_aiclient
node_github -->|"stores results"| node_githubdata
node_github -->|"uses job context"| node_applicationdata
node_scraper -.->|"fetches public data"| node_githubservice

click node_app "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/App.jsx"
click node_authpage "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/Login.jsx"
click node_authstate "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/store/authStore.js"
click node_http "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/axios.js"
click node_applicationpages "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/Applications.jsx"
click node_detail "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/ApplicationDetail.jsx"
click node_kanban "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/KanbanBoard.jsx"
click node_dashboard "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/Dashboard.jsx"
click node_resumeui "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/Resume.jsx"
click node_githubui "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/GitHub.jsx"
click node_applicationapi "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/applicationsApi.js"
click node_authapi "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/authApi.js"
click node_resumeapi "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/resumeApi.js"
click node_aiapi "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/aiApi.js"
click node_githubapi "https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/githubApi.js"
click node_applicationservice "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/applications/views.py"
click node_applicationdata "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/applications/models.py"
click node_userservice "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/users/views.py"
click node_resume "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/resumes/views.py"
click node_resumedata "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/resumes/models.py"
click node_resumeparse "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/resumes/utils.py"
click node_ai "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/ai_analysis/views.py"
click node_aiclient "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/ai_analysis/client.py"
click node_github "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/github_scanner/views.py"
click node_scraper "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/github_scanner/scraper.py"
click node_githubdata "https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/github_scanner/models.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_app,node_authpage,node_authstate,node_http,node_applicationapi,node_authapi,node_resumeapi,node_aiapi,node_githubapi toneBlue
class node_applicationpages,node_detail,node_kanban,node_dashboard,node_resumeui,node_githubui toneAmber
class node_applicationservice,node_applicationdata,node_userservice,node_resume,node_resumedata,node_resumeparse,node_ai,node_aiclient,node_github,node_scraper,node_githubdata toneMint
class node_groq,node_githubservice toneRose
class node_jobseeker toneIndigo
```

## Components

### Web application

- [Route shell](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in / register](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Auth state](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/store/authStore.js): `frontend/src/store/authStore.js`
- [HTTP client](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`
- [Application API](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/applicationsApi.js): `frontend/src/api/applicationsApi.js`
- [Auth API](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/authApi.js): `frontend/src/api/authApi.js`
- [Resume API](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/resumeApi.js): `frontend/src/api/resumeApi.js`
- [AI API](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/aiApi.js): `frontend/src/api/aiApi.js`
- [GitHub API](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/api/githubApi.js): `frontend/src/api/githubApi.js`

### Career tools

- [Applications views](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/Applications.jsx): `frontend/src/pages/Applications.jsx`
- [Application detail](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/ApplicationDetail.jsx): `frontend/src/pages/ApplicationDetail.jsx`
- [Kanban board](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/KanbanBoard.jsx): `frontend/src/pages/KanbanBoard.jsx`
- [Dashboard](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Resume workspace](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/Resume.jsx): `frontend/src/pages/Resume.jsx`
- [GitHub scanner UI](https://github.com/uday-unni/ai-career-coach/blob/main/frontend/src/pages/GitHub.jsx): `frontend/src/pages/GitHub.jsx`

### Backend services

- [Application service](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/applications/views.py): `backend/apps/applications/views.py`
- [Application records](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/applications/models.py): `backend/apps/applications/models.py`
- [User service](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/users/views.py): `backend/apps/users/views.py`
- [Resume handling](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/resumes/views.py): `backend/apps/resumes/views.py`
- [Resume records](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/resumes/models.py): `backend/apps/resumes/models.py`
- [PDF extraction](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/resumes/utils.py): `backend/apps/resumes/utils.py`
- [AI coaching](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/ai_analysis/views.py): `backend/apps/ai_analysis/views.py`
- [AI client](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/ai_analysis/client.py): `backend/apps/ai_analysis/client.py`
- [GitHub scan service](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/github_scanner/views.py): `backend/apps/github_scanner/views.py`
- [Repository scraper](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/github_scanner/scraper.py): `backend/apps/github_scanner/scraper.py`
- [Scan results](https://github.com/uday-unni/ai-career-coach/blob/main/backend/apps/github_scanner/models.py): `backend/apps/github_scanner/models.py`

### External services

- **Groq AI**
- **GitHub public data**

### Other components

- **Job seeker**

## Connections

- Job seeker → Route shell: uses
- Route shell → Sign-in / register: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Applications views: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Application detail: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Kanban board: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Resume workspace: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → GitHub scanner UI: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Auth state: checks auth (evidence: `frontend/src/App.jsx`)
- Sign-in / register → Auth API: calls (evidence: `frontend/src/pages/Login.jsx`)
- Sign-in / register → Auth state: updates (evidence: `frontend/src/pages/Login.jsx`)
- Auth API → HTTP client: sends requests (evidence: `frontend/src/api/authApi.js`)
- Applications views → Application API: creates applications (evidence: `frontend/src/pages/Applications.jsx`)
- Application detail → Application API: manages records (evidence: `frontend/src/pages/ApplicationDetail.jsx`)
- Application detail → AI API: requests coaching (evidence: `frontend/src/pages/ApplicationDetail.jsx`)
- Application detail → GitHub API: requests scans (evidence: `frontend/src/pages/ApplicationDetail.jsx`)
- Kanban board → Application API: updates status (evidence: `frontend/src/pages/KanbanBoard.jsx`)
- Dashboard → Application API: loads applications (evidence: `frontend/src/pages/Dashboard.jsx`)
- GitHub scanner UI → GitHub API: requests scan (evidence: `frontend/src/pages/GitHub.jsx`)
- Resume workspace → Resume API: uploads resume
- Application API → HTTP client: sends requests (evidence: `frontend/src/api/applicationsApi.js`)
- AI API → HTTP client: sends requests (evidence: `frontend/src/api/aiApi.js`)
- GitHub API → HTTP client: sends requests (evidence: `frontend/src/api/githubApi.js`)
- Resume API → HTTP client: sends requests
- HTTP client → User service: calls API (evidence: `README.md`)
- HTTP client → Application service: calls API (evidence: `README.md`)
- HTTP client → Resume handling: calls API (evidence: `README.md`)
- HTTP client → AI coaching: calls API (evidence: `README.md`)
- HTTP client → GitHub scan service: calls API (evidence: `README.md`)
- Application service → Application records: reads / writes (evidence: `backend/apps/applications/views.py`)
- Resume handling → Resume records: uses records
- Resume handling → PDF extraction: extracts text
- AI coaching → AI client: requests generation
- AI client → Groq AI: calls model (evidence: `backend/apps/ai_analysis/client.py`)
- GitHub scan service → Repository scraper: collects repositories (evidence: `backend/apps/github_scanner/views.py`)
- GitHub scan service → AI client: requests analysis (evidence: `backend/apps/github_scanner/views.py`)
- GitHub scan service → Scan results: stores results (evidence: `backend/apps/github_scanner/views.py`)
- GitHub scan service → Application records: uses job context (evidence: `backend/apps/github_scanner/views.py`)
- Repository scraper → GitHub public data: fetches public data
