How gaballagit/cpsc-491-ai-career-buddy works
CareerLM is a career-assistance product with a Next.js interface, an Express API, and a Supabase resume Edge Function. The main user flow is to create a career profile, then use profile, project, job, and resume features through the site. API route registrations and several frontend-to-client and function-to-helper calls are supported by excerpts; some backend implementation details and the site’s API proxy wiring are unsampled, so those relationships are left unasserted or marked unverified.
Main entry points: handler.ts Resume request handler · routes.ts API routing · client.ts Supabase client · careerProfile.ts Profile client
Components 34
Career site
- Profile onboarding
site/career-buddy-site/app/onboarding/page.tsx - Profile views
site/career-buddy-site/app/profile/page.tsx - Edit profile
site/career-buddy-site/app/profile/edit/page.tsx - Career dashboard
site/career-buddy-site/app/dashboard/page.tsx - Profile client
site/career-buddy-site/lib/careerProfile.ts - Job listings
site/career-buddy-site/components/job-list.tsx - Jobs client
site/career-buddy-site/lib/jobs.ts - Project portfolio
site/career-buddy-site/app/projects/page.tsx - Projects client
site/career-buddy-site/lib/projects.ts - Resume workspace
site/career-buddy-site/app/resume/page.tsx - Resume client
site/career-buddy-site/lib/resume.ts
Backend API
- API routing
api/src/routes.ts - Profile controller
api/src/controllers/careerProfile.ts - Jobs controller
api/src/controllers/jobs.ts - Projects controller
api/src/controllers/projects.ts - Resume controller
api/src/controllers/resumes.ts - Job matching
api/src/services/jobMatching.ts - Skill gap analysis
api/src/utils/skillGap.ts - Skill utilities
api/src/utils/skills.ts - Input validation
api/src/utils/validation.ts
Persistence
- Profile repository
api/src/database/careerProfileRepository.ts - Jobs repository
api/src/database/jobRepository.ts - Projects repository
api/src/database/projectRepository.ts - Resume repository
api/src/database/resumeRepository.ts - Supabase client
api/src/database/client.ts
Resume function
- Resume request handler
supabase/functions/resume/handler.ts - Function authentication
supabase/functions/_shared/auth.ts - File validation
supabase/functions/_shared/resume/validate.ts - Text extraction
supabase/functions/_shared/resume/extract.ts - Skill extraction
supabase/functions/_shared/resume/skills.ts - Resume skills store
supabase/functions/_shared/resume/repository.ts - HTTP responses
supabase/functions/_shared/http.ts
Other components
- Career seeker
- Supabase data store
Connections 30
- Career seeker → Profile onboarding: starts profile
site/career-buddy-site/app/onboarding/page.tsx - Profile onboarding → Profile client: saves profile
site/career-buddy-site/app/onboarding/page.tsx - Profile views → Profile client: loads profile
site/career-buddy-site/app/profile/page.tsx - Edit profile → Profile client: loads and saves
site/career-buddy-site/app/profile/edit/page.tsx - Career dashboard → Profile client: loads profile
site/career-buddy-site/app/dashboard/page.tsx - Career dashboard → Projects client: loads projects
site/career-buddy-site/app/dashboard/page.tsx - Job listings → Jobs client: loads jobs
site/career-buddy-site/components/job-list.tsx - Project portfolio → Projects client: uses client
site/career-buddy-site/app/projects/page.tsx - Resume workspace → Resume client: loads saved skills
site/career-buddy-site/app/resume/page.tsx - Career seeker → API routing: makes API requests
- API routing → Profile controller: routes profile
api/src/routes.ts - API routing → Jobs controller: routes jobs
api/src/routes.ts - API routing → Projects controller: routes projects
api/src/routes.ts - API routing → Resume controller: routes resumes
api/src/routes.ts - Profile controller → Profile repository: uses repository
api/src/controllers/careerProfile.ts - Profile controller → Input validation: validates input
api/src/controllers/careerProfile.ts - Jobs controller → Jobs repository: uses repository
api/src/controllers/jobs.ts - Profile repository → Supabase client: gets client
api/src/database/careerProfileRepository.ts - Jobs repository → Supabase client: reads jobs
api/src/database/jobRepository.ts - Projects repository → Supabase client: gets client
api/src/database/projectRepository.ts - Supabase client → Supabase data store: connects to
- Career seeker → Resume request handler: uploads resume
- Resume request handler → Function authentication: authenticates request
supabase/functions/resume/handler.ts - Resume request handler → File validation: validates file
supabase/functions/resume/handler.ts - Resume request handler → Text extraction: extracts text
supabase/functions/resume/handler.ts - Resume request handler → Skill extraction: extracts skills
supabase/functions/resume/handler.ts - Resume request handler → Resume skills store: loads and saves
supabase/functions/resume/handler.ts - Resume request handler → HTTP responses: formats responses
supabase/functions/resume/handler.ts - Resume skills store → Skill utilities: normalizes skills
supabase/functions/_shared/resume/repository.ts - Text extraction → HTTP responses: uses errors
supabase/functions/_shared/resume/extract.ts