# annasajkh/internetbackalert architecture

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

## Overview

InternetBackAlert is a desktop utility that detects an internet outage and alerts when connectivity returns. Its main workflow runs through the desktop entry point and MainSystem: periodic connectivity checks establish a confirmed disconnect, then a later reconnection can trigger configured audio and a popup. The UI exposes alert settings, which are serialized to a local JSON file. Audio is implemented through SDL_mixer bindings. Excerpts establish the core calls; some settings and alert details are only partially shown.

Main entry points: [`InternetBackAlert/Source/Systems/MainSystem.cs`](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Systems/MainSystem.cs) (Alert coordinator), [`InternetBackAlert/Source/UIs/Containers/MainContainer.cs`](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/UIs/Containers/MainContainer.cs) (Main settings UI), [`InternetBackAlert/Source/Program.cs`](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Program.cs) (Application startup), [`InternetBackAlert/Source/Audio/Music.cs`](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/Music.cs) (Music resource)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_program["Application startup<br/>[Program.cs]"]
  node_main_ui["Main settings UI<br/>[MainContainer.cs]"]
  node_main_system["Alert coordinator<br/>[MainSystem.cs]"]
  node_popup["Reconnect notification<br/>[MainSystem.cs]"]
end

subgraph group_monitor["Connectivity monitoring"]
  node_connectivity["Internet probe<br/>[Helper.cs]"]
end

subgraph group_settings["Alert settings"]
  node_settings_model["Settings data<br/>[SettingsData.cs]"]
  node_settings_store["JSON settings store<br/>[Settings.cs]"]
end

subgraph group_audio["Audio playback"]
  node_audio_types["Audio base types<br/>[Audio.cs]"]
  node_music["Music resource<br/>[Music.cs]"]
  node_music_player["Music player<br/>[MusicPlayer.cs]"]
  node_sound_effect["Sound effect resource<br/>[SoundEffect.cs]"]
  node_sound_player["Sound effect player"]
  node_global["Shared audio state<br/>[Global.cs]"]
  node_sdl["SDL2 native bindings<br/>[SDL2.cs]"]
  node_mixer["SDL_mixer bindings<br/>[SDL2_mixer.cs]"]
end

node_user(("Desktop user"))
node_internet(("Internet host"))

node_user -->|"starts"| node_program
node_program -->|"creates"| node_main_ui
node_program -->|"starts"| node_main_system
node_main_system -->|"updates"| node_main_ui
node_main_system -->|"probes"| node_connectivity
node_connectivity -->|"pings"| node_internet
node_main_ui -->|"loads"| node_settings_store
node_main_ui -->|"uses"| node_settings_model
node_main_system -->|"saves"| node_settings_store
node_settings_store -->|"serializes"| node_settings_model
node_main_system -->|"loads"| node_music
node_music -->|"inherits"| node_audio_types
node_main_system -->|"uses"| node_global
node_global -->|"creates"| node_music_player
node_main_system -->|"plays"| node_music_player
node_music_player -->|"plays"| node_music
node_music -->|"calls"| node_mixer
node_music_player -->|"calls"| node_mixer
node_sound_effect -->|"inherits"| node_audio_types
node_sound_player -->|"plays"| node_sound_effect
node_sound_effect -->|"calls"| node_mixer
node_sound_player -->|"calls"| node_mixer
node_program -->|"initializes"| node_sdl
node_main_system -->|"shows"| node_popup
node_user -->|"configures"| node_main_ui

click node_program "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Program.cs"
click node_main_ui "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/UIs/Containers/MainContainer.cs"
click node_main_system "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Systems/MainSystem.cs"
click node_connectivity "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Utils/Helper.cs"
click node_settings_model "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Data/SettingsData.cs"
click node_settings_store "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Utils/Settings.cs"
click node_audio_types "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/Audio.cs"
click node_music "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/Music.cs"
click node_music_player "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/MusicPlayer.cs"
click node_sound_effect "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/SoundEffect.cs"
click node_sound_player "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/SoundEffectPlayer.cs"
click node_global "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Utils/Global.cs"
click node_sdl "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Bindings/SDL2/SDL2.cs"
click node_mixer "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Bindings/SDL2/SDL2_mixer.cs"
click node_popup "https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Systems/MainSystem.cs"

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_program,node_main_ui,node_main_system,node_popup,node_user toneBlue
class node_connectivity toneAmber
class node_settings_model,node_settings_store toneMint
class node_audio_types,node_music,node_music_player,node_sound_effect,node_sound_player,node_global,node_sdl,node_mixer toneRose
class node_internet toneIndigo
```

## Components

### Desktop application

- [Application startup](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Program.cs): `InternetBackAlert/Source/Program.cs`
- [Main settings UI](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/UIs/Containers/MainContainer.cs): `InternetBackAlert/Source/UIs/Containers/MainContainer.cs`
- [Alert coordinator](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Systems/MainSystem.cs): `InternetBackAlert/Source/Systems/MainSystem.cs`
- [Reconnect notification](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Systems/MainSystem.cs): `InternetBackAlert/Source/Systems/MainSystem.cs`

### Connectivity monitoring

- [Internet probe](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Utils/Helper.cs): `InternetBackAlert/Source/Utils/Helper.cs`

### Alert settings

- [Settings data](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Data/SettingsData.cs): `InternetBackAlert/Source/Data/SettingsData.cs`
- [JSON settings store](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Utils/Settings.cs): `InternetBackAlert/Source/Utils/Settings.cs`

### Audio playback

- [Audio base types](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/Audio.cs): `InternetBackAlert/Source/Audio/Audio.cs`
- [Music resource](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/Music.cs): `InternetBackAlert/Source/Audio/Music.cs`
- [Music player](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/MusicPlayer.cs): `InternetBackAlert/Source/Audio/MusicPlayer.cs`
- [Sound effect resource](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/SoundEffect.cs): `InternetBackAlert/Source/Audio/SoundEffect.cs`
- [Sound effect player](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Audio/SoundEffectPlayer.cs): `InternetBackAlert/Source/Audio/SoundEffectPlayer.cs`
- [Shared audio state](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Utils/Global.cs): `InternetBackAlert/Source/Utils/Global.cs`
- [SDL2 native bindings](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Bindings/SDL2/SDL2.cs): `InternetBackAlert/Source/Bindings/SDL2/SDL2.cs`
- [SDL_mixer bindings](https://github.com/annasajkh/internetbackalert/blob/main/InternetBackAlert/Source/Bindings/SDL2/SDL2_mixer.cs): `InternetBackAlert/Source/Bindings/SDL2/SDL2_mixer.cs`

### Other components

- **Desktop user**
- **Internet host**

## Connections

- Desktop user → Application startup: starts (evidence: `InternetBackAlert/Source/Program.cs`)
- Application startup → Main settings UI: creates (evidence: `InternetBackAlert/Source/Program.cs`)
- Application startup → Alert coordinator: starts (evidence: `InternetBackAlert/Source/Program.cs`)
- Alert coordinator → Main settings UI: updates (evidence: `InternetBackAlert/Source/Systems/MainSystem.cs`)
- Alert coordinator → Internet probe: probes (evidence: `InternetBackAlert/Source/Systems/MainSystem.cs`)
- Internet probe → Internet host: pings (evidence: `InternetBackAlert/Source/Utils/Helper.cs`)
- Main settings UI → JSON settings store: loads (evidence: `InternetBackAlert/Source/UIs/Containers/MainContainer.cs`)
- Main settings UI → Settings data: uses (evidence: `InternetBackAlert/Source/UIs/Containers/MainContainer.cs`)
- Alert coordinator → JSON settings store: saves (evidence: `InternetBackAlert/Source/Systems/MainSystem.cs`)
- JSON settings store → Settings data: serializes (evidence: `InternetBackAlert/Source/Utils/Settings.cs`)
- Alert coordinator → Music resource: loads (evidence: `InternetBackAlert/Source/Systems/MainSystem.cs`)
- Music resource → Audio base types: inherits (evidence: `InternetBackAlert/Source/Audio/Music.cs`)
- Alert coordinator → Shared audio state: uses (evidence: `InternetBackAlert/Source/Systems/MainSystem.cs`)
- Shared audio state → Music player: creates (evidence: `InternetBackAlert/Source/Utils/Global.cs`)
- Alert coordinator → Music player: plays (evidence: `InternetBackAlert/Source/Systems/MainSystem.cs`)
- Music player → Music resource: plays (evidence: `InternetBackAlert/Source/Audio/MusicPlayer.cs`)
- Music resource → SDL_mixer bindings: calls (evidence: `InternetBackAlert/Source/Audio/Music.cs`)
- Music player → SDL_mixer bindings: calls (evidence: `InternetBackAlert/Source/Audio/MusicPlayer.cs`)
- Sound effect resource → Audio base types: inherits (evidence: `InternetBackAlert/Source/Audio/SoundEffect.cs`)
- Sound effect player → Sound effect resource: plays (evidence: `InternetBackAlert/Source/Audio/SoundEffectPlayer.cs`)
- Sound effect resource → SDL_mixer bindings: calls (evidence: `InternetBackAlert/Source/Audio/SoundEffect.cs`)
- Sound effect player → SDL_mixer bindings: calls (evidence: `InternetBackAlert/Source/Audio/SoundEffectPlayer.cs`)
- Application startup → SDL2 native bindings: initializes (evidence: `InternetBackAlert/Source/Program.cs`)
- Alert coordinator → Reconnect notification: shows (evidence: `InternetBackAlert/Source/Systems/MainSystem.cs`)
- Desktop user → Main settings UI: configures (evidence: `InternetBackAlert/Source/UIs/Containers/MainContainer.cs`)
