How laykimhoung/student-performance-prediction works
EduVision AI is a desktop student-management and academic intervention application. Users enter through the main window and select an administrator, teacher, or prediction-sandbox experience. The main domain workflow covers class and student management, assessment recording, performance and risk prediction, recommendations, analytics, and report export. The graph includes the database access layer and the documented model-training capability; unsampled page wiring is represented only where the tree and README support the capability, not as a specific call chain.
Main entry points: main_window.py Main Window · class_detail_page.py Class Workspace · preview_page.py Prediction Sandbox · crud.py Database Operations
Components 22
Application UI
- Desktop Entry
app.py - Main Window
ui/main_window.py - Role Selection
ui/role_selection_page.py
Administration
- Admin Login
ui/admin/login_page.py - Admin Dashboard
ui/admin/dashboard.py - Academic Management
ui/admin/academic_management.py - Student Management
ui/admin/student_management.py
Teacher Workspace
- Teacher Login
ui/teacher/login_page.py - Teacher Dashboard
ui/teacher/dashboard.py - Class Workspace
ui/teacher/class_detail_page.py - Grade Entry
ui/teacher/grade_entry_page.py - Class Analytics
ui/teacher/analytics_page.py
AI and Intervention
- Prediction Sandbox
ui/student/preview_page.py - Score and Risk Prediction
ai/predictor.py - Recommendations
ai/recommender.py - Model Training
ai/trainer.py
Data and Reports
- Database Operations
database/crud.py - SQLite Database
database/db.py - Class PDF Export
reports/pdf_generator.py - Excel Export
reports/excel_generator.py - Student PDF Export
reports/student_pdf_generator.py
Other components
- User
Connections 19
- User → Desktop Entry: launches
- Desktop Entry → Main Window: starts
- Main Window → Role Selection: shows
- Main Window → Admin Login: routes to
- Main Window → Teacher Login: routes to
- Main Window → Prediction Sandbox: opens
- Admin Dashboard → Academic Management: offers management
- Academic Management → Database Operations: manages records
- Student Management → Database Operations: manages students
- Teacher Dashboard → Class Workspace: opens classes
- Class Workspace → Grade Entry: opens grading
- Class Workspace → Class Analytics: opens analytics
- Class Workspace → Class PDF Export: exports class
- Class Workspace → Excel Export: exports class
- Prediction Sandbox → Score and Risk Prediction: requests prediction
- Prediction Sandbox → Recommendations: requests advice
- Prediction Sandbox → Student PDF Export: exports report
- Database Operations → SQLite Database: reads and writes
- Model Training → SQLite Database: loads training data