# anuragthippani1/ai-careerpilot architecture

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

- Interactive diagram: https://gitdiagram.com/anuragthippani1/ai-careerpilot
- Repository: https://github.com/anuragthippani1/ai-careerpilot

## Overview

CareerPilot is an AI career-development platform whose main journey runs from resume assessment through skill-gap analysis and roadmap planning to interview and coding practice. The React client provides the user-facing pages; Express routes expose product capabilities, with AI agents handling analysis and coaching and MySQL-backed services retaining user progress. The README documents the product journey and major features. Source excerpts and the SOURCE INDEX support selected wiring; unsampled route and page details are represented conservatively.

Main entry points: [`server/agents/orchestrator.js`](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/orchestrator.js) (Agent orchestrator), [`server/index.js`](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/index.js) (Express API), [`client/src/App.jsx`](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/App.jsx) (Client router), [`server/routes/practice.js`](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/practice.js) (Practice routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["CareerPilot client"]
  node_app["Client router<br/>[App.jsx]"]
  node_auth["Auth context<br/>[AuthContext.jsx]"]
  node_resume_ui["Resume upload<br/>[ResumeUpload.jsx]"]
  node_gap_ui["Skill gap<br/>[SkillGap.jsx]"]
  node_matches_ui["Career matches<br/>[CareerMatches.jsx]"]
  node_roadmap_ui["Career roadmap<br/>[CareerRoadmap.jsx]"]
  node_interview_ui["Mock interview<br/>[MockInterview.jsx]"]
  node_practice_ui["Coding practice<br/>[CodingPractice.jsx]"]
  node_dashboard_ui["Career dashboard<br/>[Dashboard.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and identity"]
  node_http_api["Express API<br/>[index.js]"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
  node_auth_mw["JWT authentication<br/>[auth.js]"]
  node_database[("MySQL store<br/>[database.js]")]
end

subgraph group_career["Career guidance"]
  node_resume_routes["Resume routes<br/>[resume.js]"]
  node_skills_routes["Skill routes<br/>[skills.js]"]
  node_career_routes["Career routes<br/>[career.js]"]
  node_roadmap_routes["Roadmap routes<br/>[roadmap.js]"]
  node_orchestrator["Agent orchestrator<br/>[orchestrator.js]"]
  node_resume_agent["Resume analyzer<br/>[resumeAnalyzer.js]"]
  node_skill_agent["Skill-gap agent<br/>[skillGap.js]"]
  node_advisor_agent["Career advisor<br/>[careerAdvisor.js]"]
  node_roadmap_agent["Roadmap agent<br/>[careerRoadmap.js]"]
  node_ai_service["AI provider<br/>[aiProvider.js]"]
end

subgraph group_practice["Practice and progress"]
  node_interview_routes["Interview routes<br/>[interview.js]"]
  node_interview_agent["Interview agent<br/>[interview.js]"]
  node_practice_routes["Practice routes<br/>[practice.js]"]
  node_practice_agent["Practice agent<br/>[practice.js]"]
  node_question_bank["Question bank<br/>[questionBank.js]"]
  node_executor["Code executor<br/>[codeExecutor.js]"]
  node_gamification["XP and streaks<br/>[gamification.js]"]
  node_achievements["Achievements<br/>[achievements.js]"]
end

node_seeker(("Job seeker"))

node_seeker -->|"uploads resume"| node_resume_ui
node_resume_ui -->|"informs analysis"| node_gap_ui
node_gap_ui -->|"guides planning"| node_roadmap_ui
node_roadmap_ui -->|"leads to practice"| node_interview_ui
node_interview_ui -->|"continues practice"| node_practice_ui
node_app -->|"routes to"| node_resume_ui
node_app -->|"routes to"| node_gap_ui
node_app -->|"routes to"| node_matches_ui
node_app -->|"routes to"| node_roadmap_ui
node_app -->|"routes to"| node_interview_ui
node_app -->|"routes to"| node_practice_ui
node_app -->|"routes to"| node_dashboard_ui
node_auth -->|"calls auth API"| node_api_client
node_api_client -.->|"sends API requests"| node_http_api
node_http_api -->|"mounts routes"| node_auth_routes
node_http_api -->|"mounts routes"| node_resume_routes
node_http_api -->|"mounts routes"| node_skills_routes
node_http_api -->|"mounts routes"| node_career_routes
node_http_api -->|"mounts routes"| node_roadmap_routes
node_http_api -->|"mounts routes"| node_interview_routes
node_http_api -->|"mounts routes"| node_practice_routes
node_auth_routes -->|"queries users"| node_database
node_auth_mw -->|"loads user"| node_database
node_skills_routes -->|"dispatches actions"| node_orchestrator
node_roadmap_routes -->|"dispatches actions"| node_orchestrator
node_orchestrator -->|"invokes"| node_resume_agent
node_orchestrator -->|"invokes"| node_skill_agent
node_orchestrator -->|"invokes"| node_advisor_agent
node_orchestrator -->|"invokes"| node_roadmap_agent
node_orchestrator -->|"invokes"| node_interview_agent
node_interview_routes -.->|"delegates to"| node_interview_agent
node_practice_routes -->|"invokes"| node_practice_agent
node_practice_routes -->|"gets questions"| node_question_bank
node_practice_routes -->|"runs code"| node_executor
node_practice_routes -->|"updates progress"| node_gamification
node_practice_routes -->|"checks awards"| node_achievements
node_question_bank -->|"reads questions"| node_database
node_gamification -->|"updates stats"| node_database
node_achievements -->|"stores awards"| node_database
node_achievements -->|"uses service"| node_gamification
node_orchestrator -->|"loads context"| node_database
node_orchestrator -.->|"agent provider"| node_ai_service
node_ai_service -.->|"generates guidance"| node_seeker

click node_app "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/App.jsx"
click node_auth "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/contexts/AuthContext.jsx"
click node_resume_ui "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/ResumeUpload.jsx"
click node_gap_ui "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/SkillGap.jsx"
click node_matches_ui "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/CareerMatches.jsx"
click node_roadmap_ui "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/CareerRoadmap.jsx"
click node_interview_ui "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/MockInterview.jsx"
click node_practice_ui "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/CodingPractice.jsx"
click node_dashboard_ui "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/Dashboard.jsx"
click node_api_client "https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/services/api.js"
click node_http_api "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/index.js"
click node_auth_routes "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/auth.js"
click node_auth_mw "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/middleware/auth.js"
click node_resume_routes "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/resume.js"
click node_skills_routes "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/skills.js"
click node_career_routes "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/career.js"
click node_roadmap_routes "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/roadmap.js"
click node_orchestrator "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/orchestrator.js"
click node_resume_agent "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/resumeAnalyzer.js"
click node_skill_agent "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/skillGap.js"
click node_advisor_agent "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/careerAdvisor.js"
click node_roadmap_agent "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/careerRoadmap.js"
click node_interview_routes "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/interview.js"
click node_interview_agent "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/interview.js"
click node_practice_routes "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/practice.js"
click node_practice_agent "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/practice.js"
click node_question_bank "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/services/questionBank.js"
click node_executor "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/services/codeExecutor.js"
click node_gamification "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/services/gamification.js"
click node_achievements "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/services/achievements.js"
click node_database "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/config/database.js"
click node_ai_service "https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/config/aiProvider.js"

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_resume_ui,node_gap_ui,node_matches_ui,node_roadmap_ui,node_interview_ui,node_practice_ui,node_dashboard_ui,node_api_client toneBlue
class node_http_api,node_auth_routes,node_auth_mw,node_database toneAmber
class node_resume_routes,node_skills_routes,node_career_routes,node_roadmap_routes,node_orchestrator,node_resume_agent,node_skill_agent,node_advisor_agent,node_roadmap_agent,node_ai_service toneMint
class node_interview_routes,node_interview_agent,node_practice_routes,node_practice_agent,node_question_bank,node_executor,node_gamification,node_achievements toneRose
class node_seeker toneIndigo
```

## Components

### CareerPilot client

- [Client router](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Auth context](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/contexts/AuthContext.jsx): `client/src/contexts/AuthContext.jsx`
- [Resume upload](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/ResumeUpload.jsx): `client/src/pages/ResumeUpload.jsx`
- [Skill gap](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/SkillGap.jsx): `client/src/pages/SkillGap.jsx`
- [Career matches](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/CareerMatches.jsx): `client/src/pages/CareerMatches.jsx`
- [Career roadmap](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/CareerRoadmap.jsx): `client/src/pages/CareerRoadmap.jsx`
- [Mock interview](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/MockInterview.jsx): `client/src/pages/MockInterview.jsx`
- [Coding practice](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/CodingPractice.jsx): `client/src/pages/CodingPractice.jsx`
- [Career dashboard](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [API client](https://github.com/anuragthippani1/ai-careerpilot/blob/main/client/src/services/api.js): `client/src/services/api.js`

### API and identity

- [Express API](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/index.js): `server/index.js`
- [Auth routes](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [JWT authentication](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [MySQL store](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/config/database.js): `server/config/database.js`

### Career guidance

- [Resume routes](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/resume.js): `server/routes/resume.js`
- [Skill routes](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/skills.js): `server/routes/skills.js`
- [Career routes](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/career.js): `server/routes/career.js`
- [Roadmap routes](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/roadmap.js): `server/routes/roadmap.js`
- [Agent orchestrator](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/orchestrator.js): `server/agents/orchestrator.js`
- [Resume analyzer](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/resumeAnalyzer.js): `server/agents/resumeAnalyzer.js`
- [Skill-gap agent](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/skillGap.js): `server/agents/skillGap.js`
- [Career advisor](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/careerAdvisor.js): `server/agents/careerAdvisor.js`
- [Roadmap agent](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/careerRoadmap.js): `server/agents/careerRoadmap.js`
- [AI provider](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/config/aiProvider.js): `server/config/aiProvider.js`

### Practice and progress

- [Interview routes](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/interview.js): `server/routes/interview.js`
- [Interview agent](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/interview.js): `server/agents/interview.js`
- [Practice routes](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/routes/practice.js): `server/routes/practice.js`
- [Practice agent](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/agents/practice.js): `server/agents/practice.js`
- [Question bank](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/services/questionBank.js): `server/services/questionBank.js`
- [Code executor](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/services/codeExecutor.js): `server/services/codeExecutor.js`
- [XP and streaks](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/services/gamification.js): `server/services/gamification.js`
- [Achievements](https://github.com/anuragthippani1/ai-careerpilot/blob/main/server/services/achievements.js): `server/services/achievements.js`

### Other components

- **Job seeker**

## Connections

- Job seeker → Resume upload: uploads resume (evidence: `README.md`)
- Resume upload → Skill gap: informs analysis (evidence: `README.md`)
- Skill gap → Career roadmap: guides planning (evidence: `README.md`)
- Career roadmap → Mock interview: leads to practice (evidence: `README.md`)
- Mock interview → Coding practice: continues practice (evidence: `README.md`)
- Client router → Resume upload: routes to (evidence: `client/src/App.jsx`)
- Client router → Skill gap: routes to (evidence: `client/src/App.jsx`)
- Client router → Career matches: routes to (evidence: `client/src/App.jsx`)
- Client router → Career roadmap: routes to (evidence: `client/src/App.jsx`)
- Client router → Mock interview: routes to (evidence: `client/src/App.jsx`)
- Client router → Coding practice: routes to (evidence: `client/src/App.jsx`)
- Client router → Career dashboard: routes to (evidence: `client/src/App.jsx`)
- Auth context → API client: calls auth API (evidence: `client/src/contexts/AuthContext.jsx`)
- API client → Express API: sends API requests
- Express API → Auth routes: mounts routes (evidence: `server/index.js`)
- Express API → Resume routes: mounts routes (evidence: `server/index.js`)
- Express API → Skill routes: mounts routes (evidence: `server/index.js`)
- Express API → Career routes: mounts routes (evidence: `server/index.js`)
- Express API → Roadmap routes: mounts routes (evidence: `server/index.js`)
- Express API → Interview routes: mounts routes (evidence: `server/index.js`)
- Express API → Practice routes: mounts routes (evidence: `server/index.js`)
- Auth routes → MySQL store: queries users (evidence: `server/routes/auth.js`)
- JWT authentication → MySQL store: loads user (evidence: `server/middleware/auth.js`)
- Skill routes → Agent orchestrator: dispatches actions (evidence: `server/routes/skills.js`)
- Roadmap routes → Agent orchestrator: dispatches actions (evidence: `server/routes/roadmap.js`)
- Agent orchestrator → Resume analyzer: invokes (evidence: `server/agents/orchestrator.js`)
- Agent orchestrator → Skill-gap agent: invokes (evidence: `server/agents/orchestrator.js`)
- Agent orchestrator → Career advisor: invokes (evidence: `server/agents/orchestrator.js`)
- Agent orchestrator → Roadmap agent: invokes (evidence: `server/agents/orchestrator.js`)
- Agent orchestrator → Interview agent: invokes (evidence: `server/agents/orchestrator.js`)
- Interview routes → Interview agent: delegates to
- Practice routes → Practice agent: invokes (evidence: `server/routes/practice.js`)
- Practice routes → Question bank: gets questions (evidence: `server/routes/practice.js`)
- Practice routes → Code executor: runs code (evidence: `server/routes/practice.js`)
- Practice routes → XP and streaks: updates progress (evidence: `server/routes/practice.js`)
- Practice routes → Achievements: checks awards (evidence: `server/routes/practice.js`)
- Question bank → MySQL store: reads questions (evidence: `server/services/questionBank.js`)
- XP and streaks → MySQL store: updates stats (evidence: `server/services/gamification.js`)
- Achievements → MySQL store: stores awards (evidence: `server/services/achievements.js`)
- Achievements → XP and streaks: uses service (evidence: `server/services/achievements.js`)
- Agent orchestrator → MySQL store: loads context (evidence: `server/agents/orchestrator.js`)
- Agent orchestrator → AI provider: agent provider
- AI provider → Job seeker: generates guidance
