Purpose & Project Mission
The Problem in EdTech
Most Learning Management Systems (LMS) are built for higher education or corporate compliance—dry, bureaucratic, and detached from how kids actually engage with technology. Parents are often left in the dark with fragmented report cards, while teachers spend hours on administrative overhead instead of mentoring.
The ClassLoop Solution
ClassLoop reimagines the learning cycle as a continuous, gamified adventure. Abstract physics is taught through hands-on Roblox obstacle simulation, math logic through colorful 3D puzzles, and programming through real Python bots. Every homework submission triggers instant parent transparency and rubric feedback.
Current Features & Role Operations Guide
ClassLoop implements a strict 4-Role Isolation Architecture where each stakeholder receives a tailored experience.
1. Student Portal
/student• student@demo.com
- Dashboard Metrics: Enrolled courses, graded tasks count, average grade %, and next scheduled live session.
- Homework Portal (
/student/homework): Filter tasks by status (To Do, Under Review, Graded) and track deadlines. - Submission Workspace: Submit rich text responses, inspect rubric criteria, and read personalized teacher feedback.
- Class Schedule (
/student/schedule): Live timetable calendar with automated countdowns to interactive meetings.
2. Teacher Hub
/teacher• teacher@demo.com
- Classroom Cohorts (
/teacher/classes): Create cohorts, manage student rosters, and monitor live seat capacity. - Assignment Creator (
/teacher/homework): Publish homework with deadlines, rich instructions, and customized score scales. - Split-View Grading Suite: Inspect student submissions side-by-side, input numerical scores, and write formative feedback.
- Class Timetable (
/teacher/schedule): Overview of live sessions across all taught cohorts with direct meeting links.
3. Parent Visibility
/parent• parent@demo.com
- Family Dashboard: Aggregated completion percentage, average grades, and recent teacher remarks across all children.
- Child Report Cards (
/parent/children): Granular performance reports per child with complete assignment history and evaluation breakdown. - Consolidated Schedule (
/parent/schedule): Single unified calendar tracking upcoming live classes across all enrolled siblings.
4. Admin Operations
/admin• admin@demo.com
- Executive Dashboard: 12-Month responsive enrollment trajectory charts (
ResizeObserver), KPI tiles, and system shortcuts. - User Management (
/admin/users): Full user directory with role filters, masked UUIDs, and Parent-Student link modal. - Enrollment Manager (
/admin/enrollments): Direct course enrollment and optimistic status toggles (active,completed,cancelled,expired). - Platform Reports (
/admin/reports): Grading turnaround times and class completion metrics across cohorts.
Current Technology Stack
Future Expert Features Roadmap
Planned capability upgrades documented in `document-as-code/brainstorming/feature-backlog-roadmap.md`.
Supabase Storage & Attendance
Native PDF/DOCX homework file attachments, inline document previewer, and 1-click live class meeting launcher (Zoom / Google Meet) with attendance status (`Present`, `Absent`, `Late`).
Teacher-Parent Feed & PDF Reports
Direct formative feedback timeline for parents, plus automated server-side Student Report Card PDF generator with customized vector certificate designs.
WebSocket Alerts & XP Streaks
Real-time push notifications via Supabase Realtime WebSocket changes, learner weekly streak counters, and gamified achievement badges for milestones.
Enterprise System Design & Scalability Potential
Architectural strategies for scaling ClassLoop to 100,000+ concurrent learners across multiple schools and enterprise partners.
Multi-Tenant School Partitioning
Database schema tenant isolation (`tenant_id` / organization schemas) allowing white-label deployment for school districts, private academies, and franchise partners with custom subdomains (`school.ottodot.winamus.com`).
Distributed Caching & Rate Limiting (Redis)
Integration of Redis / Upstash at the Edge layer for caching dashboard KPIs, catalog query results, and sliding-window rate limiting on sensitive auth endpoints.
Event-Driven Worker Pipelines (BullMQ / Kafka)
Offloading heavy background tasks (batch email digest dispatch, PDF certificate rendering, automated AI homework transcription) to isolated background worker containers.
Observability & OpenTelemetry Tracing
Distributed tracing with OpenTelemetry, Prometheus metrics collection, Sentry real-time exception tracking, and structured audit logs for SOC2 compliance readiness.
Explore the Source Code
ClassLoop is built with clean architecture, strict TypeScript standards, and complete Document-as-Code development history.