How shreyaa310805/ai-career-assistant works
AI Career Assistant turns a resume and job description into a free ATS assessment, then supports Premium users with application tracking and per-role career intelligence. The central path is upload/paste, parse, score, and report; the Premium branch adds saved resume versions and career views. Authentication and simulated upgrade gate those surfaces. The README documents several workspace capabilities whose individual implementations were not sampled, so those are represented at their existing frontend page paths without asserting unverified backend call chains. Interview preparation is explicitly a placeholder.
Main entry points: layout.tsx Web application · pipeline.py Ingest and analyze · deps.py Access checks · page.tsx Role workspace
Components 28
Frontend experience
- Web application
frontend/app/layout.tsx - Sign-in forms
frontend/components/auth-form.tsx - Resume scan
frontend/components/scan-panel.tsx - Analysis report
frontend/components/analysis-report.tsx - Upgrade page
frontend/app/upgrade/page.tsx - Application tracker
frontend/app/applications/page.tsx - Role workspace
frontend/app/applications/[id]/page.tsx - Career insights
frontend/app/career/page.tsx - Resume versions
frontend/app/applications/[id]/versions/page.tsx
Identity and access
- Authentication routes
backend/app/api/routes/auth.py - Access checks
backend/app/api/deps.py - Mock billing
backend/app/api/routes/billing.py - User records
backend/app/models/user.py
Resume intelligence
- Free scan route
backend/app/api/routes/quick_scan.py - Resume routes
backend/app/api/routes/resumes.py - Ingest and analyze
backend/app/services/resumes/pipeline.py - Document extraction
backend/app/services/resumes/extraction.py - Structured parsing
backend/app/services/resumes/gemini_service.py - ATS scoring
backend/app/services/resumes/ats_engine.py - Private file storage
backend/app/services/resumes/storage.py - Resume records
backend/app/models/resume.py
Application workspace
- Application tracker API
backend/app/api/routes/applications.py - Application records
backend/app/models/application.py - Career intelligence API
backend/app/api/routes/career.py - Role intelligence views
frontend/app/applications/[id]/skill-gap/page.tsx
Interview placeholder
- Interview placeholder
frontend/app/applications/[id]/interview/page.tsx - Interview routes
backend/app/api/routes/interviews.py
Other components
- Career seeker
Connections 35
- Career seeker → Web application: uses
README.md - Web application → Sign-in forms: presents
- Sign-in forms → Authentication routes: authenticates
- Authentication routes → Access checks: issues credentials
backend/app/api/routes/auth.py - Access checks → User records: checks identity
backend/app/api/deps.py - Web application → Resume scan: offers scan
- Resume scan → Free scan route: submits documents
- Free scan route → Access checks: authorizes
backend/app/api/routes/quick_scan.py - Free scan route → Ingest and analyze: runs pipeline
backend/app/api/routes/quick_scan.py - Resume routes → Ingest and analyze: runs pipeline
backend/app/api/routes/resumes.py - Ingest and analyze → Document extraction: extracts text
backend/app/services/resumes/pipeline.py - Ingest and analyze → Structured parsing: parses content
backend/app/services/resumes/pipeline.py - Ingest and analyze → ATS scoring: calculates scores
backend/app/services/resumes/pipeline.py - Ingest and analyze → Private file storage: stores upload
backend/app/services/resumes/pipeline.py - Ingest and analyze → Resume records: persists reports
backend/app/services/resumes/pipeline.py - Free scan route → Analysis report: returns assessment
- Web application → Upgrade page: offers upgrade
- Upgrade page → Mock billing: requests upgrade
- Mock billing → User records: updates plan
backend/app/api/routes/billing.py - Web application → Application tracker: opens tracker
- Application tracker → Application tracker API: manages roles
- Application tracker API → Access checks: requires premium
backend/app/api/routes/applications.py - Application tracker API → Application records: reads and writes
backend/app/api/routes/applications.py - Web application → Role workspace: opens role workspace
- Role workspace → Role intelligence views: shows capabilities
- Role workspace → Resume versions: opens versions
- Resume versions → Resume routes: manages versions
- Web application → Career insights: opens insights
- Career insights → Career intelligence API: requests intelligence
- Career intelligence API → Access checks: requires premium
backend/app/api/routes/career.py - Career intelligence API → Application records: reads applications
backend/app/api/routes/career.py - Career intelligence API → Resume records: reads ATS reports
backend/app/api/routes/career.py - Role workspace → Interview placeholder: offers placeholder
README.md - Interview routes → Access checks: checks user
backend/app/api/routes/interviews.py - Interview routes → Application records: checks application
backend/app/api/routes/interviews.py