How ciannnnnn/hackathon_2026 works
EduPulse AI is a role-based student-support platform. Teachers record dated academic snapshots; Laravel assesses support needs, persists results, and serves teacher analysis and student dashboards. Administrators provision accounts, while students review progress and study plans. Laravel is the public application and coordinates MySQL and the private ML/RAG services. The README also describes Gemini tutoring, PDF materials, and quizzes, but those implementations are not present in the supplied tree; those branches are shown as documented integrations. Some internal links rely on the SOURCE INDEX or README rather than inspected implementation excerpts.
Main entry points: web.php Web routes · DashboardDataService.php Dashboard data · AccountProvisioningService.php Account provisioning · StudentPerformance.php Performance snapshots
Components 31
Laravel application
- Web routes
web/routes/web.php - Teacher dashboard
web/app/Http/Controllers/TeacherDashboardController.php - Student dashboard
web/app/Http/Controllers/StudentDashboardController.php - Teacher student views
web/app/Http/Controllers/TeacherStudentController.php - MySQL database
Academic support
- Student records
web/app/Models/Student.php - Performance snapshots
web/app/Models/StudentPerformance.php - Support analysis
web/app/Models/StudentSupportAnalysis.php - Support assessment
web/app/Services/AcademicSupportAssessmentService.php - Teacher student analysis
web/app/Services/TeacherStudentService.php - Performance recording
web/app/Http/Controllers/StudentPerformanceController.php - Dashboard data
web/app/Services/DashboardDataService.php
Accounts and access
- Session authentication
web/app/Http/Controllers/Auth/AuthenticatedSessionController.php - Student registration
web/app/Http/Controllers/Auth/RegisteredStudentController.php - Account provisioning
web/app/Services/AccountProvisioningService.php - User administration
web/app/Http/Controllers/AdminUserController.php - Role authorization
web/app/Http/Middleware/EnsureUserHasRole.php - User accounts
web/app/Models/User.php
ML service
- ML client
web/app/Services/MachineLearningService.php - Prediction API
ml-service/app.py - Classifier inference
ml-service/prediction.py - Feature preparation
ml-service/features.py
Learning integrations
- PDF retrieval service
- Gemini AI
- Teacher learning materials
- Grounded AI tutor
- Generated quizzes
- Personalized study plans
Other components
- Teacher
- Student
- Administrator
Connections 38
- Teacher → Web routes: uses
web/routes/web.php - Student → Web routes: uses
web/routes/web.php - Administrator → Web routes: uses
web/routes/web.php - Web routes → Session authentication: routes to
web/routes/web.php - Web routes → Student registration: routes to
web/routes/web.php - Web routes → User administration: routes to
web/routes/web.php - Web routes → Performance recording: routes to
web/routes/web.php - Web routes → Teacher dashboard: routes to
web/routes/web.php - Web routes → Student dashboard: routes to
web/routes/web.php - Web routes → Teacher student views: routes to
web/routes/web.php - Student registration → Account provisioning: creates account
web/app/Http/Controllers/Auth/RegisteredStudentController.php - User administration → Account provisioning: creates account
web/app/Http/Controllers/AdminUserController.php - Account provisioning → User accounts: provisions
web/app/Services/AccountProvisioningService.php - Session authentication → User accounts: authenticates
- Web routes → Role authorization: applies role checks
- User administration → User accounts: queries and updates
web/app/Http/Controllers/AdminUserController.php - Performance recording → Performance snapshots: upserts snapshot
web/app/Http/Controllers/StudentPerformanceController.php - Performance recording → Support assessment: assesses snapshot
web/app/Http/Controllers/StudentPerformanceController.php - Support assessment → ML client: requests prediction
web/app/Services/AcademicSupportAssessmentService.php - Support assessment → Support analysis: stores assessment
web/app/Services/AcademicSupportAssessmentService.php - ML client → Prediction API: calls privately
README.md - Prediction API → Classifier inference: dispatches prediction
ml-service/app.py - Classifier inference → Feature preparation: uses features
ml-service/prediction.py - Teacher student views → Teacher student analysis: loads analysis
web/app/Http/Controllers/TeacherStudentController.php - Teacher student analysis → Student records: queries students
web/app/Services/TeacherStudentService.php - Teacher student analysis → Performance snapshots: loads snapshots
web/app/Services/TeacherStudentService.php - Teacher dashboard → Dashboard data: loads dashboard data
web/app/Http/Controllers/TeacherDashboardController.php - Student dashboard → Dashboard data: loads dashboard data
web/app/Http/Controllers/StudentDashboardController.php - Dashboard data → Student records: queries records
web/app/Services/DashboardDataService.php - Dashboard data → Performance snapshots: aggregates snapshots
web/app/Services/DashboardDataService.php - Dashboard data → Personalized study plans: loads active plan
web/app/Services/DashboardDataService.php - Account provisioning → MySQL database: persists accounts
README.md - Performance snapshots → MySQL database: persists snapshots
README.md - Teacher learning materials → PDF retrieval service: submitted for extraction
README.md - PDF retrieval service → Grounded AI tutor: supplies retrieval context
README.md - Gemini AI → Grounded AI tutor: grounds tutor responses
README.md - Gemini AI → Generated quizzes: generates quizzes
README.md - Gemini AI → Personalized study plans: supports plans
README.md