# vaishnavis-cd/cd-recruit architecture

> Architecture diagram of the GitHub repository vaishnavis-cd/cd-recruit, 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/vaishnavis-cd/cd-recruit
- Repository: https://github.com/vaishnavis-cd/cd-recruit

## Overview

Proctora is an enterprise technical hiring platform: recruiters configure assessment drives and invite candidates; candidates progress through consent and setup, complete timed assessment modules with webcam proctoring, and submit for scoring and recruiter review. The repository also documents ATS integration and multiple execution/storage infrastructure options. The graph combines documented capabilities with sampled calls and SOURCE INDEX references; unsampled module internals and some frontend-to-API details are represented only where the README supports them.

Main entry points: [`backend/api/src/session/session.service.ts`](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/session/session.service.ts) (Session lifecycle), [`backend/api/src/admin/admin.controller.ts`](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/admin/admin.controller.ts) (Recruiter administration), [`backend/api/src/prisma/prisma.service.ts`](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/prisma/prisma.service.ts) (Relational data), [`backend/api/src/drive`](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/drive) (Drive and invites)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_candidate["Candidate assessment"]
  node_sessionflow["Session flow<br/>[SessionRouter.tsx]"]
  node_sessionstate["Session state<br/>[sessionMachine.ts]"]
  node_candidateui["Assessment modules"]
  node_webproctor["Webcam proctoring"]
  node_candidateapi["Candidate API adapter<br/>[real.ts]"]
end

subgraph group_api["Assessment API"]
  node_sessionapi["Session lifecycle<br/>[session.service.ts]"]
  node_consent["Consent and candidate"]
  node_proctorapi["Proctoring evidence"]
  node_questions["Question management"]
end

subgraph group_recruit["Recruiter operations"]
  node_drive["Drive and invites"]
  node_admin["Recruiter administration"]
  node_partnerapi["Partner API"]
end

subgraph group_runtime["Evaluation runtime"]
  node_simulation["Context simulation"]
  node_coding["Coding assessment"]
  node_sql["SQL assessment"]
  node_mcq["MCQ assessment"]
  node_prompting["AI prompting"]
  node_scoring["Session scoring"]
end

subgraph group_platform["Persistence and integrations"]
  node_prisma[("Relational data<br/>[prisma.service.ts]")]
  node_minio[("Evidence object storage<br/>[minio.service.ts]")]
  node_judge0["Judge0 sandbox"]
  node_shared["Shared contracts<br/>[session.ts]"]
end

node_candidate(("Candidate"))
node_recruiter(("Recruiter"))
node_ats(("ATS partner"))

node_recruiter -->|"manages drives"| node_admin
node_ats -->|"integrates through"| node_partnerapi
node_candidate -->|"opens assessment"| node_sessionflow
node_sessionflow -->|"reads state"| node_sessionstate
node_sessionflow -->|"renders stages"| node_candidateui
node_candidateui -.->|"uses monitoring"| node_webproctor
node_candidateui -->|"submits responses"| node_candidateapi
node_candidateapi -->|"calls REST API"| node_sessionapi
node_admin -->|"creates invitations"| node_drive
node_admin -->|"serves dashboard"| node_admin
node_admin -->|"manages invites"| node_drive
node_drive -->|"creates candidates"| node_prisma
node_drive -.->|"issues invite entry"| node_sessionapi
node_sessionapi -->|"reads session data"| node_prisma
node_sessionapi -->|"delegates scoring"| node_scoring
node_sessionapi -->|"starts sandbox work"| node_simulation
node_sessionapi -->|"uses contracts"| node_shared
node_proctorapi -->|"stores event data"| node_prisma
node_proctorapi -->|"stores evidence"| node_minio
node_webproctor -->|"uploads evidence"| node_proctorapi
node_admin -->|"reviews results"| node_scoring
node_admin -->|"loads dashboard data"| node_prisma
node_admin -->|"retrieves evidence"| node_minio
node_simulation -.->|"executes code"| node_judge0
node_coding -->|"runs submissions"| node_judge0
node_sessionapi -.->|"runs module"| node_coding
node_sessionapi -.->|"runs module"| node_sql
node_sessionapi -.->|"runs module"| node_mcq
node_sessionapi -.->|"runs module"| node_prompting
node_consent -.->|"stores consent"| node_prisma

click node_sessionflow "https://github.com/vaishnavis-cd/cd-recruit/blob/main/frontend/candidate-web/src/routes/SessionRouter.tsx"
click node_sessionstate "https://github.com/vaishnavis-cd/cd-recruit/blob/main/frontend/candidate-web/src/store/sessionMachine.ts"
click node_candidateui "https://github.com/vaishnavis-cd/cd-recruit/tree/main/frontend/candidate-web/src/modules"
click node_webproctor "https://github.com/vaishnavis-cd/cd-recruit/tree/main/frontend/candidate-web/src/proctoring"
click node_candidateapi "https://github.com/vaishnavis-cd/cd-recruit/blob/main/frontend/candidate-web/src/services/session-api/real.ts"
click node_drive "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/drive"
click node_admin "https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/admin/admin.controller.ts"
click node_partnerapi "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/partner"
click node_sessionapi "https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/session/session.service.ts"
click node_consent "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/candidate"
click node_proctorapi "https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/proctoring/proctoring.service.ts"
click node_questions "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/question"
click node_simulation "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/simulation"
click node_coding "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/coding"
click node_sql "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/sql"
click node_mcq "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/mcq"
click node_prompting "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/ai-prompting"
click node_scoring "https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/session/session-scoring.service.ts"
click node_prisma "https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/prisma/prisma.service.ts"
click node_minio "https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/integrations/minio/minio.service.ts"
click node_judge0 "https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/integrations/judge0"
click node_shared "https://github.com/vaishnavis-cd/cd-recruit/blob/main/packages/shared-types/src/session.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_sessionflow,node_sessionstate,node_candidateui,node_webproctor,node_candidateapi toneBlue
class node_sessionapi,node_consent,node_proctorapi,node_questions toneAmber
class node_drive,node_admin,node_partnerapi toneMint
class node_simulation,node_coding,node_sql,node_mcq,node_prompting,node_scoring toneRose
class node_prisma,node_minio,node_judge0,node_shared,node_candidate,node_recruiter,node_ats toneIndigo
```

## Components

### Candidate assessment

- [Session flow](https://github.com/vaishnavis-cd/cd-recruit/blob/main/frontend/candidate-web/src/routes/SessionRouter.tsx): `frontend/candidate-web/src/routes/SessionRouter.tsx`
- [Session state](https://github.com/vaishnavis-cd/cd-recruit/blob/main/frontend/candidate-web/src/store/sessionMachine.ts): `frontend/candidate-web/src/store/sessionMachine.ts`
- [Assessment modules](https://github.com/vaishnavis-cd/cd-recruit/tree/main/frontend/candidate-web/src/modules): `frontend/candidate-web/src/modules`
- [Webcam proctoring](https://github.com/vaishnavis-cd/cd-recruit/tree/main/frontend/candidate-web/src/proctoring): `frontend/candidate-web/src/proctoring`
- [Candidate API adapter](https://github.com/vaishnavis-cd/cd-recruit/blob/main/frontend/candidate-web/src/services/session-api/real.ts): `frontend/candidate-web/src/services/session-api/real.ts`

### Assessment API

- [Session lifecycle](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/session/session.service.ts): `backend/api/src/session/session.service.ts`
- [Consent and candidate](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/candidate): `backend/api/src/candidate`
- [Proctoring evidence](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/proctoring/proctoring.service.ts): `backend/api/src/proctoring/proctoring.service.ts`
- [Question management](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/question): `backend/api/src/question`

### Recruiter operations

- [Drive and invites](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/drive): `backend/api/src/drive`
- [Recruiter administration](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/admin/admin.controller.ts): `backend/api/src/admin/admin.controller.ts`
- [Partner API](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/partner): `backend/api/src/partner`

### Evaluation runtime

- [Context simulation](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/simulation): `backend/api/src/simulation`
- [Coding assessment](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/coding): `backend/api/src/coding`
- [SQL assessment](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/sql): `backend/api/src/sql`
- [MCQ assessment](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/mcq): `backend/api/src/mcq`
- [AI prompting](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/ai-prompting): `backend/api/src/ai-prompting`
- [Session scoring](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/session/session-scoring.service.ts): `backend/api/src/session/session-scoring.service.ts`

### Persistence and integrations

- [Relational data](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/prisma/prisma.service.ts): `backend/api/src/prisma/prisma.service.ts`
- [Evidence object storage](https://github.com/vaishnavis-cd/cd-recruit/blob/main/backend/api/src/integrations/minio/minio.service.ts): `backend/api/src/integrations/minio/minio.service.ts`
- [Judge0 sandbox](https://github.com/vaishnavis-cd/cd-recruit/tree/main/backend/api/src/integrations/judge0): `backend/api/src/integrations/judge0`
- [Shared contracts](https://github.com/vaishnavis-cd/cd-recruit/blob/main/packages/shared-types/src/session.ts): `packages/shared-types/src/session.ts`

### Other components

- **Candidate**
- **Recruiter**
- **ATS partner**

## Connections

- Recruiter → Recruiter administration: manages drives (evidence: `README.md`)
- ATS partner → Partner API: integrates through (evidence: `README.md`)
- Candidate → Session flow: opens assessment (evidence: `README.md`)
- Session flow → Session state: reads state (evidence: `frontend/candidate-web/src/routes/SessionRouter.tsx`)
- Session flow → Assessment modules: renders stages (evidence: `frontend/candidate-web/src/routes/SessionRouter.tsx`)
- Assessment modules → Webcam proctoring: uses monitoring
- Assessment modules → Candidate API adapter: submits responses (evidence: `README.md`)
- Candidate API adapter → Session lifecycle: calls REST API (evidence: `README.md`)
- Recruiter administration → Drive and invites: creates invitations (evidence: `README.md`)
- Recruiter administration → Recruiter administration: serves dashboard (evidence: `backend/api/src/admin/admin.controller.ts`)
- Recruiter administration → Drive and invites: manages invites (evidence: `backend/api/src/admin/admin.controller.ts`)
- Drive and invites → Relational data: creates candidates (evidence: `backend/api/src/drive/candidate-ingestion.service.ts`)
- Drive and invites → Session lifecycle: issues invite entry (evidence: `backend/api/src/session/session.service.ts`)
- Session lifecycle → Relational data: reads session data (evidence: `backend/api/src/session/session.service.ts`)
- Session lifecycle → Session scoring: delegates scoring (evidence: `backend/api/src/session/session.service.ts`)
- Session lifecycle → Context simulation: starts sandbox work (evidence: `backend/api/src/session/session.service.ts`)
- Session lifecycle → Shared contracts: uses contracts (evidence: `backend/api/src/session/session.service.ts`)
- Proctoring evidence → Relational data: stores event data (evidence: `backend/api/src/proctoring/proctoring.service.ts`)
- Proctoring evidence → Evidence object storage: stores evidence (evidence: `backend/api/src/proctoring/proctoring.service.ts`)
- Webcam proctoring → Proctoring evidence: uploads evidence (evidence: `README.md`)
- Recruiter administration → Session scoring: reviews results
- Recruiter administration → Relational data: loads dashboard data
- Recruiter administration → Evidence object storage: retrieves evidence
- Context simulation → Judge0 sandbox: executes code
- Coding assessment → Judge0 sandbox: runs submissions (evidence: `README.md`)
- Session lifecycle → Coding assessment: runs module
- Session lifecycle → SQL assessment: runs module
- Session lifecycle → MCQ assessment: runs module
- Session lifecycle → AI prompting: runs module
- Consent and candidate → Relational data: stores consent
