# macchp3840/sveglia architecture

> Architecture diagram of the GitHub repository macchp3840/sveglia, 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/macchp3840/sveglia
- Repository: https://github.com/macchp3840/sveglia

## Overview

Sveglia Dura is an Android alarm designed to require wake-up missions before silencing. The user configures an alarm and its missions, the app schedules it, and at trigger time a foreground service rings while the alarm screen guides the user through math, shaking, or barcode scanning. A delayed wakefulness check can restart ringing if unanswered. The README also documents rising volume, reboot recovery, and sound/language settings. Edges reflect shown calls, indexed references, or README statements; unsampled implementation details are not inferred.

Main entry points: [`app/src/main/java/it/sveglia/AlarmScheduler.kt`](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmScheduler.kt) (Alarm scheduler), [`app/src/main/java/it/sveglia/AlarmService.kt`](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmService.kt) (Ringing service), [`app/src/main/java/it/sveglia/AlarmPrefs.kt`](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmPrefs.kt) (Alarm preferences), [`app/src/main/java/it/sveglia/HomeActivity.kt`](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/HomeActivity.kt) (Home screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Alarm setup"]
  node_home["Home screen<br/>[HomeActivity.kt]"]
  node_editor["Alarm editor<br/>[MainActivity.kt]"]
  node_wheel["Time wheel<br/>[WheelPicker.kt]"]
  node_settings["App settings"]
end

subgraph group_runtime["Alarm runtime"]
  node_scheduler["Alarm scheduler<br/>[AlarmScheduler.kt]"]
  node_receiver["Alarm receiver<br/>[AlarmReceiver.kt]"]
  node_boot["Boot recovery<br/>[BootReceiver.kt]"]
  node_service["Ringing service<br/>[AlarmService.kt]"]
end

subgraph group_mission["Wake-up missions"]
  node_alarm_ui["Alarm screen<br/>[AlarmActivity.kt]"]
  node_mission_state["Mission state<br/>[MissionState.kt]"]
  node_barcode["Barcode scanner<br/>[AlarmActivity.kt]"]
end

subgraph group_support["Persistence and presentation"]
  node_prefs[("Alarm preferences<br/>[AlarmPrefs.kt]")]
  node_flaps["Flap display<br/>[Flaps.kt]"]
end

node_user(("User"))
node_android_alarm["Android alarm manager"]
node_sensor["Phone accelerometer"]
node_sound["Alarm sound"]
node_vibration["Phone vibration"]
node_scanner_service["Google Play Services"]

node_user -->|"opens"| node_home
node_home -->|"edits alarm"| node_editor
node_home -->|"opens settings"| node_settings
node_home -->|"reads settings"| node_prefs
node_home -->|"renders time"| node_flaps
node_editor -->|"uses picker"| node_wheel
node_editor -->|"saves settings"| node_prefs
node_editor -->|"schedules test"| node_scheduler
node_settings -->|"saves options"| node_prefs
node_settings -->|"reschedules alarm"| node_scheduler
node_scheduler -->|"reads schedule"| node_prefs
node_scheduler -->|"sets alarms"| node_android_alarm
node_android_alarm -->|"dispatches broadcast"| node_receiver
node_receiver -->|"updates ring state"| node_prefs
node_receiver -->|"reschedules"| node_scheduler
node_receiver -->|"starts ringing"| node_service
node_boot -->|"restores schedule"| node_scheduler
node_boot -->|"checks pending ring"| node_prefs
node_service -->|"launches screen"| node_alarm_ui
node_service -->|"plays alarm"| node_sound
node_service -->|"vibrates"| node_vibration
node_service -->|"reads sound options"| node_prefs
node_alarm_ui -->|"reads progress"| node_mission_state
node_alarm_ui -->|"sends completion"| node_service
node_alarm_ui -->|"detects shaking"| node_sensor
node_alarm_ui -->|"starts scan"| node_barcode
node_barcode -->|"requests scan"| node_scanner_service
node_service -->|"schedules wake check"| node_scheduler
node_scheduler -->|"targets broadcasts"| node_receiver

click node_home "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/HomeActivity.kt"
click node_editor "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/MainActivity.kt"
click node_wheel "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/WheelPicker.kt"
click node_settings "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/SettingsActivity.kt"
click node_prefs "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmPrefs.kt"
click node_scheduler "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmScheduler.kt"
click node_receiver "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmReceiver.kt"
click node_boot "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/BootReceiver.kt"
click node_service "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmService.kt"
click node_alarm_ui "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmActivity.kt"
click node_mission_state "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/MissionState.kt"
click node_barcode "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmActivity.kt"
click node_flaps "https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/Flaps.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_editor,node_wheel,node_settings,node_user toneBlue
class node_scheduler,node_receiver,node_boot,node_service toneAmber
class node_alarm_ui,node_mission_state,node_barcode toneMint
class node_prefs,node_flaps toneRose
class node_android_alarm,node_sensor,node_sound,node_vibration,node_scanner_service toneIndigo
```

## Components

### Alarm setup

- [Home screen](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/HomeActivity.kt): `app/src/main/java/it/sveglia/HomeActivity.kt`
- [Alarm editor](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/MainActivity.kt): `app/src/main/java/it/sveglia/MainActivity.kt`
- [Time wheel](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/WheelPicker.kt): `app/src/main/java/it/sveglia/WheelPicker.kt`
- [App settings](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/SettingsActivity.kt): `app/src/main/java/it/sveglia/SettingsActivity.kt`

### Alarm runtime

- [Alarm scheduler](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmScheduler.kt): `app/src/main/java/it/sveglia/AlarmScheduler.kt`
- [Alarm receiver](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmReceiver.kt): `app/src/main/java/it/sveglia/AlarmReceiver.kt`
- [Boot recovery](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/BootReceiver.kt): `app/src/main/java/it/sveglia/BootReceiver.kt`
- [Ringing service](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmService.kt): `app/src/main/java/it/sveglia/AlarmService.kt`

### Wake-up missions

- [Alarm screen](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmActivity.kt): `app/src/main/java/it/sveglia/AlarmActivity.kt`
- [Mission state](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/MissionState.kt): `app/src/main/java/it/sveglia/MissionState.kt`
- [Barcode scanner](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmActivity.kt): `app/src/main/java/it/sveglia/AlarmActivity.kt`

### Persistence and presentation

- [Alarm preferences](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/AlarmPrefs.kt): `app/src/main/java/it/sveglia/AlarmPrefs.kt`
- [Flap display](https://github.com/macchp3840/sveglia/blob/main/app/src/main/java/it/sveglia/Flaps.kt): `app/src/main/java/it/sveglia/Flaps.kt`

### Other components

- **User**
- **Android alarm manager**
- **Phone accelerometer**
- **Alarm sound**
- **Phone vibration**
- **Google Play Services**

## Connections

- User → Home screen: opens (evidence: `README.md`)
- Home screen → Alarm editor: edits alarm (evidence: `app/src/main/java/it/sveglia/HomeActivity.kt`)
- Home screen → App settings: opens settings (evidence: `app/src/main/java/it/sveglia/HomeActivity.kt`)
- Home screen → Alarm preferences: reads settings (evidence: `app/src/main/java/it/sveglia/HomeActivity.kt`)
- Home screen → Flap display: renders time (evidence: `app/src/main/java/it/sveglia/HomeActivity.kt`)
- Alarm editor → Time wheel: uses picker (evidence: `app/src/main/java/it/sveglia/MainActivity.kt`)
- Alarm editor → Alarm preferences: saves settings (evidence: `app/src/main/java/it/sveglia/MainActivity.kt`)
- Alarm editor → Alarm scheduler: schedules test (evidence: `app/src/main/java/it/sveglia/MainActivity.kt`)
- App settings → Alarm preferences: saves options (evidence: `app/src/main/java/it/sveglia/SettingsActivity.kt`)
- App settings → Alarm scheduler: reschedules alarm (evidence: `app/src/main/java/it/sveglia/SettingsActivity.kt`)
- Alarm scheduler → Alarm preferences: reads schedule (evidence: `app/src/main/java/it/sveglia/AlarmScheduler.kt`)
- Alarm scheduler → Android alarm manager: sets alarms (evidence: `README.md`)
- Android alarm manager → Alarm receiver: dispatches broadcast
- Alarm receiver → Alarm preferences: updates ring state (evidence: `app/src/main/java/it/sveglia/AlarmReceiver.kt`)
- Alarm receiver → Alarm scheduler: reschedules (evidence: `app/src/main/java/it/sveglia/AlarmReceiver.kt`)
- Alarm receiver → Ringing service: starts ringing (evidence: `app/src/main/java/it/sveglia/AlarmReceiver.kt`)
- Boot recovery → Alarm scheduler: restores schedule (evidence: `app/src/main/java/it/sveglia/BootReceiver.kt`)
- Boot recovery → Alarm preferences: checks pending ring (evidence: `app/src/main/java/it/sveglia/BootReceiver.kt`)
- Ringing service → Alarm screen: launches screen (evidence: `app/src/main/java/it/sveglia/AlarmService.kt`)
- Ringing service → Alarm sound: plays alarm (evidence: `README.md`)
- Ringing service → Phone vibration: vibrates (evidence: `README.md`)
- Ringing service → Alarm preferences: reads sound options (evidence: `app/src/main/java/it/sveglia/AlarmService.kt`)
- Alarm screen → Mission state: reads progress (evidence: `app/src/main/java/it/sveglia/AlarmActivity.kt`)
- Alarm screen → Ringing service: sends completion (evidence: `app/src/main/java/it/sveglia/AlarmActivity.kt`)
- Alarm screen → Phone accelerometer: detects shaking (evidence: `README.md`)
- Alarm screen → Barcode scanner: starts scan (evidence: `app/src/main/java/it/sveglia/AlarmActivity.kt`)
- Barcode scanner → Google Play Services: requests scan (evidence: `README.md`)
- Ringing service → Alarm scheduler: schedules wake check (evidence: `app/src/main/java/it/sveglia/AlarmService.kt`)
- Alarm scheduler → Alarm receiver: targets broadcasts (evidence: `app/src/main/java/it/sveglia/AlarmScheduler.kt`)
