How c1oudreamw/qlu-toolbox works
LumaTile is a local-first campus utility for desktop and Android. The main desktop flow is student → Vue tool page → Electron/Python bridge → browser-backed school-system task → locally validated export; GPA and credit-progress views then process data locally. Android provides parallel schedule, grade-export, GPA, and credit-progress workflows through a Vue UI and native WebView/file handling. The README documents major capabilities beyond the sampled code; those relationships are labeled as documented rather than inferred from unseen calls.
Main entry points: bridge.py Python bridge · src/App.vue Desktop workspace · src/App.vue Mobile workspace · GradeExportPage.vue Grade export
Components 27
Desktop client
- Desktop workspace
src/App.vue - Grade export
src/pages/GradeExportPage.vue - GPA calculator
src/pages/GPACalculatorPage.vue - Credit progress
src/pages/CreditReportPage.vue - Schedule manager
src/pages/SchedulePage.vue - Task history
src/pages/TasksPage.vue - Electron IPC
electron/bridge.ts
Desktop task backend
- Python bridge
qlu_toolbox/bridge.py - Grade export worker
qlu_toolbox/modules/grade_export/worker.py - Grade browser service
qlu_toolbox/modules/grade_export/service.py - Schedule import worker
qlu_toolbox/modules/schedule_import/worker.py - Schedule import service
qlu_toolbox/modules/schedule_import/service.py - Credit report worker
qlu_toolbox/modules/credit_report/worker.py - Credit report service
qlu_toolbox/modules/credit_report/service.py
Android client
- Mobile workspace
apps/mobile/src/App.vue - Mobile schedule
apps/mobile/src/SchedulePage.vue - Mobile credit report
apps/mobile/src/CreditReportPage.vue - Mobile GPA parser
apps/mobile/src/gpaWorker.ts - Grade WebView plugin
apps/mobile/android/app/src/main/java/io/github/c1oudreamw/lumatile/GradeExportPlugin.kt - Grade task recovery
apps/mobile/android/app/src/main/java/io/github/c1oudreamw/lumatile/GradeTaskRepository.kt - Schedule widget
apps/mobile/android/app/src/main/java/io/github/c1oudreamw/lumatile/ScheduleWidgetService.kt
Academic domain
- Academic calculations
packages/academic-core/src/credit.ts - Schedule formats
qlu_toolbox/modules/schedule_io/domain.py
Local state
- Settings and paths
qlu_toolbox/core/paths.py - Schedule storage
qlu_toolbox/core/schedules.py - Task records
qlu_toolbox/core/tasks.py
Other components
- Student
Connections 27
- Student → Desktop workspace: uses
README.md - Desktop workspace → Grade export: opens
src/App.vue - Desktop workspace → GPA calculator: opens
src/App.vue - Desktop workspace → Credit progress: opens
src/App.vue - Desktop workspace → Schedule manager: opens
src/App.vue - Desktop workspace → Task history: opens
src/App.vue - Grade export → Electron IPC: invokes
- Electron IPC → Python bridge: forwards IPC
- Python bridge → Grade export worker: starts worker
qlu_toolbox/bridge.py - Grade export worker → Grade browser service: runs
qlu_toolbox/modules/grade_export/worker.py - Grade browser service → Academic calculations: validates workbook
qlu_toolbox/modules/grade_export/service.py - Python bridge → Schedule import worker: starts worker
- Schedule import worker → Schedule import service: runs
qlu_toolbox/modules/schedule_import/worker.py - Schedule import service → Schedule formats: parses schedule
qlu_toolbox/modules/schedule_import/service.py - Python bridge → Credit report worker: starts worker
- Credit report worker → Credit report service: runs
qlu_toolbox/modules/credit_report/worker.py - Credit report service → Academic calculations: collects progress data
- Student → Mobile workspace: uses
README.md - Mobile workspace → Mobile schedule: shows schedule
apps/mobile/src/App.vue - Mobile workspace → Mobile credit report: shows credit report
apps/mobile/src/App.vue - Mobile workspace → Mobile GPA parser: parses GPA input
apps/mobile/src/App.vue - Mobile workspace → Grade WebView plugin: requests native export
- Grade WebView plugin → Grade task recovery: records task state
- Mobile workspace → Schedule widget: refreshes widget
- Python bridge → Schedule storage: reads and writes
qlu_toolbox/bridge.py - Python bridge → Task records: records tasks
qlu_toolbox/bridge.py - Python bridge → Settings and paths: uses app paths
qlu_toolbox/bridge.py