# c1201y/classsoftwarehub-desktop architecture

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

- Interactive diagram: https://gitdiagram.com/c1201y/classsoftwarehub-desktop
- Repository: https://github.com/c1201y/classsoftwarehub-desktop

## Overview

ClassSoftwareHub Desktop is a native Windows client for browsing a software catalog, downloading installers, and using classroom-oriented tools. Its principal workflow is catalog content to software details to a background download task and a local file. The README also documents tools, a configurable sidebar, feedback and submission, experimental machine checks, settings, changelog, and updates. The graph combines documented capabilities with relationships visible in the supplied source index and excerpts; several page-to-service connections are not evidenced, so those links are omitted.

Main entry points: [`MainWindow.xaml.cs`](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/MainWindow.xaml.cs) (Desktop app), [`Core/ContentStore.cs`](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Core/ContentStore.cs) (Catalog content), [`Pages/ToolsPage.xaml.cs`](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/ToolsPage.xaml.cs) (Built-in tools), [`Pages/DetailPage.xaml.cs`](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/DetailPage.xaml.cs) (Software details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_app["Desktop app<br/>[MainWindow.xaml.cs]"]
  node_settings[("Settings<br/>[SettingsStore.cs]")]
end

subgraph group_catalog["Software catalog"]
  node_content[("Catalog content<br/>[ContentStore.cs]")]
  node_software["Software listing<br/>[SoftwareApp.cs]"]
  node_details["Software details<br/>[DetailPage.xaml.cs]"]
  node_downloads["Download tasks<br/>[DownloadManager.cs]"]
  node_downloader["File download<br/>[DownloadService.cs]"]
  node_localfile["Downloaded installer"]
end

subgraph group_classroom["Classroom tools"]
  node_toolpages["Built-in tools<br/>[ToolsPage.xaml.cs]"]
  node_clock["Clock and timer"]
  node_picknumber["Random selector"]
  node_keyboard["Virtual keyboard"]
  node_sidebar["Tool sidebar"]
  node_sidebarlayout["Sidebar layout"]
end

subgraph group_community["Community features"]
  node_feedback["Feedback center"]
  node_submission["Software submission<br/>[SubmitPage.xaml.cs]"]
  node_machinecheck["Machine check"]
  node_changelog["Changelog"]
end

subgraph group_platform["Platform services"]
  node_updater["Update flow<br/>[UpdateFlow.cs]"]
  node_updateservice["Update service<br/>[UpdateService.cs]"]
  node_github["GitHub releases"]
end

node_user(("User"))
node_website(("Software site"))

node_user -->|"uses"| node_app
node_app -->|"loads"| node_content
node_content -->|"parses"| node_software
node_user -->|"browses"| node_details
node_details -.->|"starts download"| node_downloads
node_downloads -->|"downloads via"| node_downloader
node_downloader -->|"writes"| node_localfile
node_user -->|"uses"| node_toolpages
node_toolpages -->|"offers"| node_clock
node_toolpages -->|"offers"| node_picknumber
node_user -->|"uses"| node_sidebar
node_user -->|"configures"| node_sidebarlayout
node_app -->|"opens"| node_sidebar
node_user -.->|"uses"| node_keyboard
node_user -->|"submits feedback"| node_feedback
node_user -->|"submits software"| node_submission
node_user -->|"checks machine"| node_machinecheck
node_user -->|"views"| node_changelog
node_app -->|"starts update flow"| node_updater
node_updater -->|"uses"| node_updateservice
node_updateservice -->|"queries releases"| node_github
node_content -.->|"syncs content"| node_website
node_app -->|"loads settings"| node_settings

click node_app "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/MainWindow.xaml.cs"
click node_settings "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/SettingsStore.cs"
click node_content "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Core/ContentStore.cs"
click node_software "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Data/SoftwareApp.cs"
click node_details "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/DetailPage.xaml.cs"
click node_downloads "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/DownloadManager.cs"
click node_downloader "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/DownloadService.cs"
click node_toolpages "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/ToolsPage.xaml.cs"
click node_clock "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/Tools/ClockToolPage.xaml.cs"
click node_picknumber "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/Tools/PickNumberToolPage.xaml.cs"
click node_keyboard "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/VirtualKeyboard/VirtualKeyboardService.cs"
click node_sidebar "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Views/ToolSidebarWindow.xaml.cs"
click node_sidebarlayout "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/SidebarLayoutPage.xaml.cs"
click node_feedback "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/FeedbackFormPage.xaml.cs"
click node_submission "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/SubmitPage.xaml.cs"
click node_machinecheck "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/MachineCheckPage.xaml.cs"
click node_changelog "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/ChangelogPage.xaml.cs"
click node_updater "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/Updating/UpdateFlow.cs"
click node_updateservice "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/Updating/UpdateService.cs"
click node_github "https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/Updating/GitHubReleaseSource.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_settings,node_user toneBlue
class node_content,node_software,node_details,node_downloads,node_downloader,node_localfile toneAmber
class node_toolpages,node_clock,node_picknumber,node_keyboard,node_sidebar,node_sidebarlayout toneMint
class node_feedback,node_submission,node_machinecheck,node_changelog toneRose
class node_updater,node_updateservice,node_github,node_website toneIndigo
```

## Components

### App shell

- [Desktop app](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [Settings](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/SettingsStore.cs): `Services/SettingsStore.cs`

### Software catalog

- [Catalog content](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Core/ContentStore.cs): `Core/ContentStore.cs`
- [Software listing](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Data/SoftwareApp.cs): `Data/SoftwareApp.cs`
- [Software details](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/DetailPage.xaml.cs): `Pages/DetailPage.xaml.cs`
- [Download tasks](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/DownloadManager.cs): `Services/DownloadManager.cs`
- [File download](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/DownloadService.cs): `Services/DownloadService.cs`
- **Downloaded installer**

### Classroom tools

- [Built-in tools](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/ToolsPage.xaml.cs): `Pages/ToolsPage.xaml.cs`
- [Clock and timer](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/Tools/ClockToolPage.xaml.cs): `Pages/Tools/ClockToolPage.xaml.cs`
- [Random selector](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/Tools/PickNumberToolPage.xaml.cs): `Pages/Tools/PickNumberToolPage.xaml.cs`
- [Virtual keyboard](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/VirtualKeyboard/VirtualKeyboardService.cs): `Services/VirtualKeyboard/VirtualKeyboardService.cs`
- [Tool sidebar](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Views/ToolSidebarWindow.xaml.cs): `Views/ToolSidebarWindow.xaml.cs`
- [Sidebar layout](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/SidebarLayoutPage.xaml.cs): `Pages/SidebarLayoutPage.xaml.cs`

### Community features

- [Feedback center](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/FeedbackFormPage.xaml.cs): `Pages/FeedbackFormPage.xaml.cs`
- [Software submission](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/SubmitPage.xaml.cs): `Pages/SubmitPage.xaml.cs`
- [Machine check](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/MachineCheckPage.xaml.cs): `Pages/MachineCheckPage.xaml.cs`
- [Changelog](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Pages/ChangelogPage.xaml.cs): `Pages/ChangelogPage.xaml.cs`

### Platform services

- [Update flow](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/Updating/UpdateFlow.cs): `Services/Updating/UpdateFlow.cs`
- [Update service](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/Updating/UpdateService.cs): `Services/Updating/UpdateService.cs`
- [GitHub releases](https://github.com/c1201y/classsoftwarehub-desktop/blob/main/Services/Updating/GitHubReleaseSource.cs): `Services/Updating/GitHubReleaseSource.cs`

### Other components

- **User**
- **Software site**

## Connections

- User → Desktop app: uses (evidence: `README.md`)
- Desktop app → Catalog content: loads
- Catalog content → Software listing: parses (evidence: `Core/ContentStore.cs`)
- User → Software details: browses (evidence: `README.md`)
- Software details → Download tasks: starts download
- Download tasks → File download: downloads via (evidence: `Services/DownloadManager.cs`)
- File download → Downloaded installer: writes (evidence: `Services/DownloadService.cs`)
- User → Built-in tools: uses (evidence: `README.md`)
- Built-in tools → Clock and timer: offers (evidence: `README.md`)
- Built-in tools → Random selector: offers (evidence: `README.md`)
- User → Tool sidebar: uses (evidence: `README.md`)
- User → Sidebar layout: configures (evidence: `README.md`)
- Desktop app → Tool sidebar: opens (evidence: `MainWindow.xaml.cs`)
- User → Virtual keyboard: uses
- User → Feedback center: submits feedback (evidence: `README.md`)
- User → Software submission: submits software (evidence: `README.md`)
- User → Machine check: checks machine (evidence: `README.md`)
- User → Changelog: views (evidence: `README.md`)
- Desktop app → Update flow: starts update flow (evidence: `MainWindow.xaml.cs`)
- Update flow → Update service: uses (evidence: `Services/Updating/UpdateFlow.cs`)
- Update service → GitHub releases: queries releases (evidence: `Services/Updating/UpdateService.cs`)
- Catalog content → Software site: syncs content
- Desktop app → Settings: loads settings (evidence: `MainWindow.xaml.cs`)
