How siddharth-1118/classivo3 works
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: useAcademiaData.ts Academic data hook · AppContext.tsx App state · AppLayoutClient.tsx App layout · server.ts Portal service
Components 20
App experience
- App state
src/context/AppContext.tsx - Backend proxy
src/utils/backendProxy.ts - App layout
src/app/(app)/AppLayoutClient.tsx - Theme shells
src/components/themes - Student profile
src/app/(app)/profile/page.tsx
Academic data
- Dashboard views
src/components/themes - Agenda views
src/components/themes/nova/NovaAgenda.tsx - Attendance logic
src/utils/attendance/attendanceLogic.ts - Marks logic
src/utils/marks/marksLogic.ts - Timetable logic
src/utils/timetable/timetableLogic.ts - Academic data hook
src/hooks/useAcademiaData.ts
Portal integration
- Portal service
srm-api-wrapper/backend/src/server.ts - Portal sessions
srm-api-wrapper/backend/src/services/httpSession.ts - Portal parsers
srm-api-wrapper/backend/src/parsers
User services
- Supabase client
src/lib/supabase.ts - Monetization
src/hooks/useMonetization.ts - Business rules
src/config/business.ts - Notifications
src/utils/shared/notifs.ts - Settings
src/components/shared/SettingsPage.tsx
Other components
- Student
Connections 18
- Student → App state: uses
- App state → Backend proxy: requests data
src/context/AppContext.tsx - App state → Portal service: routes portal calls
- App layout → App state: reads state
src/app/(app)/AppLayoutClient.tsx - App layout → Theme shells: selects shell
src/app/(app)/AppLayoutClient.tsx - App layout → Academic data hook: loads academic data
src/app/(app)/AppLayoutClient.tsx - Theme shells → Dashboard views: renders
- Academic data hook → Attendance logic: calculates attendance
src/hooks/useAcademiaData.ts - Academic data hook → Marks logic: processes marks
src/hooks/useAcademiaData.ts - Academic data hook → Timetable logic: loads classes
src/hooks/useAcademiaData.ts - Academic data hook → Agenda views: supplies data
- Portal service → Portal sessions: manages sessions
srm-api-wrapper/backend/src/server.ts - Portal service → Portal parsers: parses portal pages
srm-api-wrapper/backend/src/server.ts - Monetization → Business rules: uses rules
src/hooks/useMonetization.ts - Monetization → Supabase client: syncs settings
src/hooks/useMonetization.ts - Settings → Notifications: configures alerts
src/components/shared/SettingsPage.tsx - Student profile → Monetization: loads offers
src/app/(app)/profile/page.tsx - App state → Notifications: emits updates
src/context/AppContext.tsx