How polmarsol/mai-grades works
MAI Grades is a private, browser-based grade tracker for students in the named AI master’s program. Students enter or import course structure, record grades and submissions, then review projected marks, target requirements, deadlines and semester statistics; they can also explore what-if grades and export or share selected results. The README documents browser-local storage, calendar feeds, news, customization and offline support. Several feature modules are identified by the tree and README but were not sampled, so their internal calls are not asserted here.
Main entry points: index.html App shell · calendars.mjs Calendar feeds · app.js App controller · home.js Home dashboard
Components 21
Student app
- App shell
index.html - App controller
assets/js/app.js - Home dashboard
assets/js/views/home.js - Course view
assets/js/views/subject.js - Semester overview
assets/js/views/overview.js - Stats view
assets/js/views/stats.js - Settings view
assets/js/views/settings.js - Structure editor
assets/js/editor.js - Home layout
assets/js/layout.js - Submission progress
assets/js/progress.js - Grade sharing
assets/js/share.js
Grades and data
- Course catalog
assets/js/catalog.js - Grade engine
assets/js/grades.js - Browser storage
assets/js/store.js - Grade statistics
assets/js/stats.js
Calendar and updates
- Calendar feeds
tools/calendars.mjs - Calendar generation
assets/js/ics.js - Calendar subscription
assets/js/subscribe.js - Course news
assets/js/news.js
Browser delivery
- Offline service worker
sw.js
Other components
- Student
Connections 21
- Student → App shell: opens
README.md - App shell → App controller: loads
README.md - Student → Course view: records grades
README.md - Student → Structure editor: edits structure
README.md - Student → Home dashboard: reviews deadlines
README.md - Student → Semester overview: reviews semester
README.md - Student → Stats view: reviews statistics
README.md - Student → Settings view: backs up data
README.md - Course view → Grade engine: projects marks
README.md - Grade engine → Course catalog: uses structures
README.md - App controller → Browser storage: stores locally
README.md - Semester overview → Calendar generation: exports deadlines
README.md - Calendar feeds → Calendar generation: builds feeds
tools/calendars.mjs - Calendar feeds → Course catalog: reads courses
tools/calendars.mjs - Student → Calendar subscription: subscribes
README.md - Student → Course news: reads updates
README.md - Student → Grade sharing: shares grades
README.md - Student → Home layout: customizes home
README.md - Home dashboard → Submission progress: shows submissions
README.md - Stats view → Grade statistics: shows analysis
README.md - Offline service worker → App shell: caches offline
sw.js