How pythonom/lost-time-analyzer works
Lost Time Analyzer turns faculty-uploaded class grading data into risk scores and student-performance views. The documented workflow runs from CSV upload through backend parsing, rule-based scoring, ML prediction and Supabase persistence; faculty then review class insights, high-risk students, comparisons, leaderboards and individual profiles with notes. The frontend also provides authentication and shared presentation state. Backend internals beyond the indexed imports and README workflow were not excerpted, so those relationships are documented rather than source-verified.
Main entry points: App.jsx App routing · api.js API client · app.py Flask API · UploadData.jsx CSV upload
Components 20
Faculty interface
- App routing
src/App.jsx - Faculty login
src/pages/Login.jsx - CSV upload
src/pages/UploadData.jsx - Class dashboard
src/pages/Dashboard.jsx - Student directory
src/pages/Students.jsx - At-risk view
src/pages/AtRisk.jsx - Student comparison
src/pages/Compare.jsx - Leaderboard
src/pages/Leaderboard.jsx - Student profile
src/pages/StudentProfile.jsx
Frontend services
- Auth state
src/context/AuthContext.jsx - Notifications
src/context/NotificationContext.jsx - API client
src/services/api.js - Student adapter
src/utils/adapter.js
Analysis backend
- Flask API
backend/app.py - CSV processing
backend/utils/preprocess.py - Risk and trend
backend/app.py - ML prediction
backend/ml/model.py
Data services
- Supabase access
backend/services/supabase_client.py - Supabase
Other components
- Faculty
Connections 28
- Faculty → App routing: uses
README.md - App routing → Faculty login: routes to
src/App.jsx - App routing → CSV upload: routes to
src/App.jsx - App routing → Class dashboard: routes to
src/App.jsx - App routing → Student directory: routes to
src/App.jsx - App routing → At-risk view: routes to
src/App.jsx - App routing → Student comparison: routes to
src/App.jsx - App routing → Leaderboard: routes to
src/App.jsx - App routing → Student profile: routes to
src/App.jsx - App routing → Auth state: provides
src/App.jsx - Faculty → CSV upload: submits CSV
README.md - CSV upload → Flask API: uploads data
README.md - Flask API → CSV processing: parses CSV
README.md - Flask API → Risk and trend: computes scores
README.md - Flask API → ML prediction: runs prediction
README.md - Flask API → Supabase access: saves results
README.md - Supabase access → Supabase: reads and writes
README.md - Class dashboard → API client: requests insights
src/pages/Dashboard.jsx - Student directory → API client: loads students
src/pages/Students.jsx - At-risk view → API client: requests students
src/pages/AtRisk.jsx - Student comparison → API client: loads students
src/pages/Compare.jsx - Leaderboard → API client: loads students
src/pages/Leaderboard.jsx - Student profile → API client: loads students
src/pages/StudentProfile.jsx - Student profile → Flask API: loads and saves notes
README.md - API client → Flask API: calls Flask API
README.md - Faculty login → Auth state: sets session
src/pages/Login.jsx - API client → Student adapter: adapts student data
src/services/api.js - CSV upload → Notifications: reports upload status
src/pages/UploadData.jsx