How ionnerss/careerconnect works
CareerConnect is a two-sided hiring platform: job seekers build profiles, find openings, apply, and track application status; recruiters post jobs, review applicants, and compare candidates against saved requirements. The README also describes resume uploads, AI-assisted cover letters, and skill-based recommendations. The excerpts directly show recruiter comparison routes and scoring internals; other feature branches are included from the README and repository tree, with their internal wiring left unspecified where source was not sampled.
Main entry points: candidate-comparison-service.ts Comparison Service · candidate-comparison.ts Candidate Evaluation · profile Career Profile · upload-resume Resume Upload
Components 22
Job Seeker
- Career Profile
web/src/app/profile - Resume Upload
web/src/app/upload-resume - Job Search
web/src/app/jobs - Skill Recommendations
web/src/lib/jobs/search.ts - Job Applications
web/src/app/jobs/[jobID]/apply/page.tsx - Cover Letter Assist
web/src/app/jobs/cover-letter-actions.ts - Application Tracking
web/src/app/application-status/ApplicationStatusClient.tsx - Seeker Dashboard
web/src/app/dashboard/page.tsx
Recruiter
- Job Posting
web/src/app/recruiter/jobs - Applicant Review
web/src/app/recruiter/jobs/[jobId]/applicants/page.tsx
Candidate Comparison
- Job Requirements
web/src/app/api/recruiter/jobs/[jobId]/requirements/route.ts - Comparison Endpoint
web/src/app/api/recruiter/jobs/[jobId]/compare/route.ts - Comparison Service
web/src/lib/recruiter/candidate-comparison-service.ts - Candidate Data Prep
web/src/lib/recruiter/candidate-state.ts - Candidate Evaluation
web/src/lib/recruiter/candidate-comparison.ts - Scoring & Ranking
web/src/lib/recruiter/candidate-scoring.ts
Platform Services
- Accounts & Roles
web/src/app/auth - Jev AI Service
web/src/lib/ai/jev.ts - Supabase
web/src/lib/supabase/server.ts - Supabase Storage
Other components
- Job Seeker
- Recruiter
Connections 23
- Job Seeker → Accounts & Roles: signs up
README.md - Job Seeker → Career Profile: builds profile
README.md - Job Seeker → Resume Upload: uploads resume
README.md - Job Seeker → Job Search: searches jobs
README.md - Job Search → Skill Recommendations: offers matching
- Job Seeker → Job Applications: applies
README.md - Job Applications → Cover Letter Assist: requests assistance
- Job Seeker → Application Tracking: tracks applications
README.md - Job Seeker → Seeker Dashboard: views dashboard
- Recruiter → Accounts & Roles: signs in
README.md - Recruiter → Job Posting: posts jobs
README.md - Recruiter → Applicant Review: reviews applicants
README.md - Recruiter → Job Requirements: sets criteria
README.md - Recruiter → Comparison Endpoint: compares candidates
README.md - Job Requirements → Comparison Service: loads or saves
web/src/app/api/recruiter/jobs/[jobId]/requirements/route.ts - Comparison Endpoint → Comparison Service: dispatches comparison
web/src/app/api/recruiter/jobs/[jobId]/compare/route.ts - Comparison Service → Supabase: reads and writes
web/src/lib/recruiter/candidate-comparison-service.ts - Comparison Service → Candidate Data Prep: builds candidate data
web/src/lib/recruiter/candidate-comparison-service.ts - Comparison Service → Candidate Evaluation: evaluates candidates
web/src/lib/recruiter/candidate-comparison-service.ts - Candidate Evaluation → Scoring & Ranking: builds questions and ranks
web/src/lib/recruiter/candidate-comparison.ts - Candidate Evaluation → Jev AI Service: requests evaluations
web/src/lib/recruiter/candidate-comparison.ts - Resume Upload → Supabase Storage: stores resume
- Career Profile → Supabase Storage: stores images