# afraz-dev-pro/afraz-campusos architecture

> Architecture diagram of the GitHub repository afraz-dev-pro/afraz-campusos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/afraz-dev-pro/afraz-campusos
- Repository: https://github.com/afraz-dev-pro/afraz-campusos

## Overview

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: [`app/src/main/java/com/afraz/campusos/MainActivity.kt`](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/MainActivity.kt) (Compose shell), [`app/src/main/java/com/afraz/campusos/data/AppDatabase.kt`](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/data/AppDatabase.kt) (Room database), [`app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt`](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt) (Academic workspace), [`app/src/main/java/com/afraz/campusos/feature_academics/alarm/CampusAlarmScheduler.kt`](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/alarm/CampusAlarmScheduler.kt) (Class reminders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_shell["Compose shell<br/>[MainActivity.kt]"]
  node_dashboard["Dashboard<br/>[DashboardScreen.kt]"]
end

subgraph group_academics["Academics"]
  node_academic_ui["Academic workspace<br/>[AcademicsScreen.kt]"]
  node_academic_logic["Academic state"]
  node_timetable["Timetable exchange<br/>[TimetableCodec.kt]"]
  node_alarms["Class reminders"]
  node_alarm_receiver["Alarm receivers<br/>[AlarmReceivers.kt]"]
end

subgraph group_toolkit["Toolkit and finance"]
  node_toolkit_ui["Toolkit and wallet<br/>[ToolkitScreen.kt]"]
  node_toolkit_logic["Toolkit state"]
  node_finance["Finance tools<br/>[FinanceScreen.kt]"]
  node_focus["Pomodoro service"]
  node_scan_tile["Quick scan tile"]
  node_widget["Home widget"]
end

subgraph group_community["Campus community"]
  node_hackhub_ui["HackHub<br/>[HackHubScreen.kt]"]
  node_hackhub_logic["Community state"]
  node_feed_repo["Feed repository"]
  node_feed_api["Feed API"]
  node_teammates["Teammate finder"]
  node_auth["Optional sign-in<br/>[LazyAuthManager.kt]"]
  node_firebase["Firebase setup"]
end

subgraph group_shared["Local platform"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_db_holder["Database holder"]
  node_backup["JSON backup"]
end

node_student(("Student"))

node_student -->|"opens"| node_shell
node_shell -->|"routes to"| node_dashboard
node_shell -->|"routes to"| node_academic_ui
node_shell -->|"routes to"| node_toolkit_ui
node_shell -->|"routes to"| node_finance
node_shell -->|"routes to"| node_hackhub_ui
node_dashboard -->|"opens"| node_academic_ui
node_dashboard -->|"opens"| node_toolkit_ui
node_academic_ui -->|"uses state"| node_academic_logic
node_academic_ui -->|"encodes and decodes"| node_timetable
node_academic_logic -->|"reads and writes"| node_database
node_academic_logic -->|"schedules"| node_alarms
node_alarms -->|"reads"| node_database
node_alarms -.->|"sets broadcasts"| node_alarm_receiver
node_alarm_receiver -->|"loads data"| node_db_holder
node_toolkit_ui -->|"uses state"| node_toolkit_logic
node_toolkit_logic -->|"reads and writes"| node_database
node_toolkit_ui -->|"starts"| node_focus
node_scan_tile -->|"launches scanner"| node_shell
node_widget -->|"reads snapshot"| node_db_holder
node_widget -->|"finds next class"| node_alarms
node_hackhub_ui -->|"uses state"| node_hackhub_logic
node_hackhub_logic -.->|"loads feed"| node_feed_repo
node_feed_repo -->|"requests feed"| node_feed_api
node_hackhub_logic -.->|"finds teammates"| node_teammates
node_auth -->|"initializes"| node_firebase
node_teammates -->|"uses services"| node_firebase
node_db_holder -->|"creates"| node_database
node_backup -->|"backs up"| node_database
node_student -.->|"chooses sign-in"| node_auth

click node_shell "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/MainActivity.kt"
click node_dashboard "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_dashboard/DashboardScreen.kt"
click node_academic_ui "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt"
click node_academic_logic "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/AcademicsViewModel.kt"
click node_timetable "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/core/util/TimetableCodec.kt"
click node_alarms "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/alarm/CampusAlarmScheduler.kt"
click node_alarm_receiver "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/alarm/AlarmReceivers.kt"
click node_toolkit_ui "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitScreen.kt"
click node_toolkit_logic "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitViewModel.kt"
click node_finance "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/FinanceScreen.kt"
click node_focus "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/focus/PomodoroForegroundService.kt"
click node_scan_tile "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/tile/QuickScanTileService.kt"
click node_widget "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/widget/CampusGlanceWidget.kt"
click node_hackhub_ui "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubScreen.kt"
click node_hackhub_logic "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubViewModel.kt"
click node_feed_repo "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedRepository.kt"
click node_feed_api "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedApi.kt"
click node_teammates "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/TeammateRepository.kt"
click node_auth "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/LazyAuthManager.kt"
click node_firebase "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/FirebaseBootstrap.kt"
click node_database "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/data/AppDatabase.kt"
click node_db_holder "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/data/CampusDatabaseHolder.kt"
click node_backup "https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/data/JsonBackupManager.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shell,node_dashboard toneBlue
class node_academic_ui,node_academic_logic,node_timetable,node_alarms,node_alarm_receiver toneAmber
class node_toolkit_ui,node_toolkit_logic,node_finance,node_focus,node_scan_tile,node_widget toneMint
class node_hackhub_ui,node_hackhub_logic,node_feed_repo,node_feed_api,node_teammates,node_auth,node_firebase toneRose
class node_database,node_db_holder,node_backup,node_student toneIndigo
```

## Components

### App shell

- [Compose shell](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/MainActivity.kt): `app/src/main/java/com/afraz/campusos/MainActivity.kt`
- [Dashboard](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_dashboard/DashboardScreen.kt): `app/src/main/java/com/afraz/campusos/feature_dashboard/DashboardScreen.kt`

### Academics

- [Academic workspace](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt): `app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt`
- [Academic state](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/AcademicsViewModel.kt): `app/src/main/java/com/afraz/campusos/feature_academics/AcademicsViewModel.kt`
- [Timetable exchange](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/core/util/TimetableCodec.kt): `app/src/main/java/com/afraz/campusos/core/util/TimetableCodec.kt`
- [Class reminders](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/alarm/CampusAlarmScheduler.kt): `app/src/main/java/com/afraz/campusos/feature_academics/alarm/CampusAlarmScheduler.kt`
- [Alarm receivers](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_academics/alarm/AlarmReceivers.kt): `app/src/main/java/com/afraz/campusos/feature_academics/alarm/AlarmReceivers.kt`

### Toolkit and finance

- [Toolkit and wallet](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitScreen.kt): `app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitScreen.kt`
- [Toolkit state](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitViewModel.kt): `app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitViewModel.kt`
- [Finance tools](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/FinanceScreen.kt): `app/src/main/java/com/afraz/campusos/feature_toolkit/FinanceScreen.kt`
- [Pomodoro service](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/focus/PomodoroForegroundService.kt): `app/src/main/java/com/afraz/campusos/feature_toolkit/focus/PomodoroForegroundService.kt`
- [Quick scan tile](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/tile/QuickScanTileService.kt): `app/src/main/java/com/afraz/campusos/feature_toolkit/tile/QuickScanTileService.kt`
- [Home widget](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_toolkit/widget/CampusGlanceWidget.kt): `app/src/main/java/com/afraz/campusos/feature_toolkit/widget/CampusGlanceWidget.kt`

### Campus community

- [HackHub](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubScreen.kt): `app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubScreen.kt`
- [Community state](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubViewModel.kt): `app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubViewModel.kt`
- [Feed repository](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedRepository.kt): `app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedRepository.kt`
- [Feed API](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedApi.kt): `app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedApi.kt`
- [Teammate finder](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/TeammateRepository.kt): `app/src/main/java/com/afraz/campusos/feature_hackhub/TeammateRepository.kt`
- [Optional sign-in](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/LazyAuthManager.kt): `app/src/main/java/com/afraz/campusos/feature_hackhub/LazyAuthManager.kt`
- [Firebase setup](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/feature_hackhub/FirebaseBootstrap.kt): `app/src/main/java/com/afraz/campusos/feature_hackhub/FirebaseBootstrap.kt`

### Local platform

- [Room database](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/data/AppDatabase.kt): `app/src/main/java/com/afraz/campusos/data/AppDatabase.kt`
- [Database holder](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/data/CampusDatabaseHolder.kt): `app/src/main/java/com/afraz/campusos/data/CampusDatabaseHolder.kt`
- [JSON backup](https://github.com/afraz-dev-pro/afraz-campusos/blob/main/app/src/main/java/com/afraz/campusos/data/JsonBackupManager.kt): `app/src/main/java/com/afraz/campusos/data/JsonBackupManager.kt`

### Other components

- **Student**

## Connections

- Student → Compose shell: opens (evidence: `README.md`)
- Compose shell → Dashboard: routes to (evidence: `app/src/main/java/com/afraz/campusos/MainActivity.kt`)
- Compose shell → Academic workspace: routes to (evidence: `app/src/main/java/com/afraz/campusos/MainActivity.kt`)
- Compose shell → Toolkit and wallet: routes to (evidence: `app/src/main/java/com/afraz/campusos/MainActivity.kt`)
- Compose shell → Finance tools: routes to (evidence: `app/src/main/java/com/afraz/campusos/MainActivity.kt`)
- Compose shell → HackHub: routes to (evidence: `app/src/main/java/com/afraz/campusos/MainActivity.kt`)
- Dashboard → Academic workspace: opens (evidence: `README.md`)
- Dashboard → Toolkit and wallet: opens (evidence: `README.md`)
- Academic workspace → Academic state: uses state (evidence: `app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt`)
- Academic workspace → Timetable exchange: encodes and decodes (evidence: `app/src/main/java/com/afraz/campusos/feature_academics/AcademicsScreen.kt`)
- Academic state → Room database: reads and writes (evidence: `app/src/main/java/com/afraz/campusos/feature_academics/AcademicsViewModel.kt`)
- Academic state → Class reminders: schedules (evidence: `app/src/main/java/com/afraz/campusos/feature_academics/AcademicsViewModel.kt`)
- Class reminders → Room database: reads (evidence: `app/src/main/java/com/afraz/campusos/feature_academics/alarm/CampusAlarmScheduler.kt`)
- Class reminders → Alarm receivers: sets broadcasts (evidence: `app/src/main/java/com/afraz/campusos/feature_academics/alarm/AlarmReceivers.kt`)
- Alarm receivers → Database holder: loads data (evidence: `app/src/main/java/com/afraz/campusos/feature_academics/alarm/AlarmReceivers.kt`)
- Toolkit and wallet → Toolkit state: uses state (evidence: `app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitScreen.kt`)
- Toolkit state → Room database: reads and writes (evidence: `app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitViewModel.kt`)
- Toolkit and wallet → Pomodoro service: starts (evidence: `app/src/main/java/com/afraz/campusos/feature_toolkit/ToolkitScreen.kt`)
- Quick scan tile → Compose shell: launches scanner (evidence: `app/src/main/java/com/afraz/campusos/feature_toolkit/tile/QuickScanTileService.kt`)
- Home widget → Database holder: reads snapshot (evidence: `app/src/main/java/com/afraz/campusos/feature_toolkit/widget/CampusGlanceWidget.kt`)
- Home widget → Class reminders: finds next class (evidence: `app/src/main/java/com/afraz/campusos/feature_toolkit/widget/CampusGlanceWidget.kt`)
- HackHub → Community state: uses state (evidence: `app/src/main/java/com/afraz/campusos/feature_hackhub/HackHubScreen.kt`)
- Community state → Feed repository: loads feed
- Feed repository → Feed API: requests feed (evidence: `app/src/main/java/com/afraz/campusos/feature_hackhub/CommunityFeedRepository.kt`)
- Community state → Teammate finder: finds teammates
- Optional sign-in → Firebase setup: initializes (evidence: `app/src/main/java/com/afraz/campusos/feature_hackhub/LazyAuthManager.kt`)
- Teammate finder → Firebase setup: uses services (evidence: `app/src/main/java/com/afraz/campusos/feature_hackhub/TeammateRepository.kt`)
- Database holder → Room database: creates (evidence: `app/src/main/java/com/afraz/campusos/data/CampusDatabaseHolder.kt`)
- JSON backup → Room database: backs up (evidence: `app/src/main/java/com/afraz/campusos/data/JsonBackupManager.kt`)
- Student → Optional sign-in: chooses sign-in (evidence: `README.md`)
