# abhishek-tm-123/hiremind-ai architecture

> Architecture diagram of the GitHub repository abhishek-tm-123/hiremind-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhishek-tm-123/hiremind-ai
- Repository: https://github.com/abhishek-tm-123/hiremind-ai

## Overview

HireMind AI is a web application for preparing for role-specific interviews. A candidate signs in, uploads a resume and supplies a job description; the app extracts and compares their qualifications, then tailors interview questions. During an interview, answers are evaluated and assembled into a report that can be revisited from the dashboard. The graph covers the documented source relationships and the sampled parsing and evaluation implementations; some page-to-API links are shown as unverified because their call sites were not excerpted.

Main entry points: [`src/app/interview/page.tsx`](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/interview/page.tsx) (Interview session), [`src/lib/auth-context.tsx`](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/auth-context.tsx) (Client authentication), [`src/app/api/parse-resume/route.ts`](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/parse-resume/route.ts) (Resume analysis API), [`src/lib/ai-service.ts`](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/ai-service.ts) (AI interview service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Candidate experience"]
  node_landing["Landing page<br/>[page.tsx]"]
  node_hero["Hero section<br/>[hero.tsx]"]
  node_navbar["Navigation<br/>[navbar.tsx]"]
  node_footer["Footer<br/>[footer.tsx]"]
  node_sign_in["Sign in<br/>[page.tsx]"]
  node_sign_up["Sign up<br/>[page.tsx]"]
end

subgraph group_interview["Interview workflow"]
  node_setup["Interview setup<br/>[page.tsx]"]
  node_resume_upload["Resume upload<br/>[ResumeUpload.tsx]"]
  node_analysis_view["Match analysis view"]
  node_interview_page["Interview session<br/>[page.tsx]"]
  node_results["Results report<br/>[page.tsx]"]
  node_dashboard["Session dashboard<br/>[page.tsx]"]
  node_store["Interview state<br/>[interview-store.ts]"]
end

subgraph group_services["Application services"]
  node_parse_api["Resume analysis API<br/>[route.ts]"]
  node_resume_parser["Resume parser<br/>[resume-parser.ts]"]
  node_jd_parser["Job description parser<br/>[jd-parser.ts]"]
  node_matching["Match and metadata<br/>[matching-engine.ts]"]
  node_question_api["Question generation API<br/>[route.ts]"]
  node_next_question_api["Next question API<br/>[route.ts]"]
  node_evaluate_api["Answer evaluation API<br/>[route.ts]"]
  node_report_api["Report generation API<br/>[route.ts]"]
  node_ai_service["AI interview service<br/>[ai-service.ts]"]
  node_types["Interview domain types<br/>[interview.ts]"]
end

subgraph group_identity["Identity and storage"]
  node_auth_context["Client authentication<br/>[auth-context.tsx]"]
  node_auth_api["Authentication APIs<br/>[route.ts]"]
  node_signup_api["Account registration API<br/>[route.ts]"]
  node_logout_api["Logout API<br/>[route.ts]"]
  node_me_api["Current-user API<br/>[route.ts]"]
  node_auth["Token utilities<br/>[auth.ts]"]
  node_session_api["Interview sessions API<br/>[route.ts]"]
  node_session_detail_api["Session detail API<br/>[route.ts]"]
  node_database[("Application database<br/>[db.ts]")]
end

node_candidate(("Candidate"))
node_groq{{"Groq AI service"}}

node_candidate -->|"visits"| node_landing
node_landing -->|"renders"| node_hero
node_landing -->|"renders"| node_navbar
node_landing -->|"renders"| node_footer
node_candidate -->|"signs in"| node_sign_in
node_candidate -->|"registers"| node_sign_up
node_sign_in -->|"uses"| node_auth_context
node_sign_up -->|"uses"| node_auth_context
node_auth_context -->|"posts login"| node_auth_api
node_auth_context -->|"posts signup"| node_signup_api
node_auth_context -->|"posts logout"| node_logout_api
node_auth_context -->|"checks session"| node_me_api
node_auth_api -->|"verifies token"| node_auth
node_auth_api -->|"reads account"| node_database
node_signup_api -->|"creates token"| node_auth
node_signup_api -->|"creates account"| node_database
node_me_api -->|"verifies token"| node_auth
node_me_api -->|"reads account"| node_database
node_candidate -.->|"configures interview"| node_setup
node_setup -->|"uses"| node_resume_upload
node_setup -->|"renders"| node_analysis_view
node_resume_upload -->|"updates state"| node_store
node_analysis_view -->|"reads state"| node_store
node_setup -.->|"submits resume"| node_parse_api
node_parse_api -->|"parses resume"| node_resume_parser
node_parse_api -->|"parses job description"| node_jd_parser
node_parse_api -->|"calculates match"| node_matching
node_matching -->|"uses domain types"| node_types
node_parse_api -.->|"returns analysis"| node_store
node_candidate -.->|"answers questions"| node_interview_page
node_interview_page -->|"uses state"| node_store
node_interview_page -.->|"requests question"| node_next_question_api
node_interview_page -.->|"submits answer"| node_evaluate_api
node_question_api -->|"generates questions"| node_ai_service
node_next_question_api -->|"generates question"| node_ai_service
node_evaluate_api -->|"evaluates answer"| node_ai_service
node_report_api -->|"generates report"| node_ai_service
node_ai_service -.->|"requests completions"| node_groq
node_interview_page -.->|"starts questions"| node_question_api
node_interview_page -.->|"requests report"| node_report_api
node_interview_page -.->|"saves session"| node_session_api
node_candidate -.->|"reviews results"| node_results
node_results -->|"reads state"| node_store
node_results -.->|"loads session"| node_session_api
node_candidate -.->|"views sessions"| node_dashboard
node_dashboard -->|"uses identity"| node_auth_context
node_dashboard -.->|"lists sessions"| node_session_api
node_session_api -->|"verifies token"| node_auth

click node_landing "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/page.tsx"
click node_hero "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/sections/hero.tsx"
click node_navbar "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/sections/navbar.tsx"
click node_footer "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/sections/footer.tsx"
click node_sign_in "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/sign-in/%5B%5B...sign-in%5D%5D/page.tsx"
click node_sign_up "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/sign-up/%5B%5B...sign-up%5D%5D/page.tsx"
click node_setup "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/interview/setup/page.tsx"
click node_resume_upload "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/components/upload/ResumeUpload.tsx"
click node_analysis_view "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/components/analysis/AnalysisDashboard.tsx"
click node_interview_page "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/interview/page.tsx"
click node_results "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/interview/results/page.tsx"
click node_dashboard "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/dashboard/page.tsx"
click node_store "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/store/interview-store.ts"
click node_parse_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/parse-resume/route.ts"
click node_resume_parser "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/resume-parser.ts"
click node_jd_parser "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/jd-parser.ts"
click node_matching "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/matching-engine.ts"
click node_question_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/generate-questions/route.ts"
click node_next_question_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/generate-next-question/route.ts"
click node_evaluate_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/evaluate-answer/route.ts"
click node_report_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/generate-report/route.ts"
click node_ai_service "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/ai-service.ts"
click node_auth_context "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/auth-context.tsx"
click node_auth_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/auth/login/route.ts"
click node_signup_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/auth/signup/route.ts"
click node_logout_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/auth/logout/route.ts"
click node_me_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/auth/me/route.ts"
click node_auth "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/auth.ts"
click node_session_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/interviews/route.ts"
click node_session_detail_api "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/interviews/%5Bid%5D/route.ts"
click node_database "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/db.ts"
click node_types "https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/types/interview.ts"

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_landing,node_hero,node_navbar,node_footer,node_sign_in,node_sign_up toneBlue
class node_setup,node_resume_upload,node_analysis_view,node_interview_page,node_results,node_dashboard,node_store toneAmber
class node_parse_api,node_resume_parser,node_jd_parser,node_matching,node_question_api,node_next_question_api,node_evaluate_api,node_report_api,node_ai_service,node_types toneMint
class node_auth_context,node_auth_api,node_signup_api,node_logout_api,node_me_api,node_auth,node_session_api,node_session_detail_api,node_database toneRose
class node_candidate,node_groq toneIndigo
```

## Components

### Candidate experience

- [Landing page](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Hero section](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/sections/hero.tsx): `src/sections/hero.tsx`
- [Navigation](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/sections/navbar.tsx): `src/sections/navbar.tsx`
- [Footer](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/sections/footer.tsx): `src/sections/footer.tsx`
- [Sign in](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/sign-in/%5B%5B...sign-in%5D%5D/page.tsx): `src/app/sign-in/[[...sign-in]]/page.tsx`
- [Sign up](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/sign-up/%5B%5B...sign-up%5D%5D/page.tsx): `src/app/sign-up/[[...sign-up]]/page.tsx`

### Interview workflow

- [Interview setup](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/interview/setup/page.tsx): `src/app/interview/setup/page.tsx`
- [Resume upload](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/components/upload/ResumeUpload.tsx): `src/components/upload/ResumeUpload.tsx`
- [Match analysis view](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/components/analysis/AnalysisDashboard.tsx): `src/components/analysis/AnalysisDashboard.tsx`
- [Interview session](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/interview/page.tsx): `src/app/interview/page.tsx`
- [Results report](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/interview/results/page.tsx): `src/app/interview/results/page.tsx`
- [Session dashboard](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Interview state](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/store/interview-store.ts): `src/store/interview-store.ts`

### Application services

- [Resume analysis API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/parse-resume/route.ts): `src/app/api/parse-resume/route.ts`
- [Resume parser](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/resume-parser.ts): `src/lib/resume-parser.ts`
- [Job description parser](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/jd-parser.ts): `src/lib/jd-parser.ts`
- [Match and metadata](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/matching-engine.ts): `src/lib/matching-engine.ts`
- [Question generation API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/generate-questions/route.ts): `src/app/api/generate-questions/route.ts`
- [Next question API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/generate-next-question/route.ts): `src/app/api/generate-next-question/route.ts`
- [Answer evaluation API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/evaluate-answer/route.ts): `src/app/api/evaluate-answer/route.ts`
- [Report generation API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/generate-report/route.ts): `src/app/api/generate-report/route.ts`
- [AI interview service](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/ai-service.ts): `src/lib/ai-service.ts`
- [Interview domain types](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/types/interview.ts): `src/types/interview.ts`

### Identity and storage

- [Client authentication](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/auth-context.tsx): `src/lib/auth-context.tsx`
- [Authentication APIs](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/auth/login/route.ts): `src/app/api/auth/login/route.ts`
- [Account registration API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/auth/signup/route.ts): `src/app/api/auth/signup/route.ts`
- [Logout API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/auth/logout/route.ts): `src/app/api/auth/logout/route.ts`
- [Current-user API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/auth/me/route.ts): `src/app/api/auth/me/route.ts`
- [Token utilities](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Interview sessions API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/interviews/route.ts): `src/app/api/interviews/route.ts`
- [Session detail API](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/app/api/interviews/%5Bid%5D/route.ts): `src/app/api/interviews/[id]/route.ts`
- [Application database](https://github.com/abhishek-tm-123/hiremind-ai/blob/main/src/lib/db.ts): `src/lib/db.ts`

### Other components

- **Candidate**
- **Groq AI service**

## Connections

- Candidate → Landing page: visits (evidence: `src/app/page.tsx`)
- Landing page → Hero section: renders (evidence: `src/app/page.tsx`)
- Landing page → Navigation: renders (evidence: `src/app/page.tsx`)
- Landing page → Footer: renders (evidence: `src/app/page.tsx`)
- Candidate → Sign in: signs in
- Candidate → Sign up: registers
- Sign in → Client authentication: uses (evidence: `src/app/sign-in/[[...sign-in]]/page.tsx`)
- Sign up → Client authentication: uses (evidence: `src/app/sign-up/[[...sign-up]]/page.tsx`)
- Client authentication → Authentication APIs: posts login (evidence: `src/lib/auth-context.tsx`)
- Client authentication → Account registration API: posts signup (evidence: `src/lib/auth-context.tsx`)
- Client authentication → Logout API: posts logout (evidence: `src/lib/auth-context.tsx`)
- Client authentication → Current-user API: checks session (evidence: `src/lib/auth-context.tsx`)
- Authentication APIs → Token utilities: verifies token (evidence: `src/app/api/auth/login/route.ts`)
- Authentication APIs → Application database: reads account (evidence: `src/app/api/auth/login/route.ts`)
- Account registration API → Token utilities: creates token (evidence: `src/app/api/auth/signup/route.ts`)
- Account registration API → Application database: creates account (evidence: `src/app/api/auth/signup/route.ts`)
- Current-user API → Token utilities: verifies token (evidence: `src/app/api/auth/me/route.ts`)
- Current-user API → Application database: reads account (evidence: `src/app/api/auth/me/route.ts`)
- Candidate → Interview setup: configures interview
- Interview setup → Resume upload: uses (evidence: `src/app/interview/setup/page.tsx`)
- Interview setup → Match analysis view: renders (evidence: `src/app/interview/setup/page.tsx`)
- Resume upload → Interview state: updates state (evidence: `src/components/upload/ResumeUpload.tsx`)
- Match analysis view → Interview state: reads state (evidence: `src/components/analysis/AnalysisDashboard.tsx`)
- Interview setup → Resume analysis API: submits resume
- Resume analysis API → Resume parser: parses resume (evidence: `src/app/api/parse-resume/route.ts`)
- Resume analysis API → Job description parser: parses job description (evidence: `src/app/api/parse-resume/route.ts`)
- Resume analysis API → Match and metadata: calculates match (evidence: `src/app/api/parse-resume/route.ts`)
- Match and metadata → Interview domain types: uses domain types (evidence: `src/lib/matching-engine.ts`)
- Resume analysis API → Interview state: returns analysis
- Candidate → Interview session: answers questions
- Interview session → Interview state: uses state (evidence: `src/app/interview/page.tsx`)
- Interview session → Next question API: requests question
- Interview session → Answer evaluation API: submits answer
- Question generation API → AI interview service: generates questions (evidence: `src/app/api/generate-questions/route.ts`)
- Next question API → AI interview service: generates question (evidence: `src/app/api/generate-next-question/route.ts`)
- Answer evaluation API → AI interview service: evaluates answer (evidence: `src/app/api/evaluate-answer/route.ts`)
- Report generation API → AI interview service: generates report (evidence: `src/app/api/generate-report/route.ts`)
- AI interview service → Groq AI service: requests completions
- Interview session → Question generation API: starts questions
- Interview session → Report generation API: requests report
- Interview session → Interview sessions API: saves session
- Candidate → Results report: reviews results
- Results report → Interview state: reads state (evidence: `src/app/interview/results/page.tsx`)
- Results report → Interview sessions API: loads session
- Candidate → Session dashboard: views sessions
- Session dashboard → Client authentication: uses identity (evidence: `src/app/dashboard/page.tsx`)
- Session dashboard → Interview sessions API: lists sessions
- Interview sessions API → Token utilities: verifies token (evidence: `src/app/api/interviews/route.ts`)
