How gallikattip-pixel/adaptive-learning works
This repository implements an adaptive-learning product: students authenticate, complete diagnostics, and view personalized skills, pathways, practice, and progress. The browser UI calls an Express backend, which combines assessment and student-state services with a five-model ML gateway to produce learning plans. The gateway’s orchestration and model stages are shown from sampled source. Many route handlers and UI sections are only indexed, so uncertain connections are omitted or marked unverified; the README is a Vite template and documents no product capabilities.
Main entry points: pipeline.py Plan orchestrator · prerequisiteEngine.ts Prerequisite engine · AppRoutes.tsx Web routes · StudentDashboardPage.tsx Student dashboard
Components 24
Student experience
- Web routes
src/routes/AppRoutes.tsx - Authentication UI
src/pages/auth - Auth state
src/hooks/useAuth.ts - Auth client
src/services/auth/authService.ts - Student dashboard
src/pages/student/StudentDashboardPage.tsx - Learning overview
src/components/student/OverviewSection.tsx - API client
src/services/api/apiClient.ts
Application backend
- Express server
backend/src/server.ts - API routes
backend/src/routes
Learning services
- Assessment service
backend/src/services/diagnosticService.ts - Assessment repository
backend/src/repositories/assessmentRepository.ts - Student state aggregation
backend/src/services/stateAggregator.ts - Prerequisite engine
backend/src/services/prerequisiteEngine.ts - Video resources
backend/src/services/youtubeService.ts - ML gateway client
backend/src/services/mlGateway.ts
ML gateway
- Gateway API
ML-SYSTEM/ml-gateway/app.py - Plan orchestrator
ML-SYSTEM/ml-gateway/orchestrator/pipeline.py - Interest model
ML-SYSTEM/ml-gateway/adapters/model5_adapter.py - Skill-gap model
ML-SYSTEM/ml-gateway/adapters/model1_adapter.py - Mastery model
ML-SYSTEM/ml-gateway/adapters/model2_adapter.py - Recommendation model
ML-SYSTEM/ml-gateway/adapters/model3_adapter.py - Risk model
ML-SYSTEM/ml-gateway/adapters/model4_adapter.py - Plan contracts
ML-SYSTEM/ml-gateway/schemas/contracts.py
Other components
- Student
Connections 23
- Student → Web routes: uses
src/routes/AppRoutes.tsx - Web routes → Authentication UI: routes to
src/routes/AppRoutes.tsx - Web routes → Student dashboard: routes to
src/routes/AppRoutes.tsx - Authentication UI → Auth state: uses auth state
src/pages/auth/SignUpPage.tsx - Auth state → Auth client: delegates to
src/hooks/useAuth.ts - Auth client → API client: calls
src/services/auth/authService.ts - Student dashboard → API client: requests data
src/pages/student/StudentDashboardPage.tsx - Student dashboard → Learning overview: renders
src/pages/student/StudentDashboardPage.tsx - API client → Express server: HTTP requests
- Express server → API routes: mounts
backend/src/server.ts - API routes → Assessment service: dispatches
- Assessment service → Assessment repository: reads and writes
backend/src/services/diagnosticService.ts - Prerequisite engine → Student state aggregation: builds student input
backend/src/services/prerequisiteEngine.ts - Prerequisite engine → ML gateway client: requests plan
backend/src/services/prerequisiteEngine.ts - Prerequisite engine → Assessment repository: reads assessment data
- Gateway API → Plan orchestrator: invokes
ML-SYSTEM/ml-gateway/app.py - Plan orchestrator → Interest model: predicts
ML-SYSTEM/ml-gateway/orchestrator/pipeline.py - Plan orchestrator → Skill-gap model: predicts
ML-SYSTEM/ml-gateway/orchestrator/pipeline.py - Plan orchestrator → Mastery model: predicts
ML-SYSTEM/ml-gateway/orchestrator/pipeline.py - Plan orchestrator → Recommendation model: predicts
ML-SYSTEM/ml-gateway/orchestrator/pipeline.py - Plan orchestrator → Risk model: predicts
ML-SYSTEM/ml-gateway/orchestrator/pipeline.py - Plan orchestrator → Plan contracts: returns plan
ML-SYSTEM/ml-gateway/orchestrator/pipeline.py - ML gateway client → Gateway API: HTTP integration