# xijordanwang/compx551-polar-assignment architecture

> Architecture diagram of the GitHub repository xijordanwang/compx551-polar-assignment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xijordanwang/compx551-polar-assignment
- Repository: https://github.com/xijordanwang/compx551-polar-assignment

## Overview

Polar Garden is an Android wellness app centered on Polar H10 workouts: users connect a strap, view live metrics, and save sessions according to their privacy mode; local workout history feeds points and plant growth. Major branches also cover account and assessment flows, ECG and baseline checks, history, leaderboard, and coaching. The README documents the principal data flows and storage choices; source excerpts did not include runtime Kotlin, so finer call ownership is not verified.

Main entry points: [`app/src/main/java/com/example/polar/data/DataGate.kt`](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/DataGate.kt) (Privacy gate), [`app/src/main/java/com/example/polar/ui/page/WorkoutPage.kt`](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/WorkoutPage.kt) (Workout screen), [`app/src/main/java/com/example/polar/ui/page/HistoryTab.kt`](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/HistoryTab.kt) (History screens), [`app/src/main/java/com/example/polar/ui/page/EcgPage.kt`](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/EcgPage.kt) (ECG screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and screens"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_workout_ui["Workout screen<br/>[WorkoutPage.kt]"]
  node_home_ui["Home screen<br/>[MainPage.kt]"]
  node_history_ui["History screens<br/>[HistoryTab.kt]"]
  node_account_ui["Account screens<br/>[SignPage.kt]"]
  node_assessment_ui["Assessment screen<br/>[AssessmentPage.kt]"]
  node_ecg_ui["ECG screen<br/>[EcgPage.kt]"]
  node_settings_ui["Settings screens<br/>[SettingsPage.kt]"]
end

subgraph group_sensors["Sensor and health"]
  node_polar["Polar connection<br/>[PolarManager.kt]"]
  node_ecg_processing["ECG filtering<br/>[filter_ecg.kt]"]
end

subgraph group_storage["Data and privacy"]
  node_data_gate["Privacy gate<br/>[DataGate.kt]"]
  node_room[("Local records<br/>[AppDatabase.kt]")]
  node_supabase[("Online records<br/>[Supabase.kt]")]
  node_preferences[("User preferences<br/>[SettingsStore.kt]")]
end

subgraph group_engagement["Progress and community"]
  node_points["Points calculation"]
  node_plant["Plant growth<br/>[Plant.kt]"]
  node_health["Health stats<br/>[Health.kt]"]
  node_social["Friends leaderboard<br/>[SocialTab.kt]"]
  node_coach["Coach messages<br/>[Coach.kt]"]
  node_notifications["Coach notifications<br/>[CoachNotifier.kt]"]
end

node_user(("User"))
node_h10["Polar H10"]

node_user -->|"opens app"| node_activity
node_activity -->|"sign-in flow"| node_account_ui
node_user -->|"starts workout"| node_workout_ui
node_workout_ui -->|"subscribes stream"| node_polar
node_h10 -->|"streams BLE data"| node_polar
node_workout_ui -->|"saves session"| node_data_gate
node_data_gate -->|"stores raw workout"| node_room
node_data_gate -->|"uploads summary"| node_supabase
node_room -->|"emits workout flow"| node_home_ui
node_home_ui -->|"recalculates points"| node_points
node_points -->|"grows plant"| node_plant
node_user -->|"enters measurements"| node_assessment_ui
node_assessment_ui -->|"stores assessment"| node_supabase
node_user -->|"runs ECG check"| node_ecg_ui
node_ecg_ui -->|"saves ECG"| node_data_gate
node_user -->|"views history"| node_history_ui
node_history_ui -->|"reads sessions"| node_room
node_user -->|"views leaderboard"| node_social
node_social -->|"reads rankings"| node_supabase
node_user -->|"changes privacy"| node_settings_ui
node_settings_ui -->|"stores settings"| node_preferences
node_user -->|"chooses coach mode"| node_coach
node_coach -->|"provides messages"| node_notifications
node_ecg_ui -.->|"filters ECG"| node_ecg_processing
node_history_ui -.->|"shows health stats"| node_health

click node_activity "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/MainActivity.kt"
click node_workout_ui "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/WorkoutPage.kt"
click node_home_ui "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/MainPage.kt"
click node_history_ui "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/HistoryTab.kt"
click node_account_ui "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/SignPage.kt"
click node_assessment_ui "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/AssessmentPage.kt"
click node_ecg_ui "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/EcgPage.kt"
click node_settings_ui "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/SettingsPage.kt"
click node_polar "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/polar/PolarManager.kt"
click node_ecg_processing "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/processing/filter_ecg.kt"
click node_data_gate "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/DataGate.kt"
click node_room "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/db/AppDatabase.kt"
click node_supabase "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/online/Supabase.kt"
click node_preferences "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/prefs/SettingsStore.kt"
click node_points "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/logic/PointsCalculator.kt"
click node_plant "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/logic/Plant.kt"
click node_health "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/logic/Health.kt"
click node_social "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/SocialTab.kt"
click node_coach "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/logic/Coach.kt"
click node_notifications "https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/notify/CoachNotifier.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_activity,node_workout_ui,node_home_ui,node_history_ui,node_account_ui,node_assessment_ui,node_ecg_ui,node_settings_ui,node_user toneBlue
class node_polar,node_ecg_processing toneAmber
class node_data_gate,node_room,node_supabase,node_preferences toneMint
class node_points,node_plant,node_health,node_social,node_coach,node_notifications toneRose
class node_h10 toneIndigo
```

## Components

### App and screens

- [App entry](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/MainActivity.kt): `app/src/main/java/com/example/polar/MainActivity.kt`
- [Workout screen](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/WorkoutPage.kt): `app/src/main/java/com/example/polar/ui/page/WorkoutPage.kt`
- [Home screen](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/MainPage.kt): `app/src/main/java/com/example/polar/ui/page/MainPage.kt`
- [History screens](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/HistoryTab.kt): `app/src/main/java/com/example/polar/ui/page/HistoryTab.kt`
- [Account screens](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/SignPage.kt): `app/src/main/java/com/example/polar/ui/page/SignPage.kt`
- [Assessment screen](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/AssessmentPage.kt): `app/src/main/java/com/example/polar/ui/page/AssessmentPage.kt`
- [ECG screen](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/EcgPage.kt): `app/src/main/java/com/example/polar/ui/page/EcgPage.kt`
- [Settings screens](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/SettingsPage.kt): `app/src/main/java/com/example/polar/ui/page/SettingsPage.kt`

### Sensor and health

- [Polar connection](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/polar/PolarManager.kt): `app/src/main/java/com/example/polar/data/polar/PolarManager.kt`
- [ECG filtering](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/processing/filter_ecg.kt): `app/src/main/java/com/example/polar/data/processing/filter_ecg.kt`

### Data and privacy

- [Privacy gate](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/DataGate.kt): `app/src/main/java/com/example/polar/data/DataGate.kt`
- [Local records](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/db/AppDatabase.kt): `app/src/main/java/com/example/polar/data/db/AppDatabase.kt`
- [Online records](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/online/Supabase.kt): `app/src/main/java/com/example/polar/data/online/Supabase.kt`
- [User preferences](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/data/prefs/SettingsStore.kt): `app/src/main/java/com/example/polar/data/prefs/SettingsStore.kt`

### Progress and community

- [Points calculation](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/logic/PointsCalculator.kt): `app/src/main/java/com/example/polar/logic/PointsCalculator.kt`
- [Plant growth](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/logic/Plant.kt): `app/src/main/java/com/example/polar/logic/Plant.kt`
- [Health stats](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/logic/Health.kt): `app/src/main/java/com/example/polar/logic/Health.kt`
- [Friends leaderboard](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/ui/page/SocialTab.kt): `app/src/main/java/com/example/polar/ui/page/SocialTab.kt`
- [Coach messages](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/logic/Coach.kt): `app/src/main/java/com/example/polar/logic/Coach.kt`
- [Coach notifications](https://github.com/xijordanwang/compx551-polar-assignment/blob/main/app/src/main/java/com/example/polar/notify/CoachNotifier.kt): `app/src/main/java/com/example/polar/notify/CoachNotifier.kt`

### Other components

- **User**
- **Polar H10**

## Connections

- User → App entry: opens app (evidence: `README.md`)
- App entry → Account screens: sign-in flow (evidence: `README.md`)
- User → Workout screen: starts workout (evidence: `README.md`)
- Workout screen → Polar connection: subscribes stream (evidence: `README.md`)
- Polar H10 → Polar connection: streams BLE data (evidence: `README.md`)
- Workout screen → Privacy gate: saves session (evidence: `README.md`)
- Privacy gate → Local records: stores raw workout (evidence: `README.md`)
- Privacy gate → Online records: uploads summary (evidence: `README.md`)
- Local records → Home screen: emits workout flow (evidence: `README.md`)
- Home screen → Points calculation: recalculates points (evidence: `README.md`)
- Points calculation → Plant growth: grows plant (evidence: `README.md`)
- User → Assessment screen: enters measurements (evidence: `README.md`)
- Assessment screen → Online records: stores assessment (evidence: `README.md`)
- User → ECG screen: runs ECG check (evidence: `README.md`)
- ECG screen → Privacy gate: saves ECG (evidence: `README.md`)
- User → History screens: views history (evidence: `README.md`)
- History screens → Local records: reads sessions (evidence: `README.md`)
- User → Friends leaderboard: views leaderboard (evidence: `README.md`)
- Friends leaderboard → Online records: reads rankings (evidence: `README.md`)
- User → Settings screens: changes privacy (evidence: `README.md`)
- Settings screens → User preferences: stores settings (evidence: `README.md`)
- User → Coach messages: chooses coach mode (evidence: `README.md`)
- Coach messages → Coach notifications: provides messages (evidence: `README.md`)
- ECG screen → ECG filtering: filters ECG
- History screens → Health stats: shows health stats
