EchoHub/docs/auriondocs/Synthesis/Architecture.md

Architecture — HueByte/EchoHub

Auto-synthesized from 598 documented symbols across 128 files on master.

Topic Guides

Deep-dives into cross-cutting concerns synthesized from the per-symbol corpus.

• API client and authentication — How the EchoHub client authenticates with the server, handles tokens, and defines authentication DTOs.
• Theming and UI color management — Representing themes, color palettes, and runtime theme application.
• Real-time connection management — Managing the SignalR hub connection lifecycle and connection state.
• Encryption and room key management — End-to-end encryption plumbing and secure handling of per-channel room keys.
• Command handling — Slash-command parsing and dispatching command actions from UI and orchestrator.
• Attachments and file transfers — Staging and sending attachments in chat messages and coordinating outbound attachments.
• Clipboard utilities — Helpers for clipboard interactions: files and images.
• Update management — Data and update flow: backup prior to updates and update checks.

Architecture Diagram

%%{init: {'theme':'base','themeVariables':{'background':'#faf7ef','primaryColor':'#f0e2c2','primaryTextColor':'#1f2840','primaryBorderColor':'#8a7548','secondaryColor':'#d9efec','secondaryBorderColor':'#1d8a80','secondaryTextColor':'#1f2840','tertiaryColor':'#f2ebd8','tertiaryBorderColor':'#8a7548','tertiaryTextColor':'#1f2840','lineColor':'#1d8a80','titleColor':'#1f2840','fontSize':'14px','edgeLabelBackground':'#faf7ef','clusterBkg':'#f2ebd8','clusterBorder':'#8a7548','actorBkg':'#f0e2c2','actorBorder':'#8a7548','actorTextColor':'#1f2840','actorLineColor':'#8a7548','signalColor':'#1d8a80','signalTextColor':'#1f2840','activationBkgColor':'#d9efec','activationBorderColor':'#1d8a80','noteBkgColor':'#f2ebd8','noteBorderColor':'#8a7548','noteTextColor':'#1f2840','labelBoxBkgColor':'#f0e2c2','labelBoxBorderColor':'#8a7548','labelTextColor':'#1f2840','transitionColor':'#1d8a80','transitionLabelColor':'#1f2840','stateLabelColor':'#1f2840','altBackground':'#f2ebd8'}}}%%
flowchart TB
    n0["src/EchoHub.Core/DTOs · ChatService (11 files)"]
    n1["src/EchoHub.Client/Services · AppOrchestrator (14 files)"]
    n2["src/EchoHub.Client/UI · MainWindow (18 files)"]
    n3["src/EchoHub.Core/DTOs · ApiClient (10 files)"]
    n4["src/EchoHub.Server · User (12 files)"]
    n5["src/EchoHub.Core/DTOs · ChannelService (7 files)"]
    n6["src/EchoHub.Server · Program (12 files)"]
    n7["src/EchoHub.Client/Config (5 files)"]
    n8["src/EchoHub.Client/UI · Channel (4 files)"]
    n9["src/EchoHub.Core/DTOs · ChannelsController (2 files)"]
    n10["src/EchoHub.Core/Models (5 files)"]
    n0 -->|5| n10
    n0 -->|6| n4
    n0 -->|7| n6
    n0 -->|4| n7
    n0 -->|6| n8
    n1 -->|14| n0
    n1 -->|5| n2
    n1 -->|4| n3
    n1 -->|6| n4
    n1 -->|8| n7
    n1 -->|5| n8
    n2 -->|8| n0
    n2 -->|4| n4
    n3 -->|6| n0
    n3 -->|8| n4
    n3 -->|4| n9
    n4 -->|9| n3
    n5 -->|7| n0
    n5 -->|4| n4
    n5 -->|5| n8
    n6 -->|6| n0
    n6 -->|7| n4
    n9 -->|4| n4
    n9 -->|4| n5

System Overview

EchoHub is a client/server chat system that exposes an HTTP API implemented by multiple controllers and a realtime messaging surface via a hub (ChatHub), with client-side components for connecting and playback. The server hosts application services and background workers (e.g. file cleanup, data migrations) that implement business logic and maintenance tasks. Persistent state is stored in the Entity Framework DbContext (EchoHubDbContext) which is used by controllers and services. Clients interact with the server through the ApiClient and implement messaging callbacks against the IEchoHubClient contract.

Key Components

Controllers — HTTP API surface for client and administrative actions. Implemented by AuthController, ChannelsController, FilesController, InvitesController, ModerationController, ServerController, UsersController.

Services — Application services implement business logic, file handling, background tasks, and utilities used by controllers and hubs. Implemented by ChannelService, ChatService, FileStorageService, FileCleanupService, and supporting utilities such as AsciiBannerService, AudioPlaybackService, ClientEncryptionService, and DataMigrationService.

Workers / Hubs — Real-time messaging and hosted work are provided by SignalR-style hubs and background services; the primary realtime hub is implemented by ChatHub.

Data Access — Persistent application state is managed via the Entity Framework DbContext used across services and controllers: EchoHubDbContext.

External Clients — Client-side communication with the server is encapsulated by an HTTP/real-time client and the client contract. Implemented by ApiClient and the client interface IEchoHubClient.

Configuration — Server runtime options and feature flags are defined in option classes used by services and integrations. Implemented by IrcOptions, ServerLogsOptions, SpamOptions, StatsOptions.

IRC integration — IRC-related command handling and service wiring are provided by IRC support classes and extensions. Implemented by IrcServiceExtensions and IrcCommandHandler.

Core Contracts — Domain and integration interfaces that define service boundaries and encryption abstractions. Implemented by IChannelService, IChatService, IMessageEncryptionService, and IUserService.

Component Map

Subsystems below are structural clusters detected from the dependency graph — groups of symbols more densely wired to each other than to the rest of the codebase.

• src/EchoHub.Client/UI · MainWindow — 18 documented files
• src/EchoHub.Client/Services · AppOrchestrator — 14 documented files
• src/EchoHub.Server · Program — 12 documented files
• src/EchoHub.Server · User — 12 documented files
• src/EchoHub.Core/DTOs · ChatService — 11 documented files
• src/EchoHub.Core/DTOs · ApiClient — 10 documented files
• src/EchoHub.Core/DTOs · ChannelService — 7 documented files
• src/EchoHub.Client/Config — 5 documented files
• src/EchoHub.Core/Models — 5 documented files
• src/EchoHub.Client/Themes — 4 documented files
• src/EchoHub.Client/UI · Channel — 4 documented files
• src/EchoHub.Server · ServerLogsStreamService — 4 documented files
• …and 11 more subsystem folders

Components by Role

Configuration

• IrcOptions — src/EchoHub.Server.Irc/IrcOptions.cs
• ServerLogsOptions — src/EchoHub.Server/Config/ServerLogsOptions.cs
• SpamOptions — src/EchoHub.Server/Config/SpamOptions.cs
• StatsOptions — src/EchoHub.Server/Config/StatsOptions.cs

Controllers

• AuthController — src/EchoHub.Server/Controllers/AuthController.cs
• ChannelsController — src/EchoHub.Server/Controllers/ChannelsController.cs
• FilesController — src/EchoHub.Server/Controllers/FilesController.cs
• InvitesController — src/EchoHub.Server/Controllers/InvitesController.cs
• ModerationController — src/EchoHub.Server/Controllers/ModerationController.cs
• ServerController — src/EchoHub.Server/Controllers/ServerController.cs
• UsersController — src/EchoHub.Server/Controllers/UsersController.cs

Data Access

• EchoHubDbContext — src/EchoHub.Server/Data/EchoHubDbContext.cs

Extensions

• IrcServiceExtensions — src/EchoHub.Server.Irc/IrcServiceExtensions.cs

External Clients

• ApiClient — src/EchoHub.Client/Services/ApiClient.cs
• IEchoHubClient — src/EchoHub.Core/Contracts/IEchoHubClient.cs

Handlers

• CommandHandler — src/EchoHub.Client/Commands/CommandHandler.cs
• IrcCommandHandler — src/EchoHub.Server.Irc/IrcCommandHandler.cs

Realtime Hubs

• ChatHub — src/EchoHub.Server/Hubs/ChatHub.cs

Services

• AsciiBannerService — src/EchoHub.Core/Services/AsciiBannerService.cs
• AudioPlaybackService — src/EchoHub.Client/Services/AudioPlaybackService.cs
• ChannelService — src/EchoHub.Server/Services/ChannelService.cs
• ChatService — src/EchoHub.Server/Services/ChatService.cs
• ClientEncryptionService — src/EchoHub.Client/Services/ClientEncryptionService.cs
• DataMigrationService — src/EchoHub.Server/Setup/DataMigrationService.cs
• FileCleanupService — src/EchoHub.Server/Services/FileCleanupService.cs
• FileStorageService — src/EchoHub.Server/Services/FileStorageService.cs
• IChannelService — src/EchoHub.Core/Contracts/IChannelService.cs
• IChatService — src/EchoHub.Core/Contracts/IChatService.cs
• IMessageEncryptionService — src/EchoHub.Core/Contracts/IMessageEncryptionService.cs
• IUserService — src/EchoHub.Core/Contracts/IUserService.cs

---

Generated by Aurion on 2026-07-23 05:56:01 UTC