How bharathrajgit/zerith-v1 works
Zerith (BehaviourLearn) is an AI-assisted DSA learning platform. Students register, take an adaptive diagnostic, receive a learning roadmap, and continue through lessons, assessments, and coding practice; institutions manage cohorts and review analytics and malpractice reports. Monitoring spans browser and vision signals, with ML-backed analysis and a heuristic fallback. The graph emphasizes documented routing and sampled calls; other README-listed screens are grouped by capability where their implementation was not sampled.
Main entry points: index.js API server · diagnosticController.js Adaptive diagnostic · coding.controller.js Coding practice · monitoringService.js Monitoring orchestration
Components 26
Learning client
- Web application
client/src/App.jsx - Student learning
client/src/pages/student - Institution portal
client/src/pages/institution - Practice monitoring UI
client/src/hooks/usePracticeMonitoring.js - Monitoring API client
client/src/services/monitoringService.js
Platform API
- API server
server/index.js - Student authentication
server/middleware/auth.middleware.js - User profiles
server/models/User.js - Learning progress
server/models/Progress.js - Topics
server/models/Topic.js - Diagnostic sessions
server/models/DiagnosticSession.js
Learning services
- Adaptive diagnostic
server/controllers/diagnosticController.js - Coding practice
server/controllers/coding.controller.js - Progression and roadmap
server/services/progressionService.js - Assessments and lessons
server/controllers/assessment.controller.js - Institution operations
server/controllers/institution.analytics.controller.js
Monitoring
- Monitoring orchestration
server/services/monitoringService.js - Malpractice rules
server/services/antiMalpractice.js - Monitoring sessions
server/models/MonitoringSession.js - Malpractice records
server/models/MalpracticeLog.js
ML services
- ML service bridge
server/services/mlService.js - ML runtime
ml-service/app.py - Diagnostic models
ml-service/diagnostic_model.py
Other components
- Student
- Institution user
- Code judge
Connections 31
- Student → Web application: uses
client/src/App.jsx - Institution user → Web application: uses
client/src/App.jsx - Web application → Student learning: routes to
client/src/App.jsx - Web application → Institution portal: routes to
client/src/App.jsx - Student learning → API server: requests data
- Institution portal → API server: requests data
- API server → Student authentication: protects routes
- API server → Adaptive diagnostic: routes requests
server/index.js - API server → Coding practice: routes requests
server/index.js - API server → Monitoring orchestration: routes requests
server/index.js - API server → Institution operations: routes requests
server/index.js - Adaptive diagnostic → Diagnostic sessions: creates sessions
server/controllers/diagnosticController.js - Adaptive diagnostic → User profiles: updates profile
server/controllers/diagnosticController.js - Adaptive diagnostic → Progression and roadmap: generates roadmap
server/controllers/diagnosticController.js - Adaptive diagnostic → ML service bridge: classifies diagnostic
server/controllers/diagnosticController.js - Coding practice → Learning progress: reads and updates
server/controllers/coding.controller.js - Coding practice → Progression and roadmap: checks progression
server/controllers/coding.controller.js - Coding practice → ML service bridge: analyzes frames
server/controllers/coding.controller.js - Coding practice → Code judge: runs submissions
- Progression and roadmap → Learning progress: reads progress
server/services/roadmapGenerator.js - Progression and roadmap → Topics: reads topics
server/services/roadmapGenerator.js - Assessments and lessons → Learning progress: updates results
- Institution operations → User profiles: reads student data
- Practice monitoring UI → Monitoring API client: sends signals
client/src/hooks/usePracticeMonitoring.js - Monitoring API client → API server: calls monitoring API
client/src/services/monitoringService.js - Monitoring orchestration → Monitoring sessions: records sessions
server/services/monitoringService.js - Monitoring orchestration → Malpractice records: records evidence
server/services/monitoringService.js - Monitoring orchestration → Malpractice rules: applies rules
server/services/monitoringService.js - Monitoring orchestration → ML service bridge: analyzes vision
- ML service bridge → ML runtime: calls ML endpoints
server/services/mlService.js - ML runtime → Diagnostic models: loads diagnostic model
ml-service/app.py