# isahilmishra/recruit-ai architecture

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

- Interactive diagram: https://gitdiagram.com/isahilmishra/recruit-ai
- Repository: https://github.com/isahilmishra/recruit-ai

## Overview

Recruit AI connects candidate and recruiter workflows through a Next.js application and an Express API. Candidates register, submit resumes, and track applications and interviews; recruiters create jobs, review and search candidates, manage application stages, and schedule interviews or communicate with candidates. Backend request handling, AI processing, persistence, and queued work are represented separately. Frontend-to-API wiring and several UI-to-feature details were not present in sampled source, so those connections are marked unverified rather than asserted as inspected.

Main entry points: [`frontend/src/app`](https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/app) (Next.js application), [`backend/src/server.ts`](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/server.ts) (Express server), [`backend/src/controllers/recruiter.controller.ts`](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/controllers/recruiter.controller.ts) (Recruiter handlers), [`backend/src/utils/prisma.ts`](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/utils/prisma.ts) (Prisma data access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_frontend["Next.js application"]
  node_candidate_ui["Candidate workspace"]
  node_recruiter_ui["Recruiter workspace"]
  node_candidate_views["Resume and match views"]
  node_recruiter_views["Recruiter tools"]
  node_auth_context["Web authentication<br/>[auth-context.tsx]"]
end

subgraph group_api["API and access"]
  node_server["Express server<br/>[server.ts]"]
  node_auth_routes["Authentication routes<br/>[auth.routes.ts]"]
  node_candidate_routes["Candidate routes"]
  node_recruiter_routes["Recruiter routes"]
  node_ai_routes["AI routes<br/>[ai.routes.ts]"]
  node_auth_controller["Authentication handlers<br/>[auth.controller.ts]"]
  node_auth_service["Account service<br/>[auth.service.ts]"]
end

subgraph group_hiring["Hiring workflows"]
  node_candidate_controller["Candidate handlers"]
  node_recruiter_controller["Recruiter handlers"]
  node_resend["Resend email"]
end

subgraph group_intelligence["AI processing"]
  node_ai["AI parsing and matching<br/>[ai.ts]"]
  node_workers["Background workers<br/>[index.ts]"]
  node_groq["Groq LLM"]
end

subgraph group_platform["Persistence and jobs"]
  node_queue["BullMQ queues<br/>[queue.ts]"]
  node_prisma["Prisma data access<br/>[prisma.ts]"]
  node_database[("PostgreSQL")]
  node_redis[("Redis")]
end

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

node_candidate -.->|"uses"| node_frontend
node_recruiter -.->|"uses"| node_frontend
node_frontend -.->|"presents"| node_candidate_ui
node_frontend -.->|"presents"| node_recruiter_ui
node_candidate_ui -.->|"uses"| node_candidate_views
node_recruiter_ui -.->|"uses"| node_recruiter_views
node_frontend -.->|"uses"| node_auth_context
node_frontend -.->|"calls API"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_candidate_routes
node_server -->|"mounts"| node_recruiter_routes
node_server -->|"mounts"| node_ai_routes
node_auth_routes -->|"routes to"| node_auth_controller
node_candidate_routes -->|"routes to"| node_candidate_controller
node_candidate_routes -.->|"protects with"| node_auth_controller
node_recruiter_routes -->|"routes to"| node_recruiter_controller
node_recruiter_routes -.->|"protects with"| node_auth_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -->|"reads and writes"| node_prisma
node_candidate_controller -->|"reads and writes"| node_prisma
node_candidate_controller -->|"requests parsing"| node_ai
node_candidate_controller -->|"enqueues work"| node_queue
node_recruiter_controller -->|"reads and writes"| node_prisma
node_recruiter_controller -->|"requests analysis"| node_ai
node_recruiter_controller -->|"enqueues work"| node_queue
node_recruiter_controller -->|"sends email"| node_resend
node_workers -->|"consumes jobs"| node_queue
node_workers -->|"reads and writes"| node_prisma
node_workers -->|"requests processing"| node_ai
node_prisma -.->|"persists data"| node_database
node_queue -.->|"stores jobs"| node_redis
node_ai -.->|"requests completions"| node_groq

click node_frontend "https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/app"
click node_candidate_ui "https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/app/candidate"
click node_recruiter_ui "https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/app/recruiter"
click node_candidate_views "https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/components/candidate"
click node_recruiter_views "https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/components/recruiter"
click node_auth_context "https://github.com/isahilmishra/recruit-ai/blob/main/frontend/src/lib/auth-context.tsx"
click node_server "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/server.ts"
click node_auth_routes "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/routes/auth.routes.ts"
click node_candidate_routes "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/routes/candidate.routes.ts"
click node_recruiter_routes "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/routes/recruiter.routes.ts"
click node_ai_routes "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/routes/ai.routes.ts"
click node_auth_controller "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/controllers/auth.controller.ts"
click node_candidate_controller "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/controllers/candidate.controller.ts"
click node_recruiter_controller "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/controllers/recruiter.controller.ts"
click node_auth_service "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/services/auth.service.ts"
click node_ai "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/utils/ai.ts"
click node_workers "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/workers/index.ts"
click node_queue "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/utils/queue.ts"
click node_prisma "https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/utils/prisma.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_frontend,node_candidate_ui,node_recruiter_ui,node_candidate_views,node_recruiter_views,node_auth_context toneBlue
class node_server,node_auth_routes,node_candidate_routes,node_recruiter_routes,node_ai_routes,node_auth_controller,node_auth_service toneAmber
class node_candidate_controller,node_recruiter_controller,node_resend toneMint
class node_ai,node_workers,node_groq toneRose
class node_queue,node_prisma,node_database,node_redis,node_candidate,node_recruiter toneIndigo
```

## Components

### Web application

- [Next.js application](https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/app): `frontend/src/app`
- [Candidate workspace](https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/app/candidate): `frontend/src/app/candidate`
- [Recruiter workspace](https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/app/recruiter): `frontend/src/app/recruiter`
- [Resume and match views](https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/components/candidate): `frontend/src/components/candidate`
- [Recruiter tools](https://github.com/isahilmishra/recruit-ai/tree/main/frontend/src/components/recruiter): `frontend/src/components/recruiter`
- [Web authentication](https://github.com/isahilmishra/recruit-ai/blob/main/frontend/src/lib/auth-context.tsx): `frontend/src/lib/auth-context.tsx`

### API and access

- [Express server](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Authentication routes](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Candidate routes](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/routes/candidate.routes.ts): `backend/src/routes/candidate.routes.ts`
- [Recruiter routes](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/routes/recruiter.routes.ts): `backend/src/routes/recruiter.routes.ts`
- [AI routes](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/routes/ai.routes.ts): `backend/src/routes/ai.routes.ts`
- [Authentication handlers](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Account service](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`

### Hiring workflows

- [Candidate handlers](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/controllers/candidate.controller.ts): `backend/src/controllers/candidate.controller.ts`
- [Recruiter handlers](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/controllers/recruiter.controller.ts): `backend/src/controllers/recruiter.controller.ts`
- **Resend email**

### AI processing

- [AI parsing and matching](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/utils/ai.ts): `backend/src/utils/ai.ts`
- [Background workers](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/workers/index.ts): `backend/src/workers/index.ts`
- **Groq LLM**

### Persistence and jobs

- [BullMQ queues](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/utils/queue.ts): `backend/src/utils/queue.ts`
- [Prisma data access](https://github.com/isahilmishra/recruit-ai/blob/main/backend/src/utils/prisma.ts): `backend/src/utils/prisma.ts`
- **PostgreSQL**
- **Redis**

### Other components

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

## Connections

- Candidate → Next.js application: uses
- Recruiter → Next.js application: uses
- Next.js application → Candidate workspace: presents
- Next.js application → Recruiter workspace: presents
- Candidate workspace → Resume and match views: uses
- Recruiter workspace → Recruiter tools: uses
- Next.js application → Web authentication: uses
- Next.js application → Express server: calls API
- Express server → Authentication routes: mounts (evidence: `backend/src/server.ts`)
- Express server → Candidate routes: mounts (evidence: `backend/src/server.ts`)
- Express server → Recruiter routes: mounts (evidence: `backend/src/server.ts`)
- Express server → AI routes: mounts (evidence: `backend/src/server.ts`)
- Authentication routes → Authentication handlers: routes to (evidence: `backend/src/routes/auth.routes.ts`)
- Candidate routes → Candidate handlers: routes to (evidence: `backend/src/routes/candidate.routes.ts`)
- Candidate routes → Authentication handlers: protects with
- Recruiter routes → Recruiter handlers: routes to (evidence: `backend/src/routes/recruiter.routes.ts`)
- Recruiter routes → Authentication handlers: protects with
- Authentication handlers → Account service: delegates to (evidence: `backend/src/controllers/auth.controller.ts`)
- Account service → Prisma data access: reads and writes (evidence: `backend/src/services/auth.service.ts`)
- Candidate handlers → Prisma data access: reads and writes (evidence: `backend/src/controllers/candidate.controller.ts`)
- Candidate handlers → AI parsing and matching: requests parsing (evidence: `backend/src/controllers/candidate.controller.ts`)
- Candidate handlers → BullMQ queues: enqueues work (evidence: `backend/src/controllers/candidate.controller.ts`)
- Recruiter handlers → Prisma data access: reads and writes (evidence: `backend/src/controllers/recruiter.controller.ts`)
- Recruiter handlers → AI parsing and matching: requests analysis (evidence: `backend/src/controllers/recruiter.controller.ts`)
- Recruiter handlers → BullMQ queues: enqueues work (evidence: `backend/src/controllers/recruiter.controller.ts`)
- Recruiter handlers → Resend email: sends email (evidence: `backend/src/controllers/recruiter.controller.ts`)
- Background workers → BullMQ queues: consumes jobs (evidence: `backend/src/workers/index.ts`)
- Background workers → Prisma data access: reads and writes (evidence: `backend/src/workers/index.ts`)
- Background workers → AI parsing and matching: requests processing (evidence: `backend/src/workers/index.ts`)
- Prisma data access → PostgreSQL: persists data
- BullMQ queues → Redis: stores jobs
- AI parsing and matching → Groq LLM: requests completions
