# abhik2244/interview-strategy-planner architecture

> Architecture diagram of the GitHub repository abhik2244/interview-strategy-planner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhik2244/interview-strategy-planner
- Repository: https://github.com/abhik2244/interview-strategy-planner

## Overview

This is an interview-preparation application: users register or log in, submit a resume PDF with job and self-description details, then view generated interview reports and download a tailored resume PDF. The graph follows the visible frontend routing and state hooks into the server’s route/controller/service and persistence layers. The README is empty, and frontend API-to-server transport wiring was not shown, so that relationship is omitted; unsampled implementations are represented only where the source index supports them.

Main entry points: [`frontend/src/app.routes.jsx`](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/app.routes.jsx) (Page routes), [`frontend/src/App.jsx`](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/App.jsx) (App shell), [`frontend/src/features/resumeReport/pages/InterviewReport.jsx`](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/pages/InterviewReport.jsx) (Report details), [`server/src/routes/interviewReport.routes.js`](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/routes/interviewReport.routes.js) (Report routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_app["App shell<br/>[App.jsx]"]
  node_routes["Page routes<br/>[app.routes.jsx]"]
end

subgraph group_auth["Authentication"]
  node_authstate["Auth state<br/>[auth.context.jsx]"]
  node_authhook["Auth actions<br/>[useAuth.js]"]
  node_authpages["Login and register"]
  node_routeguards["Route guards<br/>[Protected.jsx]"]
  node_authapi["Auth API client<br/>[auth.api.js]"]
end

subgraph group_reports["Interview reports"]
  node_reportstate["Report state"]
  node_reporthook["Report actions<br/>[useResumeReport.js]"]
  node_reporthome["Report dashboard<br/>[Home.jsx]"]
  node_reportdetail["Report details"]
  node_questioncard["Question card<br/>[QuestionCard.jsx]"]
  node_roadmapday["Roadmap day<br/>[RoadMapDay.jsx]"]
  node_reportapi["Report API client"]
end

subgraph group_server["Server API"]
  node_serverapp["HTTP app<br/>[app.js]"]
  node_authroutes["Auth routes<br/>[auth.routes.js]"]
  node_reportroutes["Report routes"]
  node_authcontroller["Auth controller<br/>[auth.controller.js]"]
  node_reportcontroller["Report controller"]
  node_authmiddleware["Auth middleware<br/>[auth.middleware.js]"]
  node_filemiddleware["Upload middleware<br/>[file.middleware.js]"]
end

subgraph group_domain["Domain services and data"]
  node_aiservice["AI report generation<br/>[ai.service.js]"]
  node_pdfservice["PDF generation"]
  node_userstore[("User records<br/>[user.model.js]")]
  node_blackliststore[("Token blacklist<br/>[blacklist.model.js]")]
  node_reportstore[("Report records")]
  node_dbconfig["Database connection<br/>[database.js]"]
end

node_user(("User"))

node_user -.->|"uses"| node_app
node_app -->|"renders"| node_routes
node_app -->|"provides state"| node_authstate
node_app -->|"provides state"| node_reportstate
node_routes -->|"routes to"| node_authpages
node_routes -->|"protects pages"| node_routeguards
node_routes -->|"routes to"| node_reporthome
node_routes -->|"routes to"| node_reportdetail
node_authpages -->|"uses actions"| node_authhook
node_routeguards -->|"checks session"| node_authhook
node_authhook -->|"reads and updates"| node_authstate
node_authhook -->|"calls"| node_authapi
node_reporthome -->|"uses actions"| node_reporthook
node_reportdetail -->|"uses actions"| node_reporthook
node_reporthook -->|"reads and updates"| node_reportstate
node_reporthook -->|"calls"| node_reportapi
node_reportdetail -->|"renders"| node_questioncard
node_reportdetail -->|"renders"| node_roadmapday
node_serverapp -->|"mounts"| node_authroutes
node_serverapp -->|"mounts"| node_reportroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"applies"| node_authmiddleware
node_reportroutes -->|"applies"| node_authmiddleware
node_reportroutes -->|"uploads through"| node_filemiddleware
node_reportroutes -->|"dispatches"| node_reportcontroller
node_authcontroller -->|"reads and writes"| node_userstore
node_authcontroller -->|"blacklists token"| node_blackliststore
node_authmiddleware -->|"checks token"| node_blackliststore
node_reportcontroller -->|"generates report"| node_aiservice
node_reportcontroller -->|"generates resume"| node_pdfservice
node_reportcontroller -->|"reads and writes"| node_reportstore
node_aiservice -->|"uses"| node_pdfservice

click node_app "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/App.jsx"
click node_routes "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/app.routes.jsx"
click node_authstate "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/auth/auth.context.jsx"
click node_authhook "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/auth/hooks/useAuth.js"
click node_authpages "https://github.com/abhik2244/interview-strategy-planner/tree/main/frontend/src/features/auth/pages"
click node_routeguards "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/auth/components/Protected.jsx"
click node_authapi "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/auth/services/auth.api.js"
click node_reportstate "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/resumeReport.context.jsx"
click node_reporthook "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/hooks/useResumeReport.js"
click node_reporthome "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/pages/Home.jsx"
click node_reportdetail "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/pages/InterviewReport.jsx"
click node_questioncard "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/components/QuestionCard.jsx"
click node_roadmapday "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/components/RoadMapDay.jsx"
click node_reportapi "https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/services/resumeReport.api.js"
click node_serverapp "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/app.js"
click node_authroutes "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/routes/auth.routes.js"
click node_reportroutes "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/routes/interviewReport.routes.js"
click node_authcontroller "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/controllers/auth.controller.js"
click node_reportcontroller "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/controllers/interviewReport.controller.js"
click node_authmiddleware "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/middlewares/auth.middleware.js"
click node_filemiddleware "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/middlewares/file.middleware.js"
click node_aiservice "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/services/ai.service.js"
click node_pdfservice "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/services/pdfgeneration.service.js"
click node_userstore "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/models/user.model.js"
click node_blackliststore "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/models/blacklist.model.js"
click node_reportstore "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/models/interviewReport.model.js"
click node_dbconfig "https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/config/database.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_routes,node_user toneBlue
class node_authstate,node_authhook,node_authpages,node_routeguards,node_authapi toneAmber
class node_reportstate,node_reporthook,node_reporthome,node_reportdetail,node_questioncard,node_roadmapday,node_reportapi toneMint
class node_serverapp,node_authroutes,node_reportroutes,node_authcontroller,node_reportcontroller,node_authmiddleware,node_filemiddleware toneRose
class node_aiservice,node_pdfservice,node_userstore,node_blackliststore,node_reportstore,node_dbconfig toneIndigo
```

## Components

### Frontend experience

- [App shell](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Page routes](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/app.routes.jsx): `frontend/src/app.routes.jsx`

### Authentication

- [Auth state](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/auth/auth.context.jsx): `frontend/src/features/auth/auth.context.jsx`
- [Auth actions](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/auth/hooks/useAuth.js): `frontend/src/features/auth/hooks/useAuth.js`
- [Login and register](https://github.com/abhik2244/interview-strategy-planner/tree/main/frontend/src/features/auth/pages): `frontend/src/features/auth/pages`
- [Route guards](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/auth/components/Protected.jsx): `frontend/src/features/auth/components/Protected.jsx`
- [Auth API client](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/auth/services/auth.api.js): `frontend/src/features/auth/services/auth.api.js`

### Interview reports

- [Report state](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/resumeReport.context.jsx): `frontend/src/features/resumeReport/resumeReport.context.jsx`
- [Report actions](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/hooks/useResumeReport.js): `frontend/src/features/resumeReport/hooks/useResumeReport.js`
- [Report dashboard](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/pages/Home.jsx): `frontend/src/features/resumeReport/pages/Home.jsx`
- [Report details](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/pages/InterviewReport.jsx): `frontend/src/features/resumeReport/pages/InterviewReport.jsx`
- [Question card](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/components/QuestionCard.jsx): `frontend/src/features/resumeReport/components/QuestionCard.jsx`
- [Roadmap day](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/components/RoadMapDay.jsx): `frontend/src/features/resumeReport/components/RoadMapDay.jsx`
- [Report API client](https://github.com/abhik2244/interview-strategy-planner/blob/main/frontend/src/features/resumeReport/services/resumeReport.api.js): `frontend/src/features/resumeReport/services/resumeReport.api.js`

### Server API

- [HTTP app](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/app.js): `server/src/app.js`
- [Auth routes](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/routes/auth.routes.js): `server/src/routes/auth.routes.js`
- [Report routes](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/routes/interviewReport.routes.js): `server/src/routes/interviewReport.routes.js`
- [Auth controller](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/controllers/auth.controller.js): `server/src/controllers/auth.controller.js`
- [Report controller](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/controllers/interviewReport.controller.js): `server/src/controllers/interviewReport.controller.js`
- [Auth middleware](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/middlewares/auth.middleware.js): `server/src/middlewares/auth.middleware.js`
- [Upload middleware](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/middlewares/file.middleware.js): `server/src/middlewares/file.middleware.js`

### Domain services and data

- [AI report generation](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/services/ai.service.js): `server/src/services/ai.service.js`
- [PDF generation](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/services/pdfgeneration.service.js): `server/src/services/pdfgeneration.service.js`
- [User records](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/models/user.model.js): `server/src/models/user.model.js`
- [Token blacklist](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/models/blacklist.model.js): `server/src/models/blacklist.model.js`
- [Report records](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/models/interviewReport.model.js): `server/src/models/interviewReport.model.js`
- [Database connection](https://github.com/abhik2244/interview-strategy-planner/blob/main/server/src/config/database.js): `server/src/config/database.js`

### Other components

- **User**

## Connections

- User → App shell: uses
- App shell → Page routes: renders (evidence: `frontend/src/App.jsx`)
- App shell → Auth state: provides state (evidence: `frontend/src/App.jsx`)
- App shell → Report state: provides state (evidence: `frontend/src/App.jsx`)
- Page routes → Login and register: routes to (evidence: `frontend/src/app.routes.jsx`)
- Page routes → Route guards: protects pages (evidence: `frontend/src/app.routes.jsx`)
- Page routes → Report dashboard: routes to (evidence: `frontend/src/app.routes.jsx`)
- Page routes → Report details: routes to (evidence: `frontend/src/app.routes.jsx`)
- Login and register → Auth actions: uses actions (evidence: `frontend/src/features/auth/pages/Login.jsx`)
- Route guards → Auth actions: checks session (evidence: `frontend/src/features/auth/components/Protected.jsx`)
- Auth actions → Auth state: reads and updates (evidence: `frontend/src/features/auth/hooks/useAuth.js`)
- Auth actions → Auth API client: calls (evidence: `frontend/src/features/auth/hooks/useAuth.js`)
- Report dashboard → Report actions: uses actions (evidence: `frontend/src/features/resumeReport/pages/Home.jsx`)
- Report details → Report actions: uses actions (evidence: `frontend/src/features/resumeReport/pages/InterviewReport.jsx`)
- Report actions → Report state: reads and updates (evidence: `frontend/src/features/resumeReport/hooks/useResumeReport.js`)
- Report actions → Report API client: calls (evidence: `frontend/src/features/resumeReport/hooks/useResumeReport.js`)
- Report details → Question card: renders (evidence: `frontend/src/features/resumeReport/pages/InterviewReport.jsx`)
- Report details → Roadmap day: renders (evidence: `frontend/src/features/resumeReport/pages/InterviewReport.jsx`)
- HTTP app → Auth routes: mounts (evidence: `server/src/app.js`)
- HTTP app → Report routes: mounts (evidence: `server/src/app.js`)
- Auth routes → Auth controller: dispatches (evidence: `server/src/routes/auth.routes.js`)
- Auth routes → Auth middleware: applies (evidence: `server/src/routes/auth.routes.js`)
- Report routes → Auth middleware: applies (evidence: `server/src/routes/interviewReport.routes.js`)
- Report routes → Upload middleware: uploads through (evidence: `server/src/routes/interviewReport.routes.js`)
- Report routes → Report controller: dispatches (evidence: `server/src/routes/interviewReport.routes.js`)
- Auth controller → User records: reads and writes (evidence: `server/src/controllers/auth.controller.js`)
- Auth controller → Token blacklist: blacklists token (evidence: `server/src/controllers/auth.controller.js`)
- Auth middleware → Token blacklist: checks token (evidence: `server/src/middlewares/auth.middleware.js`)
- Report controller → AI report generation: generates report (evidence: `server/src/controllers/interviewReport.controller.js`)
- Report controller → PDF generation: generates resume (evidence: `server/src/controllers/interviewReport.controller.js`)
- Report controller → Report records: reads and writes (evidence: `server/src/controllers/interviewReport.controller.js`)
- AI report generation → PDF generation: uses (evidence: `server/src/services/ai.service.js`)
