How ravadakaran/vertexleam-ai works
VertexLearn AI is a role-based learning management system. The main journey starts with sign-in, proceeds through instructor course creation and admin approval, then student enrollment and a persisted learning workspace with lessons and assessments. Separate capabilities include course-grounded AI tutoring, discussions, notifications, analytics, personalization, and gamification. The graph combines documented capabilities with relationships visible in excerpts and the source index; unsampled wiring is left out rather than inferred.
Main entry points: http.ts HTTP application · routes.ts Lessons and playback · CourseWorkspace.tsx Course workspace · learning Learning access and media
Components 34
Web experience
- Role navigation
frontend/src/routes/App.tsx - Workspace UI
frontend/src/layouts/Workspace.tsx - Sign-in UI
frontend/src/pages/auth/AuthForm.tsx - Session state
frontend/src/auth.ts - Web API client
frontend/src/api.ts - Course workspace
frontend/src/pages/CourseWorkspace.tsx - Learning dashboard
frontend/src/pages/Learning.tsx - Assessments UI
frontend/src/pages/Assessments.tsx - Admin panel
frontend/src/pages/AdminPanel.tsx - Course community UI
frontend/src/components/CourseCommunity.tsx
Identity and governance
- Authentication routes
backend/src/modules/auth/routes.ts - Authentication service
backend/src/modules/auth/service.ts - Governance routes
backend/src/modules/admin/routes.ts
Courses and learning
- Course catalog
backend/src/modules/courses/service.ts - Course routes
backend/src/modules/courses/routes.ts - Enrollment service
backend/src/modules/enrollments/service.ts - Lessons and playback
backend/src/modules/learning/routes.ts - Learning access and media
backend/src/modules/learning - Assignments
backend/src/modules/assignments/routes.ts - Quizzes
backend/src/modules/quizzes/routes.ts
Learning engagement
- AI tutor
backend/src/modules/ai/routes.ts - Mastery and recommendations
backend/src/modules/personalization/routes.ts - Discussions
backend/src/modules/discussions/routes.ts - Notifications
backend/src/modules/notifications/routes.ts - Awards and leaderboard
backend/src/modules/gamification/routes.ts - Analytics
backend/src/modules/analytics/routes.ts
Service platform
- HTTP application
backend/src/http.ts - Authentication middleware
backend/src/middleware/auth.ts - PostgreSQL
backend/src/db/index.ts - Cache and limits
backend/src/cache.ts - Event outbox
backend/src/jobs/outbox.ts
Other components
- Learner
- Instructor
- Administrator
Connections 48
- Learner → Sign-in UI: signs in
- Instructor → Sign-in UI: signs in
- Administrator → Sign-in UI: signs in
- Sign-in UI → Session state: updates session
frontend/src/pages/auth/AuthForm.tsx - Session state → Authentication routes: authenticates via
frontend/src/auth.ts - Role navigation → Session state: checks role
frontend/src/routes/App.tsx - Role navigation → Workspace UI: renders
frontend/src/routes/App.tsx - Workspace UI → Learning dashboard: hosts
- Workspace UI → Admin panel: hosts
- Learner → Learning dashboard: views learning
- Learning dashboard → Web API client: requests data
- Instructor → Course workspace: authors courses
README.md - Learner → Course workspace: studies course
README.md - Course workspace → Course community UI: renders
frontend/src/pages/CourseWorkspace.tsx - Course workspace → Assessments UI: renders
frontend/src/pages/CourseWorkspace.tsx - Course workspace → Web API client: requests data
frontend/src/pages/CourseWorkspace.tsx - Administrator → Admin panel: governs courses
README.md - Admin panel → Web API client: requests data
- Web API client → HTTP application: calls API
- HTTP application → Authentication routes: routes requests
backend/src/modules/auth/routes.ts - HTTP application → Course routes: routes requests
backend/src/modules/courses/routes.ts - HTTP application → Lessons and playback: routes requests
backend/src/modules/learning/routes.ts - HTTP application → Assignments: routes requests
backend/src/modules/assignments/routes.ts - HTTP application → Quizzes: routes requests
backend/src/modules/quizzes/routes.ts - HTTP application → AI tutor: routes requests
backend/src/modules/ai/routes.ts - HTTP application → Governance routes: routes requests
backend/src/modules/admin/routes.ts - HTTP application → Discussions: routes requests
backend/src/modules/discussions/routes.ts - HTTP application → Mastery and recommendations: routes requests
backend/src/modules/personalization/routes.ts - HTTP application → Notifications: routes requests
backend/src/modules/notifications/routes.ts - HTTP application → Awards and leaderboard: routes requests
backend/src/modules/gamification/routes.ts - HTTP application → Analytics: routes requests
backend/src/modules/analytics/routes.ts - Authentication routes → Authentication middleware: uses
backend/src/modules/auth/routes.ts - Authentication routes → Authentication service: delegates to
backend/src/modules/auth/routes.ts - Governance routes → PostgreSQL: queries
backend/src/modules/admin/routes.ts - Governance routes → Learning access and media: checks scope
backend/src/modules/admin/routes.ts - Course routes → Authentication middleware: uses
backend/src/modules/courses/routes.ts - Course routes → Course catalog: delegates to
backend/src/modules/courses/routes.ts - Course routes → Enrollment service: delegates to
backend/src/modules/courses/routes.ts - Lessons and playback → PostgreSQL: queries
backend/src/modules/learning/routes.ts - Lessons and playback → Course catalog: loads course view
backend/src/modules/learning/routes.ts - Lessons and playback → Learning access and media: checks scope
backend/src/modules/learning/routes.ts - Lessons and playback → PostgreSQL: stores playback
backend/src/modules/learning/routes.ts - Assignments → Learning access and media: checks scope
backend/src/modules/assignments/routes.ts - Assignments → Cache and limits: limits uploads
backend/src/modules/assignments/routes.ts - Quizzes → Learning access and media: checks scope
backend/src/modules/quizzes/routes.ts - Quizzes → PostgreSQL: stores attempts
backend/src/modules/quizzes/routes.ts - AI tutor → Learning access and media: checks course access
backend/src/modules/ai/routes.ts - AI tutor → PostgreSQL: stores tutor sessions
backend/src/modules/ai/routes.ts