# nithinannamalai/tutor-ward-app architecture

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

- Interactive diagram: https://gitdiagram.com/nithinannamalai/tutor-ward-app
- Repository: https://github.com/nithinannamalai/tutor-ward-app

## Overview

EEE Department Portal is a student-and-faculty hub spanning academic tracking, records and requests, and campus services. The main workflow is entering the React app, choosing a portal feature, and using its interface; data-backed features delegate to a shared service that accesses Supabase and falls back to browser storage. The AI tutor can call Gemini when configured. The README is an untouched Vite template, so product capabilities are inferred from the route catalog and source index. Some feature-to-app wiring and unsampled service behavior are not visible in excerpts.

Main entry points: [`src/App.tsx`](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/App.tsx) (Portal application), [`src/services/db.ts`](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/services/db.ts) (Portal data service), [`src/components/desktop/DesktopVisionaDashboard.tsx`](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/desktop/DesktopVisionaDashboard.tsx) (Desktop dashboard), [`src/components/academics/AcademicsTracker.tsx`](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/AcademicsTracker.tsx) (Academic tracker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Portal entry"]
  node_app["Portal application<br/>[App.tsx]"]
  node_routes["Feature catalog<br/>[appRoutes.ts]"]
  node_desktop_dashboard["Desktop dashboard"]
end

subgraph group_academics["Academic hub"]
  node_academic_tracker["Academic tracker"]
  node_calendar["Academic calendar"]
  node_gpa["GPA calculator<br/>[GpaCalculator.tsx]"]
  node_nptel["NPTEL tracker<br/>[NptelTracker.tsx]"]
  node_timetable["Class timetable<br/>[Timetable.tsx]"]
end

subgraph group_records["Records and requests"]
  node_profile_docs["Profile and documents<br/>[ProfileDocs.tsx]"]
  node_od_form["OD requests<br/>[ODForm.tsx]"]
  node_letters["Request letters<br/>[RequestLetters.tsx]"]
end

subgraph group_services["Student services"]
  node_attendance["Attendance tracker"]
  node_career["Career hub<br/>[CareerHub.tsx]"]
  node_lab_finder["Lab seat finder<br/>[LabSeatFinder.tsx]"]
  node_puzzle["Puzzle games<br/>[PuzzleGames.tsx]"]
  node_announcements["Announcements"]
  node_ai["AI tutor<br/>[AIChatbot.tsx]"]
end

subgraph group_data["Data and integrations"]
  node_db["Portal data service<br/>[db.ts]"]
  node_supabase_client["Supabase client<br/>[supabaseClient.ts]"]
  node_browser_storage[("Browser storage")]
end

node_student(("Student or faculty"))
node_supabase[("Supabase")]
node_gemini["Gemini API"]

node_student -.->|"opens"| node_app
node_app -->|"uses catalog"| node_routes
node_app -->|"renders"| node_announcements
node_app -->|"renders"| node_ai
node_app -.->|"selects feature"| node_academic_tracker
node_app -.->|"selects feature"| node_calendar
node_app -.->|"selects feature"| node_gpa
node_app -.->|"selects feature"| node_nptel
node_app -.->|"selects feature"| node_timetable
node_app -.->|"selects feature"| node_profile_docs
node_app -.->|"selects feature"| node_od_form
node_app -.->|"selects feature"| node_letters
node_app -.->|"selects feature"| node_attendance
node_app -.->|"selects feature"| node_career
node_app -.->|"selects feature"| node_lab_finder
node_app -.->|"selects feature"| node_puzzle
node_app -.->|"selects view"| node_desktop_dashboard
node_academic_tracker -->|"accesses data"| node_db
node_calendar -->|"accesses data"| node_db
node_nptel -->|"accesses data"| node_db
node_timetable -->|"accesses data"| node_db
node_attendance -->|"accesses data"| node_db
node_profile_docs -->|"accesses data"| node_db
node_letters -->|"accesses data"| node_db
node_announcements -->|"accesses data"| node_db
node_desktop_dashboard -->|"accesses data"| node_db
node_db -->|"uses client"| node_supabase_client
node_supabase_client -->|"creates client"| node_supabase
node_db -->|"fallback reads and writes"| node_browser_storage
node_ai -->|"sends prompt"| node_gemini

click node_app "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/App.tsx"
click node_routes "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/routes/appRoutes.ts"
click node_academic_tracker "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/AcademicsTracker.tsx"
click node_calendar "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/AcademicCalendar.tsx"
click node_gpa "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/GpaCalculator.tsx"
click node_nptel "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/NptelTracker.tsx"
click node_timetable "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/Timetable.tsx"
click node_profile_docs "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/ProfileDocs.tsx"
click node_od_form "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/ODForm.tsx"
click node_letters "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/RequestLetters.tsx"
click node_attendance "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/AttendanceTracker.tsx"
click node_career "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/CareerHub.tsx"
click node_lab_finder "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/LabSeatFinder.tsx"
click node_puzzle "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/PuzzleGames.tsx"
click node_announcements "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/common/AnnouncementBanner.tsx"
click node_ai "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/common/AIChatbot.tsx"
click node_desktop_dashboard "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/desktop/DesktopVisionaDashboard.tsx"
click node_db "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/services/db.ts"
click node_supabase_client "https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/services/supabaseClient.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_app,node_routes,node_desktop_dashboard toneBlue
class node_academic_tracker,node_calendar,node_gpa,node_nptel,node_timetable,node_supabase toneAmber
class node_profile_docs,node_od_form,node_letters,node_gemini toneMint
class node_attendance,node_career,node_lab_finder,node_puzzle,node_announcements,node_ai toneRose
class node_db,node_supabase_client,node_browser_storage,node_student toneIndigo
```

## Components

### Portal entry

- [Portal application](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/App.tsx): `src/App.tsx`
- [Feature catalog](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/routes/appRoutes.ts): `src/routes/appRoutes.ts`
- [Desktop dashboard](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/desktop/DesktopVisionaDashboard.tsx): `src/components/desktop/DesktopVisionaDashboard.tsx`

### Academic hub

- [Academic tracker](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/AcademicsTracker.tsx): `src/components/academics/AcademicsTracker.tsx`
- [Academic calendar](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/AcademicCalendar.tsx): `src/components/academics/AcademicCalendar.tsx`
- [GPA calculator](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/GpaCalculator.tsx): `src/components/academics/GpaCalculator.tsx`
- [NPTEL tracker](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/NptelTracker.tsx): `src/components/academics/NptelTracker.tsx`
- [Class timetable](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/academics/Timetable.tsx): `src/components/academics/Timetable.tsx`

### Records and requests

- [Profile and documents](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/ProfileDocs.tsx): `src/components/services/ProfileDocs.tsx`
- [OD requests](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/ODForm.tsx): `src/components/services/ODForm.tsx`
- [Request letters](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/RequestLetters.tsx): `src/components/services/RequestLetters.tsx`

### Student services

- [Attendance tracker](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/AttendanceTracker.tsx): `src/components/services/AttendanceTracker.tsx`
- [Career hub](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/CareerHub.tsx): `src/components/services/CareerHub.tsx`
- [Lab seat finder](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/LabSeatFinder.tsx): `src/components/services/LabSeatFinder.tsx`
- [Puzzle games](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/services/PuzzleGames.tsx): `src/components/services/PuzzleGames.tsx`
- [Announcements](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/common/AnnouncementBanner.tsx): `src/components/common/AnnouncementBanner.tsx`
- [AI tutor](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/components/common/AIChatbot.tsx): `src/components/common/AIChatbot.tsx`

### Data and integrations

- [Portal data service](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/services/db.ts): `src/services/db.ts`
- [Supabase client](https://github.com/nithinannamalai/tutor-ward-app/blob/main/src/services/supabaseClient.ts): `src/services/supabaseClient.ts`
- **Browser storage**

### Other components

- **Student or faculty**
- **Supabase**
- **Gemini API**

## Connections

- Student or faculty → Portal application: opens
- Portal application → Feature catalog: uses catalog (evidence: `src/App.tsx`)
- Portal application → Announcements: renders (evidence: `src/App.tsx`)
- Portal application → AI tutor: renders (evidence: `src/App.tsx`)
- Portal application → Academic tracker: selects feature
- Portal application → Academic calendar: selects feature
- Portal application → GPA calculator: selects feature
- Portal application → NPTEL tracker: selects feature
- Portal application → Class timetable: selects feature
- Portal application → Profile and documents: selects feature (evidence: `src/components/services/ProfileDocs.tsx`)
- Portal application → OD requests: selects feature
- Portal application → Request letters: selects feature
- Portal application → Attendance tracker: selects feature
- Portal application → Career hub: selects feature
- Portal application → Lab seat finder: selects feature
- Portal application → Puzzle games: selects feature
- Portal application → Desktop dashboard: selects view (evidence: `src/components/desktop/DesktopVisionaDashboard.tsx`)
- Academic tracker → Portal data service: accesses data (evidence: `src/components/academics/AcademicsTracker.tsx`)
- Academic calendar → Portal data service: accesses data (evidence: `src/components/academics/AcademicCalendar.tsx`)
- NPTEL tracker → Portal data service: accesses data (evidence: `src/components/academics/NptelTracker.tsx`)
- Class timetable → Portal data service: accesses data (evidence: `src/components/academics/Timetable.tsx`)
- Attendance tracker → Portal data service: accesses data (evidence: `src/components/services/AttendanceTracker.tsx`)
- Profile and documents → Portal data service: accesses data (evidence: `src/components/services/ProfileDocs.tsx`)
- Request letters → Portal data service: accesses data (evidence: `src/components/services/RequestLetters.tsx`)
- Announcements → Portal data service: accesses data (evidence: `src/components/common/AnnouncementBanner.tsx`)
- Desktop dashboard → Portal data service: accesses data (evidence: `src/components/desktop/DesktopVisionaDashboard.tsx`)
- Portal data service → Supabase client: uses client (evidence: `src/services/db.ts`)
- Supabase client → Supabase: creates client (evidence: `src/services/supabaseClient.ts`)
- Portal data service → Browser storage: fallback reads and writes (evidence: `src/services/db.ts`)
- AI tutor → Gemini API: sends prompt (evidence: `src/components/common/AIChatbot.tsx`)
