How akshay001-a/ai-hr-interview-system works
Interview Studio guides a student from resume and job-description review through personalized HR practice, answer capture, feedback, and saved reports. The README documents the shared dashboard/backend and the interview-to-feedback handoff; sampled routes and services establish key backend calls. Some frontend-to-backend links and unsampled subsystems are documented but not directly shown in source excerpts.
Main entry points: routes.py Interview endpoints · App.jsx Dashboard · InterviewApp.jsx Interview experience · InterviewRoom.jsx Interview room
Components 29
Shared workspace
- Dashboard
frontend/src/App.jsx - Workspace navigation
frontend/src/Workspace.jsx - Report validation
frontend/src/feedback.js
Interview preparation
- Interview experience
modules/interview_engine/frontend/InterviewApp.jsx - Document review
modules/interview_engine/frontend/src/DocumentPreparation.jsx - Question studio
modules/interview_engine/frontend/src/QuestionStudio.jsx - Interview room
modules/interview_engine/frontend/src/InterviewRoom.jsx - Session and drafts
modules/interview_engine/frontend/src/interviewSession.js - Voice input
modules/interview_engine/frontend/src/voiceInput.js - Interview API client
modules/interview_engine/frontend/src/api.js - Interview endpoints
modules/interview_engine/backend/routes.py - PDF extraction
modules/interview_engine/backend/pdf_service.py - Profile extraction and comparison
modules/interview_engine/backend/profile_service.py - Question planning
modules/interview_engine/backend/question_service.py - Model generation runtime
modules/interview_engine/backend/generation_runtime.py - Adaptive follow-ups
modules/interview_engine/backend/followup_service.py - Session completion
modules/interview_engine/backend/session_service.py
Feedback and reports
- Feedback and report views
modules/feedback_engine/frontend/FeedbackApp.jsx - Feedback endpoints
modules/feedback_engine/backend/routes.py - Report generation
modules/feedback_engine/backend/feedback_service.py - Answer evaluation
modules/feedback_engine/backend/evaluation_service.py - Communication analysis
modules/feedback_engine/backend/communication_service.py - Report storage
modules/feedback_engine/backend/database.py
Shared backend
- Shared API
frontend/src/api.js - API application
backend/main.py - Application settings
backend/config.py - Completed interview contract
backend/contracts.py
Other components
- Student
- Gemini
Connections 34
- Student → Dashboard: uses
README.md - Dashboard → Workspace navigation: renders
frontend/src/App.jsx - Dashboard → Interview experience: embeds
frontend/src/App.jsx - Dashboard → Feedback and report views: embeds
frontend/src/App.jsx - Interview experience → Document review: renders
modules/interview_engine/frontend/InterviewApp.jsx - Interview experience → Question studio: renders
modules/interview_engine/frontend/InterviewApp.jsx - Interview experience → Interview room: renders
modules/interview_engine/frontend/InterviewApp.jsx - Document review → Interview API client: requests
modules/interview_engine/frontend/src/DocumentPreparation.jsx - Interview room → Interview API client: requests
modules/interview_engine/frontend/src/InterviewRoom.jsx - Interview room → Session and drafts: uses
modules/interview_engine/frontend/src/InterviewRoom.jsx - Interview room → Voice input: uses
modules/interview_engine/frontend/src/InterviewRoom.jsx - Interview API client → Interview endpoints: calls
- Dashboard → Shared API: requests
frontend/src/App.jsx - Shared API → Feedback endpoints: calls
- API application → Interview endpoints: registers
backend/main.py - API application → Feedback endpoints: registers
backend/main.py - Interview endpoints → PDF extraction: extracts PDFs
modules/interview_engine/backend/routes.py - Interview endpoints → Profile extraction and comparison: extracts profiles
modules/interview_engine/backend/routes.py - Interview endpoints → Question planning: generates plans
modules/interview_engine/backend/routes.py - Interview endpoints → Adaptive follow-ups: generates follow-ups
modules/interview_engine/backend/routes.py - Interview endpoints → Session completion: completes sessions
modules/interview_engine/backend/routes.py - Question planning → Profile extraction and comparison: uses reviewed profile
modules/interview_engine/backend/question_service.py - Question planning → Model generation runtime: requests generation
modules/interview_engine/backend/question_service.py - Model generation runtime → Gemini: generates content
modules/interview_engine/backend/generation_runtime.py - Adaptive follow-ups → Question planning: reuses generation
modules/interview_engine/backend/followup_service.py - Session completion → Completed interview contract: hands off session
README.md - Feedback endpoints → Report generation: evaluates interview
modules/feedback_engine/backend/routes.py - Report generation → Answer evaluation: evaluates answers
modules/feedback_engine/backend/feedback_service.py - Report generation → Communication analysis: analyzes answers
modules/feedback_engine/backend/feedback_service.py - Report generation → Report storage: saves report
modules/feedback_engine/backend/feedback_service.py - Feedback endpoints → Report storage: reads history
modules/feedback_engine/backend/routes.py - Feedback and report views → Report validation: validates report
modules/feedback_engine/frontend/FeedbackApp.jsx - Feedback and report views → Shared API: requests reports
modules/feedback_engine/frontend/FeedbackApp.jsx - Application settings → Report storage: configures storage
modules/feedback_engine/backend/database.py