How hetshah24-06/ai-interview-prep works
Interview Master supports account-based interview preparation: a user signs in, submits a job description and resume or self-description, receives a structured interview report, and can review reports or download a tailored resume PDF. The graph follows the sampled frontend routing and request handling into backend controllers, AI generation, and persistence. README-documented Gemini and PDF-rendering capabilities are included; unsampled cross-service wiring is marked optional or left out where the excerpts do not establish it.
Main entry points: auth.routes.js Auth routes · interview.routes.js Interview routes · App.jsx Application shell · app.routes.jsx Page routing
Components 26
Web client
- Application shell
Frontend/src/App.jsx - Page routing
Frontend/src/app.routes.jsx - Login and register
Frontend/src/features/auth/pages - Auth actions
Frontend/src/features/auth/hooks/useAuth.js - Session state
Frontend/src/features/auth/auth.context.jsx - Auth API client
Frontend/src/features/auth/services/auth.api.js - Report submission
Frontend/src/features/interview/pages/Home.jsx - Report viewer
Frontend/src/features/interview/pages/Interview.jsx - Report actions
Frontend/src/features/interview/hooks/useInterview.js - Report state
Frontend/src/features/interview/interview.context.jsx - Interview API client
Frontend/src/features/interview/services/interview.api.js
Identity and access
- Auth routes
Backend/src/routes/auth.routes.js - Account operations
Backend/src/controllers/auth.controller.js - Session validation
Backend/src/middlewares/auth.middleware.js - Login rate limit
Backend/src/middlewares/rateLimit.middleware.js
Interview preparation
- Interview routes
Backend/src/routes/interview.routes.js - Resume upload
Backend/src/middlewares/file.middleware.js - Report operations
Backend/src/controllers/interview.controller.js - AI generation
Backend/src/services/ai.service.js
Backend runtime and state
- HTTP application
Backend/src/app.js - User records
Backend/src/models/user.model.js - Token blacklist
Backend/src/models/blacklist.model.js - Interview reports
Backend/src/models/interviewReport.model.js
Other components
- Candidate
- Gemini
- PDF renderer
Connections 33
- Candidate → Application shell: uses
README.md - Application shell → Page routing: mounts
Frontend/src/App.jsx - Application shell → Session state: provides
Frontend/src/App.jsx - Application shell → Report state: provides
Frontend/src/App.jsx - Page routing → Login and register: routes to
Frontend/src/app.routes.jsx - Page routing → Report submission: routes to
Frontend/src/app.routes.jsx - Page routing → Report viewer: routes to
Frontend/src/app.routes.jsx - Login and register → Auth actions: uses
Frontend/src/features/auth/pages/Login.jsx - Auth actions → Session state: reads and updates
Frontend/src/features/auth/hooks/useAuth.js - Auth actions → Auth API client: calls
Frontend/src/features/auth/hooks/useAuth.js - Session state → Auth API client: restores session via
Frontend/src/features/auth/auth.context.jsx - Report submission → Report actions: uses
Frontend/src/features/interview/pages/Home.jsx - Report viewer → Report actions: uses
Frontend/src/features/interview/pages/Interview.jsx - Report actions → Report state: reads and updates
Frontend/src/features/interview/hooks/useInterview.js - Report actions → Interview API client: calls
Frontend/src/features/interview/hooks/useInterview.js - Auth API client → Auth routes: requests auth endpoints
- Interview API client → Interview routes: requests report endpoints
- HTTP application → Auth routes: mounts
Backend/src/app.js - HTTP application → Interview routes: mounts
Backend/src/app.js - Auth routes → Account operations: dispatches to
Backend/src/routes/auth.routes.js - Auth routes → Session validation: checks sessions
Backend/src/routes/auth.routes.js - Auth routes → Login rate limit: limits login
Backend/src/routes/auth.routes.js - Account operations → User records: reads and writes
Backend/src/controllers/auth.controller.js - Account operations → Token blacklist: blacklists token
Backend/src/controllers/auth.controller.js - Session validation → Token blacklist: checks token
Backend/src/middlewares/auth.middleware.js - Interview routes → Session validation: checks sessions
Backend/src/routes/interview.routes.js - Interview routes → Resume upload: accepts resume via
Backend/src/routes/interview.routes.js - Interview routes → Report operations: dispatches to
Backend/src/routes/interview.routes.js - Report operations → AI generation: generates report or PDF
Backend/src/controllers/interview.controller.js - Report operations → Interview reports: reads and writes
Backend/src/controllers/interview.controller.js - Report operations → Resume upload: extracts uploaded PDF text
Backend/src/controllers/interview.controller.js - AI generation → Gemini: requests structured output
README.md - AI generation → PDF renderer: renders resume PDF
README.md