# 24cs045jay/adaptive-learning-platform architecture

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

- Interactive diagram: https://gitdiagram.com/24cs045jay/adaptive-learning-platform
- Repository: https://github.com/24cs045jay/adaptive-learning-platform

## Overview

This tree is primarily an AI Tutor learning portal: students and staff use role-based workspaces for document-backed questions, study resources, quizzes, discussions, and administration. The sampled data context fetches backend data, and the Express entrypoint mounts domain APIs backed by Supabase models. The README instead describes a KMRL FastAPI scaffold and a human-reviewed document-action workflow; that conflicts with the sampled runtime and tree, so the graph follows the AI Tutor implementation. Several feature routes are unsampled, so their internal flows are not inferred.

Main entry points: [`routes`](https://github.com/24cs045jay/adaptive-learning-platform/tree/main/routes) (Learning endpoints), [`routes/auth.js`](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/routes/auth.js) (Auth endpoints), [`server.express.js`](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/server.express.js) (Express API), [`src/components/app-shell.tsx`](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/components/app-shell.tsx) (Role workspaces)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Portal"]
  node_web["Role workspaces<br/>[app-shell.tsx]"]
  node_authui["Client authentication<br/>[auth.tsx]"]
  node_authstore["Auth store<br/>[auth-store.ts]"]
  node_datactx["App data context"]
end

subgraph group_learning["Learning"]
  node_ask["Student questions<br/>[student.ask.tsx]"]
  node_rag["RAG engine<br/>[rag-engine.ts]"]
  node_study["Study features"]
  node_faculty["Faculty features<br/>[faculty.upload.tsx]"]
  node_admin["Administration<br/>[admin.users.tsx]"]
end

subgraph group_api["Backend APIs"]
  node_server["Express API<br/>[server.express.js]"]
  node_authroutes["Auth endpoints<br/>[auth.js]"]
  node_domainroutes["Learning endpoints"]
end

subgraph group_identity["Identity and storage"]
  node_guard["Auth middleware<br/>[auth.js]"]
  node_mailer["Email delivery<br/>[mailer.js]"]
  node_models["Supabase model layer<br/>[index.js]"]
  node_supabase[("Supabase<br/>[supabase.js]")]
end

node_learners(("Learners and staff"))

node_learners -.->|"use"| node_web
node_web -.->|"uses"| node_authui
node_web -.->|"uses"| node_datactx
node_authui -->|"delegates to"| node_authstore
node_datactx -->|"reads auth"| node_authui
node_datactx -->|"fetches API"| node_domainroutes
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_domainroutes
node_server -->|"connects"| node_supabase
node_authroutes -->|"uses"| node_models
node_authroutes -->|"uses"| node_guard
node_authroutes -->|"sends OTP"| node_mailer
node_guard -->|"loads user"| node_models
node_domainroutes -.->|"uses"| node_models
node_ask -.->|"queries"| node_rag
node_faculty -.->|"uses API"| node_domainroutes
node_study -.->|"uses API"| node_domainroutes
node_admin -.->|"uses API"| node_domainroutes

click node_web "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/components/app-shell.tsx"
click node_authui "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/lib/auth.tsx"
click node_authstore "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/lib/auth-store.ts"
click node_datactx "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/lib/app-data-context.tsx"
click node_ask "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/routes/student.ask.tsx"
click node_rag "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/lib/rag-engine.ts"
click node_study "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/routes/student.quizzes.tsx"
click node_faculty "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/routes/faculty.upload.tsx"
click node_admin "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/routes/admin.users.tsx"
click node_server "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/server.express.js"
click node_authroutes "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/routes/auth.js"
click node_domainroutes "https://github.com/24cs045jay/adaptive-learning-platform/tree/main/routes"
click node_guard "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/middleware/auth.js"
click node_mailer "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/lib/mailer.js"
click node_models "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/models/index.js"
click node_supabase "https://github.com/24cs045jay/adaptive-learning-platform/blob/main/db/supabase.js"

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_web,node_authui,node_authstore,node_datactx toneBlue
class node_ask,node_rag,node_study,node_faculty,node_admin toneAmber
class node_server,node_authroutes,node_domainroutes toneMint
class node_guard,node_mailer,node_models,node_supabase toneRose
class node_learners toneIndigo
```

## Components

### Portal

- [Role workspaces](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/components/app-shell.tsx): `src/components/app-shell.tsx`
- [Client authentication](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/lib/auth.tsx): `src/lib/auth.tsx`
- [Auth store](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/lib/auth-store.ts): `src/lib/auth-store.ts`
- [App data context](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/lib/app-data-context.tsx): `src/lib/app-data-context.tsx`

### Learning

- [Student questions](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/routes/student.ask.tsx): `src/routes/student.ask.tsx`
- [RAG engine](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/lib/rag-engine.ts): `src/lib/rag-engine.ts`
- [Study features](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/routes/student.quizzes.tsx): `src/routes/student.quizzes.tsx`
- [Faculty features](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/routes/faculty.upload.tsx): `src/routes/faculty.upload.tsx`
- [Administration](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/src/routes/admin.users.tsx): `src/routes/admin.users.tsx`

### Backend APIs

- [Express API](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/server.express.js): `server.express.js`
- [Auth endpoints](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/routes/auth.js): `routes/auth.js`
- [Learning endpoints](https://github.com/24cs045jay/adaptive-learning-platform/tree/main/routes): `routes`

### Identity and storage

- [Auth middleware](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/middleware/auth.js): `middleware/auth.js`
- [Email delivery](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/lib/mailer.js): `lib/mailer.js`
- [Supabase model layer](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/models/index.js): `models/index.js`
- [Supabase](https://github.com/24cs045jay/adaptive-learning-platform/blob/main/db/supabase.js): `db/supabase.js`

### Other components

- **Learners and staff**

## Connections

- Learners and staff → Role workspaces: use
- Role workspaces → Client authentication: uses (evidence: `src/components/app-shell.tsx`)
- Role workspaces → App data context: uses (evidence: `src/components/app-shell.tsx`)
- Client authentication → Auth store: delegates to (evidence: `src/lib/auth.tsx`)
- App data context → Client authentication: reads auth (evidence: `src/lib/app-data-context.tsx`)
- App data context → Learning endpoints: fetches API (evidence: `src/lib/app-data-context.tsx`)
- Express API → Auth endpoints: mounts (evidence: `server.express.js`)
- Express API → Learning endpoints: mounts (evidence: `server.express.js`)
- Express API → Supabase: connects (evidence: `server.express.js`)
- Auth endpoints → Supabase model layer: uses (evidence: `routes/auth.js`)
- Auth endpoints → Auth middleware: uses (evidence: `routes/auth.js`)
- Auth endpoints → Email delivery: sends OTP (evidence: `routes/auth.js`)
- Auth middleware → Supabase model layer: loads user (evidence: `middleware/auth.js`)
- Learning endpoints → Supabase model layer: uses (evidence: `routes/auth.js`)
- Student questions → RAG engine: queries
- Faculty features → Learning endpoints: uses API
- Study features → Learning endpoints: uses API
- Administration → Learning endpoints: uses API
