# royprem19/careerpath_ai architecture

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

- Interactive diagram: https://gitdiagram.com/royprem19/careerpath_ai
- Repository: https://github.com/royprem19/careerpath_ai

## Overview

CareerPath AI connects a candidate’s resume and skills to industry roles, quantified skill gaps, alternative career recommendations, and learning roadmaps, with PDF reports as an export. The frontend also exposes authentication, institution analytics, and market/talent intelligence. Edges are limited to wiring shown in the excerpts, SOURCE INDEX references, or README; several capability modules are indexed but unsampled, so their internal calls are not inferred.

Main entry points: [`frontend/src/services/api.js`](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/services/api.js) (API client), [`frontend/src/App.jsx`](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/App.jsx) (CareerPath UI), [`backend/database.py`](https://github.com/royprem19/careerpath_ai/blob/main/backend/database.py) (Supabase client), [`backend/routers/resume.py`](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/resume.py) (Resume API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Candidate experience"]
  node_webapp["CareerPath UI<br/>[App.jsx]"]
  node_upload["Resume upload<br/>[UploadPage.jsx]"]
  node_profile["Profile review<br/>[ProfileReview.jsx]"]
  node_roleui["Role selection<br/>[RoleSelection.jsx]"]
  node_dashboard["Career dashboard<br/>[Dashboard.jsx]"]
  node_marketui["Market insights"]
  node_growthui["Career simulator"]
  node_authui["Account screens<br/>[AuthPage.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_context["App state<br/>[AppContext.jsx]"]
  node_provider["State provider<br/>[AppProvider.jsx]"]
end

subgraph group_api["API and identity"]
  node_auth["Authentication<br/>[auth.py]"]
  node_resume_route["Resume API<br/>[resume.py]"]
  node_roles["Role catalog<br/>[roles.py]"]
  node_analysis_route["Gap analysis API<br/>[analysis.py]"]
  node_recommend_route["Recommendations API<br/>[recommendations.py]"]
  node_roadmap_route["Roadmap API<br/>[roadmap.py]"]
  node_report_route["PDF report API<br/>[report.py]"]
  node_schemas["Request schemas<br/>[schemas.py]"]
end

subgraph group_career["Career intelligence"]
  node_parser["Resume parser<br/>[resume_parser.py]"]
  node_extractor["Skill extraction<br/>[skill_extractor.py]"]
  node_normalizer["Skill normalization"]
  node_gap["Gap analyzer<br/>[gap_analyzer.py]"]
  node_recommender["Role recommender<br/>[recommender.py]"]
  node_roadmap["Learning roadmap"]
  node_report["Report generator"]
end

subgraph group_insights["Workforce insights"]
  node_talent["Talent intelligence"]
  node_institution["Institution analytics<br/>[institution.py]"]
end

subgraph group_platform["Persistence and delivery"]
  node_auth_service["Auth service<br/>[auth_service.py]"]
  node_email["Verification email<br/>[email_service.py]"]
  node_database[("Supabase client<br/>[database.py]")]
end

node_candidate(("Candidate"))
node_supabase[("Supabase database")]
node_smtp(("SMTP service"))

node_candidate -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_upload
node_webapp -->|"routes to"| node_profile
node_webapp -->|"routes to"| node_roleui
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_marketui
node_webapp -->|"routes to"| node_growthui
node_webapp -->|"routes to"| node_authui
node_upload -->|"uploads resume"| node_api_client
node_profile -->|"reads profile"| node_context
node_provider -->|"provides state"| node_context
node_webapp -->|"wraps routes"| node_provider
node_roleui -->|"loads roles"| node_api_client
node_dashboard -->|"requests analysis"| node_api_client
node_marketui -->|"requests insights"| node_api_client
node_growthui -->|"requests predictions"| node_api_client
node_authui -->|"authenticates"| node_api_client
node_api_client -->|"HTTP request"| node_resume_route
node_api_client -->|"HTTP request"| node_roles
node_api_client -->|"HTTP request"| node_analysis_route
node_api_client -->|"HTTP request"| node_recommend_route
node_api_client -->|"HTTP request"| node_roadmap_route
node_api_client -->|"HTTP request"| node_report_route
node_api_client -->|"HTTP request"| node_auth
node_api_client -->|"HTTP request"| node_talent
node_api_client -->|"HTTP request"| node_institution
node_resume_route -->|"parses resume"| node_parser
node_resume_route -->|"extracts skills"| node_extractor
node_resume_route -->|"normalizes skills"| node_normalizer
node_analysis_route -->|"calculates gaps"| node_gap
node_recommend_route -->|"ranks roles"| node_recommender
node_roadmap_route -->|"generates plan"| node_roadmap
node_report_route -->|"creates PDF"| node_report
node_auth -->|"delegates auth"| node_auth_service
node_auth_service -->|"sends verification"| node_email
node_email -.->|"delivers email"| node_smtp
node_auth_service -->|"reads/writes profiles"| node_database
node_database -->|"connects"| node_supabase
node_roles -->|"loads role data"| node_database
node_roadmap_route -->|"loads data"| node_database
node_analysis_route -->|"uses role lookup"| node_roles
node_recommend_route -->|"uses role lookup"| node_roles
node_schemas -.-> node_database
node_normalizer -->|"uses skill logic"| node_extractor

click node_webapp "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/App.jsx"
click node_upload "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/UploadPage.jsx"
click node_profile "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/ProfileReview.jsx"
click node_roleui "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/RoleSelection.jsx"
click node_dashboard "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/Dashboard.jsx"
click node_marketui "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/MarketInsightsPage.jsx"
click node_growthui "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/CareerGrowthSimulator.jsx"
click node_authui "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/AuthPage.jsx"
click node_api_client "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/services/api.js"
click node_auth "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/auth.py"
click node_resume_route "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/resume.py"
click node_roles "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/roles.py"
click node_analysis_route "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/analysis.py"
click node_recommend_route "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/recommendations.py"
click node_roadmap_route "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/roadmap.py"
click node_report_route "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/report.py"
click node_schemas "https://github.com/royprem19/careerpath_ai/blob/main/backend/models/schemas.py"
click node_parser "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/resume_parser.py"
click node_extractor "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/skill_extractor.py"
click node_normalizer "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/skill_normalizer.py"
click node_gap "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/gap_analyzer.py"
click node_recommender "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/recommender.py"
click node_roadmap "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/roadmap_generator.py"
click node_report "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/report_generator.py"
click node_talent "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/talent_intelligence.py"
click node_institution "https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/institution.py"
click node_auth_service "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/auth_service.py"
click node_email "https://github.com/royprem19/careerpath_ai/blob/main/backend/services/email_service.py"
click node_database "https://github.com/royprem19/careerpath_ai/blob/main/backend/database.py"
click node_context "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/context/AppContext.jsx"
click node_provider "https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/context/AppProvider.jsx"

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_webapp,node_upload,node_profile,node_roleui,node_dashboard,node_marketui,node_growthui,node_authui,node_api_client,node_context,node_provider toneBlue
class node_auth,node_resume_route,node_roles,node_analysis_route,node_recommend_route,node_roadmap_route,node_report_route,node_schemas,node_supabase toneAmber
class node_parser,node_extractor,node_normalizer,node_gap,node_recommender,node_roadmap,node_report toneMint
class node_talent,node_institution toneRose
class node_auth_service,node_email,node_database,node_candidate,node_smtp toneIndigo
```

## Components

### Candidate experience

- [CareerPath UI](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Resume upload](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/UploadPage.jsx): `frontend/src/pages/UploadPage.jsx`
- [Profile review](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/ProfileReview.jsx): `frontend/src/pages/ProfileReview.jsx`
- [Role selection](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/RoleSelection.jsx): `frontend/src/pages/RoleSelection.jsx`
- [Career dashboard](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Market insights](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/MarketInsightsPage.jsx): `frontend/src/pages/MarketInsightsPage.jsx`
- [Career simulator](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/CareerGrowthSimulator.jsx): `frontend/src/pages/CareerGrowthSimulator.jsx`
- [Account screens](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/pages/AuthPage.jsx): `frontend/src/pages/AuthPage.jsx`
- [API client](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [App state](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/context/AppContext.jsx): `frontend/src/context/AppContext.jsx`
- [State provider](https://github.com/royprem19/careerpath_ai/blob/main/frontend/src/context/AppProvider.jsx): `frontend/src/context/AppProvider.jsx`

### API and identity

- [Authentication](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/auth.py): `backend/routers/auth.py`
- [Resume API](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/resume.py): `backend/routers/resume.py`
- [Role catalog](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/roles.py): `backend/routers/roles.py`
- [Gap analysis API](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/analysis.py): `backend/routers/analysis.py`
- [Recommendations API](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/recommendations.py): `backend/routers/recommendations.py`
- [Roadmap API](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/roadmap.py): `backend/routers/roadmap.py`
- [PDF report API](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/report.py): `backend/routers/report.py`
- [Request schemas](https://github.com/royprem19/careerpath_ai/blob/main/backend/models/schemas.py): `backend/models/schemas.py`

### Career intelligence

- [Resume parser](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/resume_parser.py): `backend/services/resume_parser.py`
- [Skill extraction](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/skill_extractor.py): `backend/services/skill_extractor.py`
- [Skill normalization](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/skill_normalizer.py): `backend/services/skill_normalizer.py`
- [Gap analyzer](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/gap_analyzer.py): `backend/services/gap_analyzer.py`
- [Role recommender](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/recommender.py): `backend/services/recommender.py`
- [Learning roadmap](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/roadmap_generator.py): `backend/services/roadmap_generator.py`
- [Report generator](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/report_generator.py): `backend/services/report_generator.py`

### Workforce insights

- [Talent intelligence](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/talent_intelligence.py): `backend/routers/talent_intelligence.py`
- [Institution analytics](https://github.com/royprem19/careerpath_ai/blob/main/backend/routers/institution.py): `backend/routers/institution.py`

### Persistence and delivery

- [Auth service](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/auth_service.py): `backend/services/auth_service.py`
- [Verification email](https://github.com/royprem19/careerpath_ai/blob/main/backend/services/email_service.py): `backend/services/email_service.py`
- [Supabase client](https://github.com/royprem19/careerpath_ai/blob/main/backend/database.py): `backend/database.py`

### Other components

- **Candidate**
- **Supabase database**
- **SMTP service**

## Connections

- Candidate → CareerPath UI: uses (evidence: `frontend/src/App.jsx`)
- CareerPath UI → Resume upload: routes to (evidence: `frontend/src/App.jsx`)
- CareerPath UI → Profile review: routes to (evidence: `frontend/src/App.jsx`)
- CareerPath UI → Role selection: routes to (evidence: `frontend/src/App.jsx`)
- CareerPath UI → Career dashboard: routes to (evidence: `frontend/src/App.jsx`)
- CareerPath UI → Market insights: routes to (evidence: `frontend/src/App.jsx`)
- CareerPath UI → Career simulator: routes to (evidence: `frontend/src/App.jsx`)
- CareerPath UI → Account screens: routes to (evidence: `frontend/src/App.jsx`)
- Resume upload → API client: uploads resume (evidence: `frontend/src/pages/UploadPage.jsx`)
- Profile review → App state: reads profile (evidence: `frontend/src/pages/ProfileReview.jsx`)
- State provider → App state: provides state (evidence: `frontend/src/context/AppProvider.jsx`)
- CareerPath UI → State provider: wraps routes (evidence: `frontend/src/App.jsx`)
- Role selection → API client: loads roles (evidence: `frontend/src/pages/RoleSelection.jsx`)
- Career dashboard → API client: requests analysis (evidence: `frontend/src/pages/Dashboard.jsx`)
- Market insights → API client: requests insights (evidence: `frontend/src/pages/MarketInsightsPage.jsx`)
- Career simulator → API client: requests predictions (evidence: `frontend/src/pages/CareerGrowthSimulator.jsx`)
- Account screens → API client: authenticates (evidence: `frontend/src/pages/AuthPage.jsx`)
- API client → Resume API: HTTP request (evidence: `frontend/src/services/api.js`)
- API client → Role catalog: HTTP request (evidence: `frontend/src/services/api.js`)
- API client → Gap analysis API: HTTP request (evidence: `frontend/src/services/api.js`)
- API client → Recommendations API: HTTP request (evidence: `frontend/src/services/api.js`)
- API client → Roadmap API: HTTP request (evidence: `frontend/src/services/api.js`)
- API client → PDF report API: HTTP request (evidence: `frontend/src/services/api.js`)
- API client → Authentication: HTTP request (evidence: `frontend/src/services/api.js`)
- API client → Talent intelligence: HTTP request (evidence: `frontend/src/services/api.js`)
- API client → Institution analytics: HTTP request (evidence: `frontend/src/services/api.js`)
- Resume API → Resume parser: parses resume (evidence: `backend/routers/resume.py`)
- Resume API → Skill extraction: extracts skills (evidence: `backend/routers/resume.py`)
- Resume API → Skill normalization: normalizes skills (evidence: `backend/routers/resume.py`)
- Gap analysis API → Gap analyzer: calculates gaps (evidence: `backend/routers/analysis.py`)
- Recommendations API → Role recommender: ranks roles (evidence: `backend/routers/recommendations.py`)
- Roadmap API → Learning roadmap: generates plan (evidence: `backend/routers/roadmap.py`)
- PDF report API → Report generator: creates PDF (evidence: `backend/routers/report.py`)
- Authentication → Auth service: delegates auth (evidence: `backend/routers/auth.py`)
- Auth service → Verification email: sends verification (evidence: `backend/services/auth_service.py`)
- Verification email → SMTP service: delivers email (evidence: `backend/services/email_service.py`)
- Auth service → Supabase client: reads/writes profiles (evidence: `backend/services/auth_service.py`)
- Supabase client → Supabase database: connects (evidence: `backend/database.py`)
- Role catalog → Supabase client: loads role data (evidence: `backend/routers/roles.py`)
- Roadmap API → Supabase client: loads data (evidence: `backend/routers/roadmap.py`)
- Gap analysis API → Role catalog: uses role lookup (evidence: `backend/routers/analysis.py`)
- Recommendations API → Role catalog: uses role lookup (evidence: `backend/routers/recommendations.py`)
- Request schemas → Supabase client
- Skill normalization → Skill extraction: uses skill logic (evidence: `backend/services/skill_normalizer.py`)
