How yxsh-codes/ai-resume-analyser works
This is a full-stack AI resume-analysis and interview-preparation platform. Users authenticate, submit resume and job information, then receive interview reports, browse saved reports, and download generated resumes. The README also documents ATS insights and resume/job matching, though the sampled implementation does not establish their detailed runtime flow. Frontend-to-backend HTTP wiring and AI-provider calls are not visible in the excerpts, so those links are marked unverified.
Main entry points: app.routes.jsx Page routing · useAuth.js Auth actions · useInterview.js Report actions · auth.routes.js Auth routes
Components 26
Web application
- Application shell
Frontend/src/App.jsx - Page routing
Frontend/src/app.routes.jsx
Authentication
- Login page
Frontend/src/features/auth/pages/Login.jsx - Registration page
Frontend/src/features/auth/pages/Register.jsx - Auth state
Frontend/src/features/auth/auth.context.jsx - Auth actions
Frontend/src/features/auth/hooks/useAuth.js - Auth API client
Frontend/src/features/auth/services/auth.api.js - Route guard
Frontend/src/features/auth/components/Protected.jsx
Interview workflow
- Report dashboard
Frontend/src/features/interview/pages/Home.jsx - Interview report view
Frontend/src/features/interview/pages/Interview.jsx - Interview state
Frontend/src/features/interview/interview.context.jsx - Report actions
Frontend/src/features/interview/hooks/useInterview.js - Interview API client
Frontend/src/features/interview/services/interview.api.js
Backend API
- Express API
Backend/src/app.js - Auth routes
Backend/src/routes/auth.routes.js - Interview routes
Backend/src/routes/interview.routes.js - Auth operations
Backend/src/controllers/auth.controller.js - Token validation
Backend/src/middlewares/auth.middleware.js - Report operations
Backend/src/controllers/interview.controller.js - AI analysis and PDF
Backend/src/services/ai.service.js
Persistent data
- MongoDB connection
Backend/src/config/database.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
- User
- AI provider
Connections 33
- User → Page routing: uses
README.md - Application shell → Page routing: mounts
Frontend/src/App.jsx - Application shell → Auth state: provides
Frontend/src/App.jsx - Application shell → Interview state: provides
Frontend/src/App.jsx - Page routing → Login page: routes to
Frontend/src/app.routes.jsx - Page routing → Registration page: routes to
Frontend/src/app.routes.jsx - Page routing → Route guard: guards
Frontend/src/app.routes.jsx - Page routing → Report dashboard: routes to
Frontend/src/app.routes.jsx - Page routing → Interview report view: routes to
Frontend/src/app.routes.jsx - Login page → Auth actions: uses
Frontend/src/features/auth/pages/Login.jsx - Registration page → Auth actions: uses
Frontend/src/features/auth/pages/Register.jsx - Auth actions → Auth state: updates
Frontend/src/features/auth/hooks/useAuth.js - Auth actions → Auth API client: calls
Frontend/src/features/auth/hooks/useAuth.js - Route guard → Auth actions: checks
Frontend/src/features/auth/components/Protected.jsx - Report dashboard → Report actions: uses
Frontend/src/features/interview/pages/Home.jsx - Interview report view → Report actions: uses
Frontend/src/features/interview/pages/Interview.jsx - Report actions → Interview state: 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: HTTP calls
- Interview API client → Interview routes: HTTP calls
- Express API → Auth routes: mounts
Backend/src/app.js - Express API → Interview routes: mounts
Backend/src/app.js - Auth routes → Auth operations: dispatches
Backend/src/routes/auth.routes.js - Auth routes → Token validation: protects
Backend/src/routes/auth.routes.js - Interview routes → Token validation: protects
Backend/src/routes/interview.routes.js - Interview routes → Report operations: dispatches
Backend/src/routes/interview.routes.js - Auth operations → User records: reads/writes
Backend/src/controllers/auth.controller.js - Auth operations → Token blacklist: records logout
Backend/src/controllers/auth.controller.js - Token validation → Token blacklist: checks
Backend/src/middlewares/auth.middleware.js - Report operations → AI analysis and PDF: requests analysis
Backend/src/controllers/interview.controller.js - Report operations → Interview reports: reads/writes
Backend/src/controllers/interview.controller.js - AI analysis and PDF → AI provider: uses provider
README.md - Express API → MongoDB connection: connects
Backend/server.js