# huzaifa-bubere/aether-ai-platform architecture

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

- Interactive diagram: https://gitdiagram.com/huzaifa-bubere/aether-ai-platform
- Repository: https://github.com/huzaifa-bubere/aether-ai-platform

## Overview

AETHER is an AI-powered interview-preparation platform with adjacent aptitude testing, coding practice, career learning, job discovery, and resume tools. A principal workflow is a candidate configuring an adaptive interview, answering questions, receiving adaptive follow-ups and evaluation, then viewing a report. The graph also preserves documented platform capabilities and the career, jobs, coding, and aptitude branches. Some connections come from README descriptions; unsampled implementation details are not inferred, and external AI, storage, and payment links are shown only where documented.

Main entry points: [`backend/src/routes/adaptiveInterview.routes.ts`](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/routes/adaptiveInterview.routes.ts) (Adaptive Interview API), [`frontend/src/app/App.tsx`](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/App.tsx) (Web Application), [`frontend/src/app/pages/InterviewRoomPage.tsx`](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/InterviewRoomPage.tsx) (Interview Rooms), [`frontend/src/app/pages/ResumeAnalyzerPage.tsx`](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/ResumeAnalyzerPage.tsx) (Resume Tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Candidate Experience"]
  node_webapp["Web Application<br/>[App.tsx]"]
  node_interviewui["Interview Rooms"]
  node_reportui["Interview Reports<br/>[FeedbackPage.tsx]"]
  node_resumeui["Resume Tools"]
  node_aptitudeui["Aptitude Tests<br/>[ExamRoom.tsx]"]
  node_codingui["Coding Workspace"]
  node_careerui["Career Learning"]
  node_jobui["Job Discovery<br/>[JobsPage.tsx]"]
end

subgraph group_interviews["Interview Assessment"]
  node_adaptiveapi["Adaptive Interview API"]
  node_adaptiveengine["Adaptive Session Service"]
  node_interviewmodel[("Interview Records")]
  node_interviewstrategy["Adaptive Decision Engine"]
  node_aiapi["AI Analysis API<br/>[main.py]"]
  node_aianalysis["AI Analysis Services<br/>[gemini_service.py]"]
end

subgraph group_learning["Learning and Practice"]
  node_aptitudeapi["Aptitude API"]
  node_codingapi["Coding Submissions"]
end

subgraph group_careerjobs["Career and Jobs"]
  node_careerroutes["Career Services<br/>[career.routes.ts]"]
  node_jobsroutes["Jobs API<br/>[jobs.routes.ts]"]
  node_jobingest["Job Ingestion"]
  node_jobproviders["Job Providers<br/>[index.ts]"]
end

subgraph group_platform["Platform Services"]
  node_resumeapi["Resume API<br/>[resume.ts]"]
  node_activity["Activity Tracking"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_payments["Payments<br/>[payment.ts]"]
  node_stripe["Stripe"]
end

node_candidate(("Candidate"))

node_candidate -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_interviewui
node_interviewui -.->|"submits interview"| node_adaptiveapi
node_adaptiveapi -->|"invokes"| node_adaptiveengine
node_adaptiveapi -->|"persists session"| node_interviewmodel
node_adaptiveengine -.->|"selects next action"| node_interviewstrategy
node_adaptiveapi -.->|"produces report"| node_reportui
node_adaptiveapi -->|"records completion"| node_activity
node_candidate -->|"requests analysis"| node_aiapi
node_aiapi -->|"uses services"| node_aianalysis
node_candidate -->|"analyzes resume"| node_resumeui
node_resumeui -->|"uploads resume"| node_resumeapi
node_candidate -.->|"takes test"| node_aptitudeui
node_aptitudeui -.->|"starts attempt"| node_aptitudeapi
node_aptitudeapi -->|"records completion"| node_activity
node_candidate -->|"practices coding"| node_codingui
node_codingui -.->|"submits solution"| node_codingapi
node_candidate -.->|"learns skills"| node_careerui
node_careerui -.->|"requests career content"| node_careerroutes
node_candidate -.->|"searches jobs"| node_jobui
node_jobui -.->|"requests job data"| node_jobsroutes
node_jobsroutes -->|"refreshes listings"| node_jobingest
node_jobingest -->|"fetches listings"| node_jobproviders
node_candidate -->|"authenticates"| node_auth
node_candidate -->|"manages subscription"| node_payments
node_payments -->|"processes payment"| node_stripe

click node_webapp "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/App.tsx"
click node_interviewui "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/InterviewRoomPage.tsx"
click node_reportui "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/FeedbackPage.tsx"
click node_adaptiveapi "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/routes/adaptiveInterview.routes.ts"
click node_adaptiveengine "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/services/adaptiveInterview.service.ts"
click node_interviewmodel "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/models/AdaptiveInterview.ts"
click node_interviewstrategy "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/interview/engine/AdaptiveInterviewEngine.ts"
click node_aiapi "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/ai-server/src/main.py"
click node_aianalysis "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/ai-server/src/services/gemini_service.py"
click node_resumeui "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/ResumeAnalyzerPage.tsx"
click node_resumeapi "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/routes/resume.ts"
click node_aptitudeui "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/pages/aptitude/ExamRoom.tsx"
click node_aptitudeapi "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/controllers/studentAptitude.controller.ts"
click node_codingui "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/features/coding/pages/ProblemWorkspacePage.tsx"
click node_codingapi "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/coding/controllers/coding.submissions.controller.ts"
click node_careerui "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/CareerLearningPage.tsx"
click node_careerroutes "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/career/routes/career.routes.ts"
click node_jobui "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/JobsPage.tsx"
click node_jobsroutes "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/jobs/routes/jobs.routes.ts"
click node_jobingest "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/jobs/services/ingestion.service.ts"
click node_jobproviders "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/jobs/providers/index.ts"
click node_activity "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/services/activity.service.ts"
click node_auth "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/middleware/auth.ts"
click node_payments "https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/routes/payment.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_webapp,node_interviewui,node_reportui,node_resumeui,node_aptitudeui,node_codingui,node_careerui,node_jobui toneBlue
class node_adaptiveapi,node_adaptiveengine,node_interviewmodel,node_interviewstrategy,node_aiapi,node_aianalysis toneAmber
class node_aptitudeapi,node_codingapi toneMint
class node_careerroutes,node_jobsroutes,node_jobingest,node_jobproviders toneRose
class node_resumeapi,node_activity,node_auth,node_payments,node_stripe,node_candidate toneIndigo
```

## Components

### Candidate Experience

- [Web Application](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/App.tsx): `frontend/src/app/App.tsx`
- [Interview Rooms](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/InterviewRoomPage.tsx): `frontend/src/app/pages/InterviewRoomPage.tsx`
- [Interview Reports](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/FeedbackPage.tsx): `frontend/src/app/pages/FeedbackPage.tsx`
- [Resume Tools](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/ResumeAnalyzerPage.tsx): `frontend/src/app/pages/ResumeAnalyzerPage.tsx`
- [Aptitude Tests](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/pages/aptitude/ExamRoom.tsx): `frontend/src/pages/aptitude/ExamRoom.tsx`
- [Coding Workspace](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/features/coding/pages/ProblemWorkspacePage.tsx): `frontend/src/app/features/coding/pages/ProblemWorkspacePage.tsx`
- [Career Learning](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/CareerLearningPage.tsx): `frontend/src/app/pages/CareerLearningPage.tsx`
- [Job Discovery](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/frontend/src/app/pages/JobsPage.tsx): `frontend/src/app/pages/JobsPage.tsx`

### Interview Assessment

- [Adaptive Interview API](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/routes/adaptiveInterview.routes.ts): `backend/src/routes/adaptiveInterview.routes.ts`
- [Adaptive Session Service](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/services/adaptiveInterview.service.ts): `backend/src/services/adaptiveInterview.service.ts`
- [Interview Records](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/models/AdaptiveInterview.ts): `backend/src/models/AdaptiveInterview.ts`
- [Adaptive Decision Engine](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/interview/engine/AdaptiveInterviewEngine.ts): `backend/src/interview/engine/AdaptiveInterviewEngine.ts`
- [AI Analysis API](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/ai-server/src/main.py): `ai-server/src/main.py`
- [AI Analysis Services](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/ai-server/src/services/gemini_service.py): `ai-server/src/services/gemini_service.py`

### Learning and Practice

- [Aptitude API](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/controllers/studentAptitude.controller.ts): `backend/src/controllers/studentAptitude.controller.ts`
- [Coding Submissions](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/coding/controllers/coding.submissions.controller.ts): `backend/src/coding/controllers/coding.submissions.controller.ts`

### Career and Jobs

- [Career Services](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/career/routes/career.routes.ts): `backend/src/career/routes/career.routes.ts`
- [Jobs API](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/jobs/routes/jobs.routes.ts): `backend/src/jobs/routes/jobs.routes.ts`
- [Job Ingestion](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/jobs/services/ingestion.service.ts): `backend/src/jobs/services/ingestion.service.ts`
- [Job Providers](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/jobs/providers/index.ts): `backend/src/jobs/providers/index.ts`

### Platform Services

- [Resume API](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/routes/resume.ts): `backend/src/routes/resume.ts`
- [Activity Tracking](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/services/activity.service.ts): `backend/src/services/activity.service.ts`
- [Authentication](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/middleware/auth.ts): `backend/src/middleware/auth.ts`
- [Payments](https://github.com/huzaifa-bubere/aether-ai-platform/blob/main/backend/src/routes/payment.ts): `backend/src/routes/payment.ts`
- **Stripe**

### Other components

- **Candidate**

## Connections

- Candidate → Web Application: uses (evidence: `README.md`)
- Web Application → Interview Rooms: routes to (evidence: `frontend/src/app/App.tsx`)
- Interview Rooms → Adaptive Interview API: submits interview
- Adaptive Interview API → Adaptive Session Service: invokes (evidence: `backend/src/routes/adaptiveInterview.routes.ts`)
- Adaptive Interview API → Interview Records: persists session (evidence: `backend/src/routes/adaptiveInterview.routes.ts`)
- Adaptive Session Service → Adaptive Decision Engine: selects next action
- Adaptive Interview API → Interview Reports: produces report
- Adaptive Interview API → Activity Tracking: records completion (evidence: `backend/src/routes/adaptiveInterview.routes.ts`)
- Candidate → AI Analysis API: requests analysis (evidence: `README.md`)
- AI Analysis API → AI Analysis Services: uses services (evidence: `ai-server/src/main.py`)
- Candidate → Resume Tools: analyzes resume (evidence: `README.md`)
- Resume Tools → Resume API: uploads resume (evidence: `README.md`)
- Candidate → Aptitude Tests: takes test
- Aptitude Tests → Aptitude API: starts attempt
- Aptitude API → Activity Tracking: records completion (evidence: `backend/src/controllers/studentAptitude.controller.ts`)
- Candidate → Coding Workspace: practices coding (evidence: `README.md`)
- Coding Workspace → Coding Submissions: submits solution
- Candidate → Career Learning: learns skills
- Career Learning → Career Services: requests career content
- Candidate → Job Discovery: searches jobs
- Job Discovery → Jobs API: requests job data
- Jobs API → Job Ingestion: refreshes listings (evidence: `backend/src/jobs/routes/jobs.routes.ts`)
- Job Ingestion → Job Providers: fetches listings (evidence: `backend/src/jobs/services/ingestion.service.ts`)
- Candidate → Authentication: authenticates (evidence: `README.md`)
- Candidate → Payments: manages subscription (evidence: `README.md`)
- Payments → Stripe: processes payment (evidence: `README.md`)
