How manish-joshi1/ai-recruitment-assistant works
AI-Recruitment-Assistant is a web application for collecting job and candidate materials, generating candidate-to-role scorecards, and asking questions about a scorecard. The visible workflow runs from the React home page through API calls to Django endpoints, then into AI extraction and scorecard calculation backed by recruitment records; users can review results and open a candidate chat. The source excerpts support the main scoring and transcript-analysis links, but do not expose all endpoint routing or chat orchestration, so those connections are left unasserted or marked unverified.
Main entry points: App.tsx App routing · views.py Django endpoints · api.ts API client · HomePage.tsx Workflow home
Components 15
Recruiter interface
- App routing
frontend/src/App.tsx - Workflow home
frontend/src/pages/HomePage.tsx - File upload
frontend/src/components/FileUpload.tsx - Scorecard list
frontend/src/components/ScorecardList.tsx - Scorecard view
frontend/src/pages/ScorecardPage.tsx - Candidate chat
frontend/src/pages/ChatPage.tsx - Header
frontend/src/components/Header.tsx
Application API
- API client
frontend/src/services/api.ts - Django endpoints
backend/recruitment/views.py - Request serializers
backend/recruitment/serializers.py
AI analysis
- Scorecard calculation
backend/recruitment/services/scorecard_service.py - AI extraction and chat
backend/recruitment/services/openai_service.py
Recruitment records
- Recruitment records
backend/recruitment/models.py
Other components
- Recruiter
- OpenAI service
Connections 19
- Recruiter → App routing: uses
- App routing → Header: renders
frontend/src/App.tsx - App routing → Workflow home: routes to
frontend/src/App.tsx - App routing → Scorecard view: routes to
frontend/src/App.tsx - App routing → Candidate chat: routes to
frontend/src/App.tsx - Workflow home → File upload: renders
frontend/src/pages/HomePage.tsx - Workflow home → Scorecard list: renders
frontend/src/pages/HomePage.tsx - Workflow home → API client: calls
frontend/src/pages/HomePage.tsx - Scorecard list → API client: loads
frontend/src/components/ScorecardList.tsx - Scorecard view → API client: loads
frontend/src/pages/ScorecardPage.tsx - Candidate chat → API client: calls
frontend/src/pages/ChatPage.tsx - API client → Django endpoints: HTTP requests
- Django endpoints → Request serializers: uses
backend/recruitment/views.py - Django endpoints → AI extraction and chat: extracts transcript
backend/recruitment/views.py - Django endpoints → Scorecard calculation: generates scorecards
backend/recruitment/views.py - Scorecard calculation → Recruitment records: reads and writes
backend/recruitment/services/scorecard_service.py - Scorecard calculation → AI extraction and chat: extracts data
backend/recruitment/services/scorecard_service.py - Django endpoints → Recruitment records: creates records
backend/recruitment/views.py - AI extraction and chat → OpenAI service: requests completions
backend/recruitment/services/openai_service.py