# i2van/hourglass architecture

> Architecture diagram of the GitHub repository i2van/hourglass, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/i2van/hourglass
- Repository: https://github.com/i2van/hourglass

## Overview

##### Main Components

a. Core Application Layer:
- Main Timer Engine (Hourglass/Timing/)
- Parsing System (Hourglass/Parsing/)
- Manager Components (Hourglass/Managers/)
- Windows UI Components (Hourglass/Windows/)

b. External Integrations:
- Windows Native Integration
- Audio System
- Virtual Desktop Integration
- Task Dialog System

**┌─ User Interface Layer ─────────────────────┐**
- Timer Windows                            │
- Theme Manager                            │
- Task Dialog                             │
- ┬────────────────────────┘
- ↕
**┌─ Application Core Layer ───────────────────┐**
- ┌─ Manager Services ─┐ ┌─ Timer Core ────┐ │
- Timer Manager   │ │ - Timer Base     │ │
- Sound Manager   │ │ - Timer Options  │ │
- Theme Manager   │ │ - Timer Start    │ │
- Update Manager  │ └────────────────┬─┘ │
- ┘                   │   │
- ┌─ Parser System ───┐                  ↕   │
- DateTime Token  │          ┌─ State ─┐ │
- TimeSpan Token  │←─────────│ Running │ │
- Timer Start     │          │ Paused  │ │
- ┘          │ Expired │ │
- ┬────────────┴─────────┘
- ↕
**┌─ Integration Layer ──────────────────────┐**
- Windows Native Methods                 │
- Audio System (NAudio)                  │
- Virtual Desktop API                    │
- Task Dialog System                     │
- ┬────────────────────────┘
- ↕
**┌─ System Layer ────────────────────────────┐**
- Windows OS                              │
- .NET Framework 4.8                      │
- ┘

##### Important Relationships

- Bidirectional communication between UI and Manager Services
- One-way dependency from Managers to Timer Core
- Integration points with Windows native features
- Parser System's interaction with Timer Core
- Audio system integration flow

##### Implementation Details

- File format support for audio (.wav, .ogg)
- Virtual desktop integration
- Windows native feature usage
- Timer state management
- Multi-timer support

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph UI["User Interface Layer"]
        TimerWindows["Timer Windows"]:::ui
        NotificationIcon["Notification Area Icon"]:::ui
        ThemeUI["Theme Manager Window"]:::ui
        TaskDialogUI["Task Dialog"]:::ui
    end

    subgraph Core["Application Core Layer"]
        subgraph Managers["Manager Services"]
            TimerMgr["Timer Manager"]:::core
            SoundMgr["Sound Manager"]:::core
            ThemeMgr["Theme Manager"]:::core
            UpdateMgr["Update Manager"]:::core
            SettingsMgr["Settings Manager"]:::core
            NotificationMgr["Notification Manager"]:::core
        end

        subgraph TimerCore["Timer Core"]
            TimerBase["Timer Base"]:::core
            TimerImpl["Timer Implementation"]:::core
            TimerOptions["Timer Options"]:::core
            TimerState["Timer State"]:::core
        end

        subgraph Parser["Parser System"]
            DateTimeToken["DateTime Token"]:::core
            TimeSpanToken["TimeSpan Token"]:::core
            TimerStart["Timer Start"]:::core
        end

        subgraph State["Timer States"]
            Running["Running"]:::state
            Paused["Paused"]:::state
            Expired["Expired"]:::state
        end
    end

    subgraph Integration["Integration Layer"]
        WinNative["Windows Native Methods"]:::integration
        AudioSystem["Audio System"]:::integration
        VirtualDesktop["Virtual Desktop API"]:::integration
        TaskDialog["Task Dialog System"]:::integration
        CLI["Command Line Interface"]:::integration
    end

    subgraph System["System Layer"]
        Windows["Windows OS"]:::system
        DotNet["NET Framework 4.8"]:::system
    end

    %% Relationships
    UI --> Managers
    Managers --> TimerCore
    Parser --> TimerCore
    TimerCore --> State
    Managers --> Integration
    Integration --> System

    %% Click Events
    click TimerBase "https://github.com/i2van/hourglass/blob/main/Hourglass/Timing/TimerBase.cs"
    click TimerImpl "https://github.com/i2van/hourglass/blob/main/Hourglass/Timing/Timer.cs"
    click Parser "https://github.com/i2van/hourglass/tree/main/Hourglass/Parsing/"
    click Managers "https://github.com/i2van/hourglass/tree/main/Hourglass/Managers/"
    click TimerWindows "https://github.com/i2van/hourglass/tree/main/Hourglass/Windows/"
    click AudioSystem "https://github.com/i2van/hourglass/blob/main/Hourglass.NAudio/AudioPlayer.cs"
    click VirtualDesktop "https://github.com/i2van/hourglass/tree/main/Hourglass/Lib/WindowsVirtualDesktopHelper/"
    click TaskDialog "https://github.com/i2van/hourglass/tree/main/Hourglass/Lib/TaskDialog/"
    click ThemeMgr "https://github.com/i2van/hourglass/blob/main/Hourglass/Managers/ThemeManager.cs"
    click ThemeUI "https://github.com/i2van/hourglass/blob/main/Hourglass/Windows/ThemeManagerWindow.xaml"
    click NotificationMgr "https://github.com/i2van/hourglass/blob/main/Hourglass/Managers/NotificationAreaIconManager.cs"
    click NotificationIcon "https://github.com/i2van/hourglass/blob/main/Hourglass/Windows/NotificationAreaIcon.cs"
    click TimerState "https://github.com/i2van/hourglass/blob/main/Hourglass/Serialization/TimerInfo.cs"
    click TimerOptions "https://github.com/i2van/hourglass/blob/main/Hourglass/Serialization/TimerOptionsInfo.cs"
    click CLI "https://github.com/i2van/hourglass/blob/main/Hourglass/CommandLineArguments.cs"
    click SettingsMgr "https://github.com/i2van/hourglass/blob/main/Hourglass/Managers/SettingsManager.cs"
    click UpdateMgr "https://github.com/i2van/hourglass/blob/main/Hourglass/Managers/UpdateManager.cs"
    click SoundMgr "https://github.com/i2van/hourglass/blob/main/Hourglass/Managers/SoundManager.cs"

    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:#fff
    classDef core fill:#2ecc71,stroke:#27ae60,color:#fff
    classDef integration fill:#e67e22,stroke:#d35400,color:#fff
    classDef system fill:#95a5a6,stroke:#7f8c8d,color:#fff
    classDef state fill:#9b59b6,stroke:#8e44ad,color:#fff
```
