# siddharth-1118/classivo3 architecture

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

- Interactive diagram: https://gitdiagram.com/siddharth-1118/classivo3
- Repository: https://github.com/siddharth-1118/classivo3

## Overview

This repository is a student academic companion centered on connecting academic data to dashboard and study-planning views. The visible runtime includes app state and backend-proxy calls, an SRM portal wrapper with parsers, academic calculations, themed UI, and monetization/notification features. The README describes a separate SRM Student Companion login-and-snapshot workflow, but its named routes and persistence stack are not present in the supplied tree; the graph therefore follows the available Classivo source evidence. Several UI and backend subsystems are represented by their exact directories because their files were not excerpted.

Main entry points: [`src/hooks/useAcademiaData.ts`](https://github.com/siddharth-1118/classivo3/blob/main/src/hooks/useAcademiaData.ts) (Academic data hook), [`src/context/AppContext.tsx`](https://github.com/siddharth-1118/classivo3/blob/main/src/context/AppContext.tsx) (App state), [`src/app/(app)/AppLayoutClient.tsx`](https://github.com/siddharth-1118/classivo3/blob/main/src/app/(app)/AppLayoutClient.tsx) (App layout), [`srm-api-wrapper/backend/src/server.ts`](https://github.com/siddharth-1118/classivo3/blob/main/srm-api-wrapper/backend/src/server.ts) (Portal service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_appstate["App state<br/>[AppContext.tsx]"]
  node_proxy["Backend proxy<br/>[backendProxy.ts]"]
  node_layout["App layout"]
  node_themes["Theme shells"]
  node_profile["Student profile<br/>[page.tsx]"]
end

subgraph group_academic["Academic data"]
  node_dashboard["Dashboard views"]
  node_agenda["Agenda views<br/>[NovaAgenda.tsx]"]
  node_attendance["Attendance logic<br/>[attendanceLogic.ts]"]
  node_marks["Marks logic<br/>[marksLogic.ts]"]
  node_timetable["Timetable logic<br/>[timetableLogic.ts]"]
  node_academia["Academic data hook<br/>[useAcademiaData.ts]"]
end

subgraph group_portal["Portal integration"]
  node_portalserver["Portal service<br/>[server.ts]"]
  node_session["Portal sessions<br/>[httpSession.ts]"]
  node_parsers["Portal parsers"]
end

subgraph group_services["User services"]
  node_supabase["Supabase client<br/>[supabase.ts]"]
  node_monetization["Monetization<br/>[useMonetization.ts]"]
  node_business["Business rules<br/>[business.ts]"]
  node_notifications["Notifications<br/>[notifs.ts]"]
  node_settings["Settings<br/>[SettingsPage.tsx]"]
end

node_student(("Student"))

node_student -->|"uses"| node_appstate
node_appstate -->|"requests data"| node_proxy
node_appstate -.->|"routes portal calls"| node_portalserver
node_layout -->|"reads state"| node_appstate
node_layout -->|"selects shell"| node_themes
node_layout -->|"loads academic data"| node_academia
node_themes -.->|"renders"| node_dashboard
node_academia -->|"calculates attendance"| node_attendance
node_academia -->|"processes marks"| node_marks
node_academia -->|"loads classes"| node_timetable
node_academia -.->|"supplies data"| node_agenda
node_portalserver -->|"manages sessions"| node_session
node_portalserver -->|"parses portal pages"| node_parsers
node_monetization -->|"uses rules"| node_business
node_monetization -->|"syncs settings"| node_supabase
node_settings -->|"configures alerts"| node_notifications
node_profile -->|"loads offers"| node_monetization
node_appstate -->|"emits updates"| node_notifications

click node_appstate "https://github.com/siddharth-1118/classivo3/blob/main/src/context/AppContext.tsx"
click node_proxy "https://github.com/siddharth-1118/classivo3/blob/main/src/utils/backendProxy.ts"
click node_layout "https://github.com/siddharth-1118/classivo3/blob/main/src/app/(app)/AppLayoutClient.tsx"
click node_themes "https://github.com/siddharth-1118/classivo3/tree/main/src/components/themes"
click node_dashboard "https://github.com/siddharth-1118/classivo3/tree/main/src/components/themes"
click node_agenda "https://github.com/siddharth-1118/classivo3/blob/main/src/components/themes/nova/NovaAgenda.tsx"
click node_attendance "https://github.com/siddharth-1118/classivo3/blob/main/src/utils/attendance/attendanceLogic.ts"
click node_marks "https://github.com/siddharth-1118/classivo3/blob/main/src/utils/marks/marksLogic.ts"
click node_timetable "https://github.com/siddharth-1118/classivo3/blob/main/src/utils/timetable/timetableLogic.ts"
click node_academia "https://github.com/siddharth-1118/classivo3/blob/main/src/hooks/useAcademiaData.ts"
click node_portalserver "https://github.com/siddharth-1118/classivo3/blob/main/srm-api-wrapper/backend/src/server.ts"
click node_session "https://github.com/siddharth-1118/classivo3/blob/main/srm-api-wrapper/backend/src/services/httpSession.ts"
click node_parsers "https://github.com/siddharth-1118/classivo3/tree/main/srm-api-wrapper/backend/src/parsers"
click node_supabase "https://github.com/siddharth-1118/classivo3/blob/main/src/lib/supabase.ts"
click node_monetization "https://github.com/siddharth-1118/classivo3/blob/main/src/hooks/useMonetization.ts"
click node_business "https://github.com/siddharth-1118/classivo3/blob/main/src/config/business.ts"
click node_notifications "https://github.com/siddharth-1118/classivo3/blob/main/src/utils/shared/notifs.ts"
click node_settings "https://github.com/siddharth-1118/classivo3/blob/main/src/components/shared/SettingsPage.tsx"
click node_profile "https://github.com/siddharth-1118/classivo3/blob/main/src/app/(app)/profile/page.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_appstate,node_proxy,node_layout,node_themes,node_profile toneBlue
class node_dashboard,node_agenda,node_attendance,node_marks,node_timetable,node_academia toneAmber
class node_portalserver,node_session,node_parsers toneMint
class node_supabase,node_monetization,node_business,node_notifications,node_settings toneRose
class node_student toneIndigo
```

## Components

### App experience

- [App state](https://github.com/siddharth-1118/classivo3/blob/main/src/context/AppContext.tsx): `src/context/AppContext.tsx`
- [Backend proxy](https://github.com/siddharth-1118/classivo3/blob/main/src/utils/backendProxy.ts): `src/utils/backendProxy.ts`
- [App layout](https://github.com/siddharth-1118/classivo3/blob/main/src/app/(app)/AppLayoutClient.tsx): `src/app/(app)/AppLayoutClient.tsx`
- [Theme shells](https://github.com/siddharth-1118/classivo3/tree/main/src/components/themes): `src/components/themes`
- [Student profile](https://github.com/siddharth-1118/classivo3/blob/main/src/app/(app)/profile/page.tsx): `src/app/(app)/profile/page.tsx`

### Academic data

- [Dashboard views](https://github.com/siddharth-1118/classivo3/tree/main/src/components/themes): `src/components/themes`
- [Agenda views](https://github.com/siddharth-1118/classivo3/blob/main/src/components/themes/nova/NovaAgenda.tsx): `src/components/themes/nova/NovaAgenda.tsx`
- [Attendance logic](https://github.com/siddharth-1118/classivo3/blob/main/src/utils/attendance/attendanceLogic.ts): `src/utils/attendance/attendanceLogic.ts`
- [Marks logic](https://github.com/siddharth-1118/classivo3/blob/main/src/utils/marks/marksLogic.ts): `src/utils/marks/marksLogic.ts`
- [Timetable logic](https://github.com/siddharth-1118/classivo3/blob/main/src/utils/timetable/timetableLogic.ts): `src/utils/timetable/timetableLogic.ts`
- [Academic data hook](https://github.com/siddharth-1118/classivo3/blob/main/src/hooks/useAcademiaData.ts): `src/hooks/useAcademiaData.ts`

### Portal integration

- [Portal service](https://github.com/siddharth-1118/classivo3/blob/main/srm-api-wrapper/backend/src/server.ts): `srm-api-wrapper/backend/src/server.ts`
- [Portal sessions](https://github.com/siddharth-1118/classivo3/blob/main/srm-api-wrapper/backend/src/services/httpSession.ts): `srm-api-wrapper/backend/src/services/httpSession.ts`
- [Portal parsers](https://github.com/siddharth-1118/classivo3/tree/main/srm-api-wrapper/backend/src/parsers): `srm-api-wrapper/backend/src/parsers`

### User services

- [Supabase client](https://github.com/siddharth-1118/classivo3/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Monetization](https://github.com/siddharth-1118/classivo3/blob/main/src/hooks/useMonetization.ts): `src/hooks/useMonetization.ts`
- [Business rules](https://github.com/siddharth-1118/classivo3/blob/main/src/config/business.ts): `src/config/business.ts`
- [Notifications](https://github.com/siddharth-1118/classivo3/blob/main/src/utils/shared/notifs.ts): `src/utils/shared/notifs.ts`
- [Settings](https://github.com/siddharth-1118/classivo3/blob/main/src/components/shared/SettingsPage.tsx): `src/components/shared/SettingsPage.tsx`

### Other components

- **Student**

## Connections

- Student → App state: uses
- App state → Backend proxy: requests data (evidence: `src/context/AppContext.tsx`)
- App state → Portal service: routes portal calls
- App layout → App state: reads state (evidence: `src/app/(app)/AppLayoutClient.tsx`)
- App layout → Theme shells: selects shell (evidence: `src/app/(app)/AppLayoutClient.tsx`)
- App layout → Academic data hook: loads academic data (evidence: `src/app/(app)/AppLayoutClient.tsx`)
- Theme shells → Dashboard views: renders
- Academic data hook → Attendance logic: calculates attendance (evidence: `src/hooks/useAcademiaData.ts`)
- Academic data hook → Marks logic: processes marks (evidence: `src/hooks/useAcademiaData.ts`)
- Academic data hook → Timetable logic: loads classes (evidence: `src/hooks/useAcademiaData.ts`)
- Academic data hook → Agenda views: supplies data
- Portal service → Portal sessions: manages sessions (evidence: `srm-api-wrapper/backend/src/server.ts`)
- Portal service → Portal parsers: parses portal pages (evidence: `srm-api-wrapper/backend/src/server.ts`)
- Monetization → Business rules: uses rules (evidence: `src/hooks/useMonetization.ts`)
- Monetization → Supabase client: syncs settings (evidence: `src/hooks/useMonetization.ts`)
- Settings → Notifications: configures alerts (evidence: `src/components/shared/SettingsPage.tsx`)
- Student profile → Monetization: loads offers (evidence: `src/app/(app)/profile/page.tsx`)
- App state → Notifications: emits updates (evidence: `src/context/AppContext.tsx`)
