# maateja/sih-final-imps architecture

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

- Interactive diagram: https://gitdiagram.com/maateja/sih-final-imps
- Repository: https://github.com/maateja/sih-final-imps

## Overview

EduPath Navigator is an AI-assisted educational guidance platform for students and parents. Its documented journey is aptitude assessment and stream suggestions, followed by career and course exploration, college discovery, and ongoing planning through timelines and personalized recommendations. The graph also shows authentication, Firebase-backed user state, and the Genkit AI layer. README statements support the major product capabilities; source-index references support the cited page and module connections. Several routes and integrations were not sampled, so their internal wiring is not inferred.

Main entry points: [`src/lib/quiz/riasec-scoring.ts`](https://github.com/maateja/sih-final-imps/blob/main/src/lib/quiz/riasec-scoring.ts) (RIASEC scoring), [`src/lib/career-recommendations.ts`](https://github.com/maateja/sih-final-imps/blob/main/src/lib/career-recommendations.ts) (Career recommendations), [`src/app/[locale]/(app)/quiz/results/page.tsx`](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/quiz/results/page.tsx) (Quiz results), [`src/app/[locale]/(app)/one-stop-advisor/page.tsx`](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/one-stop-advisor/page.tsx) (One-stop advisor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_landing["Landing experience<br/>[page.tsx]"]
  node_auth["Auth routes<br/>[page.tsx]"]
end

subgraph group_assessment["Assessment and AI"]
  node_quiz["Aptitude quiz<br/>[QuizForm.tsx]"]
  node_scoring["RIASEC scoring<br/>[riasec-scoring.ts]"]
  node_results["Quiz results<br/>[page.tsx]"]
  node_streamai["Stream suggestion AI"]
end

subgraph group_guidance["Career guidance"]
  node_recommendations["Career recommendations"]
  node_courses["Course catalog"]
  node_oneadvisor["One-stop advisor<br/>[page.tsx]"]
  node_plan["Career plan<br/>[page.tsx]"]
  node_tasks["Roadmap tasks<br/>[suggested-tasks.ts]"]
end

subgraph group_discovery["College and resources"]
  node_colleges["College directory<br/>[page.tsx]"]
  node_collegeai["College recommendation AI"]
  node_resources["Resource library<br/>[page.tsx]"]
end

subgraph group_platform["Identity and state"]
  node_authstate["Auth state hook<br/>[use-auth.tsx]"]
  node_firebaseauth["Firebase authentication<br/>[auth.ts]"]
  node_firestore[("Firestore user data<br/>[database.ts]")]
  node_firebase["Firebase service<br/>[client.ts]"]
end

node_student(("Student or parent"))

node_student -->|"opens"| node_landing
node_landing -->|"offers sign-in"| node_auth
node_student -.->|"takes assessment"| node_quiz
node_quiz -.->|"scores answers"| node_scoring
node_results -->|"requests suggestion"| node_streamai
node_results -->|"uses scoring"| node_scoring
node_scoring -->|"informs"| node_recommendations
node_recommendations -->|"uses course data"| node_courses
node_oneadvisor -->|"uses recommendations"| node_recommendations
node_oneadvisor -->|"uses course data"| node_courses
node_student -->|"discovers colleges"| node_colleges
node_colleges -.->|"gets personalized suggestions"| node_collegeai
node_student -->|"explores resources"| node_resources
node_plan -.->|"uses task catalog"| node_tasks
node_authstate -->|"calls auth helpers"| node_firebaseauth
node_authstate -->|"saves user data"| node_firestore
node_firestore -->|"uses client"| node_firebase
node_student -->|"tracks deadlines"| node_plan

click node_landing "https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/page.tsx"
click node_auth "https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(auth)/signup/page.tsx"
click node_authstate "https://github.com/maateja/sih-final-imps/blob/main/src/hooks/use-auth.tsx"
click node_quiz "https://github.com/maateja/sih-final-imps/blob/main/src/components/quiz/QuizForm.tsx"
click node_scoring "https://github.com/maateja/sih-final-imps/blob/main/src/lib/quiz/riasec-scoring.ts"
click node_results "https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/quiz/results/page.tsx"
click node_streamai "https://github.com/maateja/sih-final-imps/blob/main/src/ai/flows/stream-suggestion-from-quiz.ts"
click node_recommendations "https://github.com/maateja/sih-final-imps/blob/main/src/lib/career-recommendations.ts"
click node_courses "https://github.com/maateja/sih-final-imps/blob/main/src/lib/courses-database.ts"
click node_oneadvisor "https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/one-stop-advisor/page.tsx"
click node_plan "https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/my-plan/page.tsx"
click node_tasks "https://github.com/maateja/sih-final-imps/blob/main/src/lib/suggested-tasks.ts"
click node_colleges "https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/colleges/page.tsx"
click node_collegeai "https://github.com/maateja/sih-final-imps/blob/main/src/ai/flows/personalized-college-recommendations.ts"
click node_resources "https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/resources/page.tsx"
click node_firebaseauth "https://github.com/maateja/sih-final-imps/blob/main/src/lib/firebase/auth.ts"
click node_firestore "https://github.com/maateja/sih-final-imps/blob/main/src/lib/firebase/database.ts"
click node_firebase "https://github.com/maateja/sih-final-imps/blob/main/src/lib/firebase/client.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_auth toneBlue
class node_quiz,node_scoring,node_results,node_streamai toneAmber
class node_recommendations,node_courses,node_oneadvisor,node_plan,node_tasks toneMint
class node_colleges,node_collegeai,node_resources toneRose
class node_authstate,node_firebaseauth,node_firestore,node_firebase,node_student toneIndigo
```

## Components

### Entry and access

- [Landing experience](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/page.tsx): `src/app/[locale]/page.tsx`
- [Auth routes](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(auth)/signup/page.tsx): `src/app/[locale]/(auth)/signup/page.tsx`

### Assessment and AI

- [Aptitude quiz](https://github.com/maateja/sih-final-imps/blob/main/src/components/quiz/QuizForm.tsx): `src/components/quiz/QuizForm.tsx`
- [RIASEC scoring](https://github.com/maateja/sih-final-imps/blob/main/src/lib/quiz/riasec-scoring.ts): `src/lib/quiz/riasec-scoring.ts`
- [Quiz results](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/quiz/results/page.tsx): `src/app/[locale]/(app)/quiz/results/page.tsx`
- [Stream suggestion AI](https://github.com/maateja/sih-final-imps/blob/main/src/ai/flows/stream-suggestion-from-quiz.ts): `src/ai/flows/stream-suggestion-from-quiz.ts`

### Career guidance

- [Career recommendations](https://github.com/maateja/sih-final-imps/blob/main/src/lib/career-recommendations.ts): `src/lib/career-recommendations.ts`
- [Course catalog](https://github.com/maateja/sih-final-imps/blob/main/src/lib/courses-database.ts): `src/lib/courses-database.ts`
- [One-stop advisor](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/one-stop-advisor/page.tsx): `src/app/[locale]/(app)/one-stop-advisor/page.tsx`
- [Career plan](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/my-plan/page.tsx): `src/app/[locale]/(app)/my-plan/page.tsx`
- [Roadmap tasks](https://github.com/maateja/sih-final-imps/blob/main/src/lib/suggested-tasks.ts): `src/lib/suggested-tasks.ts`

### College and resources

- [College directory](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/colleges/page.tsx): `src/app/[locale]/(app)/colleges/page.tsx`
- [College recommendation AI](https://github.com/maateja/sih-final-imps/blob/main/src/ai/flows/personalized-college-recommendations.ts): `src/ai/flows/personalized-college-recommendations.ts`
- [Resource library](https://github.com/maateja/sih-final-imps/blob/main/src/app/%5Blocale%5D/(app)/resources/page.tsx): `src/app/[locale]/(app)/resources/page.tsx`

### Identity and state

- [Auth state hook](https://github.com/maateja/sih-final-imps/blob/main/src/hooks/use-auth.tsx): `src/hooks/use-auth.tsx`
- [Firebase authentication](https://github.com/maateja/sih-final-imps/blob/main/src/lib/firebase/auth.ts): `src/lib/firebase/auth.ts`
- [Firestore user data](https://github.com/maateja/sih-final-imps/blob/main/src/lib/firebase/database.ts): `src/lib/firebase/database.ts`
- [Firebase service](https://github.com/maateja/sih-final-imps/blob/main/src/lib/firebase/client.ts): `src/lib/firebase/client.ts`

### Other components

- **Student or parent**

## Connections

- Student or parent → Landing experience: opens (evidence: `src/app/[locale]/page.tsx`)
- Landing experience → Auth routes: offers sign-in (evidence: `src/app/[locale]/page.tsx`)
- Student or parent → Aptitude quiz: takes assessment
- Aptitude quiz → RIASEC scoring: scores answers
- Quiz results → Stream suggestion AI: requests suggestion (evidence: `src/app/[locale]/(app)/quiz/results/page.tsx`)
- Quiz results → RIASEC scoring: uses scoring (evidence: `src/app/[locale]/(app)/quiz/results/page.tsx`)
- RIASEC scoring → Career recommendations: informs (evidence: `src/lib/career-recommendations.ts`)
- Career recommendations → Course catalog: uses course data (evidence: `src/lib/career-recommendations.ts`)
- One-stop advisor → Career recommendations: uses recommendations (evidence: `src/app/[locale]/(app)/one-stop-advisor/page.tsx`)
- One-stop advisor → Course catalog: uses course data (evidence: `src/app/[locale]/(app)/one-stop-advisor/page.tsx`)
- Student or parent → College directory: discovers colleges (evidence: `README.md`)
- College directory → College recommendation AI: gets personalized suggestions
- Student or parent → Resource library: explores resources (evidence: `README.md`)
- Career plan → Roadmap tasks: uses task catalog
- Auth state hook → Firebase authentication: calls auth helpers (evidence: `src/hooks/use-auth.tsx`)
- Auth state hook → Firestore user data: saves user data (evidence: `src/hooks/use-auth.tsx`)
- Firestore user data → Firebase service: uses client (evidence: `src/lib/firebase/database.ts`)
- Student or parent → Career plan: tracks deadlines (evidence: `README.md`)
