# adir2368/semestero-me architecture

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

- Interactive diagram: https://gitdiagram.com/adir2368/semestero-me
- Repository: https://github.com/adir2368/semestero-me

## Overview

Semestero ME is a Technion academic planning and daily-study workspace: students plan a degree, inspect prerequisites, simulate GPA, manage coursework and calendars, and sync schedules and tasks. The README also documents course-resource discovery and web, iOS, Windows, Android, and Wear experiences. The graph combines those documented capabilities with indexed Android/Wear components; unsampled web-module wiring and the phone–watch transport are not asserted where the excerpts do not show them.

Main entry points: [`app.js`](https://github.com/adir2368/semestero-me/blob/main/app.js) (Academic Workspace), [`android/wear/src/main/java/com/technion/semestero/wear/WearScheduleHelper.java`](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearScheduleHelper.java) (Wear Schedule), [`android/wear/src/main/java/com/technion/semestero/wear/WearDataSyncService.java`](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearDataSyncService.java) (Wear Data Sync), [`android/wear/src/main/java/com/technion/semestero/wear/MainActivity.java`](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/MainActivity.java) (Wear App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Degree Planning"]
  node_webapp["Academic Workspace<br/>[app.js]"]
  node_planner["Degree Planner<br/>[planner_module.js]"]
  node_catalog[("Course Catalog<br/>[planner_catalog.js]")]
  node_curriculum["Prerequisite Map"]
  node_grades["GPA Simulator<br/>[grade_sheet.js]"]
end

subgraph group_study["Study Operations"]
  node_tasks["Tasks and Exams<br/>[attendance_hub.js]"]
  node_calendar["Academic Calendar"]
  node_timetable["Weekly Timetable"]
end

subgraph group_sync["Sync and Knowledge"]
  node_moodle["Moodle Sync<br/>[moodle_sync.js]"]
  node_cheesefork["CheeseFork"]
  node_pangea["Pangea Resources"]
  node_auth["Account Sync<br/>[auth_sync.js]"]
end

subgraph group_mobile["Mobile and Wear"]
  node_androidapp["Android App Shell<br/>[MainActivity.java]"]
  node_phonewidgets["Phone Widgets"]
  node_wearsync["Phone Wear Sync"]
  node_wearapp["Wear App<br/>[MainActivity.java]"]
  node_wearschedule["Wear Schedule"]
  node_weartasks["Wear Task Tile"]
  node_classtile["Class Tile"]
  node_classcomplication["Class Complication"]
  node_taskcomplication["Task Complication"]
  node_weardata["Wear Data Sync"]
  node_wearcarousel["Schedule Carousel"]
  node_wearnotify["Wear Notifications"]
  node_wearreceiver["Notification Receiver"]
  node_ios["iOS App Shell"]
end

node_student(("Student"))

node_student -->|"uses"| node_webapp
node_webapp -->|"plans degree"| node_planner
node_webapp -->|"views prerequisites"| node_curriculum
node_webapp -->|"simulates GPA"| node_grades
node_webapp -->|"tracks coursework"| node_tasks
node_webapp -->|"views events"| node_calendar
node_webapp -->|"views schedule"| node_timetable
node_webapp -->|"syncs deadlines"| node_moodle
node_webapp -->|"imports timetable"| node_cheesefork
node_webapp -->|"links resources"| node_pangea
node_webapp -->|"offers courses"| node_catalog
node_student -->|"opens app"| node_androidapp
node_student -->|"opens app"| node_ios
node_androidapp -->|"syncs watch"| node_wearsync
node_androidapp -->|"updates widgets"| node_phonewidgets
node_wearsync -.->|"transfers payload"| node_weardata
node_wearapp -->|"uses schedule"| node_wearschedule
node_wearapp -->|"uses carousel"| node_wearcarousel
node_wearapp -->|"uses notifications"| node_wearnotify
node_wearschedule -->|"serves schedule"| node_classtile
node_wearschedule -->|"serves schedule"| node_classcomplication
node_weardata -->|"triggers alerts"| node_wearnotify
node_weardata -->|"refreshes tasks"| node_taskcomplication
node_weardata -->|"updates schedule"| node_wearschedule
node_wearnotify -->|"uses schedule"| node_wearschedule

click node_webapp "https://github.com/adir2368/semestero-me/blob/main/app.js"
click node_planner "https://github.com/adir2368/semestero-me/blob/main/planner_module.js"
click node_catalog "https://github.com/adir2368/semestero-me/blob/main/planner_catalog.js"
click node_curriculum "https://github.com/adir2368/semestero-me/blob/main/curriculum_template.js"
click node_grades "https://github.com/adir2368/semestero-me/blob/main/grade_sheet.js"
click node_tasks "https://github.com/adir2368/semestero-me/blob/main/attendance_hub.js"
click node_calendar "https://github.com/adir2368/semestero-me/blob/main/calendar_sync_engine.js"
click node_timetable "https://github.com/adir2368/semestero-me/blob/main/timetable_generator.js"
click node_moodle "https://github.com/adir2368/semestero-me/blob/main/moodle_sync.js"
click node_cheesefork "https://github.com/adir2368/semestero-me/blob/main/cheesefork_database.js"
click node_pangea "https://github.com/adir2368/semestero-me/blob/main/pangea_knowledge_hub.js"
click node_auth "https://github.com/adir2368/semestero-me/blob/main/auth_sync.js"
click node_androidapp "https://github.com/adir2368/semestero-me/blob/main/android/app/src/main/java/com/technion/semestero/MainActivity.java"
click node_phonewidgets "https://github.com/adir2368/semestero-me/blob/main/android/app/src/main/java/com/technion/semestero/SemesteroScheduleWidget.java"
click node_wearsync "https://github.com/adir2368/semestero-me/blob/main/android/app/src/main/java/com/technion/semestero/WearSyncManager.java"
click node_wearapp "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/MainActivity.java"
click node_wearschedule "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearScheduleHelper.java"
click node_weartasks "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/SemesteroTasksTileService.java"
click node_classtile "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/SemesteroClassTileService.java"
click node_classcomplication "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/SemesteroComplicationService.java"
click node_taskcomplication "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/SemesteroTasksComplicationService.java"
click node_weardata "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearDataSyncService.java"
click node_wearcarousel "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearCarouselAdapter.java"
click node_wearnotify "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearNotificationHelper.java"
click node_wearreceiver "https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearNotificationReceiver.java"
click node_ios "https://github.com/adir2368/semestero-me/blob/main/ios/App/App/SceneDelegate.swift"

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_webapp,node_planner,node_catalog,node_curriculum,node_grades toneBlue
class node_tasks,node_calendar,node_timetable toneAmber
class node_moodle,node_cheesefork,node_pangea,node_auth toneMint
class node_androidapp,node_phonewidgets,node_wearsync,node_wearapp,node_wearschedule,node_weartasks,node_classtile,node_classcomplication,node_taskcomplication,node_weardata,node_wearcarousel,node_wearnotify,node_wearreceiver,node_ios toneRose
class node_student toneIndigo
```

## Components

### Degree Planning

- [Academic Workspace](https://github.com/adir2368/semestero-me/blob/main/app.js): `app.js`
- [Degree Planner](https://github.com/adir2368/semestero-me/blob/main/planner_module.js): `planner_module.js`
- [Course Catalog](https://github.com/adir2368/semestero-me/blob/main/planner_catalog.js): `planner_catalog.js`
- [Prerequisite Map](https://github.com/adir2368/semestero-me/blob/main/curriculum_template.js): `curriculum_template.js`
- [GPA Simulator](https://github.com/adir2368/semestero-me/blob/main/grade_sheet.js): `grade_sheet.js`

### Study Operations

- [Tasks and Exams](https://github.com/adir2368/semestero-me/blob/main/attendance_hub.js): `attendance_hub.js`
- [Academic Calendar](https://github.com/adir2368/semestero-me/blob/main/calendar_sync_engine.js): `calendar_sync_engine.js`
- [Weekly Timetable](https://github.com/adir2368/semestero-me/blob/main/timetable_generator.js): `timetable_generator.js`

### Sync and Knowledge

- [Moodle Sync](https://github.com/adir2368/semestero-me/blob/main/moodle_sync.js): `moodle_sync.js`
- [CheeseFork](https://github.com/adir2368/semestero-me/blob/main/cheesefork_database.js): `cheesefork_database.js`
- [Pangea Resources](https://github.com/adir2368/semestero-me/blob/main/pangea_knowledge_hub.js): `pangea_knowledge_hub.js`
- [Account Sync](https://github.com/adir2368/semestero-me/blob/main/auth_sync.js): `auth_sync.js`

### Mobile and Wear

- [Android App Shell](https://github.com/adir2368/semestero-me/blob/main/android/app/src/main/java/com/technion/semestero/MainActivity.java): `android/app/src/main/java/com/technion/semestero/MainActivity.java`
- [Phone Widgets](https://github.com/adir2368/semestero-me/blob/main/android/app/src/main/java/com/technion/semestero/SemesteroScheduleWidget.java): `android/app/src/main/java/com/technion/semestero/SemesteroScheduleWidget.java`
- [Phone Wear Sync](https://github.com/adir2368/semestero-me/blob/main/android/app/src/main/java/com/technion/semestero/WearSyncManager.java): `android/app/src/main/java/com/technion/semestero/WearSyncManager.java`
- [Wear App](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/MainActivity.java): `android/wear/src/main/java/com/technion/semestero/wear/MainActivity.java`
- [Wear Schedule](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearScheduleHelper.java): `android/wear/src/main/java/com/technion/semestero/wear/WearScheduleHelper.java`
- [Wear Task Tile](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/SemesteroTasksTileService.java): `android/wear/src/main/java/com/technion/semestero/wear/SemesteroTasksTileService.java`
- [Class Tile](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/SemesteroClassTileService.java): `android/wear/src/main/java/com/technion/semestero/wear/SemesteroClassTileService.java`
- [Class Complication](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/SemesteroComplicationService.java): `android/wear/src/main/java/com/technion/semestero/wear/SemesteroComplicationService.java`
- [Task Complication](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/SemesteroTasksComplicationService.java): `android/wear/src/main/java/com/technion/semestero/wear/SemesteroTasksComplicationService.java`
- [Wear Data Sync](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearDataSyncService.java): `android/wear/src/main/java/com/technion/semestero/wear/WearDataSyncService.java`
- [Schedule Carousel](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearCarouselAdapter.java): `android/wear/src/main/java/com/technion/semestero/wear/WearCarouselAdapter.java`
- [Wear Notifications](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearNotificationHelper.java): `android/wear/src/main/java/com/technion/semestero/wear/WearNotificationHelper.java`
- [Notification Receiver](https://github.com/adir2368/semestero-me/blob/main/android/wear/src/main/java/com/technion/semestero/wear/WearNotificationReceiver.java): `android/wear/src/main/java/com/technion/semestero/wear/WearNotificationReceiver.java`
- [iOS App Shell](https://github.com/adir2368/semestero-me/blob/main/ios/App/App/SceneDelegate.swift): `ios/App/App/SceneDelegate.swift`

### Other components

- **Student**

## Connections

- Student → Academic Workspace: uses
- Academic Workspace → Degree Planner: plans degree
- Academic Workspace → Prerequisite Map: views prerequisites
- Academic Workspace → GPA Simulator: simulates GPA
- Academic Workspace → Tasks and Exams: tracks coursework
- Academic Workspace → Academic Calendar: views events
- Academic Workspace → Weekly Timetable: views schedule
- Academic Workspace → Moodle Sync: syncs deadlines
- Academic Workspace → CheeseFork: imports timetable
- Academic Workspace → Pangea Resources: links resources
- Academic Workspace → Course Catalog: offers courses
- Student → Android App Shell: opens app
- Student → iOS App Shell: opens app
- Android App Shell → Phone Wear Sync: syncs watch (evidence: `android/app/src/main/java/com/technion/semestero/MainActivity.java`)
- Android App Shell → Phone Widgets: updates widgets (evidence: `android/app/src/main/java/com/technion/semestero/MainActivity.java`)
- Phone Wear Sync → Wear Data Sync: transfers payload
- Wear App → Wear Schedule: uses schedule (evidence: `android/wear/src/main/java/com/technion/semestero/wear/MainActivity.java`)
- Wear App → Schedule Carousel: uses carousel (evidence: `android/wear/src/main/java/com/technion/semestero/wear/MainActivity.java`)
- Wear App → Wear Notifications: uses notifications (evidence: `android/wear/src/main/java/com/technion/semestero/wear/MainActivity.java`)
- Wear Schedule → Class Tile: serves schedule (evidence: `android/wear/src/main/java/com/technion/semestero/wear/WearScheduleHelper.java`)
- Wear Schedule → Class Complication: serves schedule (evidence: `android/wear/src/main/java/com/technion/semestero/wear/WearScheduleHelper.java`)
- Wear Data Sync → Wear Notifications: triggers alerts (evidence: `android/wear/src/main/java/com/technion/semestero/wear/WearDataSyncService.java`)
- Wear Data Sync → Task Complication: refreshes tasks (evidence: `android/wear/src/main/java/com/technion/semestero/wear/WearDataSyncService.java`)
- Wear Data Sync → Wear Schedule: updates schedule (evidence: `android/wear/src/main/java/com/technion/semestero/wear/WearDataSyncService.java`)
- Wear Notifications → Wear Schedule: uses schedule (evidence: `android/wear/src/main/java/com/technion/semestero/wear/WearNotificationHelper.java`)
