How anujsharma8d/mockspire works
Mockspire is an AI-powered mock-interview platform. The main workflow is: a candidate configures an interview, answers generated questions (optionally by speech), receives adaptive follow-ups, and views scored feedback and progress. The graph separates the React experience, API/auth boundary, interview and analysis logic, and persistence/integrations. The excerpts show key interview and result calls; some client API wiring and unsampled controllers are represented only at subsystem level, so their links rely on README architecture and workflow descriptions.
Main entry points: App.jsx React routes · api API clients · InterviewController.js Session and question setup · models MongoDB models
Components 22
Candidate experience
- React routes
client/src/App.jsx - Interview setup
client/src/pages/Setup.jsx - Live interview
client/src/pages/Interview.jsx - Speech input
client/src/hooks/useSpeechRecognition.js - Results view
client/src/pages/Result.jsx - Dashboard and history
client/src/pages/Dashboard.jsx
API and access
- API clients
client/src/api - Express API
server/server.js - Authentication routes
server/routes/authRoutes.js - JWT verification
server/middleware/auth.js - Interview routes
server/routes/interviewRoutes.js
Interview workflow
- Session and question setup
server/controllers/InterviewController.js - Answer handling
server/controllers/AnswerController.js - Adaptive evaluation
server/services/adaptiveInterviewService.js - Question selection
server/services/questionSelectionService.js - Fallback question bank
server/services/fallbackQuestionBank.js - Gemini AI
Analysis and persistence
- Result generation
server/controllers/ResultController.js - Performance insights
server/controllers/InsightController.js - MongoDB models
server/models
Other components
- Candidate
- Browser Speech API
Connections 28
- Candidate → React routes: uses
README.md - React routes → Interview setup: routes to
client/src/App.jsx - React routes → Live interview: routes to
client/src/App.jsx - React routes → Results view: routes to
client/src/App.jsx - React routes → Dashboard and history: routes to
client/src/App.jsx - Live interview → Speech input: uses
- Speech input → Browser Speech API: recognizes speech
README.md - Interview setup → API clients: requests interview
README.md - Live interview → API clients: submits answers
README.md - Results view → API clients: requests results
README.md - Dashboard and history → API clients: requests history
client/src/pages/Dashboard.jsx - API clients → Express API: REST requests
README.md - Express API → Authentication routes: mounts
server/server.js - Express API → Interview routes: mounts
server/server.js - Authentication routes → JWT verification: verifies protected requests
server/routes/authRoutes.js - Interview routes → JWT verification: verifies requests
server/routes/interviewRoutes.js - Interview routes → Session and question setup: dispatches
server/routes/interviewRoutes.js - Session and question setup → Gemini AI: generates questions
server/controllers/InterviewController.js - Session and question setup → Fallback question bank: falls back to
server/controllers/InterviewController.js - Session and question setup → MongoDB models: stores sessions and questions
server/controllers/InterviewController.js - Answer handling → Adaptive evaluation: evaluates and follows up
server/controllers/AnswerController.js - Answer handling → Question selection: builds context and questions
server/controllers/AnswerController.js - Answer handling → MongoDB models: reads and saves answers
server/controllers/AnswerController.js - Adaptive evaluation → Gemini AI: evaluates responses
server/services/adaptiveInterviewService.js - Result generation → MongoDB models: loads and stores results
server/controllers/ResultController.js - Result generation → Gemini AI: generates feedback
server/controllers/ResultController.js - Performance insights → MongoDB models: reads insights
server/controllers/InsightController.js - Performance insights → Gemini AI: generates insights
server/controllers/InsightController.js