How ashok8072014509/hireai works
HireAI is a full-stack recruitment platform whose main candidate journey runs from applying to a job through four assessed rounds, a hiring decision, and an offer. The frontend provides candidate and recruiter/admin portals; the Express backend exposes the workflows and persists hiring state. The README documents capabilities such as resume intelligence, proctoring, appeals, analytics, scheduling, and onboarding, but many corresponding implementations were not sampled. Those branches are included at subsystem level; their internal wiring is omitted where evidence is unavailable.
Main entry points: admin.routes.ts Admin API · application.controller.ts Application Workflow · codingAssessment.controller.ts Coding Round · server.ts HTTP Server
Components 30
Candidate Journey
- Candidate Portal
frontend/src/App.tsx - Applications
frontend/src/pages/Applications.tsx - Application API
backend/src/routes/application.routes.ts - Application Workflow
backend/src/controllers/application.controller.ts - Resume Intelligence
backend/src/services/resumeParser.service.ts
Assessment Engine
- Aptitude Round
backend/src/controllers/assessment.controller.ts - Coding Round
backend/src/controllers/codingAssessment.controller.ts - Code Execution
backend/src/services/codeExecution/codeExecution.service.ts - Technical Interview
backend/src/services/technicalInterview.service.ts - HR Interview
backend/src/services/hrInterview.service.ts - Proctoring
backend/src/controllers/proctoring.controller.ts - Hiring Decision
backend/src/services/finalHiringDecision.service.ts
Recruiter Operations
- Recruiter Portal
frontend/src/components/AdminLayout.tsx - Admin API
backend/src/routes/admin.routes.ts - Hiring Intelligence
backend/src/services/hiringIntelligence.service.ts - Appeals
backend/src/controllers/appeal.controller.ts - Question Quality
backend/src/services/questionQuality.service.ts
Enterprise Services
- Organizations
backend/src/services/organization.service.ts - Interview Scheduling
backend/src/services/interviewScheduling.service.ts - Offers
backend/src/services/offerManagement.service.ts - Candidate Dossiers
backend/src/services/candidateDossier.service.ts - Notifications
backend/src/services/notification.service.ts
Application Platform
- API Client
frontend/src/lib/api.ts - HTTP Server
backend/src/server.ts - Authentication
backend/src/middleware/auth.ts - PostgreSQL
backend/src/lib/prisma.ts - Media Manager
frontend/src/lib/mediaManager.ts - Proctoring Guard
frontend/src/hooks/useProctoringGuard.ts - Assessment Runners
frontend/src/pages/AssessmentRunner.tsx
Other components
- Candidate
Connections 32
- Candidate → Candidate Portal: uses portal
README.md - Candidate Portal → Applications: routes to
frontend/src/App.tsx - Applications → API Client: requests data
frontend/src/pages/Applications.tsx - API Client → HTTP Server: calls API
- HTTP Server → Application API: mounts routes
backend/src/server.ts - Application API → Application Workflow: routes requests
backend/src/routes/application.routes.ts - Application Workflow → PostgreSQL: reads and writes
backend/src/controllers/application.controller.ts - Application Workflow → Candidate: sends confirmations
backend/src/controllers/application.controller.ts - Application Workflow → Aptitude Round: starts four rounds
README.md - Candidate → Resume Intelligence: submits resume
README.md - Aptitude Round → Coding Round: precedes
README.md - Coding Round → Code Execution: executes code
backend/src/controllers/codingAssessment.controller.ts - Coding Round → Technical Interview: precedes
README.md - Technical Interview → HR Interview: precedes
README.md - Candidate → Proctoring: is monitored
README.md - HR Interview → Hiring Decision: informs decision
README.md - Hiring Decision → Offers: generates offer
README.md - Recruiter Portal → Admin API: manages hiring
- HTTP Server → Admin API: mounts routes
backend/src/server.ts - Admin API → Authentication: requires roles
backend/src/routes/admin.routes.ts - Admin API → Hiring Intelligence: serves intelligence
- Admin API → Question Quality: routes review
- Admin API → Appeals: supports resolution
- Admin API → Organizations: serves tenancy
- Admin API → Interview Scheduling: serves scheduling
- Admin API → Offers: serves offers
- Admin API → Notifications: serves notifications
- Admin API → Candidate Dossiers: serves dossiers
- Authentication → PostgreSQL: checks account
backend/src/middleware/auth.ts - Assessment Runners → Proctoring Guard: uses guard
frontend/src/pages/AssessmentRunner.tsx - Proctoring Guard → Media Manager: stops streams
frontend/src/hooks/useProctoringGuard.ts - Proctoring Guard → API Client: reports violations
frontend/src/hooks/useProctoringGuard.ts