How malakabubakkar33/webclass works
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: index.ts API route registry · database.ts Application data · authService.ts Auth services · AppRoutes.tsx Role-based pages
Components 30
Web application
- Web app shell
frontend/src/App.tsx - Role-based pages
frontend/src/routes/AppRoutes.tsx - Login and signup
frontend/src/pages/auth - Student portal
frontend/src/pages/student - Teacher portal
frontend/src/pages/teacher - Public course site
frontend/src/pages/public - API client
frontend/src/services/api.ts
Identity and access
- Session context
frontend/src/context/AuthContext.tsx - Auth endpoints
backend/src/routes/authRoutes.ts - Authentication
backend/src/controllers/authController.ts - Auth services
backend/src/services/authService.ts - JWT access control
backend/src/middlewares/authMiddleware.ts
Learning workflows
- Course and video APIs
backend/src/routes/courseRoutes.ts - Topics and lessons
backend/src/services/videoService.ts - Assignment workflow
backend/src/controllers/assignmentController.ts - Student learning data
backend/src/controllers/studentPortalController.ts
Class operations
- Student management
backend/src/controllers/studentController.ts - Attendance management
backend/src/controllers/attendanceController.ts - Attendance rules
backend/src/services/attendanceService.ts - Teacher dashboard
backend/src/controllers/teacherController.ts
Data and integrations
- API route registry
backend/src/routes/index.ts - Notifications
backend/src/services/notificationService.ts - Email delivery
backend/src/services/emailService.ts - Media storage
backend/src/services/storageService.ts - Application data
backend/src/config/database.ts - Supabase database
backend/src/services/supabaseDbService.ts - Express API
backend/src/app.ts
Other components
- Learner or teacher
- Supabase Storage
- Resend email
Connections 37
- Learner or teacher → Public course site: browses courses
README.md - Learner or teacher → Login and signup: signs in
README.md - Web app shell → Role-based pages: renders routes
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
frontend/src/context/AuthContext.tsx - Student portal → API client: requests learning data
README.md - Teacher portal → API client: requests management data
README.md - API client → Express API: calls REST API
README.md - Express API → API route registry: mounts routes
backend/src/app.ts - API route registry → Auth endpoints: registers endpoints
backend/src/routes/index.ts - Auth endpoints → Authentication: dispatches auth
- Authentication → Auth services: delegates auth
backend/src/services/authService.ts - Auth services → Application data: reads and writes
backend/src/services/authService.ts - Auth services → Supabase database: uses connected database
backend/src/services/authService.ts - Auth services → Notifications: triggers notifications
backend/src/services/authService.ts - Auth services → Email delivery: sends email
backend/src/services/authService.ts - Auth services → JWT access control: issues JWT
backend/src/services/authService.ts - API route registry → Course and video APIs: registers course routes
backend/src/routes/index.ts - Course and video APIs → Topics and lessons: dispatches lesson operations
- API route registry → Student management: registers student routes
backend/src/routes/index.ts - API route registry → Student learning data: registers student routes
- API route registry → Attendance management: registers attendance routes
backend/src/routes/index.ts - Attendance management → Attendance rules: uses attendance rules
backend/src/controllers/attendanceController.ts - API route registry → Teacher dashboard: registers teacher routes
backend/src/routes/index.ts - Attendance management → Application data: reads and writes
backend/src/controllers/attendanceController.ts - Student management → Application data: reads and writes
backend/src/controllers/studentController.ts - Student learning data → Application data: reads learning data
backend/src/controllers/studentPortalController.ts - Teacher dashboard → Application data: reads dashboard data
backend/src/controllers/teacherController.ts - Assignment workflow → Application data: stores submissions
backend/src/controllers/assignmentController.ts - Assignment workflow → Media storage: uploads submissions
backend/src/controllers/assignmentController.ts - Assignment workflow → Notifications: notifies users
backend/src/controllers/assignmentController.ts - Media storage → Supabase Storage: uploads media
backend/src/services/storageService.ts - Email delivery → Resend email: delivers messages
- Application data → Supabase database: syncs records
backend/src/config/database.ts