# srivathsanram/eduverse architecture

> Architecture diagram of the GitHub repository srivathsanram/eduverse, 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/srivathsanram/eduverse
- Repository: https://github.com/srivathsanram/eduverse

## Overview

Eduverse combines a teacher-led classroom and learning-materials LMS with a separate knowledge-tracing model service. Teachers create classes, arrange topic relationships, upload materials, and choose assignment questions; students join classes, access materials and assignments, and submit work for results. The model API supports prediction, while the training and dataset-loading code forms an internal model-development layer. The graph reflects documented links and sampled calls; unsampled page behavior and any web-to-model-service integration are not inferred.

Main entry points: [`lib/supabaseClient.ts`](https://github.com/srivathsanram/eduverse/blob/main/lib/supabaseClient.ts) (Supabase client), [`app/teacher/dashboard/page.tsx`](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/page.tsx) (Teacher dashboard), [`app/teacher/dashboard/[classId]/learning-materials/page.tsx`](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/learning-materials/page.tsx) (Learning materials), [`app/student/dashboard/page.tsx`](https://github.com/srivathsanram/eduverse/blob/main/app/student/dashboard/page.tsx) (Student dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_teacher["Teacher tools"]
  node_teacher_dashboard["Teacher dashboard<br/>[page.tsx]"]
  node_class_create["Class creation<br/>[page.tsx]"]
  node_topic_editor["Topic flow editor<br/>[page.tsx]"]
  node_topic_flow["Flow visualization<br/>[TopicFlow.tsx]"]
  node_materials_manager["Learning materials<br/>[page.tsx]"]
  node_pdf_upload["PDF upload<br/>[PDFUploadArea.tsx]"]
  node_assignment_creator["Assignment creation<br/>[page.tsx]"]
  node_teacher_analytics["Class analytics<br/>[page.tsx]"]
  node_teacher_auth["Teacher sign-in<br/>[page.tsx]"]
end

subgraph group_student["Student learning"]
  node_student_dashboard["Student dashboard<br/>[page.tsx]"]
  node_class_learning["Class learning space<br/>[page.tsx]"]
  node_assignment_view["Assignment attempt<br/>[page.tsx]"]
  node_assignment_results["Assignment results<br/>[page.tsx]"]
  node_student_assignment["Assignment page<br/>[page.tsx]"]
  node_student_class["Class page<br/>[page.tsx]"]
  node_student_auth["Student sign-in<br/>[page.tsx]"]
end

subgraph group_platform["Shared platform"]
  node_supabase_client["Supabase client<br/>[supabaseClient.ts]"]
  node_supabase[("Supabase services")]
end

subgraph group_intelligence["Knowledge tracing"]
  node_kt_api["Prediction API<br/>[main.py]"]
  node_kt_models["Tracing models"]
  node_kt_training["Model training<br/>[train.py]"]
  node_kt_datasets["Dataset loaders"]
  node_kt_utils["Sequence utilities<br/>[utils.py]"]
end

node_teacher_actor(("Teacher"))
node_student_actor(("Student"))

node_teacher_actor -->|"opens tools"| node_teacher_dashboard
node_teacher_dashboard -->|"links to"| node_class_create
node_teacher_dashboard -->|"links to"| node_topic_editor
node_teacher_dashboard -->|"links to"| node_materials_manager
node_teacher_dashboard -->|"links to"| node_assignment_creator
node_teacher_dashboard -->|"links to"| node_teacher_analytics
node_topic_editor -->|"renders"| node_topic_flow
node_materials_manager -->|"uses"| node_pdf_upload
node_teacher_dashboard -->|"queries"| node_supabase_client
node_class_create -->|"writes class"| node_supabase_client
node_topic_flow -->|"loads and saves flow"| node_supabase_client
node_materials_manager -->|"manages materials"| node_supabase_client
node_assignment_creator -->|"creates assignment"| node_supabase_client
node_student_actor -->|"opens classes"| node_student_dashboard
node_student_dashboard -->|"opens class"| node_class_learning
node_class_learning -->|"opens assignment"| node_assignment_view
node_student_actor -->|"attempts work"| node_assignment_view
node_student_dashboard -->|"joins and lists classes"| node_supabase_client
node_class_learning -->|"loads class content"| node_supabase_client
node_assignment_view -->|"loads and records work"| node_supabase_client
node_assignment_results -->|"loads results"| node_supabase_client
node_student_assignment -->|"uses backend"| node_supabase_client
node_student_class -->|"uses backend"| node_supabase_client
node_teacher_auth -->|"authenticates"| node_supabase_client
node_student_auth -->|"authenticates"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_kt_api -->|"runs DKT variants"| node_kt_models
node_kt_training -->|"loads datasets"| node_kt_datasets
node_kt_training -->|"trains models"| node_kt_models
node_kt_datasets -->|"segments sequences"| node_kt_utils

click node_teacher_dashboard "https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/page.tsx"
click node_class_create "https://github.com/srivathsanram/eduverse/blob/main/app/teacher/create-class/page.tsx"
click node_topic_editor "https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/edit-flow/page.tsx"
click node_topic_flow "https://github.com/srivathsanram/eduverse/blob/main/components/TopicFlow.tsx"
click node_materials_manager "https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/learning-materials/page.tsx"
click node_pdf_upload "https://github.com/srivathsanram/eduverse/blob/main/components/PDFUploadArea.tsx"
click node_assignment_creator "https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/create-assignment/page.tsx"
click node_teacher_analytics "https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/analytics/page.tsx"
click node_student_dashboard "https://github.com/srivathsanram/eduverse/blob/main/app/student/dashboard/page.tsx"
click node_class_learning "https://github.com/srivathsanram/eduverse/blob/main/app/student/dashboard/%5BclassId%5D/page.tsx"
click node_assignment_view "https://github.com/srivathsanram/eduverse/blob/main/app/student/dashboard/%5BclassId%5D/assignments/%5BassignmentId%5D/page.tsx"
click node_assignment_results "https://github.com/srivathsanram/eduverse/blob/main/app/student/assignment/%5BassignmentId%5D/results/page.tsx"
click node_student_assignment "https://github.com/srivathsanram/eduverse/blob/main/app/student/assignment/%5BassignmentId%5D/page.tsx"
click node_student_class "https://github.com/srivathsanram/eduverse/blob/main/app/student/class/%5BclassId%5D/page.tsx"
click node_teacher_auth "https://github.com/srivathsanram/eduverse/blob/main/app/teacher/auth/page.tsx"
click node_student_auth "https://github.com/srivathsanram/eduverse/blob/main/app/student/auth/page.tsx"
click node_supabase_client "https://github.com/srivathsanram/eduverse/blob/main/lib/supabaseClient.ts"
click node_kt_api "https://github.com/srivathsanram/eduverse/blob/main/kt_models/main.py"
click node_kt_models "https://github.com/srivathsanram/eduverse/tree/main/kt_models/models"
click node_kt_training "https://github.com/srivathsanram/eduverse/blob/main/kt_models/train.py"
click node_kt_datasets "https://github.com/srivathsanram/eduverse/tree/main/kt_models/data_loaders"
click node_kt_utils "https://github.com/srivathsanram/eduverse/blob/main/kt_models/models/utils.py"

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_teacher_dashboard,node_class_create,node_topic_editor,node_topic_flow,node_materials_manager,node_pdf_upload,node_assignment_creator,node_teacher_analytics,node_teacher_auth toneBlue
class node_student_dashboard,node_class_learning,node_assignment_view,node_assignment_results,node_student_assignment,node_student_class,node_student_auth toneAmber
class node_supabase_client,node_supabase toneMint
class node_kt_api,node_kt_models,node_kt_training,node_kt_datasets,node_kt_utils toneRose
class node_teacher_actor,node_student_actor toneIndigo
```

## Components

### Teacher tools

- [Teacher dashboard](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/page.tsx): `app/teacher/dashboard/page.tsx`
- [Class creation](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/create-class/page.tsx): `app/teacher/create-class/page.tsx`
- [Topic flow editor](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/edit-flow/page.tsx): `app/teacher/dashboard/[classId]/edit-flow/page.tsx`
- [Flow visualization](https://github.com/srivathsanram/eduverse/blob/main/components/TopicFlow.tsx): `components/TopicFlow.tsx`
- [Learning materials](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/learning-materials/page.tsx): `app/teacher/dashboard/[classId]/learning-materials/page.tsx`
- [PDF upload](https://github.com/srivathsanram/eduverse/blob/main/components/PDFUploadArea.tsx): `components/PDFUploadArea.tsx`
- [Assignment creation](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/create-assignment/page.tsx): `app/teacher/dashboard/[classId]/create-assignment/page.tsx`
- [Class analytics](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/dashboard/%5BclassId%5D/analytics/page.tsx): `app/teacher/dashboard/[classId]/analytics/page.tsx`
- [Teacher sign-in](https://github.com/srivathsanram/eduverse/blob/main/app/teacher/auth/page.tsx): `app/teacher/auth/page.tsx`

### Student learning

- [Student dashboard](https://github.com/srivathsanram/eduverse/blob/main/app/student/dashboard/page.tsx): `app/student/dashboard/page.tsx`
- [Class learning space](https://github.com/srivathsanram/eduverse/blob/main/app/student/dashboard/%5BclassId%5D/page.tsx): `app/student/dashboard/[classId]/page.tsx`
- [Assignment attempt](https://github.com/srivathsanram/eduverse/blob/main/app/student/dashboard/%5BclassId%5D/assignments/%5BassignmentId%5D/page.tsx): `app/student/dashboard/[classId]/assignments/[assignmentId]/page.tsx`
- [Assignment results](https://github.com/srivathsanram/eduverse/blob/main/app/student/assignment/%5BassignmentId%5D/results/page.tsx): `app/student/assignment/[assignmentId]/results/page.tsx`
- [Assignment page](https://github.com/srivathsanram/eduverse/blob/main/app/student/assignment/%5BassignmentId%5D/page.tsx): `app/student/assignment/[assignmentId]/page.tsx`
- [Class page](https://github.com/srivathsanram/eduverse/blob/main/app/student/class/%5BclassId%5D/page.tsx): `app/student/class/[classId]/page.tsx`
- [Student sign-in](https://github.com/srivathsanram/eduverse/blob/main/app/student/auth/page.tsx): `app/student/auth/page.tsx`

### Shared platform

- [Supabase client](https://github.com/srivathsanram/eduverse/blob/main/lib/supabaseClient.ts): `lib/supabaseClient.ts`
- **Supabase services**

### Knowledge tracing

- [Prediction API](https://github.com/srivathsanram/eduverse/blob/main/kt_models/main.py): `kt_models/main.py`
- [Tracing models](https://github.com/srivathsanram/eduverse/tree/main/kt_models/models): `kt_models/models`
- [Model training](https://github.com/srivathsanram/eduverse/blob/main/kt_models/train.py): `kt_models/train.py`
- [Dataset loaders](https://github.com/srivathsanram/eduverse/tree/main/kt_models/data_loaders): `kt_models/data_loaders`
- [Sequence utilities](https://github.com/srivathsanram/eduverse/blob/main/kt_models/models/utils.py): `kt_models/models/utils.py`

### Other components

- **Teacher**
- **Student**

## Connections

- Teacher → Teacher dashboard: opens tools (evidence: `app/teacher/dashboard/page.tsx`)
- Teacher dashboard → Class creation: links to (evidence: `app/teacher/dashboard/page.tsx`)
- Teacher dashboard → Topic flow editor: links to (evidence: `app/teacher/dashboard/page.tsx`)
- Teacher dashboard → Learning materials: links to (evidence: `app/teacher/dashboard/page.tsx`)
- Teacher dashboard → Assignment creation: links to (evidence: `app/teacher/dashboard/page.tsx`)
- Teacher dashboard → Class analytics: links to (evidence: `app/teacher/dashboard/page.tsx`)
- Topic flow editor → Flow visualization: renders (evidence: `app/teacher/dashboard/[classId]/edit-flow/page.tsx`)
- Learning materials → PDF upload: uses (evidence: `app/teacher/dashboard/[classId]/learning-materials/page.tsx`)
- Teacher dashboard → Supabase client: queries (evidence: `app/teacher/dashboard/page.tsx`)
- Class creation → Supabase client: writes class (evidence: `app/teacher/create-class/page.tsx`)
- Flow visualization → Supabase client: loads and saves flow (evidence: `components/TopicFlow.tsx`)
- Learning materials → Supabase client: manages materials (evidence: `app/teacher/dashboard/[classId]/learning-materials/page.tsx`)
- Assignment creation → Supabase client: creates assignment (evidence: `app/teacher/dashboard/[classId]/create-assignment/page.tsx`)
- Student → Student dashboard: opens classes (evidence: `app/student/dashboard/page.tsx`)
- Student dashboard → Class learning space: opens class (evidence: `app/student/dashboard/page.tsx`)
- Class learning space → Assignment attempt: opens assignment (evidence: `app/student/dashboard/[classId]/page.tsx`)
- Student → Assignment attempt: attempts work (evidence: `app/student/dashboard/[classId]/assignments/[assignmentId]/page.tsx`)
- Student dashboard → Supabase client: joins and lists classes (evidence: `app/student/dashboard/page.tsx`)
- Class learning space → Supabase client: loads class content (evidence: `app/student/dashboard/[classId]/page.tsx`)
- Assignment attempt → Supabase client: loads and records work (evidence: `app/student/dashboard/[classId]/assignments/[assignmentId]/page.tsx`)
- Assignment results → Supabase client: loads results (evidence: `app/student/assignment/[assignmentId]/results/page.tsx`)
- Assignment page → Supabase client: uses backend (evidence: `app/student/assignment/[assignmentId]/page.tsx`)
- Class page → Supabase client: uses backend (evidence: `app/student/class/[classId]/page.tsx`)
- Teacher sign-in → Supabase client: authenticates (evidence: `app/teacher/auth/page.tsx`)
- Student sign-in → Supabase client: authenticates (evidence: `app/student/auth/page.tsx`)
- Supabase client → Supabase services: connects to (evidence: `lib/supabaseClient.ts`)
- Prediction API → Tracing models: runs DKT variants (evidence: `kt_models/main.py`)
- Model training → Dataset loaders: loads datasets (evidence: `kt_models/train.py`)
- Model training → Tracing models: trains models (evidence: `kt_models/train.py`)
- Dataset loaders → Sequence utilities: segments sequences (evidence: `kt_models/data_loaders/statics2011.py`)
