# qsmd-wait/retime-testing architecture

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

- Interactive diagram: https://gitdiagram.com/qsmd-wait/retime-testing
- Repository: https://github.com/qsmd-wait/retime-testing

## Overview

ReTime-Testing is a Windows desktop time-scheduling and progress-display application. Its principal workflow starts the app, initializes desktop services, calibrates application time, and uses schedule execution to update progress state. The repository also contains schedule editing and persistence, settings, themes, onboarding, and desktop overlay/tray features. Edges reflect the excerpts and SOURCE INDEX references; unsampled feature wiring is shown only as unverified where useful.

Main entry points: [`ReTime-Testing/App.xaml.cs`](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/App.xaml.cs) (App startup), [`ReTime-Testing/Services/Scheduling/ScheduleManager.cs`](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Scheduling/ScheduleManager.cs) (Schedule manager), [`ReTime-Testing.Infrastructure/Services/Configuration/ConfigurationManager.cs`](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Configuration/ConfigurationManager.cs) (Configuration paths), [`ReTime-Testing.Infrastructure/Services/Calibration/TimeCalibrationService.cs`](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/TimeCalibrationService.cs) (Time calibration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Application startup"]
  node_app["App startup<br/>[App.xaml.cs]"]
  node_tray["Tray controller"]
end

subgraph group_schedule["Time scheduling"]
  node_schedule_manager["Schedule manager<br/>[ScheduleManager.cs]"]
  node_plan["Execution plan<br/>[ExecutionPlan.cs]"]
  node_time_point["Schedule time points<br/>[TimePoint.cs]"]
  node_progress["Progress state"]
  node_schedule_editor["Schedule editor"]
  node_schedule_files[("Schedule files")]
  node_group_manager["Schedule groups"]
end

subgraph group_settings["Configuration and time"]
  node_time_service["Absolute time"]
  node_calibration["Time calibration"]
  node_ntp["NTP provider<br/>[NtpTimeProvider.cs]"]
  node_cloud_calibration["Cloud calibration"]
  node_settings_service["Settings service<br/>[SettingsService.cs]"]
  node_configuration["Configuration paths"]
  node_config_files[("Configuration files")]
end

subgraph group_desktop["Desktop experience"]
  node_desktop_windows["Desktop windows"]
  node_time_top["TimeTop overlay"]
  node_theme["Theme service<br/>[ThemeService.cs]"]
  node_onboarding["Onboarding flow<br/>[OnboardingFlow.cs]"]
end

node_user(("Desktop user"))

node_user -->|"launches"| node_app
node_app -->|"initializes"| node_tray
node_app -->|"starts calibration"| node_calibration
node_app -->|"subscribes to changes"| node_settings_service
node_app -->|"resolves service"| node_schedule_manager
node_schedule_manager -->|"reads time"| node_time_service
node_schedule_manager -->|"updates state"| node_progress
node_schedule_manager -->|"uses plan"| node_plan
node_schedule_manager -->|"processes points"| node_time_point
node_progress -->|"loads state styles"| node_settings_service
node_calibration -->|"adjusts time"| node_time_service
node_calibration -->|"requests calibration"| node_cloud_calibration
node_calibration -.->|"uses provider"| node_ntp
node_settings_service -.->|"uses paths"| node_configuration
node_configuration -.->|"locates configuration"| node_config_files
node_schedule_files -->|"gets schedule directory"| node_configuration
node_group_manager -->|"uses configuration"| node_configuration
node_schedule_editor -.->|"edits schedules"| node_schedule_files
node_app -.->|"starts desktop UI"| node_desktop_windows
node_desktop_windows -->|"uses view model"| node_time_top
node_theme -->|"reads theme settings"| node_configuration
node_app -.->|"opens setup flow"| node_onboarding

click node_app "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/App.xaml.cs"
click node_tray "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Desktop/TrayIconController.cs"
click node_schedule_manager "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Scheduling/ScheduleManager.cs"
click node_plan "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Models/ExecutionPlan.cs"
click node_time_point "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Models/TimePoint.cs"
click node_progress "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Scheduling/ProgressStateManager.cs"
click node_schedule_editor "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/ViewModels/TimeScheduleEditor/TimeScheduleEditorViewModel.cs"
click node_schedule_files "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Scheduling/TimeScheduleManager.cs"
click node_group_manager "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Scheduling/ScheduleGroupManager.cs"
click node_time_service "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/AbsoluteTimeService.cs"
click node_calibration "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/TimeCalibrationService.cs"
click node_ntp "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/NtpTimeProvider.cs"
click node_cloud_calibration "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/CloudCalibrationService.cs"
click node_settings_service "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Configuration/SettingsService.cs"
click node_configuration "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Configuration/ConfigurationManager.cs"
click node_config_files "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Configuration/JsonConfigProvider.cs"
click node_desktop_windows "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Desktop/DesktopWindowManager.cs"
click node_time_top "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/ViewModels/TimeTopDesktopViewModel.cs"
click node_theme "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/ThemeService.cs"
click node_onboarding "https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Onboarding/OnboardingFlow.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_app,node_tray,node_user toneBlue
class node_schedule_manager,node_plan,node_time_point,node_progress,node_schedule_editor,node_schedule_files,node_group_manager toneAmber
class node_time_service,node_calibration,node_ntp,node_cloud_calibration,node_settings_service,node_configuration,node_config_files toneMint
class node_desktop_windows,node_time_top,node_theme,node_onboarding toneRose
```

## Components

### Application startup

- [App startup](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/App.xaml.cs): `ReTime-Testing/App.xaml.cs`
- [Tray controller](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Desktop/TrayIconController.cs): `ReTime-Testing/Services/Desktop/TrayIconController.cs`

### Time scheduling

- [Schedule manager](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Scheduling/ScheduleManager.cs): `ReTime-Testing/Services/Scheduling/ScheduleManager.cs`
- [Execution plan](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Models/ExecutionPlan.cs): `ReTime-Testing/Models/ExecutionPlan.cs`
- [Schedule time points](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Models/TimePoint.cs): `ReTime-Testing/Models/TimePoint.cs`
- [Progress state](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Scheduling/ProgressStateManager.cs): `ReTime-Testing/Services/Scheduling/ProgressStateManager.cs`
- [Schedule editor](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/ViewModels/TimeScheduleEditor/TimeScheduleEditorViewModel.cs): `ReTime-Testing/ViewModels/TimeScheduleEditor/TimeScheduleEditorViewModel.cs`
- [Schedule files](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Scheduling/TimeScheduleManager.cs): `ReTime-Testing.Infrastructure/Services/Scheduling/TimeScheduleManager.cs`
- [Schedule groups](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Scheduling/ScheduleGroupManager.cs): `ReTime-Testing.Infrastructure/Services/Scheduling/ScheduleGroupManager.cs`

### Configuration and time

- [Absolute time](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/AbsoluteTimeService.cs): `ReTime-Testing.Infrastructure/Services/Calibration/AbsoluteTimeService.cs`
- [Time calibration](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/TimeCalibrationService.cs): `ReTime-Testing.Infrastructure/Services/Calibration/TimeCalibrationService.cs`
- [NTP provider](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/NtpTimeProvider.cs): `ReTime-Testing.Infrastructure/Services/Calibration/NtpTimeProvider.cs`
- [Cloud calibration](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Calibration/CloudCalibrationService.cs): `ReTime-Testing.Infrastructure/Services/Calibration/CloudCalibrationService.cs`
- [Settings service](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Configuration/SettingsService.cs): `ReTime-Testing.Infrastructure/Services/Configuration/SettingsService.cs`
- [Configuration paths](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Configuration/ConfigurationManager.cs): `ReTime-Testing.Infrastructure/Services/Configuration/ConfigurationManager.cs`
- [Configuration files](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing.Infrastructure/Services/Configuration/JsonConfigProvider.cs): `ReTime-Testing.Infrastructure/Services/Configuration/JsonConfigProvider.cs`

### Desktop experience

- [Desktop windows](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Desktop/DesktopWindowManager.cs): `ReTime-Testing/Services/Desktop/DesktopWindowManager.cs`
- [TimeTop overlay](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/ViewModels/TimeTopDesktopViewModel.cs): `ReTime-Testing/ViewModels/TimeTopDesktopViewModel.cs`
- [Theme service](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/ThemeService.cs): `ReTime-Testing/Services/ThemeService.cs`
- [Onboarding flow](https://github.com/qsmd-wait/retime-testing/blob/main/ReTime-Testing/Services/Onboarding/OnboardingFlow.cs): `ReTime-Testing/Services/Onboarding/OnboardingFlow.cs`

### Other components

- **Desktop user**

## Connections

- Desktop user → App startup: launches
- App startup → Tray controller: initializes (evidence: `ReTime-Testing/App.xaml.cs`)
- App startup → Time calibration: starts calibration (evidence: `ReTime-Testing/App.xaml.cs`)
- App startup → Settings service: subscribes to changes (evidence: `ReTime-Testing/App.xaml.cs`)
- App startup → Schedule manager: resolves service (evidence: `ReTime-Testing/App.xaml.cs`)
- Schedule manager → Absolute time: reads time (evidence: `ReTime-Testing/Services/Scheduling/ScheduleManager.cs`)
- Schedule manager → Progress state: updates state (evidence: `ReTime-Testing/Services/Scheduling/ScheduleManager.cs`)
- Schedule manager → Execution plan: uses plan (evidence: `ReTime-Testing/Services/Scheduling/ScheduleManager.cs`)
- Schedule manager → Schedule time points: processes points (evidence: `ReTime-Testing/Services/Scheduling/ScheduleManager.cs`)
- Progress state → Settings service: loads state styles (evidence: `ReTime-Testing/Services/Scheduling/ProgressStateManager.cs`)
- Time calibration → Absolute time: adjusts time (evidence: `ReTime-Testing.Infrastructure/Services/Calibration/TimeCalibrationService.cs`)
- Time calibration → Cloud calibration: requests calibration (evidence: `ReTime-Testing.Infrastructure/Services/Calibration/TimeCalibrationService.cs`)
- Time calibration → NTP provider: uses provider
- Settings service → Configuration paths: uses paths
- Configuration paths → Configuration files: locates configuration
- Schedule files → Configuration paths: gets schedule directory (evidence: `ReTime-Testing.Infrastructure/Services/Scheduling/TimeScheduleManager.cs`)
- Schedule groups → Configuration paths: uses configuration (evidence: `ReTime-Testing.Infrastructure/Services/Scheduling/ScheduleGroupManager.cs`)
- Schedule editor → Schedule files: edits schedules
- App startup → Desktop windows: starts desktop UI
- Desktop windows → TimeTop overlay: uses view model (evidence: `ReTime-Testing/Services/Desktop/DesktopWindowManager.cs`)
- Theme service → Configuration paths: reads theme settings
- App startup → Onboarding flow: opens setup flow
