# malakabubakkar33/webclass architecture

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

- Interactive diagram: https://gitdiagram.com/malakabubakkar33/webclass
- Repository: https://github.com/malakabubakkar33/webclass

## Overview

WebCraft LMS is a classroom learning platform for one teacher and multiple students. Users enter through the public site or unified login; authenticated students consume courses, lessons, assignments, and attendance, while the teacher manages course content, submissions, attendance, and the roster. The frontend calls a REST API; backend routes dispatch to controllers and services that use persistent data and external storage and messaging. The README documents several capabilities whose individual implementation files were not sampled, so those branches are shown at subsystem level where the tree supports them.

Main entry points: [`backend/src/routes/index.ts`](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/routes/index.ts) (API route registry), [`backend/src/config/database.ts`](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/config/database.ts) (Application data), [`backend/src/services/authService.ts`](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/authService.ts) (Auth services), [`frontend/src/routes/AppRoutes.tsx`](https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/routes/AppRoutes.tsx) (Role-based pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Web app shell<br/>[App.tsx]"]
  node_routes["Role-based pages<br/>[AppRoutes.tsx]"]
  node_authui["Login and signup"]
  node_studentui["Student portal"]
  node_teacherui["Teacher portal"]
  node_publicui["Public course site"]
  node_clientapi["API client<br/>[api.ts]"]
end

subgraph group_identity["Identity and access"]
  node_clientauth["Session context<br/>[AuthContext.tsx]"]
  node_authroutes["Auth endpoints<br/>[authRoutes.ts]"]
  node_authctrl["Authentication<br/>[authController.ts]"]
  node_authsvc["Auth services<br/>[authService.ts]"]
  node_authguard["JWT access control<br/>[authMiddleware.ts]"]
end

subgraph group_learning["Learning workflows"]
  node_coursecontent["Course and video APIs<br/>[courseRoutes.ts]"]
  node_topicvideo["Topics and lessons<br/>[videoService.ts]"]
  node_assignments["Assignment workflow"]
  node_studentportal["Student learning data"]
end

subgraph group_operations["Class operations"]
  node_studentops["Student management"]
  node_attendance["Attendance management"]
  node_attservice["Attendance rules"]
  node_teacherops["Teacher dashboard"]
end

subgraph group_platform["Data and integrations"]
  node_approutes["API route registry<br/>[index.ts]"]
  node_notifications["Notifications"]
  node_email["Email delivery<br/>[emailService.ts]"]
  node_storage["Media storage<br/>[storageService.ts]"]
  node_database[("Application data<br/>[database.ts]")]
  node_supabase[("Supabase database")]
  node_api["Express API<br/>[app.ts]"]
end

node_visitor(("Learner or teacher"))
node_supastorage[("Supabase Storage")]
node_resend["Resend email"]

node_visitor -->|"browses courses"| node_publicui
node_visitor -->|"signs in"| node_authui
node_app -->|"renders routes"| node_routes
node_routes -.->|"routes users"| node_authui
node_routes -.->|"routes students"| node_studentui
node_routes -.->|"routes teachers"| node_teacherui
node_authui -.->|"establishes session"| node_clientauth
node_clientauth -->|"uses API"| node_clientapi
node_studentui -->|"requests learning data"| node_clientapi
node_teacherui -->|"requests management data"| node_clientapi
node_clientapi -->|"calls REST API"| node_api
node_api -->|"mounts routes"| node_approutes
node_approutes -->|"registers endpoints"| node_authroutes
node_authroutes -.->|"dispatches auth"| node_authctrl
node_authctrl -.->|"delegates auth"| node_authsvc
node_authsvc -->|"reads and writes"| node_database
node_authsvc -->|"uses connected database"| node_supabase
node_authsvc -->|"triggers notifications"| node_notifications
node_authsvc -->|"sends email"| node_email
node_authsvc -->|"issues JWT"| node_authguard
node_approutes -->|"registers course routes"| node_coursecontent
node_coursecontent -.->|"dispatches lesson operations"| node_topicvideo
node_approutes -->|"registers student routes"| node_studentops
node_approutes -->|"registers student routes"| node_studentportal
node_approutes -->|"registers attendance routes"| node_attendance
node_attendance -->|"uses attendance rules"| node_attservice
node_approutes -->|"registers teacher routes"| node_teacherops
node_attendance -->|"reads and writes"| node_database
node_studentops -->|"reads and writes"| node_database
node_studentportal -->|"reads learning data"| node_database
node_teacherops -->|"reads dashboard data"| node_database
node_assignments -->|"stores submissions"| node_database
node_assignments -->|"uploads submissions"| node_storage
node_assignments -->|"notifies users"| node_notifications
node_storage -->|"uploads media"| node_supastorage
node_email -.->|"delivers messages"| node_resend
node_database -->|"syncs records"| node_supabase

click node_app "https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/App.tsx"
click node_routes "https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/routes/AppRoutes.tsx"
click node_authui "https://github.com/malakabubakkar33/webclass/tree/main/frontend/src/pages/auth"
click node_studentui "https://github.com/malakabubakkar33/webclass/tree/main/frontend/src/pages/student"
click node_teacherui "https://github.com/malakabubakkar33/webclass/tree/main/frontend/src/pages/teacher"
click node_publicui "https://github.com/malakabubakkar33/webclass/tree/main/frontend/src/pages/public"
click node_clientauth "https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/context/AuthContext.tsx"
click node_clientapi "https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/services/api.ts"
click node_approutes "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/routes/index.ts"
click node_authroutes "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/routes/authRoutes.ts"
click node_authctrl "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/authController.ts"
click node_authsvc "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/authService.ts"
click node_authguard "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/middlewares/authMiddleware.ts"
click node_coursecontent "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/routes/courseRoutes.ts"
click node_topicvideo "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/videoService.ts"
click node_assignments "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/assignmentController.ts"
click node_studentops "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/studentController.ts"
click node_studentportal "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/studentPortalController.ts"
click node_attendance "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/attendanceController.ts"
click node_attservice "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/attendanceService.ts"
click node_teacherops "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/teacherController.ts"
click node_notifications "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/notificationService.ts"
click node_email "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/emailService.ts"
click node_storage "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/storageService.ts"
click node_database "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/config/database.ts"
click node_supabase "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/supabaseDbService.ts"
click node_api "https://github.com/malakabubakkar33/webclass/blob/main/backend/src/app.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_authui,node_studentui,node_teacherui,node_publicui,node_clientapi toneBlue
class node_clientauth,node_authroutes,node_authctrl,node_authsvc,node_authguard,node_supastorage toneAmber
class node_coursecontent,node_topicvideo,node_assignments,node_studentportal toneMint
class node_studentops,node_attendance,node_attservice,node_teacherops toneRose
class node_approutes,node_notifications,node_email,node_storage,node_database,node_supabase,node_api,node_visitor,node_resend toneIndigo
```

## Components

### Web application

- [Web app shell](https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Role-based pages](https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/routes/AppRoutes.tsx): `frontend/src/routes/AppRoutes.tsx`
- [Login and signup](https://github.com/malakabubakkar33/webclass/tree/main/frontend/src/pages/auth): `frontend/src/pages/auth`
- [Student portal](https://github.com/malakabubakkar33/webclass/tree/main/frontend/src/pages/student): `frontend/src/pages/student`
- [Teacher portal](https://github.com/malakabubakkar33/webclass/tree/main/frontend/src/pages/teacher): `frontend/src/pages/teacher`
- [Public course site](https://github.com/malakabubakkar33/webclass/tree/main/frontend/src/pages/public): `frontend/src/pages/public`
- [API client](https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Identity and access

- [Session context](https://github.com/malakabubakkar33/webclass/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Auth endpoints](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/routes/authRoutes.ts): `backend/src/routes/authRoutes.ts`
- [Authentication](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/authController.ts): `backend/src/controllers/authController.ts`
- [Auth services](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/authService.ts): `backend/src/services/authService.ts`
- [JWT access control](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/middlewares/authMiddleware.ts): `backend/src/middlewares/authMiddleware.ts`

### Learning workflows

- [Course and video APIs](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/routes/courseRoutes.ts): `backend/src/routes/courseRoutes.ts`
- [Topics and lessons](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/videoService.ts): `backend/src/services/videoService.ts`
- [Assignment workflow](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/assignmentController.ts): `backend/src/controllers/assignmentController.ts`
- [Student learning data](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/studentPortalController.ts): `backend/src/controllers/studentPortalController.ts`

### Class operations

- [Student management](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/studentController.ts): `backend/src/controllers/studentController.ts`
- [Attendance management](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/attendanceController.ts): `backend/src/controllers/attendanceController.ts`
- [Attendance rules](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/attendanceService.ts): `backend/src/services/attendanceService.ts`
- [Teacher dashboard](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/controllers/teacherController.ts): `backend/src/controllers/teacherController.ts`

### Data and integrations

- [API route registry](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/routes/index.ts): `backend/src/routes/index.ts`
- [Notifications](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/notificationService.ts): `backend/src/services/notificationService.ts`
- [Email delivery](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/emailService.ts): `backend/src/services/emailService.ts`
- [Media storage](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/storageService.ts): `backend/src/services/storageService.ts`
- [Application data](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/config/database.ts): `backend/src/config/database.ts`
- [Supabase database](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/services/supabaseDbService.ts): `backend/src/services/supabaseDbService.ts`
- [Express API](https://github.com/malakabubakkar33/webclass/blob/main/backend/src/app.ts): `backend/src/app.ts`

### Other components

- **Learner or teacher**
- **Supabase Storage**
- **Resend email**

## Connections

- Learner or teacher → Public course site: browses courses (evidence: `README.md`)
- Learner or teacher → Login and signup: signs in (evidence: `README.md`)
- Web app shell → Role-based pages: renders routes (evidence: `frontend/src/App.tsx`)
- Role-based pages → Login and signup: routes users
- Role-based pages → Student portal: routes students
- Role-based pages → Teacher portal: routes teachers
- Login and signup → Session context: establishes session
- Session context → API client: uses API (evidence: `frontend/src/context/AuthContext.tsx`)
- Student portal → API client: requests learning data (evidence: `README.md`)
- Teacher portal → API client: requests management data (evidence: `README.md`)
- API client → Express API: calls REST API (evidence: `README.md`)
- Express API → API route registry: mounts routes (evidence: `backend/src/app.ts`)
- API route registry → Auth endpoints: registers endpoints (evidence: `backend/src/routes/index.ts`)
- Auth endpoints → Authentication: dispatches auth
- Authentication → Auth services: delegates auth (evidence: `backend/src/services/authService.ts`)
- Auth services → Application data: reads and writes (evidence: `backend/src/services/authService.ts`)
- Auth services → Supabase database: uses connected database (evidence: `backend/src/services/authService.ts`)
- Auth services → Notifications: triggers notifications (evidence: `backend/src/services/authService.ts`)
- Auth services → Email delivery: sends email (evidence: `backend/src/services/authService.ts`)
- Auth services → JWT access control: issues JWT (evidence: `backend/src/services/authService.ts`)
- API route registry → Course and video APIs: registers course routes (evidence: `backend/src/routes/index.ts`)
- Course and video APIs → Topics and lessons: dispatches lesson operations
- API route registry → Student management: registers student routes (evidence: `backend/src/routes/index.ts`)
- API route registry → Student learning data: registers student routes
- API route registry → Attendance management: registers attendance routes (evidence: `backend/src/routes/index.ts`)
- Attendance management → Attendance rules: uses attendance rules (evidence: `backend/src/controllers/attendanceController.ts`)
- API route registry → Teacher dashboard: registers teacher routes (evidence: `backend/src/routes/index.ts`)
- Attendance management → Application data: reads and writes (evidence: `backend/src/controllers/attendanceController.ts`)
- Student management → Application data: reads and writes (evidence: `backend/src/controllers/studentController.ts`)
- Student learning data → Application data: reads learning data (evidence: `backend/src/controllers/studentPortalController.ts`)
- Teacher dashboard → Application data: reads dashboard data (evidence: `backend/src/controllers/teacherController.ts`)
- Assignment workflow → Application data: stores submissions (evidence: `backend/src/controllers/assignmentController.ts`)
- Assignment workflow → Media storage: uploads submissions (evidence: `backend/src/controllers/assignmentController.ts`)
- Assignment workflow → Notifications: notifies users (evidence: `backend/src/controllers/assignmentController.ts`)
- Media storage → Supabase Storage: uploads media (evidence: `backend/src/services/storageService.ts`)
- Email delivery → Resend email: delivers messages
- Application data → Supabase database: syncs records (evidence: `backend/src/config/database.ts`)
