How tushar-kumar-code/ai-career-coach works
AI Career Coach is a full-stack placement-readiness platform. A student uses the web dashboard to complete career discovery, upload a resume, build skills and a roadmap, practice interviews, find jobs, and receive coaching. FastAPI endpoints orchestrate domain engines that analyze evidence, generate learning content, match jobs, and compute readiness. Persisted profile, resume, skill, roadmap, interview, and application state feeds the Digital Twin, placement checklist, recommendations, achievements, and career brief. The sampled source confirms several engine-to-engine calls; some endpoint-to-service wiring is inferred from the documented API modules.
Components 31
Web Client
- Dashboard
frontend/src/app/(dashboard)/dashboard/page.tsx - Assessment UI
frontend/src/app/(dashboard)/assessment/page.tsx - Resume UI
frontend/src/app/(dashboard)/resume/page.tsx - Roadmap UI
frontend/src/app/(dashboard)/roadmap/page.tsx - Interview UI
frontend/src/app/(dashboard)/interview/page.tsx - Jobs UI
frontend/src/app/(dashboard)/jobs/page.tsx - Chat UI
frontend/src/app/(dashboard)/chat/page.tsx
API Surface
- API Router
backend/app/api/router.py - Assessment API
backend/app/api/v1/assessment.py - Resume API
backend/app/api/v1/resume.py - Skills API
backend/app/api/v1/skills.py - Roadmap API
backend/app/api/v1/roadmap.py - Interview API
backend/app/api/v1/interview.py - Jobs API
backend/app/api/v1/jobs.py - Chat API
backend/app/api/v1/chat.py
Career Intelligence
- Career Assessment
backend/app/services/assessment/adaptive_engine.py - ATS Analysis
backend/app/services/resume/ats_engine.py - Skill Intelligence
backend/app/services/skill/ingestion_engine.py - Skill Gap Analysis
backend/app/services/skill/gap_engine.py - Roadmap Planning
backend/app/services/roadmap/roadmap_engine.py - Interview Evaluation
backend/app/services/interview/adaptive_engine.py - Job Matching
backend/app/services/job/matching_engine.py - Digital Twin
backend/app/services/digital_twin/twin_service.py - Placement Checklist
backend/app/services/placement/checklist_engine.py - Career Brief
backend/app/services/placement/brief_engine.py - Next Action
backend/app/services/digital_twin/recommendation_engine.py
Career State
- Career Database
backend/app/core/database.py
AI Integrations
- AI Client
backend/app/services/ai/client.py
Other components
- Student
- Groq Provider
backend/app/services/ai/groq_provider.py - Gemini Provider
backend/app/services/ai/gemini_provider.py
Connections 40
- Student → Dashboard: uses
- Dashboard → API Router: requests
- Assessment UI → Assessment API: submits answers
- Resume UI → Resume API: uploads resume
- Roadmap UI → Roadmap API: updates tasks
- Interview UI → Interview API: starts session
- Jobs UI → Jobs API: searches jobs
- Chat UI → Chat API: sends messages
- API Router → Assessment API: dispatches
- API Router → Resume API: dispatches
- API Router → Skills API: dispatches
- API Router → Roadmap API: dispatches
- API Router → Interview API: dispatches
- API Router → Jobs API: dispatches
- API Router → Chat API: dispatches
- Assessment API → Career Assessment: runs assessment
- Resume API → ATS Analysis: scores resume
- Skills API → Skill Intelligence: ingests evidence
- Skills API → Skill Gap Analysis: analyzes gaps
- Roadmap API → Roadmap Planning: builds roadmap
- Interview API → Interview Evaluation: evaluates answers
- Jobs API → Job Matching: matches jobs
- Chat API → AI Client: requests coaching
- Career Assessment → AI Client: generates questions
- Roadmap Planning → AI Client: generates phases
- AI Client → Groq Provider: calls provider
- AI Client → Gemini Provider: calls provider
- Skill Intelligence → Career Database: writes skills
- Skill Gap Analysis → Career Database: reads profiles
- ATS Analysis → Career Database: stores scores
- Roadmap Planning → Career Database: stores roadmap
- Interview Evaluation → Career Database: reads sessions
- Job Matching → Career Database: reads career data
- Digital Twin → Career Database: computes from data
- Placement Checklist → Digital Twin: reads readiness
- Placement Checklist → Skill Gap Analysis: reads gaps
- Placement Checklist → Career Database: audits evidence
- Next Action → Career Database: reads weak areas
- Career Brief → Digital Twin: reads twin
- Career Brief → Career Database: reads records