How vamshinethula/ai-career-assistant works
AI Career Assistant is a React/FastAPI application for account-based resume analysis, public remote-job discovery, and job-description comparison. The main user flow is register/log in, upload a PDF, then inspect detected skills and role overlaps or search jobs and compare a description; users can save comparison results. Job discovery includes provider aggregation and optional evidence-aware matching. The graph preserves documented capabilities, but unsampled routes and storage details are represented only where README or source-index evidence supports them.
Main entry points: resumes.py Resume routes · api.js API client · main.py FastAPI application · job_search.py Search and snapshots
Components 28
Web interface
- Career workspace
frontend/src/App.jsx - Personal dashboard
frontend/src/components/Dashboard.jsx - Resume panels
frontend/src/components/ResumeList.jsx - Jobs for you
frontend/src/components/JobsForYou.jsx - Comparison review
frontend/src/components/JobComparison.jsx - Saved comparisons
frontend/src/components/SavedComparisons.jsx - API client
frontend/src/services/api.js
Accounts and API
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/routers/auth.py - User routes
backend/app/routers/users.py - Token authentication
backend/app/oauth2.py - SQLite data store
backend/app/database.py - User and resume records
backend/app/models.py
Resume analysis
- Resume routes
backend/app/routers/resumes.py - PDF text extraction
backend/app/services/resume_parser.py - Skill extraction
backend/app/services/skill_extractor.py - Example role overlaps
backend/app/services/role_matcher.py
Job discovery
- Job search routes
backend/app/routers/jobs.py - Search and snapshots
backend/app/services/job_search.py - Job providers
backend/app/services/job_provider.py - Job result contracts
backend/app/job_schemas.py - Job matching
backend/app/services/job_matcher.py - Evidence-aware matching
backend/app/services/occupational_evidence/matcher.py
Job comparison
- Reviewed score
frontend/src/services/reviewedScore.js - Description comparison
backend/app/services/job_comparison.py - Comparison download
frontend/src/services/comparisonExport.js
Other components
- Career seeker
- Public job sources
Connections 34
- Career seeker → Career workspace: uses
frontend/src/App.jsx - Career workspace → Personal dashboard: renders
frontend/src/App.jsx - Career workspace → API client: session requests
- Personal dashboard → Resume panels: presents resumes
- Personal dashboard → Jobs for you: presents jobs
- Resume panels → API client: loads resume data
- Jobs for you → API client: requests jobs
- Comparison review → API client: compares and saves
frontend/src/components/JobComparison.jsx - Comparison review → Saved comparisons: opens saved results
frontend/src/components/JobComparison.jsx - Comparison review → Reviewed score: calculates review
frontend/src/components/JobComparison.jsx - Saved comparisons → API client: loads saved results
frontend/src/components/SavedComparisons.jsx - Saved comparisons → Comparison download: downloads summary
frontend/src/components/SavedComparisons.jsx - API client → FastAPI application: HTTP requests
- FastAPI application → Authentication routes: routes
backend/app/main.py - FastAPI application → User routes: routes
backend/app/main.py - FastAPI application → Resume routes: routes
backend/app/main.py - FastAPI application → Job search routes: routes
backend/app/main.py - Authentication routes → Token authentication: issues tokens
backend/app/routers/auth.py - Authentication routes → SQLite data store: reads and writes
backend/app/routers/auth.py - Token authentication → User and resume records: loads user
backend/app/oauth2.py - Resume routes → Token authentication: checks ownership
backend/app/routers/resumes.py - Resume routes → User and resume records: reads and writes
backend/app/routers/resumes.py - Resume routes → PDF text extraction: extracts text
backend/app/routers/resumes.py - Resume routes → Skill extraction: detects skills
backend/app/routers/resumes.py - Resume routes → Example role overlaps: scores overlaps
backend/app/routers/resumes.py - Resume routes → Description comparison: compares description
backend/app/routers/resumes.py - Job search routes → Search and snapshots: searches listings
backend/app/routers/jobs.py - Search and snapshots → Job providers: fetches listings
backend/app/services/job_search.py - Job providers → Public job sources: queries sources
- Search and snapshots → Job matching: scores postings
backend/app/services/job_search.py - Job matching → Skill extraction: extracts skills
backend/app/services/job_matcher.py - Search and snapshots → Evidence-aware matching: optional evidence match
backend/app/services/job_search.py - Search and snapshots → User and resume records: stores snapshots
backend/app/services/job_search.py - Job search routes → Job result contracts: uses contracts
backend/app/routers/jobs.py