# student-cybrarians/intellihire architecture

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

- Interactive diagram: https://gitdiagram.com/student-cybrarians/intellihire
- Repository: https://github.com/student-cybrarians/intellihire

## Overview

IntelliHire supports candidate preparation through onboarding, resume/JD analysis, adaptive assessments, and technical interview practice, with recruiter and organization workspaces also represented in the client. The app routes users to these surfaces; a Cloudflare-style API handler and async worker are present, but the excerpts do not establish their internal wiring. Resume extraction has a Python entry point and a bundled pypdf implementation. Several feature-to-backend relationships are documented at product level but not visible in sampled calls, so they are not inferred here.

Main entry points: [`src/client/App.tsx`](https://github.com/student-cybrarians/intellihire/blob/main/src/client/App.tsx) (Application routes), [`functions/api/[[route]].ts`](https://github.com/student-cybrarians/intellihire/blob/main/functions/api/%5B%5Broute%5D%5D.ts) (API handler), [`src/client/pages/Resume.tsx`](https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Resume.tsx) (Resume analysis), [`resume-extractor/src/index.py`](https://github.com/student-cybrarians/intellihire/blob/main/resume-extractor/src/index.py) (Resume extractor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client application"]
  node_app["Application routes<br/>[App.tsx]"]
  node_access["Route access<br/>[ProtectedRoute.tsx]"]
end

subgraph group_career["Preparation workflows"]
  node_onboarding["Onboarding<br/>[Onboarding.tsx]"]
  node_dashboard["Candidate dashboard<br/>[Dashboard.tsx]"]
  node_assessment["Assessment practice<br/>[AssessmentV2.tsx]"]
  node_assessment_skill["Skill assessment<br/>[Assessment.tsx]"]
  node_resume["Resume analysis<br/>[Resume.tsx]"]
  node_readiness["Evidence strategy"]
  node_candidate_workspace["Candidate workspace"]
  node_recruiter_workspace["Recruiter workspace"]
end

subgraph group_services["Platform services"]
  node_api["API handler<br/>[&#91;&#91;route&#93;&#93;.ts]"]
  node_worker["Async worker<br/>[index.ts]"]
end

subgraph group_pdf["Resume extraction"]
  node_extractor["Resume extractor<br/>[index.py]"]
  node_extractor_entry["Extractor entry point<br/>[index.py]"]
  node_pypdf["PDF parsing library"]
end

node_candidate(("Candidate"))
node_recruiter(("Recruiter"))

node_app -->|"guards routes"| node_access
node_app -->|"routes to"| node_onboarding
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_assessment
node_app -->|"routes to"| node_assessment_skill
node_app -->|"routes to"| node_resume
node_app -.->|"routes to"| node_candidate_workspace
node_app -.->|"routes to"| node_recruiter_workspace
node_candidate -.->|"uses"| node_app
node_recruiter -.->|"uses"| node_app
node_extractor_entry -.->|"delegates to"| node_extractor
node_extractor -->|"imports"| node_pypdf
node_resume -.->|"requests analysis"| node_api
node_assessment -.->|"submits attempts"| node_api
node_assessment_skill -.->|"requests assessment"| node_api
node_api -.->|"dispatches work"| node_worker
node_api -.->|"requests extraction"| node_extractor
node_resume -.->|"uses insights"| node_readiness

click node_app "https://github.com/student-cybrarians/intellihire/blob/main/src/client/App.tsx"
click node_access "https://github.com/student-cybrarians/intellihire/blob/main/src/client/components/ProtectedRoute.tsx"
click node_onboarding "https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Onboarding.tsx"
click node_dashboard "https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Dashboard.tsx"
click node_assessment "https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/AssessmentV2.tsx"
click node_assessment_skill "https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Assessment.tsx"
click node_resume "https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Resume.tsx"
click node_readiness "https://github.com/student-cybrarians/intellihire/blob/main/src/shared/evidenceStrategy.ts"
click node_candidate_workspace "https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/dashboard/CandidateWorkspace.tsx"
click node_recruiter_workspace "https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/dashboard/RecruiterWorkspace.tsx"
click node_api "https://github.com/student-cybrarians/intellihire/blob/main/functions/api/%5B%5Broute%5D%5D.ts"
click node_worker "https://github.com/student-cybrarians/intellihire/blob/main/m1-async-worker/src/index.ts"
click node_extractor "https://github.com/student-cybrarians/intellihire/blob/main/resume-extractor/src/index.py"
click node_extractor_entry "https://github.com/student-cybrarians/intellihire/blob/main/resume-extractor/index.py"
click node_pypdf "https://github.com/student-cybrarians/intellihire/tree/main/resume-extractor/src/pypdf"

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_app,node_access toneBlue
class node_onboarding,node_dashboard,node_assessment,node_assessment_skill,node_resume,node_readiness,node_candidate_workspace,node_recruiter_workspace toneAmber
class node_api,node_worker toneMint
class node_extractor,node_extractor_entry,node_pypdf toneRose
class node_candidate,node_recruiter toneIndigo
```

## Components

### Client application

- [Application routes](https://github.com/student-cybrarians/intellihire/blob/main/src/client/App.tsx): `src/client/App.tsx`
- [Route access](https://github.com/student-cybrarians/intellihire/blob/main/src/client/components/ProtectedRoute.tsx): `src/client/components/ProtectedRoute.tsx`

### Preparation workflows

- [Onboarding](https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Onboarding.tsx): `src/client/pages/Onboarding.tsx`
- [Candidate dashboard](https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Dashboard.tsx): `src/client/pages/Dashboard.tsx`
- [Assessment practice](https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/AssessmentV2.tsx): `src/client/pages/AssessmentV2.tsx`
- [Skill assessment](https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Assessment.tsx): `src/client/pages/Assessment.tsx`
- [Resume analysis](https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/Resume.tsx): `src/client/pages/Resume.tsx`
- [Evidence strategy](https://github.com/student-cybrarians/intellihire/blob/main/src/shared/evidenceStrategy.ts): `src/shared/evidenceStrategy.ts`
- [Candidate workspace](https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/dashboard/CandidateWorkspace.tsx): `src/client/pages/dashboard/CandidateWorkspace.tsx`
- [Recruiter workspace](https://github.com/student-cybrarians/intellihire/blob/main/src/client/pages/dashboard/RecruiterWorkspace.tsx): `src/client/pages/dashboard/RecruiterWorkspace.tsx`

### Platform services

- [API handler](https://github.com/student-cybrarians/intellihire/blob/main/functions/api/%5B%5Broute%5D%5D.ts): `functions/api/[[route]].ts`
- [Async worker](https://github.com/student-cybrarians/intellihire/blob/main/m1-async-worker/src/index.ts): `m1-async-worker/src/index.ts`

### Resume extraction

- [Resume extractor](https://github.com/student-cybrarians/intellihire/blob/main/resume-extractor/src/index.py): `resume-extractor/src/index.py`
- [Extractor entry point](https://github.com/student-cybrarians/intellihire/blob/main/resume-extractor/index.py): `resume-extractor/index.py`
- [PDF parsing library](https://github.com/student-cybrarians/intellihire/tree/main/resume-extractor/src/pypdf): `resume-extractor/src/pypdf`

### Other components

- **Candidate**
- **Recruiter**

## Connections

- Application routes → Route access: guards routes (evidence: `src/client/App.tsx`)
- Application routes → Onboarding: routes to (evidence: `src/client/App.tsx`)
- Application routes → Candidate dashboard: routes to (evidence: `src/client/App.tsx`)
- Application routes → Assessment practice: routes to (evidence: `src/client/App.tsx`)
- Application routes → Skill assessment: routes to (evidence: `src/client/App.tsx`)
- Application routes → Resume analysis: routes to (evidence: `src/client/App.tsx`)
- Application routes → Candidate workspace: routes to
- Application routes → Recruiter workspace: routes to
- Candidate → Application routes: uses
- Recruiter → Application routes: uses
- Extractor entry point → Resume extractor: delegates to
- Resume extractor → PDF parsing library: imports (evidence: `resume-extractor/src/index.py`)
- Resume analysis → API handler: requests analysis
- Assessment practice → API handler: submits attempts
- Skill assessment → API handler: requests assessment
- API handler → Async worker: dispatches work
- API handler → Resume extractor: requests extraction
- Resume analysis → Evidence strategy: uses insights
