# fedeveloper95/med architecture

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

- Interactive diagram: https://gitdiagram.com/fedeveloper95/med
- Repository: https://github.com/fedeveloper95/med

## Overview

Med is an Android medicine and medical-history tracker with a Wear OS companion. The primary workflow is recording medicines or events, then relying on flexible schedules, notifications, and alarms to support taking medication; the watch can display synced items and send event or alarm actions back. Settings, onboarding, data portability, and in-app updates are additional product branches. The excerpts and source index show selected calls and imports; links for unsampled domain behavior are omitted rather than inferred.

Main entry points: [`app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt`](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt) (Settings hub), [`app/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt) (Home screen), [`wear/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`](https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt) (Watch home), [`wear/src/main/kotlin/com/fedeveloper95/med/services/WearDataManager.kt`](https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/services/WearDataManager.kt) (Watch data manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_phone["Phone app"]
  node_home["Home screen<br/>[MainActivity.kt]"]
  node_welcome["Onboarding<br/>[WelcomeActivity.kt]"]
  node_updater["In-app updater<br/>[Updater.kt]"]
end

subgraph group_care["Medication tracking"]
  node_medicine_editor["Medicine editor"]
  node_edit_mode["Edit mode"]
  node_medical_profile["Medical profile<br/>[You.kt]"]
  node_stats["Stats view<br/>[Stats.kt]"]
  node_app_data["App data layer<br/>[MedApp.kt]"]
end

subgraph group_platform["Reminders and settings"]
  node_alarms["Alarm handling<br/>[AlarmActivity.kt]"]
  node_alarm_service["Alarm service<br/>[AlarmService.kt]"]
  node_settings["Settings hub"]
  node_notification_settings["Notification settings"]
  node_quick_settings["Quick actions"]
  node_inventory_settings["Inventory settings"]
  node_advanced_settings["Advanced settings"]
  node_csv["Data portability<br/>[CsvPortability.kt]"]
end

subgraph group_watch["Wear companion"]
  node_watch_home["Watch home<br/>[MainActivity.kt]"]
  node_watch_add["Add event"]
  node_watch_data["Watch data manager<br/>[WearDataManager.kt]"]
  node_watch_listener["Watch listener"]
  node_watch_alarm["Watch alarm<br/>[Alarm.kt]"]
  node_phone_wear["Phone sync"]
  node_wear_sync["Wear sync manager<br/>[WearSyncManager.kt]"]
  node_wear_service["Wear data service"]
end

node_user(("User"))

node_user -.->|"opens"| node_home
node_user -.->|"records medicines"| node_medicine_editor
node_user -.->|"edits tracking"| node_edit_mode
node_home -->|"uses"| node_app_data
node_home -->|"uses"| node_updater
node_home -->|"opens"| node_notification_settings
node_settings -->|"opens"| node_notification_settings
node_settings -->|"opens"| node_quick_settings
node_settings -->|"opens"| node_inventory_settings
node_settings -->|"opens"| node_advanced_settings
node_advanced_settings -->|"uses"| node_csv
node_alarms -->|"starts"| node_alarm_service
node_watch_home -->|"initializes"| node_watch_data
node_watch_home -->|"opens"| node_watch_add
node_watch_add -->|"sends event"| node_watch_data
node_watch_listener -->|"updates"| node_watch_data
node_watch_listener -->|"launches"| node_watch_alarm
node_phone_wear -->|"uses"| node_wear_sync
node_wear_service -.->|"uses"| node_wear_sync
node_user -.->|"sets up"| node_welcome
node_user -.->|"uses companion"| node_watch_home

click node_home "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt"
click node_medicine_editor "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/MedicineBottomSheet.kt"
click node_edit_mode "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/EditModeActivity.kt"
click node_medical_profile "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/Tabs/You.kt"
click node_stats "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/Tabs/Stats.kt"
click node_app_data "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/services/MedApp.kt"
click node_alarms "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/AlarmActivity.kt"
click node_alarm_service "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/services/AlarmService.kt"
click node_settings "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt"
click node_notification_settings "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/NotificationsSettingsActivity.kt"
click node_quick_settings "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/QuickActionsSettingsActivity.kt"
click node_inventory_settings "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/InventorySettingsActivity.kt"
click node_advanced_settings "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/AdvancedSettingsActivity.kt"
click node_csv "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/services/CsvPortability.kt"
click node_welcome "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/WelcomeActivity.kt"
click node_updater "https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/services/Updater.kt"
click node_watch_home "https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt"
click node_watch_add "https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/AddEventActivity.kt"
click node_watch_data "https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/services/WearDataManager.kt"
click node_watch_listener "https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/services/WatchWearListenerService.kt"
click node_watch_alarm "https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/Alarm.kt"
click node_phone_wear "https://github.com/fedeveloper95/med/blob/main/app/src/github/kotlin/com/fedeveloper95/med/services/AppWearListenerService.kt"
click node_wear_sync "https://github.com/fedeveloper95/med/blob/main/app/src/github/kotlin/com/fedeveloper95/med/services/WearSyncManager.kt"
click node_wear_service "https://github.com/fedeveloper95/med/blob/main/app/src/foss/kotlin/com/fedeveloper95/med/services/AppWearListenerService.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_home,node_welcome,node_updater,node_user toneBlue
class node_medicine_editor,node_edit_mode,node_medical_profile,node_stats,node_app_data toneAmber
class node_alarms,node_alarm_service,node_settings,node_notification_settings,node_quick_settings,node_inventory_settings,node_advanced_settings,node_csv toneMint
class node_watch_home,node_watch_add,node_watch_data,node_watch_listener,node_watch_alarm,node_phone_wear,node_wear_sync,node_wear_service toneRose
```

## Components

### Phone app

- [Home screen](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`
- [Onboarding](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/WelcomeActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/WelcomeActivity.kt`
- [In-app updater](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/services/Updater.kt): `app/src/main/kotlin/com/fedeveloper95/med/services/Updater.kt`

### Medication tracking

- [Medicine editor](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/MedicineBottomSheet.kt): `app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/MedicineBottomSheet.kt`
- [Edit mode](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/EditModeActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/EditModeActivity.kt`
- [Medical profile](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/Tabs/You.kt): `app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/Tabs/You.kt`
- [Stats view](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/Tabs/Stats.kt): `app/src/main/kotlin/com/fedeveloper95/med/elements/MainActivity/Tabs/Stats.kt`
- [App data layer](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/services/MedApp.kt): `app/src/main/kotlin/com/fedeveloper95/med/services/MedApp.kt`

### Reminders and settings

- [Alarm handling](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/AlarmActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/AlarmActivity.kt`
- [Alarm service](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/services/AlarmService.kt): `app/src/main/kotlin/com/fedeveloper95/med/services/AlarmService.kt`
- [Settings hub](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt`
- [Notification settings](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/NotificationsSettingsActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/NotificationsSettingsActivity.kt`
- [Quick actions](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/QuickActionsSettingsActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/QuickActionsSettingsActivity.kt`
- [Inventory settings](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/InventorySettingsActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/InventorySettingsActivity.kt`
- [Advanced settings](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/AdvancedSettingsActivity.kt): `app/src/main/kotlin/com/fedeveloper95/med/AdvancedSettingsActivity.kt`
- [Data portability](https://github.com/fedeveloper95/med/blob/main/app/src/main/kotlin/com/fedeveloper95/med/services/CsvPortability.kt): `app/src/main/kotlin/com/fedeveloper95/med/services/CsvPortability.kt`

### Wear companion

- [Watch home](https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt): `wear/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`
- [Add event](https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/AddEventActivity.kt): `wear/src/main/kotlin/com/fedeveloper95/med/AddEventActivity.kt`
- [Watch data manager](https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/services/WearDataManager.kt): `wear/src/main/kotlin/com/fedeveloper95/med/services/WearDataManager.kt`
- [Watch listener](https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/services/WatchWearListenerService.kt): `wear/src/main/kotlin/com/fedeveloper95/med/services/WatchWearListenerService.kt`
- [Watch alarm](https://github.com/fedeveloper95/med/blob/main/wear/src/main/kotlin/com/fedeveloper95/med/Alarm.kt): `wear/src/main/kotlin/com/fedeveloper95/med/Alarm.kt`
- [Phone sync](https://github.com/fedeveloper95/med/blob/main/app/src/github/kotlin/com/fedeveloper95/med/services/AppWearListenerService.kt): `app/src/github/kotlin/com/fedeveloper95/med/services/AppWearListenerService.kt`
- [Wear sync manager](https://github.com/fedeveloper95/med/blob/main/app/src/github/kotlin/com/fedeveloper95/med/services/WearSyncManager.kt): `app/src/github/kotlin/com/fedeveloper95/med/services/WearSyncManager.kt`
- [Wear data service](https://github.com/fedeveloper95/med/blob/main/app/src/foss/kotlin/com/fedeveloper95/med/services/AppWearListenerService.kt): `app/src/foss/kotlin/com/fedeveloper95/med/services/AppWearListenerService.kt`

### Other components

- **User**

## Connections

- User → Home screen: opens
- User → Medicine editor: records medicines
- User → Edit mode: edits tracking
- Home screen → App data layer: uses (evidence: `app/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`)
- Home screen → In-app updater: uses (evidence: `app/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`)
- Home screen → Notification settings: opens (evidence: `app/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`)
- Settings hub → Notification settings: opens (evidence: `app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt`)
- Settings hub → Quick actions: opens (evidence: `app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt`)
- Settings hub → Inventory settings: opens (evidence: `app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt`)
- Settings hub → Advanced settings: opens (evidence: `app/src/main/kotlin/com/fedeveloper95/med/SettingsActivity.kt`)
- Advanced settings → Data portability: uses (evidence: `app/src/main/kotlin/com/fedeveloper95/med/AdvancedSettingsActivity.kt`)
- Alarm handling → Alarm service: starts (evidence: `app/src/main/kotlin/com/fedeveloper95/med/AlarmActivity.kt`)
- Watch home → Watch data manager: initializes (evidence: `wear/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`)
- Watch home → Add event: opens (evidence: `wear/src/main/kotlin/com/fedeveloper95/med/MainActivity.kt`)
- Add event → Watch data manager: sends event (evidence: `wear/src/main/kotlin/com/fedeveloper95/med/AddEventActivity.kt`)
- Watch listener → Watch data manager: updates (evidence: `wear/src/main/kotlin/com/fedeveloper95/med/services/WatchWearListenerService.kt`)
- Watch listener → Watch alarm: launches (evidence: `wear/src/main/kotlin/com/fedeveloper95/med/services/WatchWearListenerService.kt`)
- Phone sync → Wear sync manager: uses (evidence: `app/src/github/kotlin/com/fedeveloper95/med/services/AppWearListenerService.kt`)
- Wear data service → Wear sync manager: uses
- User → Onboarding: sets up
- User → Watch home: uses companion
