February 7, 2025
VLesson: AI-Powered Educational Platform
Key Features
- AI-Powered Tutoring Provides contextual explanations, step-by-step guidance, and learning support through a secure AI assistant connected to the platform backend.
- Student Progress & Analytics Tracks course progress, test results, grades, weak areas, and learning activity to provide better visibility into student performance.
- Role-Based Learning Environment Supports separate student, teacher, and admin experiences with protected routes, role-aware interfaces, and backend authorization checks.
- Testing & Assessment System Allows teachers to create and manage tests while students complete assessments with tracked attempts, scores, and submission history.
- AI Reports & Learning Insights Generates AI-assisted student reports and learning insights based on platform analytics and student performance data.
- Whiteboard & Vision AI Support Includes AI-assisted whiteboard and vision features for explaining, solving, and analyzing educational problems.
- Secure Storage & File Access Handles course and platform files through Supabase Storage and Cloudflare R2 integrations with authorization-aware access controls.
Technologies Used
- React, TypeScript & Vite Frontend application architecture with fast development builds and client-side routing.
- Node.js & Express.js Backend API gateway for authentication, authorization, AI requests, storage access, and server-side platform workflows.
- Supabase PostgreSQL Primary database with Row Level Security, policies, migrations, and structured relational data.
- Supabase Auth & JWT Gateway Secure authentication flow using access tokens, refresh sessions, protected routes, and backend role checks.
- AI Provider Integrations Multi-provider AI gateway for tutoring, reports, learning insights, whiteboard assistance, and model fallback.
- Supabase Storage & Cloudflare R2 File storage infrastructure for secure course materials and user-accessible assets.
- Tailwind CSS & Radix UI UI styling and accessible component primitives for a modern, responsive interface.
- Vitest & Playwright Automated testing setup for unit, integration, and end-to-end workflows.
Challenges and Learnings
- Building a JWT-based API gateway with refresh-session handling, role checks, ownership checks, and rate limits.
- Designing Supabase Row Level Security policies to protect student, teacher, admin, and service-level data access.
- Integrating AI tutoring and reporting through backend-controlled endpoints instead of exposing provider access directly from the frontend.
- Adding grounding and telemetry so AI responses can be connected to course context and reviewed for quality.
- Creating separate workflows for students, teachers, and administrators while keeping shared platform behavior consistent.
