How samiksha267/career-prep-platform works
This is a career-preparation app: users upload resumes and job descriptions, compare them for fit, rewrite resumes, practise interviews, and review a dashboard. The frontend routes these workflows and sends authenticated requests to a FastAPI backend. Backend routes coordinate parsing and domain services, which use structured LLM generation and persist user-scoped records. The graph retains the documented feature branches, but several service implementations were not sampled; their links are included only where the source index or route excerpts support them.
Main entry points: router.py API router · client.js API client · App.jsx Page routing · resumes.py Resume API
Components 34
Web application
- Page routing
frontend/src/App.jsx - Browser auth
frontend/src/context/AuthContext.jsx - Supabase client
frontend/src/api/supabaseClient.js - API client
frontend/src/api/client.js - Resume page
frontend/src/pages/Resumes.jsx - Job descriptions page
frontend/src/pages/JobDescriptions.jsx - Match page
frontend/src/pages/Match.jsx - Interview page
frontend/src/pages/Interview.jsx - Dashboard page
frontend/src/pages/Dashboard.jsx
API and identity
- Resume rewrite API
backend/app/api/routes/resume_rewrite.py - API router
backend/app/api/router.py - Resume API
backend/app/api/routes/resumes.py - Job description API
backend/app/api/routes/job_descriptions.py - Matching API
backend/app/api/routes/match.py - Interview API
backend/app/api/routes/interview.py - Dashboard API
backend/app/api/routes/dashboard.py - JWT verification
backend/app/core/auth.py
Career workflows
- File parsing
backend/app/services/file_parsing.py - Resume analysis
backend/app/services/resume_parser.py - Job analysis
backend/app/services/jd_parser.py - Fit assessment
backend/app/services/matching.py - ATS check
backend/app/services/ats_check.py - Resume rewriting
backend/app/services/resume_rewrite.py - Dashboard aggregation
backend/app/services/dashboard.py
Interview practice
- Interview engine
backend/app/services/interview_engine.py
Persistence and AI
- User records
backend/app/services/user_service.py - Database sessions
backend/app/db/session.py - Domain records
backend/app/models - Supabase database
- Structured LLM
backend/app/llm/structured.py - Provider fallback
backend/app/llm/router.py - Gemini provider
backend/app/llm/gemini_client.py - Groq provider
backend/app/llm/groq_client.py
Other components
- Candidate
Connections 48
- Candidate → Page routing: uses
- Page routing → Resume page: routes to
frontend/src/App.jsx - Page routing → Job descriptions page: routes to
frontend/src/App.jsx - Page routing → Match page: routes to
frontend/src/App.jsx - Page routing → Interview page: routes to
frontend/src/App.jsx - Page routing → Dashboard page: routes to
frontend/src/App.jsx - Browser auth → Supabase client: authenticates with
frontend/src/context/AuthContext.jsx - API client → Supabase client: gets session
frontend/src/api/client.js - Resume page → API client: requests data
frontend/src/pages/Resumes.jsx - Job descriptions page → API client: requests data
frontend/src/pages/JobDescriptions.jsx - Match page → API client: requests match
frontend/src/pages/Match.jsx - Interview page → API client: requests interview
frontend/src/pages/Interview.jsx - Dashboard page → API client: requests summary
frontend/src/pages/Dashboard.jsx - API client → API router: sends HTTP requests
- API router → Resume API: registers
backend/app/api/router.py - API router → Job description API: registers
backend/app/api/router.py - API router → Matching API: registers
backend/app/api/router.py - API router → Resume rewrite API: registers
backend/app/api/router.py - API router → Interview API: registers
backend/app/api/router.py - API router → Dashboard API: registers
backend/app/api/router.py - Resume API → JWT verification: verifies identity
backend/app/api/routes/resumes.py - Job description API → JWT verification: verifies identity
backend/app/api/routes/job_descriptions.py - Matching API → JWT verification: verifies identity
backend/app/api/routes/match.py - Interview API → JWT verification: verifies identity
backend/app/api/routes/interview.py - Dashboard API → JWT verification: verifies identity
backend/app/api/routes/dashboard.py - Resume API → File parsing: uses
backend/app/api/routes/resumes.py - Resume API → Resume analysis: uses
backend/app/api/routes/resumes.py - Job description API → File parsing: uses
backend/app/api/routes/job_descriptions.py - Job description API → Job analysis: uses
backend/app/api/routes/job_descriptions.py - Matching API → Fit assessment: uses
backend/app/api/routes/match.py - Matching API → ATS check: uses
backend/app/api/routes/match.py - Resume rewrite API → Resume rewriting: uses
backend/app/api/routes/resume_rewrite.py - Interview API → Interview engine: uses
backend/app/api/routes/interview.py - Dashboard API → Dashboard aggregation: uses
backend/app/api/routes/dashboard.py - Resume API → Database sessions: gets session
backend/app/api/routes/resumes.py - Job description API → Database sessions: gets session
backend/app/api/routes/job_descriptions.py - Matching API → Database sessions: gets session
backend/app/api/routes/match.py - Interview API → Database sessions: gets session
backend/app/api/routes/interview.py - Dashboard API → Database sessions: gets session
backend/app/api/routes/dashboard.py - Database sessions → Supabase database: connects
- User records → Domain records: uses
backend/app/services/user_service.py - Resume API → User records: uses
backend/app/api/routes/resumes.py - Job description API → User records: uses
backend/app/api/routes/job_descriptions.py - Interview API → User records: uses
backend/app/api/routes/interview.py - Interview engine → Structured LLM: generates structured output
backend/app/services/interview_engine.py - Job analysis → Structured LLM: generates structured output
backend/app/services/jd_parser.py - Structured LLM → Provider fallback: requests text
backend/app/llm/structured.py - Provider fallback → Gemini provider: tries provider
backend/app/llm/router.py