How eyadalahmad/interactive-qm-exercises works
Interactive Streamlit QM exercises serve student groups and administrators. The main workflow is group-code login, exercise selection and timed participation, then saving up to three attempts per group, exercise and session; administrators manage groups and exercises and compare results. The graph includes both documented exercise types, timing, session preparation and Supabase persistence. Relationships are limited to calls visible in excerpts or references in the source index; unsampled implementation details are not inferred.
Main entry points: supabase_client.py Supabase client · main_view.py Application routing · student_dashboard.py Student dashboard · exercise_service.py Exercise service
Components 21
App entry
- Application routing
ui/main_view.py
Access and administration
- Admin login
ui/admin_login.py - Admin dashboard
ui/admin_dashboard.py - Group management
ui/group_management.py - Exercise controls
ui/exercise_management.py - Results comparison
ui/results_comparison.py
Student exercises
- Countdown timer
ui/countdown_timer.py - Student dashboard
ui/student_dashboard.py - Color mixing
ui/exercises/color_mixing_view.py - 3D printing exercise
ui/exercises/printing_3d_view.py - 3D visualizer
ui/exercises/printing_3d_visualizer.py
Domain services
- Admin authentication
services/admin_auth.py - Group service
services/group_service.py - Results service
services/results_service.py - Printing simulation
services/printing_simulation_service.py - Exercise service
services/exercise_service.py - Attempt service
services/attempt_service.py - Session service
services/session_service.py
Persistence
- Supabase client
database/supabase_client.py - Supabase database
Other components
- Student or admin
Connections 32
- Student or admin → Application routing: opens
- Application routing → Admin dashboard: routes admin
ui/main_view.py - Application routing → Student dashboard: routes student
ui/main_view.py - Application routing → Admin login: opens login
ui/main_view.py - Application routing → Group service: authenticates group
ui/main_view.py - Admin login → Admin authentication: checks credentials
ui/admin_login.py - Admin dashboard → Group management: renders
ui/admin_dashboard.py - Admin dashboard → Exercise controls: renders
ui/admin_dashboard.py - Admin dashboard → Results comparison: renders
ui/admin_dashboard.py - Group management → Group service: manages groups
ui/group_management.py - Group service → Admin authentication: checks access
services/group_service.py - Exercise controls → Admin authentication: checks access
ui/exercise_management.py - Exercise controls → Exercise service: controls exercises
ui/exercise_management.py - Exercise controls → Countdown timer: renders timer
ui/exercise_management.py - Results comparison → Exercise service: loads exercises
ui/results_comparison.py - Results comparison → Results service: loads results
ui/results_comparison.py - Student dashboard → Exercise service: loads status
ui/student_dashboard.py - Student dashboard → Countdown timer: renders timer
ui/student_dashboard.py - Student dashboard → Color mixing: dispatches color
ui/student_dashboard.py - Student dashboard → 3D printing exercise: dispatches printing
ui/student_dashboard.py - Color mixing → Attempt service: loads and saves attempts
ui/exercises/color_mixing_view.py - Color mixing → Exercise service: loads target color
ui/exercises/color_mixing_view.py - 3D printing exercise → Attempt service: loads and saves attempts
ui/exercises/printing_3d_view.py - 3D printing exercise → Printing simulation: calculates quality
ui/exercises/printing_3d_view.py - 3D printing exercise → 3D visualizer: renders model
ui/exercises/printing_3d_view.py - Attempt service → Session service: gets session
services/attempt_service.py - Group service → Supabase client: uses client
services/group_service.py - Exercise service → Supabase client: uses client
services/exercise_service.py - Attempt service → Supabase client: uses client
services/attempt_service.py - Session service → Supabase client: uses client
services/session_service.py - Results service → Supabase client: uses client
services/results_service.py - Supabase client → Supabase database: queries and updates
database/supabase_client.py