# ganeshram15/vidyamitra architecture

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

- Interactive diagram: https://gitdiagram.com/ganeshram15/vidyamitra
- Repository: https://github.com/ganeshram15/vidyamitra

## Overview

VidyaMitra is an AI-powered interview practice and resume-shortlisting platform. Candidates enter through the web app, practice interviews or multi-round aptitude and coding assessments, then receive feedback and retain results; resume analysis and recruiter shortlisting are parallel workflows. The graph preserves documented voice, chatbot, proctoring, reporting, and admin capabilities. Edges cite README or shown source relationships; some backend and external-service wiring is not visible in the excerpts, so uncertain links are omitted.

Main entry points: [`src/contexts/InterviewContext.tsx`](https://github.com/ganeshram15/vidyamitra/blob/main/src/contexts/InterviewContext.tsx) (Interview orchestration), [`src/App.tsx`](https://github.com/ganeshram15/vidyamitra/blob/main/src/App.tsx) (Application routes), [`src/pages/AdminDashboard.tsx`](https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/AdminDashboard.tsx) (Admin dashboard), [`src/pages/Interview.tsx`](https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/Interview.tsx) (Interview sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Application routes<br/>[App.tsx]"]
  node_auth["Authentication<br/>[AuthContext.tsx]"]
end

subgraph group_interview["Interview practice"]
  node_interview_context["Interview orchestration"]
  node_interview_sessions["Interview sessions<br/>[Interview.tsx]"]
  node_rounds["Aptitude and coding rounds<br/>[Round1Aptitude.tsx]"]
  node_voice_bot["FRIEDE voice interviews<br/>[BotInterview.tsx]"]
  node_feedback["Feedback and reports<br/>[interviewUtils.ts]"]
  node_proctoring["Malpractice detection"]
end

subgraph group_career["Career and resumes"]
  node_resume["Resume analysis<br/>[SmartResume.tsx]"]
  node_resume_processing["Resume parsing and ATS<br/>[atsParser.ts]"]
  node_career_tools["Career planning and jobs<br/>[CareerPlanner.tsx]"]
  node_chatbot["AI chatbot assistant<br/>[MitoiChat.tsx]"]
end

subgraph group_services["Platform services"]
  node_api_client["REST API client<br/>[api.ts]"]
  node_data_service["Interview data service<br/>[firebaseService.ts]"]
  node_backend["API server<br/>[apiServer.ts]"]
  node_database[("Application database<br/>[database.ts]")]
  node_ai["Gemini and AI services<br/>[geminiService.ts]"]
  node_code_execution["Judge0 code execution<br/>[judge0Service.ts]"]
  node_object_storage["AWS S3 storage<br/>[s3Routes.ts]"]
  node_cloud["AWS cloud services<br/>[index.mjs]"]
end

subgraph group_recruiting["Recruiting"]
  node_admin["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_bulk_screening["Bulk resume screening"]
  node_email["Selection email notifications<br/>[emailService.ts]"]
end

node_candidate(("Candidate"))
node_recruiter(("Recruiter / admin"))

node_candidate -->|"uses"| node_app
node_recruiter -->|"manages"| node_admin
node_app -->|"provides session"| node_auth
node_app -->|"provides interview state"| node_interview_context
node_candidate -->|"starts practice"| node_interview_sessions
node_interview_sessions -.->|"records answers"| node_interview_context
node_candidate -->|"takes assessments"| node_rounds
node_candidate -->|"practices by voice"| node_voice_bot
node_interview_context -->|"generates feedback"| node_feedback
node_interview_context -->|"saves sessions"| node_data_service
node_interview_context -->|"requests evaluation"| node_ai
node_candidate -->|"is monitored"| node_proctoring
node_candidate -->|"uploads resume"| node_resume
node_resume -->|"scores compatibility"| node_resume_processing
node_candidate -->|"explores career options"| node_career_tools
node_candidate -->|"asks for guidance"| node_chatbot
node_data_service -->|"calls REST endpoints"| node_api_client
node_api_client -->|"sends API requests"| node_backend
node_backend -.->|"persists application data"| node_database
node_rounds -->|"runs code"| node_code_execution
node_recruiter -->|"uploads resumes"| node_bulk_screening
node_admin -->|"manages screening"| node_bulk_screening
node_admin -->|"sends decisions"| node_email
node_object_storage -.->|"uses AWS"| node_cloud

click node_app "https://github.com/ganeshram15/vidyamitra/blob/main/src/App.tsx"
click node_auth "https://github.com/ganeshram15/vidyamitra/blob/main/src/contexts/AuthContext.tsx"
click node_interview_context "https://github.com/ganeshram15/vidyamitra/blob/main/src/contexts/InterviewContext.tsx"
click node_interview_sessions "https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/Interview.tsx"
click node_rounds "https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/Round1Aptitude.tsx"
click node_voice_bot "https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/BotInterview.tsx"
click node_feedback "https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/interviewUtils.ts"
click node_proctoring "https://github.com/ganeshram15/vidyamitra/blob/main/src/hooks/useBehaviorProctor.ts"
click node_resume "https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/SmartResume.tsx"
click node_resume_processing "https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/atsParser.ts"
click node_career_tools "https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/CareerPlanner.tsx"
click node_chatbot "https://github.com/ganeshram15/vidyamitra/blob/main/src/components/MitoiChat.tsx"
click node_api_client "https://github.com/ganeshram15/vidyamitra/blob/main/src/lib/api.ts"
click node_data_service "https://github.com/ganeshram15/vidyamitra/blob/main/src/lib/firebaseService.ts"
click node_backend "https://github.com/ganeshram15/vidyamitra/blob/main/server/apiServer.ts"
click node_database "https://github.com/ganeshram15/vidyamitra/blob/main/server/database.ts"
click node_ai "https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/geminiService.ts"
click node_code_execution "https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/judge0Service.ts"
click node_admin "https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/AdminDashboard.tsx"
click node_bulk_screening "https://github.com/ganeshram15/vidyamitra/blob/main/src/components/BulkResumeUpload.tsx"
click node_email "https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/emailService.ts"
click node_object_storage "https://github.com/ganeshram15/vidyamitra/blob/main/server/s3Routes.ts"
click node_cloud "https://github.com/ganeshram15/vidyamitra/blob/main/lambda/textract-resume/index.mjs"

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_auth toneBlue
class node_interview_context,node_interview_sessions,node_rounds,node_voice_bot,node_feedback,node_proctoring toneAmber
class node_resume,node_resume_processing,node_career_tools,node_chatbot toneMint
class node_api_client,node_data_service,node_backend,node_database,node_ai,node_code_execution,node_object_storage,node_cloud toneRose
class node_admin,node_bulk_screening,node_email,node_candidate,node_recruiter toneIndigo
```

## Components

### Web application

- [Application routes](https://github.com/ganeshram15/vidyamitra/blob/main/src/App.tsx): `src/App.tsx`
- [Authentication](https://github.com/ganeshram15/vidyamitra/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`

### Interview practice

- [Interview orchestration](https://github.com/ganeshram15/vidyamitra/blob/main/src/contexts/InterviewContext.tsx): `src/contexts/InterviewContext.tsx`
- [Interview sessions](https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/Interview.tsx): `src/pages/Interview.tsx`
- [Aptitude and coding rounds](https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/Round1Aptitude.tsx): `src/pages/Round1Aptitude.tsx`
- [FRIEDE voice interviews](https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/BotInterview.tsx): `src/pages/BotInterview.tsx`
- [Feedback and reports](https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/interviewUtils.ts): `src/utils/interviewUtils.ts`
- [Malpractice detection](https://github.com/ganeshram15/vidyamitra/blob/main/src/hooks/useBehaviorProctor.ts): `src/hooks/useBehaviorProctor.ts`

### Career and resumes

- [Resume analysis](https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/SmartResume.tsx): `src/pages/SmartResume.tsx`
- [Resume parsing and ATS](https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/atsParser.ts): `src/utils/atsParser.ts`
- [Career planning and jobs](https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/CareerPlanner.tsx): `src/pages/CareerPlanner.tsx`
- [AI chatbot assistant](https://github.com/ganeshram15/vidyamitra/blob/main/src/components/MitoiChat.tsx): `src/components/MitoiChat.tsx`

### Platform services

- [REST API client](https://github.com/ganeshram15/vidyamitra/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [Interview data service](https://github.com/ganeshram15/vidyamitra/blob/main/src/lib/firebaseService.ts): `src/lib/firebaseService.ts`
- [API server](https://github.com/ganeshram15/vidyamitra/blob/main/server/apiServer.ts): `server/apiServer.ts`
- [Application database](https://github.com/ganeshram15/vidyamitra/blob/main/server/database.ts): `server/database.ts`
- [Gemini and AI services](https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/geminiService.ts): `src/utils/geminiService.ts`
- [Judge0 code execution](https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/judge0Service.ts): `src/utils/judge0Service.ts`
- [AWS S3 storage](https://github.com/ganeshram15/vidyamitra/blob/main/server/s3Routes.ts): `server/s3Routes.ts`
- [AWS cloud services](https://github.com/ganeshram15/vidyamitra/blob/main/lambda/textract-resume/index.mjs): `lambda/textract-resume/index.mjs`

### Recruiting

- [Admin dashboard](https://github.com/ganeshram15/vidyamitra/blob/main/src/pages/AdminDashboard.tsx): `src/pages/AdminDashboard.tsx`
- [Bulk resume screening](https://github.com/ganeshram15/vidyamitra/blob/main/src/components/BulkResumeUpload.tsx): `src/components/BulkResumeUpload.tsx`
- [Selection email notifications](https://github.com/ganeshram15/vidyamitra/blob/main/src/utils/emailService.ts): `src/utils/emailService.ts`

### Other components

- **Candidate**
- **Recruiter / admin**

## Connections

- Candidate → Application routes: uses
- Recruiter / admin → Admin dashboard: manages
- Application routes → Authentication: provides session (evidence: `src/App.tsx`)
- Application routes → Interview orchestration: provides interview state (evidence: `src/App.tsx`)
- Candidate → Interview sessions: starts practice
- Interview sessions → Interview orchestration: records answers
- Candidate → Aptitude and coding rounds: takes assessments
- Candidate → FRIEDE voice interviews: practices by voice
- Interview orchestration → Feedback and reports: generates feedback (evidence: `src/contexts/InterviewContext.tsx`)
- Interview orchestration → Interview data service: saves sessions (evidence: `src/contexts/InterviewContext.tsx`)
- Interview orchestration → Gemini and AI services: requests evaluation (evidence: `src/contexts/InterviewContext.tsx`)
- Candidate → Malpractice detection: is monitored
- Candidate → Resume analysis: uploads resume
- Resume analysis → Resume parsing and ATS: scores compatibility (evidence: `src/pages/SmartResume.tsx`)
- Candidate → Career planning and jobs: explores career options
- Candidate → AI chatbot assistant: asks for guidance
- Interview data service → REST API client: calls REST endpoints (evidence: `src/lib/firebaseService.ts`)
- REST API client → API server: sends API requests (evidence: `src/lib/api.ts`)
- API server → Application database: persists application data
- Aptitude and coding rounds → Judge0 code execution: runs code
- Recruiter / admin → Bulk resume screening: uploads resumes
- Admin dashboard → Bulk resume screening: manages screening (evidence: `src/pages/AdminDashboard.tsx`)
- Admin dashboard → Selection email notifications: sends decisions
- AWS S3 storage → AWS cloud services: uses AWS
