How akash00173/interview-plan-generator works
This is a web app for generating and reviewing AI-assisted interview preparation plans. A candidate registers or logs in, submits a resume or self-description with a job description, and receives a saved report containing a match score, questions, skill gaps, and a preparation plan; reports can be revisited and exported as PDFs. The map includes authentication, report generation, and persistence. The README is empty and several implementation files were not sampled, so some UI-to-hook wiring and route details are not shown; Ollama is an optional AI integration.
Main entry points: App.jsx App provider · app.routes.jsx Page router · interview.controller.js Report controller · app.js Express API
Components 25
Candidate web app
- App provider
Frontend/src/App.jsx - Page router
Frontend/src/app.routes.jsx - Login and register
Frontend/src/features/auth/pages - Report dashboard
Frontend/src/features/interview/pages/home.jsx - Report view
Frontend/src/features/interview/pages/interview.jsx - Auth state
Frontend/src/features/auth/auth.context.jsx - Auth actions
Frontend/src/features/interview/hooks/useAuth.js - Interview state
Frontend/src/features/interview/interview.context.jsx - Report actions
Frontend/src/features/interview/hooks/useInterview.js - Auth API client
Frontend/src/features/auth/services/auth.api.js - Interview API client
Frontend/src/features/auth/services/interview.api.js
API and authentication
- Express API
Backend/src/app.js - Auth routes
Backend/src/routes/auth.routes.js - Interview routes
Backend/src/routes/interview.route.js - Auth controller
Backend/src/controllers/auth.controller.js - Token middleware
Backend/src/middlewares/auth.middleware.js
Interview preparation
- Report controller
Backend/src/controllers/interview.controller.js - Report generation
Backend/src/services/ai.service.js - PDF export
Backend/src/controllers/interview.controller.js
Persistent data
- 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
- MongoDB
- Ollama service
Connections 28
- Candidate → App provider: uses
- App provider → Page router: provides routes
- Page router → Login and register: routes to
- Page router → Report dashboard: routes to
- Page router → Report view: routes to
- App provider → Auth state: provides state
- App provider → Interview state: provides state
- Auth actions → Auth state: updates
- Auth actions → Auth API client: calls
- Report actions → Interview state: updates
- Report actions → Interview API client: calls
- Auth API client → Express API: requests
- Interview API client → Express API: requests
- Express API → Auth routes: mounts
- Express API → Interview routes: mounts
- Auth routes → Auth controller: dispatches
- Auth routes → Token middleware: guards
- Token middleware → Token blacklist: checks token
- Auth controller → User records: reads and writes
- Auth controller → Token blacklist: records logout
- Interview routes → Report controller: dispatches
- Report controller → Report generation: generates report
- Report controller → Interview reports: creates and reads
- Report controller → PDF export: renders export
- Report generation → Ollama service: queries model
- User records → MongoDB: persists
- Token blacklist → MongoDB: persists
- Interview reports → MongoDB: persists