# ionnerss/careerconnect architecture

> Architecture diagram of the GitHub repository ionnerss/careerconnect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ionnerss/careerconnect
- Repository: https://github.com/ionnerss/careerconnect

## Overview

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: [`web/src/lib/recruiter/candidate-comparison-service.ts`](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-comparison-service.ts) (Comparison Service), [`web/src/lib/recruiter/candidate-comparison.ts`](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-comparison.ts) (Candidate Evaluation), [`web/src/app/profile`](https://github.com/ionnerss/careerconnect/tree/main/web/src/app/profile) (Career Profile), [`web/src/app/upload-resume`](https://github.com/ionnerss/careerconnect/tree/main/web/src/app/upload-resume) (Resume Upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_jobseeker["Job Seeker"]
  node_profile["Career Profile"]
  node_resume["Resume Upload"]
  node_job_search["Job Search"]
  node_recommendations["Skill Recommendations<br/>[search.ts]"]
  node_application["Job Applications<br/>[page.tsx]"]
  node_cover_letter["Cover Letter Assist"]
  node_status["Application Tracking"]
  node_dashboard["Seeker Dashboard<br/>[page.tsx]"]
end

subgraph group_recruiter["Recruiter"]
  node_job_posting["Job Posting"]
  node_applicant_review["Applicant Review<br/>[page.tsx]"]
end

subgraph group_comparison["Candidate Comparison"]
  node_requirements["Job Requirements<br/>[route.ts]"]
  node_compare_api["Comparison Endpoint<br/>[route.ts]"]
  node_comparison_service["Comparison Service"]
  node_candidate_state["Candidate Data Prep<br/>[candidate-state.ts]"]
  node_comparison_engine["Candidate Evaluation"]
  node_scoring["Scoring &amp; Ranking"]
end

subgraph group_platform["Platform Services"]
  node_auth["Accounts &amp; Roles"]
  node_ai["Jev AI Service<br/>[jev.ts]"]
  node_supabase[("Supabase<br/>[server.ts]")]
  node_storage[("Supabase Storage")]
end

node_seeker(("Job Seeker"))
node_recruiter_actor(("Recruiter"))

node_seeker -->|"signs up"| node_auth
node_seeker -->|"builds profile"| node_profile
node_seeker -->|"uploads resume"| node_resume
node_seeker -->|"searches jobs"| node_job_search
node_job_search -.->|"offers matching"| node_recommendations
node_seeker -->|"applies"| node_application
node_application -.->|"requests assistance"| node_cover_letter
node_seeker -->|"tracks applications"| node_status
node_seeker -.->|"views dashboard"| node_dashboard
node_recruiter_actor -->|"signs in"| node_auth
node_recruiter_actor -->|"posts jobs"| node_job_posting
node_recruiter_actor -->|"reviews applicants"| node_applicant_review
node_recruiter_actor -->|"sets criteria"| node_requirements
node_recruiter_actor -->|"compares candidates"| node_compare_api
node_requirements -->|"loads or saves"| node_comparison_service
node_compare_api -->|"dispatches comparison"| node_comparison_service
node_comparison_service -->|"reads and writes"| node_supabase
node_comparison_service -->|"builds candidate data"| node_candidate_state
node_comparison_service -->|"evaluates candidates"| node_comparison_engine
node_comparison_engine -->|"builds questions and ranks"| node_scoring
node_comparison_engine -->|"requests evaluations"| node_ai
node_resume -.->|"stores resume"| node_storage
node_profile -.->|"stores images"| node_storage

click node_auth "https://github.com/ionnerss/careerconnect/tree/main/web/src/app/auth"
click node_profile "https://github.com/ionnerss/careerconnect/tree/main/web/src/app/profile"
click node_resume "https://github.com/ionnerss/careerconnect/tree/main/web/src/app/upload-resume"
click node_job_search "https://github.com/ionnerss/careerconnect/tree/main/web/src/app/jobs"
click node_recommendations "https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/jobs/search.ts"
click node_application "https://github.com/ionnerss/careerconnect/blob/main/web/src/app/jobs/%5BjobID%5D/apply/page.tsx"
click node_cover_letter "https://github.com/ionnerss/careerconnect/blob/main/web/src/app/jobs/cover-letter-actions.ts"
click node_status "https://github.com/ionnerss/careerconnect/blob/main/web/src/app/application-status/ApplicationStatusClient.tsx"
click node_dashboard "https://github.com/ionnerss/careerconnect/blob/main/web/src/app/dashboard/page.tsx"
click node_job_posting "https://github.com/ionnerss/careerconnect/tree/main/web/src/app/recruiter/jobs"
click node_applicant_review "https://github.com/ionnerss/careerconnect/blob/main/web/src/app/recruiter/jobs/%5BjobId%5D/applicants/page.tsx"
click node_requirements "https://github.com/ionnerss/careerconnect/blob/main/web/src/app/api/recruiter/jobs/%5BjobId%5D/requirements/route.ts"
click node_compare_api "https://github.com/ionnerss/careerconnect/blob/main/web/src/app/api/recruiter/jobs/%5BjobId%5D/compare/route.ts"
click node_comparison_service "https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-comparison-service.ts"
click node_candidate_state "https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-state.ts"
click node_comparison_engine "https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-comparison.ts"
click node_scoring "https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-scoring.ts"
click node_ai "https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/ai/jev.ts"
click node_supabase "https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/supabase/server.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_profile,node_resume,node_job_search,node_recommendations,node_application,node_cover_letter,node_status,node_dashboard toneBlue
class node_job_posting,node_applicant_review toneAmber
class node_requirements,node_compare_api,node_comparison_service,node_candidate_state,node_comparison_engine,node_scoring toneMint
class node_auth,node_ai,node_supabase,node_storage toneRose
class node_seeker,node_recruiter_actor toneIndigo
```

## Components

### Job Seeker

- [Career Profile](https://github.com/ionnerss/careerconnect/tree/main/web/src/app/profile): `web/src/app/profile`
- [Resume Upload](https://github.com/ionnerss/careerconnect/tree/main/web/src/app/upload-resume): `web/src/app/upload-resume`
- [Job Search](https://github.com/ionnerss/careerconnect/tree/main/web/src/app/jobs): `web/src/app/jobs`
- [Skill Recommendations](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/jobs/search.ts): `web/src/lib/jobs/search.ts`
- [Job Applications](https://github.com/ionnerss/careerconnect/blob/main/web/src/app/jobs/%5BjobID%5D/apply/page.tsx): `web/src/app/jobs/[jobID]/apply/page.tsx`
- [Cover Letter Assist](https://github.com/ionnerss/careerconnect/blob/main/web/src/app/jobs/cover-letter-actions.ts): `web/src/app/jobs/cover-letter-actions.ts`
- [Application Tracking](https://github.com/ionnerss/careerconnect/blob/main/web/src/app/application-status/ApplicationStatusClient.tsx): `web/src/app/application-status/ApplicationStatusClient.tsx`
- [Seeker Dashboard](https://github.com/ionnerss/careerconnect/blob/main/web/src/app/dashboard/page.tsx): `web/src/app/dashboard/page.tsx`

### Recruiter

- [Job Posting](https://github.com/ionnerss/careerconnect/tree/main/web/src/app/recruiter/jobs): `web/src/app/recruiter/jobs`
- [Applicant Review](https://github.com/ionnerss/careerconnect/blob/main/web/src/app/recruiter/jobs/%5BjobId%5D/applicants/page.tsx): `web/src/app/recruiter/jobs/[jobId]/applicants/page.tsx`

### Candidate Comparison

- [Job Requirements](https://github.com/ionnerss/careerconnect/blob/main/web/src/app/api/recruiter/jobs/%5BjobId%5D/requirements/route.ts): `web/src/app/api/recruiter/jobs/[jobId]/requirements/route.ts`
- [Comparison Endpoint](https://github.com/ionnerss/careerconnect/blob/main/web/src/app/api/recruiter/jobs/%5BjobId%5D/compare/route.ts): `web/src/app/api/recruiter/jobs/[jobId]/compare/route.ts`
- [Comparison Service](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-comparison-service.ts): `web/src/lib/recruiter/candidate-comparison-service.ts`
- [Candidate Data Prep](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-state.ts): `web/src/lib/recruiter/candidate-state.ts`
- [Candidate Evaluation](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-comparison.ts): `web/src/lib/recruiter/candidate-comparison.ts`
- [Scoring & Ranking](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/recruiter/candidate-scoring.ts): `web/src/lib/recruiter/candidate-scoring.ts`

### Platform Services

- [Accounts & Roles](https://github.com/ionnerss/careerconnect/tree/main/web/src/app/auth): `web/src/app/auth`
- [Jev AI Service](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/ai/jev.ts): `web/src/lib/ai/jev.ts`
- [Supabase](https://github.com/ionnerss/careerconnect/blob/main/web/src/lib/supabase/server.ts): `web/src/lib/supabase/server.ts`
- **Supabase Storage**

### Other components

- **Job Seeker**
- **Recruiter**

## Connections

- Job Seeker → Accounts & Roles: signs up (evidence: `README.md`)
- Job Seeker → Career Profile: builds profile (evidence: `README.md`)
- Job Seeker → Resume Upload: uploads resume (evidence: `README.md`)
- Job Seeker → Job Search: searches jobs (evidence: `README.md`)
- Job Search → Skill Recommendations: offers matching
- Job Seeker → Job Applications: applies (evidence: `README.md`)
- Job Applications → Cover Letter Assist: requests assistance
- Job Seeker → Application Tracking: tracks applications (evidence: `README.md`)
- Job Seeker → Seeker Dashboard: views dashboard
- Recruiter → Accounts & Roles: signs in (evidence: `README.md`)
- Recruiter → Job Posting: posts jobs (evidence: `README.md`)
- Recruiter → Applicant Review: reviews applicants (evidence: `README.md`)
- Recruiter → Job Requirements: sets criteria (evidence: `README.md`)
- Recruiter → Comparison Endpoint: compares candidates (evidence: `README.md`)
- Job Requirements → Comparison Service: loads or saves (evidence: `web/src/app/api/recruiter/jobs/[jobId]/requirements/route.ts`)
- Comparison Endpoint → Comparison Service: dispatches comparison (evidence: `web/src/app/api/recruiter/jobs/[jobId]/compare/route.ts`)
- Comparison Service → Supabase: reads and writes (evidence: `web/src/lib/recruiter/candidate-comparison-service.ts`)
- Comparison Service → Candidate Data Prep: builds candidate data (evidence: `web/src/lib/recruiter/candidate-comparison-service.ts`)
- Comparison Service → Candidate Evaluation: evaluates candidates (evidence: `web/src/lib/recruiter/candidate-comparison-service.ts`)
- Candidate Evaluation → Scoring & Ranking: builds questions and ranks (evidence: `web/src/lib/recruiter/candidate-comparison.ts`)
- Candidate Evaluation → Jev AI Service: requests evaluations (evidence: `web/src/lib/recruiter/candidate-comparison.ts`)
- Resume Upload → Supabase Storage: stores resume
- Career Profile → Supabase Storage: stores images
