# kapil1290/genai-project architecture

> Architecture diagram of the GitHub repository kapil1290/genai-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kapil1290/genai-project
- Repository: https://github.com/kapil1290/genai-project

## Overview

Resume Analyser’s implemented workflow is an authenticated resume-to-interview-preparation report: the user submits a PDF resume and descriptions, the backend extracts resume text, requests structured analysis from an AI service, saves the report, and the frontend presents reports and history. The README also describes matching scores, skill gaps, suggestions, and ATS feedback; sampled AI code shows match scoring, questions, skill gaps, and a preparation plan, but not all documented sections. Some frontend-to-backend links are documented rather than visible in sampled API source.

Main entry points: [`Backend/src/routes/interview.routes.js`](https://github.com/kapil1290/genai-project/blob/main/Backend/src/routes/interview.routes.js) (Report endpoints), [`Frontend/src/app.route.jsx`](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/app.route.jsx) (Page routing), [`Backend/src/routes/auth.route.js`](https://github.com/kapil1290/genai-project/blob/main/Backend/src/routes/auth.route.js) (Auth endpoints), [`Backend/src/controllers/auth.controller.js`](https://github.com/kapil1290/genai-project/blob/main/Backend/src/controllers/auth.controller.js) (Auth handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_app["React app<br/>[App.jsx]"]
  node_routing["Page routing<br/>[app.route.jsx]"]
  node_login["Login and register<br/>[Login.jsx]"]
  node_home["Report home<br/>[Home.jsx]"]
  node_interview_page["Report detail<br/>[Interview.jsx]"]
end

subgraph group_identity["Authentication"]
  node_auth_hook["Auth actions<br/>[useAuth.js]"]
  node_auth_api["Auth API<br/>[auth.api.js]"]
  node_auth_routes["Auth endpoints<br/>[auth.route.js]"]
  node_auth_controller["Auth handlers<br/>[auth.controller.js]"]
  node_auth_middleware["JWT guard<br/>[auth.middleware.js]"]
end

subgraph group_reports["Report workflow"]
  node_interview_hook["Report actions<br/>[useInterview.js]"]
  node_interview_api["Report API<br/>[interview.api.js]"]
  node_interview_routes["Report endpoints"]
  node_file_upload["Resume upload<br/>[file.middleware.js]"]
  node_report_controller["Report handler"]
  node_ai["AI analysis<br/>[ai.service.js]"]
  node_temp_service["Prompt support<br/>[temp.js]"]
  node_backend_app["HTTP application<br/>[app.js]"]
end

subgraph group_persistence["Persistence"]
  node_users[("User records<br/>[user.model.js]")]
  node_blacklist[("Token blacklist<br/>[blacklist.model.js]")]
  node_reports_db[("Saved reports")]
  node_database_connect["Database connection<br/>[db.js]"]
end

node_user(("Candidate"))

node_user -->|"uses"| node_app
node_app -->|"installs routes"| node_routing
node_routing -->|"routes to"| node_login
node_login -->|"uses"| node_auth_hook
node_auth_hook -->|"calls"| node_auth_api
node_auth_api -.->|"requests"| node_auth_routes
node_backend_app -->|"mounts"| node_auth_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"guards"| node_auth_middleware
node_auth_controller -->|"reads and writes"| node_users
node_auth_controller -->|"records logout"| node_blacklist
node_auth_middleware -->|"checks token"| node_blacklist
node_routing -->|"routes to"| node_home
node_routing -->|"routes to"| node_interview_page
node_home -->|"uses"| node_interview_hook
node_interview_page -->|"uses"| node_interview_hook
node_interview_hook -->|"calls"| node_interview_api
node_interview_api -.->|"requests"| node_interview_routes
node_backend_app -->|"mounts"| node_interview_routes
node_interview_routes -->|"guards"| node_auth_middleware
node_interview_routes -->|"processes upload"| node_file_upload
node_interview_routes -->|"dispatches"| node_report_controller
node_report_controller -->|"requests analysis"| node_ai
node_report_controller -->|"creates and reads"| node_reports_db
node_ai -.->|"references"| node_temp_service
node_database_connect -.->|"initializes"| node_backend_app

click node_app "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/App.jsx"
click node_routing "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/app.route.jsx"
click node_login "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/auth/pages/Login.jsx"
click node_auth_hook "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/auth/hooks/useAuth.js"
click node_auth_api "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/auth/services/auth.api.js"
click node_auth_routes "https://github.com/kapil1290/genai-project/blob/main/Backend/src/routes/auth.route.js"
click node_auth_controller "https://github.com/kapil1290/genai-project/blob/main/Backend/src/controllers/auth.controller.js"
click node_auth_middleware "https://github.com/kapil1290/genai-project/blob/main/Backend/src/middlewares/auth.middleware.js"
click node_users "https://github.com/kapil1290/genai-project/blob/main/Backend/src/models/user.model.js"
click node_blacklist "https://github.com/kapil1290/genai-project/blob/main/Backend/src/models/blacklist.model.js"
click node_home "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/interview/pages/Home.jsx"
click node_interview_page "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/interview/pages/Interview.jsx"
click node_interview_hook "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/interview/hooks/useInterview.js"
click node_interview_api "https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/interview/services/interview.api.js"
click node_interview_routes "https://github.com/kapil1290/genai-project/blob/main/Backend/src/routes/interview.routes.js"
click node_file_upload "https://github.com/kapil1290/genai-project/blob/main/Backend/src/middlewares/file.middleware.js"
click node_report_controller "https://github.com/kapil1290/genai-project/blob/main/Backend/src/controllers/interview.controller.js"
click node_ai "https://github.com/kapil1290/genai-project/blob/main/Backend/src/services/ai.service.js"
click node_temp_service "https://github.com/kapil1290/genai-project/blob/main/Backend/src/services/temp.js"
click node_reports_db "https://github.com/kapil1290/genai-project/blob/main/Backend/src/models/interviewReport.model.js"
click node_backend_app "https://github.com/kapil1290/genai-project/blob/main/Backend/src/app.js"
click node_database_connect "https://github.com/kapil1290/genai-project/blob/main/Backend/src/db/db.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_routing,node_login,node_home,node_interview_page toneBlue
class node_auth_hook,node_auth_api,node_auth_routes,node_auth_controller,node_auth_middleware toneAmber
class node_interview_hook,node_interview_api,node_interview_routes,node_file_upload,node_report_controller,node_ai,node_temp_service,node_backend_app toneMint
class node_users,node_blacklist,node_reports_db,node_database_connect toneRose
class node_user toneIndigo
```

## Components

### User interface

- [React app](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Page routing](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/app.route.jsx): `Frontend/src/app.route.jsx`
- [Login and register](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/auth/pages/Login.jsx): `Frontend/src/features/auth/pages/Login.jsx`
- [Report home](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/interview/pages/Home.jsx): `Frontend/src/features/interview/pages/Home.jsx`
- [Report detail](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/interview/pages/Interview.jsx): `Frontend/src/features/interview/pages/Interview.jsx`

### Authentication

- [Auth actions](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/auth/hooks/useAuth.js): `Frontend/src/features/auth/hooks/useAuth.js`
- [Auth API](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/auth/services/auth.api.js): `Frontend/src/features/auth/services/auth.api.js`
- [Auth endpoints](https://github.com/kapil1290/genai-project/blob/main/Backend/src/routes/auth.route.js): `Backend/src/routes/auth.route.js`
- [Auth handlers](https://github.com/kapil1290/genai-project/blob/main/Backend/src/controllers/auth.controller.js): `Backend/src/controllers/auth.controller.js`
- [JWT guard](https://github.com/kapil1290/genai-project/blob/main/Backend/src/middlewares/auth.middleware.js): `Backend/src/middlewares/auth.middleware.js`

### Report workflow

- [Report actions](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/interview/hooks/useInterview.js): `Frontend/src/features/interview/hooks/useInterview.js`
- [Report API](https://github.com/kapil1290/genai-project/blob/main/Frontend/src/features/interview/services/interview.api.js): `Frontend/src/features/interview/services/interview.api.js`
- [Report endpoints](https://github.com/kapil1290/genai-project/blob/main/Backend/src/routes/interview.routes.js): `Backend/src/routes/interview.routes.js`
- [Resume upload](https://github.com/kapil1290/genai-project/blob/main/Backend/src/middlewares/file.middleware.js): `Backend/src/middlewares/file.middleware.js`
- [Report handler](https://github.com/kapil1290/genai-project/blob/main/Backend/src/controllers/interview.controller.js): `Backend/src/controllers/interview.controller.js`
- [AI analysis](https://github.com/kapil1290/genai-project/blob/main/Backend/src/services/ai.service.js): `Backend/src/services/ai.service.js`
- [Prompt support](https://github.com/kapil1290/genai-project/blob/main/Backend/src/services/temp.js): `Backend/src/services/temp.js`
- [HTTP application](https://github.com/kapil1290/genai-project/blob/main/Backend/src/app.js): `Backend/src/app.js`

### Persistence

- [User records](https://github.com/kapil1290/genai-project/blob/main/Backend/src/models/user.model.js): `Backend/src/models/user.model.js`
- [Token blacklist](https://github.com/kapil1290/genai-project/blob/main/Backend/src/models/blacklist.model.js): `Backend/src/models/blacklist.model.js`
- [Saved reports](https://github.com/kapil1290/genai-project/blob/main/Backend/src/models/interviewReport.model.js): `Backend/src/models/interviewReport.model.js`
- [Database connection](https://github.com/kapil1290/genai-project/blob/main/Backend/src/db/db.js): `Backend/src/db/db.js`

### Other components

- **Candidate**

## Connections

- Candidate → React app: uses (evidence: `README.md`)
- React app → Page routing: installs routes (evidence: `Frontend/src/App.jsx`)
- Page routing → Login and register: routes to (evidence: `Frontend/src/app.route.jsx`)
- Login and register → Auth actions: uses (evidence: `Frontend/src/features/auth/pages/Login.jsx`)
- Auth actions → Auth API: calls (evidence: `Frontend/src/features/auth/hooks/useAuth.js`)
- Auth API → Auth endpoints: requests
- HTTP application → Auth endpoints: mounts (evidence: `Backend/src/app.js`)
- Auth endpoints → Auth handlers: dispatches (evidence: `Backend/src/routes/auth.route.js`)
- Auth endpoints → JWT guard: guards (evidence: `Backend/src/routes/auth.route.js`)
- Auth handlers → User records: reads and writes (evidence: `Backend/src/controllers/auth.controller.js`)
- Auth handlers → Token blacklist: records logout (evidence: `Backend/src/controllers/auth.controller.js`)
- JWT guard → Token blacklist: checks token (evidence: `Backend/src/middlewares/auth.middleware.js`)
- Page routing → Report home: routes to (evidence: `Frontend/src/app.route.jsx`)
- Page routing → Report detail: routes to (evidence: `Frontend/src/app.route.jsx`)
- Report home → Report actions: uses (evidence: `Frontend/src/features/interview/pages/Home.jsx`)
- Report detail → Report actions: uses (evidence: `Frontend/src/features/interview/pages/Interview.jsx`)
- Report actions → Report API: calls (evidence: `Frontend/src/features/interview/hooks/useInterview.js`)
- Report API → Report endpoints: requests
- HTTP application → Report endpoints: mounts (evidence: `Backend/src/app.js`)
- Report endpoints → JWT guard: guards (evidence: `Backend/src/routes/interview.routes.js`)
- Report endpoints → Resume upload: processes upload (evidence: `Backend/src/routes/interview.routes.js`)
- Report endpoints → Report handler: dispatches (evidence: `Backend/src/routes/interview.routes.js`)
- Report handler → AI analysis: requests analysis (evidence: `Backend/src/controllers/interview.controller.js`)
- Report handler → Saved reports: creates and reads (evidence: `Backend/src/controllers/interview.controller.js`)
- AI analysis → Prompt support: references (evidence: `Backend/src/services/ai.service.js`)
- Database connection → HTTP application: initializes
