How isahilmishra/recruit-ai works
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: app Next.js application · server.ts Express server · recruiter.controller.ts Recruiter handlers · prisma.ts Prisma data access
Components 25
Web application
- Next.js application
frontend/src/app - Candidate workspace
frontend/src/app/candidate - Recruiter workspace
frontend/src/app/recruiter - Resume and match views
frontend/src/components/candidate - Recruiter tools
frontend/src/components/recruiter - Web authentication
frontend/src/lib/auth-context.tsx
API and access
- Express server
backend/src/server.ts - Authentication routes
backend/src/routes/auth.routes.ts - Candidate routes
backend/src/routes/candidate.routes.ts - Recruiter routes
backend/src/routes/recruiter.routes.ts - AI routes
backend/src/routes/ai.routes.ts - Authentication handlers
backend/src/controllers/auth.controller.ts - Account service
backend/src/services/auth.service.ts
Hiring workflows
- Candidate handlers
backend/src/controllers/candidate.controller.ts - Recruiter handlers
backend/src/controllers/recruiter.controller.ts - Resend email
AI processing
- AI parsing and matching
backend/src/utils/ai.ts - Background workers
backend/src/workers/index.ts - Groq LLM
Persistence and jobs
- BullMQ queues
backend/src/utils/queue.ts - Prisma data access
backend/src/utils/prisma.ts - PostgreSQL
- Redis
Other components
- Candidate
- Recruiter
Connections 32
- 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
backend/src/server.ts - Express server → Candidate routes: mounts
backend/src/server.ts - Express server → Recruiter routes: mounts
backend/src/server.ts - Express server → AI routes: mounts
backend/src/server.ts - Authentication routes → Authentication handlers: routes to
backend/src/routes/auth.routes.ts - Candidate routes → Candidate handlers: routes to
backend/src/routes/candidate.routes.ts - Candidate routes → Authentication handlers: protects with
- Recruiter routes → Recruiter handlers: routes to
backend/src/routes/recruiter.routes.ts - Recruiter routes → Authentication handlers: protects with
- Authentication handlers → Account service: delegates to
backend/src/controllers/auth.controller.ts - Account service → Prisma data access: reads and writes
backend/src/services/auth.service.ts - Candidate handlers → Prisma data access: reads and writes
backend/src/controllers/candidate.controller.ts - Candidate handlers → AI parsing and matching: requests parsing
backend/src/controllers/candidate.controller.ts - Candidate handlers → BullMQ queues: enqueues work
backend/src/controllers/candidate.controller.ts - Recruiter handlers → Prisma data access: reads and writes
backend/src/controllers/recruiter.controller.ts - Recruiter handlers → AI parsing and matching: requests analysis
backend/src/controllers/recruiter.controller.ts - Recruiter handlers → BullMQ queues: enqueues work
backend/src/controllers/recruiter.controller.ts - Recruiter handlers → Resend email: sends email
backend/src/controllers/recruiter.controller.ts - Background workers → BullMQ queues: consumes jobs
backend/src/workers/index.ts - Background workers → Prisma data access: reads and writes
backend/src/workers/index.ts - Background workers → AI parsing and matching: requests processing
backend/src/workers/index.ts - Prisma data access → PostgreSQL: persists data
- BullMQ queues → Redis: stores jobs
- AI parsing and matching → Groq LLM: requests completions