How afraz-dev-pro/afraz-campusos works
CampusOS is an Android campus-life command center. Students enter through a Compose navigation shell and use the dashboard to reach academics, toolkit/finance, and HackHub. Academic schedules and tasks drive attendance/progress features and reminders; toolkit covers scanning, PDFs, wallet documents, focus, and spending; HackHub provides community feeds and teammate discovery. The README documents further capabilities such as PYQ Vault, bill splits, widget, and Quick Settings scan. Edges are limited to README statements or indexed/excerpted source references; unsampled internals are represented only at supported subsystem paths.
Main entry points: MainActivity.kt Compose shell · AppDatabase.kt Room database · AcademicsScreen.kt Academic workspace · CampusAlarmScheduler.kt Class reminders
Components 24
App shell
- Compose shell
app/src/main/java/com/afraz/campusos/MainActivity.kt - Dashboard
app/src/main/java/com/afraz/campusos/feature_dashboard/DashboardScreen.kt
Academics
- Academic workspace
app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt - Academic state
app/src/main/java/com/afraz/campusos/feature_academics/AcademicsViewModel.kt - Timetable exchange
app/src/main/java/com/afraz/campusos/core/util/TimetableCodec.kt - Class reminders
app/src/main/java/com/afraz/campusos/feature_academics/alarm/CampusAlarmScheduler.kt - Alarm receivers
app/src/main/java/com/afraz/campusos/feature_academics/alarm/AlarmReceivers.kt
Toolkit and finance
- Toolkit and wallet
app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitScreen.kt - Toolkit state
app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitViewModel.kt - Finance tools
app/src/main/java/com/afraz/campusos/feature_toolkit/FinanceScreen.kt - Pomodoro service
app/src/main/java/com/afraz/campusos/feature_toolkit/focus/PomodoroForegroundService.kt - Quick scan tile
app/src/main/java/com/afraz/campusos/feature_toolkit/tile/QuickScanTileService.kt - Home widget
app/src/main/java/com/afraz/campusos/feature_toolkit/widget/CampusGlanceWidget.kt
Campus community
- HackHub
app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubScreen.kt - Community state
app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubViewModel.kt - Feed repository
app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedRepository.kt - Feed API
app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedApi.kt - Teammate finder
app/src/main/java/com/afraz/campusos/feature_hackhub/TeammateRepository.kt - Optional sign-in
app/src/main/java/com/afraz/campusos/feature_hackhub/LazyAuthManager.kt - Firebase setup
app/src/main/java/com/afraz/campusos/feature_hackhub/FirebaseBootstrap.kt
Local platform
- Room database
app/src/main/java/com/afraz/campusos/data/AppDatabase.kt - Database holder
app/src/main/java/com/afraz/campusos/data/CampusDatabaseHolder.kt - JSON backup
app/src/main/java/com/afraz/campusos/data/JsonBackupManager.kt
Other components
- Student
Connections 30
- Student → Compose shell: opens
README.md - Compose shell → Dashboard: routes to
app/src/main/java/com/afraz/campusos/MainActivity.kt - Compose shell → Academic workspace: routes to
app/src/main/java/com/afraz/campusos/MainActivity.kt - Compose shell → Toolkit and wallet: routes to
app/src/main/java/com/afraz/campusos/MainActivity.kt - Compose shell → Finance tools: routes to
app/src/main/java/com/afraz/campusos/MainActivity.kt - Compose shell → HackHub: routes to
app/src/main/java/com/afraz/campusos/MainActivity.kt - Dashboard → Academic workspace: opens
README.md - Dashboard → Toolkit and wallet: opens
README.md - Academic workspace → Academic state: uses state
app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt - Academic workspace → Timetable exchange: encodes and decodes
app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt - Academic state → Room database: reads and writes
app/src/main/java/com/afraz/campusos/feature_academics/AcademicsViewModel.kt - Academic state → Class reminders: schedules
app/src/main/java/com/afraz/campusos/feature_academics/AcademicsViewModel.kt - Class reminders → Room database: reads
app/src/main/java/com/afraz/campusos/feature_academics/alarm/CampusAlarmScheduler.kt - Class reminders → Alarm receivers: sets broadcasts
app/src/main/java/com/afraz/campusos/feature_academics/alarm/AlarmReceivers.kt - Alarm receivers → Database holder: loads data
app/src/main/java/com/afraz/campusos/feature_academics/alarm/AlarmReceivers.kt - Toolkit and wallet → Toolkit state: uses state
app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitScreen.kt - Toolkit state → Room database: reads and writes
app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitViewModel.kt - Toolkit and wallet → Pomodoro service: starts
app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitScreen.kt - Quick scan tile → Compose shell: launches scanner
app/src/main/java/com/afraz/campusos/feature_toolkit/tile/QuickScanTileService.kt - Home widget → Database holder: reads snapshot
app/src/main/java/com/afraz/campusos/feature_toolkit/widget/CampusGlanceWidget.kt - Home widget → Class reminders: finds next class
app/src/main/java/com/afraz/campusos/feature_toolkit/widget/CampusGlanceWidget.kt - HackHub → Community state: uses state
app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubScreen.kt - Community state → Feed repository: loads feed
- Feed repository → Feed API: requests feed
app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedRepository.kt - Community state → Teammate finder: finds teammates
- Optional sign-in → Firebase setup: initializes
app/src/main/java/com/afraz/campusos/feature_hackhub/LazyAuthManager.kt - Teammate finder → Firebase setup: uses services
app/src/main/java/com/afraz/campusos/feature_hackhub/TeammateRepository.kt - Database holder → Room database: creates
app/src/main/java/com/afraz/campusos/data/CampusDatabaseHolder.kt - JSON backup → Room database: backs up
app/src/main/java/com/afraz/campusos/data/JsonBackupManager.kt - Student → Optional sign-in: chooses sign-in
README.md