How aalaswad275-byte/bloom-adapt-engine works
AdaptiveMind is an assessment and learning platform: instructors manage classes and author/share assessments; students take assessments and review outcomes; administrators oversee institutions and performance. The frontend is routed through a React/Convex application, with Convex providing backend functions and persisted state. Adaptive assessment logic and webcam proctoring are distinct runtime subsystems. The graph emphasizes documented routes and sampled imports; links from unsampled pages to backend functions are omitted rather than inferred.
Main entry points: main.tsx App routing · useExamMonitor.ts Exam monitoring hook · yoloClient.ts YOLO client · Auth.tsx Sign-in
Components 25
Assessment experience
- App routing
src/main.tsx - Sign-in
src/pages/Auth.tsx - Instructor portal
src/pages/InstructorPortal.tsx - Assessment authoring
src/pages/InstructorAssessments.tsx - Question editors
src/components/DragDropQuestionEditor.tsx - Shared questions
src/pages/SharedQuestions.tsx - Assessment details
src/pages/AssessmentDetails.tsx - Assessment taking
src/pages/TakeAssessment.tsx - Exam session
src/pages/Exam.tsx - Student results
src/pages/AssessmentResults.tsx
Backend and identity
- Convex backend
src/convex - Application data
src/convex/schema.ts - User functions
src/convex/users.ts - Auth hook
src/hooks/use-auth.ts
Adaptive and monitoring
- Adaptive IRT
src/lib/irt/engine.ts - Exam monitoring hook
src/hooks/useExamMonitor.ts - Violation engine
src/lib/monitoring/engine.ts - Browser detector
src/lib/monitoring/browserDetector.ts - YOLO client
src/lib/monitoring/yoloClient.ts - YOLO service
monitoring-service/app.py
Administration
- Admin console
src/pages/admin/AdminDashboard.tsx - Admin analytics
src/pages/admin/Analytics.tsx - Class performance
src/pages/ClassPerformanceReport.tsx
Other components
- Student
- Instructor
Connections 17
- Student → App routing: opens
src/main.tsx - Instructor → App routing: opens
src/main.tsx - App routing → Sign-in: routes
src/main.tsx - App routing → Exam session: routes
src/main.tsx - App routing → Instructor portal: routes
src/main.tsx - App routing → Class performance: routes
src/main.tsx - Sign-in → Auth hook: uses
src/pages/Auth.tsx - Auth hook → User functions: queries
src/hooks/use-auth.ts - Assessment authoring → Question editors: renders
src/pages/InstructorAssessments.tsx - Assessment details → Adaptive IRT: imports
src/pages/AssessmentDetails.tsx - Exam monitoring hook → Browser detector: uses
src/hooks/useExamMonitor.ts - Exam monitoring hook → YOLO client: uses
src/hooks/useExamMonitor.ts - Exam monitoring hook → Violation engine: uses
- YOLO client → YOLO service: sends detections
- YOLO client → Browser detector: falls back
- Convex backend → Application data: defines data
- Admin console → Admin analytics: offers