# vatsalgupta2025-creator/vit-meridian architecture

> Architecture diagram of the GitHub repository vatsalgupta2025-creator/vit-meridian, 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/vatsalgupta2025-creator/vit-meridian
- Repository: https://github.com/vatsalgupta2025-creator/vit-meridian

## Overview

VIT-MERIDIAN is a unified smart-campus platform: students enter an OS-like interface, choose academic, campus-life, productivity, career, or AI features, and receive campus information or complete tasks. The repository combines Next.js pages and feature components with API routes, authentication, Prisma persistence, and demo data. The README documents the main capabilities and the app shell, but most feature-to-route wiring was not sampled; those connections are therefore not asserted. Several major features are documented but their implementation details were not inspected.

Main entry points: [`src/app/page.tsx`](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/page.tsx) (Campus OS shell), [`src/lib/prisma.ts`](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/prisma.ts) (Prisma client), [`src/components/OracleSearch.tsx`](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/OracleSearch.tsx) (Oracle Search), [`src/lib/auth.ts`](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/auth.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Campus experience"]
  node_shell["Campus OS shell<br/>[page.tsx]"]
  node_login["Login experience<br/>[page.tsx]"]
end

subgraph group_learning["Learning and AI"]
  node_search["Oracle Search<br/>[OracleSearch.tsx]"]
  node_knowledge["Knowledge cards<br/>[KnowledgeCard.tsx]"]
  node_studybuddy["AI Study Buddy<br/>[StudyBuddy.tsx]"]
  node_quiz["Quiz generation<br/>[quizGenerator.ts]"]
  node_learningdata["Learning resources<br/>[learningData.ts]"]
  node_interview["AI mock interview"]
  node_career["Career roadmap<br/>[AiRoadmap.tsx]"]
  node_academics["Academic tools"]
end

subgraph group_operations["Campus operations"]
  node_campus["Campus services"]
  node_attendance["Attendance service<br/>[route.ts]"]
  node_parent["Parent portal<br/>[route.ts]"]
  node_polls["Polls<br/>[route.ts]"]
  node_lostfound["Lost and found<br/>[route.ts]"]
  node_travel["Travel pool<br/>[route.ts]"]
end

subgraph group_safety["Safety services"]
  node_safetyui["Safety features<br/>[VitgrowwSafe.tsx]"]
  node_safetyadmin["Safety administration<br/>[AdminDashboard.tsx]"]
  node_safetyapi["Safety API"]
  node_safetynotify["Safety notifications"]
end

subgraph group_platform["Platform services"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_api["Campus API routes"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_database[("Campus database")]
  node_mockbackend["Demo data backend<br/>[mockBackend.ts]"]
  node_mockdata["Campus mock data<br/>[mockData.ts]"]
  node_canonical["Canonical campus types<br/>[canonical.ts]"]
  node_learningtypes["Learning types<br/>[learning.ts]"]
  node_chatui["AI chat interface"]
  node_shader["Shader backgrounds"]
end

node_student(("Student"))

node_student -->|"opens"| node_shell
node_shell -->|"routes to"| node_search
node_shell -->|"routes to"| node_studybuddy
node_shell -->|"routes to"| node_interview
node_shell -->|"routes to"| node_career
node_shell -->|"routes to"| node_academics
node_shell -->|"routes to"| node_campus
node_search -->|"renders"| node_knowledge
node_search -->|"queries"| node_mockbackend
node_search -->|"reads"| node_mockdata
node_mockbackend -->|"reads"| node_mockdata
node_studybuddy -->|"generates quizzes"| node_quiz
node_learningdata -->|"uses types"| node_learningtypes
node_quiz -->|"uses types"| node_learningtypes
node_login -.->|"authenticates"| node_auth
node_api -.->|"requires sessions"| node_auth
node_attendance -->|"requires session"| node_auth
node_attendance -->|"reads and writes"| node_prisma
node_parent -->|"requires session"| node_auth
node_parent -->|"reads and writes"| node_prisma
node_polls -->|"reads and writes"| node_prisma
node_lostfound -->|"reads and writes"| node_prisma
node_travel -->|"reads and writes"| node_prisma
node_safetyadmin -->|"uses"| node_safetyui
node_safetyapi -.->|"may notify"| node_safetynotify
node_safetynotify -->|"records notifications"| node_prisma
node_prisma -.->|"persists data"| node_database
node_chatui -->|"uses background"| node_shader

click node_shell "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/page.tsx"
click node_login "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/login/page.tsx"
click node_search "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/OracleSearch.tsx"
click node_knowledge "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/KnowledgeCard.tsx"
click node_studybuddy "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/StudyBuddy.tsx"
click node_quiz "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/quizGenerator.ts"
click node_learningdata "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/data/learningData.ts"
click node_interview "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/AiMockInterview.tsx"
click node_career "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/AiRoadmap.tsx"
click node_academics "https://github.com/vatsalgupta2025-creator/vit-meridian/tree/main/src/components"
click node_campus "https://github.com/vatsalgupta2025-creator/vit-meridian/tree/main/src/components"
click node_attendance "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/attendance/route.ts"
click node_parent "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/parent-portal/route.ts"
click node_polls "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/polls/route.ts"
click node_lostfound "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/lost-found/route.ts"
click node_travel "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/travel-pool/route.ts"
click node_safetyui "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/VitgrowwSafe.tsx"
click node_safetyadmin "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/safety/AdminDashboard.tsx"
click node_safetyapi "https://github.com/vatsalgupta2025-creator/vit-meridian/tree/main/src/app/api/safety"
click node_safetynotify "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/safety/notificationService.ts"
click node_auth "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/auth.ts"
click node_api "https://github.com/vatsalgupta2025-creator/vit-meridian/tree/main/src/app/api"
click node_prisma "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/prisma.ts"
click node_mockbackend "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/data/mockBackend.ts"
click node_mockdata "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/data/mockData.ts"
click node_canonical "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/types/canonical.ts"
click node_learningtypes "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/types/learning.ts"
click node_chatui "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/ui/animated-ai-chat.tsx"
click node_shader "https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/ui/shader-background.tsx"

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_shell,node_login toneBlue
class node_search,node_knowledge,node_studybuddy,node_quiz,node_learningdata,node_interview,node_career,node_academics toneAmber
class node_campus,node_attendance,node_parent,node_polls,node_lostfound,node_travel toneMint
class node_safetyui,node_safetyadmin,node_safetyapi,node_safetynotify toneRose
class node_auth,node_api,node_prisma,node_database,node_mockbackend,node_mockdata,node_canonical,node_learningtypes,node_chatui,node_shader,node_student toneIndigo
```

## Components

### Campus experience

- [Campus OS shell](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Login experience](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`

### Learning and AI

- [Oracle Search](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/OracleSearch.tsx): `src/components/OracleSearch.tsx`
- [Knowledge cards](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/KnowledgeCard.tsx): `src/components/KnowledgeCard.tsx`
- [AI Study Buddy](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/StudyBuddy.tsx): `src/components/StudyBuddy.tsx`
- [Quiz generation](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/quizGenerator.ts): `src/lib/quizGenerator.ts`
- [Learning resources](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/data/learningData.ts): `src/data/learningData.ts`
- [AI mock interview](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/AiMockInterview.tsx): `src/components/AiMockInterview.tsx`
- [Career roadmap](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/AiRoadmap.tsx): `src/components/AiRoadmap.tsx`
- [Academic tools](https://github.com/vatsalgupta2025-creator/vit-meridian/tree/main/src/components): `src/components`

### Campus operations

- [Campus services](https://github.com/vatsalgupta2025-creator/vit-meridian/tree/main/src/components): `src/components`
- [Attendance service](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/attendance/route.ts): `src/app/api/attendance/route.ts`
- [Parent portal](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/parent-portal/route.ts): `src/app/api/parent-portal/route.ts`
- [Polls](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/polls/route.ts): `src/app/api/polls/route.ts`
- [Lost and found](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/lost-found/route.ts): `src/app/api/lost-found/route.ts`
- [Travel pool](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/app/api/travel-pool/route.ts): `src/app/api/travel-pool/route.ts`

### Safety services

- [Safety features](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/VitgrowwSafe.tsx): `src/components/VitgrowwSafe.tsx`
- [Safety administration](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/safety/AdminDashboard.tsx): `src/components/safety/AdminDashboard.tsx`
- [Safety API](https://github.com/vatsalgupta2025-creator/vit-meridian/tree/main/src/app/api/safety): `src/app/api/safety`
- [Safety notifications](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/safety/notificationService.ts): `src/lib/safety/notificationService.ts`

### Platform services

- [Authentication](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Campus API routes](https://github.com/vatsalgupta2025-creator/vit-meridian/tree/main/src/app/api): `src/app/api`
- [Prisma client](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- **Campus database**
- [Demo data backend](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/data/mockBackend.ts): `src/data/mockBackend.ts`
- [Campus mock data](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/data/mockData.ts): `src/data/mockData.ts`
- [Canonical campus types](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/types/canonical.ts): `src/types/canonical.ts`
- [Learning types](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/types/learning.ts): `src/types/learning.ts`
- [AI chat interface](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/ui/animated-ai-chat.tsx): `src/components/ui/animated-ai-chat.tsx`
- [Shader backgrounds](https://github.com/vatsalgupta2025-creator/vit-meridian/blob/main/src/components/ui/shader-background.tsx): `src/components/ui/shader-background.tsx`

### Other components

- **Student**

## Connections

- Student → Campus OS shell: opens
- Campus OS shell → Oracle Search: routes to
- Campus OS shell → AI Study Buddy: routes to
- Campus OS shell → AI mock interview: routes to
- Campus OS shell → Career roadmap: routes to
- Campus OS shell → Academic tools: routes to
- Campus OS shell → Campus services: routes to
- Oracle Search → Knowledge cards: renders (evidence: `src/components/OracleSearch.tsx`)
- Oracle Search → Demo data backend: queries (evidence: `src/components/OracleSearch.tsx`)
- Oracle Search → Campus mock data: reads (evidence: `src/components/OracleSearch.tsx`)
- Demo data backend → Campus mock data: reads (evidence: `src/data/mockBackend.ts`)
- AI Study Buddy → Quiz generation: generates quizzes
- Learning resources → Learning types: uses types (evidence: `src/data/learningData.ts`)
- Quiz generation → Learning types: uses types (evidence: `src/lib/quizGenerator.ts`)
- Login experience → Authentication: authenticates
- Campus API routes → Authentication: requires sessions (evidence: `src/app/api/parent-portal/route.ts`)
- Attendance service → Authentication: requires session (evidence: `src/app/api/attendance/route.ts`)
- Attendance service → Prisma client: reads and writes (evidence: `src/app/api/attendance/route.ts`)
- Parent portal → Authentication: requires session (evidence: `src/app/api/parent-portal/route.ts`)
- Parent portal → Prisma client: reads and writes (evidence: `src/app/api/parent-portal/route.ts`)
- Polls → Prisma client: reads and writes (evidence: `src/app/api/polls/route.ts`)
- Lost and found → Prisma client: reads and writes (evidence: `src/app/api/lost-found/route.ts`)
- Travel pool → Prisma client: reads and writes (evidence: `src/app/api/travel-pool/route.ts`)
- Safety administration → Safety features: uses (evidence: `src/components/safety/AdminDashboard.tsx`)
- Safety API → Safety notifications: may notify
- Safety notifications → Prisma client: records notifications (evidence: `src/lib/safety/notificationService.ts`)
- Prisma client → Campus database: persists data
- AI chat interface → Shader backgrounds: uses background (evidence: `src/components/ui/animated-ai-chat.tsx`)
