# damianmorozov/opentgresearcher architecture

> Architecture diagram of the GitHub repository damianmorozov/opentgresearcher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/damianmorozov/opentgresearcher
- Repository: https://github.com/damianmorozov/opentgresearcher

## Overview

##### Project type and purpose
- This is a multi-frontend .NET solution (“OpenTgResearcher”) that provides a Telegram research and download tool.
- It implements a layered architecture: Core (domain models & services), Infrastructure (helpers, contracts, view-models), Storage (EF Core repositories & contexts), and multiple Presentation apps (Blazor web UI, console, WinUI3/desktop, WPF desktop).

##### File structure
- Top-level solution file and Directory.Build.* define build settings.
- “Core/TgDownloaderDesktop.Core”: domain services and models (IFileService, sample data).
- “Core/TgInfrastructure”: common contracts (ITgConnectClient, ITgViewModelBase…), helpers (logging, licensing), enums, DTO/view-model interfaces.
- “Core/TgStorage”: EF Core contexts for various host types (Blazor, Console, Desktop, Memory, Test), repositories for entities (Apps, Contacts, Messages, Sources…), migrations, DTOs & view-models.
- “Presentation”: four independent host projects sharing the same Core/Infrastructure/Storage layers:
- TgDownloaderBlazor – Blazor Server app
- TgDownloaderConsole – console UI w/ menu helpers
- TgDownloaderDesktop – WinUI3 MVVM desktop
- TgDownloaderWinDesktopWPF – WPF desktop MVVM
- “Tests”: unit/integration tests for Core, Console, Desktop, Storage.
- “Settings”: JSON configs per host.
- Dockerfiles under Presentation projects for containerized deployment.

##### Key insights from README
- The product is a Telegram chat downloader/researcher.
- Requires Telegram API credentials (api_id/api_hash).
- Offers guides for console, desktop, Docker, filters, groups.
- Releases are published on GitHub and Docker Hub.

##### Main components
a. Core layer
– Domain models & services (FileService, SampleDataService).
b. Infrastructure layer
– Contracts & interfaces (ITgConnectClient, ITgDbProxy, ITgHelper)
– Helpers (TgLogHelper, TgLicenseManagerHelper)
– ViewModel base types & DTOs
c. Storage layer
– EF Core contexts (Blazor, Console, Desktop, Memory, Test)
– Repositories (Apps, Contacts, Messages, Sources, Proxies, Filters…)
– Migrations (per host)
– Database (SQLite/SQL Server, etc.)
d. Presentation layer (four hosts)
– Blazor Server app
– Console menu app
– WinUI3 desktop MVVM
– WPF desktop MVVM
e. External services & resources
– Telegram API (via TgConnectClientBase)
– License API (TgLicense)
– File system (FileService)
– Docker registry (for container images)

##### Relationships & interactions
- Presentation apps → call Infrastructure contracts (e.g., ITgConnectClient for Telegram, ITgDbProxy for storage)
- Infrastructure → delegates to Storage layer via repository interfaces (ITgEfRepository)
- Storage → EF Core contexts → Database
- Infrastructure & Storage → use Core services for file operations & sample data if needed
- Presentation apps → use MVVM: Views bind to ViewModels from Infrastructure
- All layers use dependency injection (inject services & repositories)

##### Architectural patterns & design principles
- Layered architecture (Core → Infrastructure → Storage → Presentation)
- Repository pattern (EF Core repositories abstract DB)
- MVVM pattern for desktop & Blazor (ViewModels expose data & commands)
- Dependency inversion (interfaces in Infrastructure, implementations in Storage & Core)
- Single solution with multiple host projects sharing layers
- Use of migrations for multiple contexts per host

##### Step-by-step guidance
8. Validate coverage: ensure all top-level folders/projects appear as components or sub-components.

##### Detail
- Major services and contracts.
- Reuse: one Storage layer serving multiple hosts.
- Migration sub-systems per host context.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Presentation Layer" 
        direction TB
        Blazor["Blazor Server App"]:::presentation
        Console["Console App"]:::presentation
        WinUI3["WinUI3 Desktop MVVM"]:::presentation
        WPF["WPF Desktop MVVM"]:::presentation
    end

    subgraph "Infrastructure Layer"
        direction TB
        Contracts["Contracts & Interfaces"]:::infrastructure
        ViewModels["ViewModel Base & DTOs"]:::infrastructure
        TgLicenseHelper["TgLicenseManagerHelper"]:::infrastructure
        TgLicenseAPI["TgLicense API"]:::infrastructure
    end

    subgraph "Storage Layer"
        direction TB
        subgraph "EF Core Contexts"
            direction TB
            EfBlazor["TgEfBlazorContext"]:::storage
            EfConsole["TgEfConsoleContext"]:::storage
            EfDesktop["TgEfDesktopContext"]:::storage
            EfMemory["TgEfMemoryContext"]:::storage
            EfTest["TgEfTestContext"]:::storage
        end
        subgraph "Repositories & Migrations"
            direction TB
            Repos["Repository Interfaces (ITgEfRepository*)"]:::storage
            Migrations["Migrations per Host"]:::storage
        end
        subgraph "Telegram Connect Clients"
            direction TB
            TgConnectBase["TgConnectClientBase"]:::storage
            TgConnectBlazor["TgConnectClientBlazor"]:::storage
            TgConnectConsole["TgConnectClientConsole"]:::storage
            TgConnectDesktop["TgConnectClientDesktop"]:::storage
            TgConnectTest["TgConnectClientTest"]:::storage
        end
        DB["Database"]:::storage
    end

    subgraph "Core Layer"
        direction TB
        FileService["FileService"]:::core
        SampleData["SampleDataService"]:::core
    end

    TelegramAPI["Telegram API"]:::external
    LicenseService["License Service"]:::external
    FileSystem["File System"]:::external

    Blazor -->|uses| Contracts
    Console -->|uses| Contracts
    WinUI3 -->|uses| Contracts
    WPF -->|uses| Contracts

    Contracts -->|calls| Repos
    ViewModels -->|depends on| Repos
    TgLicenseHelper -->|calls| TgLicenseAPI
    TgLicenseHelper -->|calls| FileService

    Repos -->|EF Core| EfBlazor
    Repos -->|EF Core| EfConsole
    Repos -->|EF Core| EfDesktop
    Repos -->|EF Core| EfMemory
    Repos -->|EF Core| EfTest

    EfBlazor -->|migrations| Migrations
    EfConsole -->|migrations| Migrations
    EfDesktop -->|migrations| Migrations
    EfMemory -->|migrations| Migrations
    EfTest -->|migrations| Migrations

    TgConnectBase -->|implements| TgConnectBlazor
    TgConnectBase -->|implements| TgConnectConsole
    TgConnectBase -->|implements| TgConnectDesktop
    TgConnectBase -->|implements| TgConnectTest

    TgConnectBase -->|calls| TelegramAPI
    FileService -->|file I/O| FileSystem

    FileService -->|used by| Repos
    SampleData -->|used by| Repos

    classDef presentation fill:#FFA500,stroke:#333,stroke-width:1px
    classDef infrastructure fill:#1E90FF,stroke:#333,stroke-width:1px
    classDef storage fill:#32CD32,stroke:#333,stroke-width:1px
    classDef core fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef external fill:#FF6347,stroke:#333,stroke-width:1px

    click Blazor "https://github.com/damianmorozov/opentgresearcher/tree/main/Presentation/TgDownloaderBlazor"
    click Console "https://github.com/damianmorozov/opentgresearcher/tree/main/Presentation/TgDownloaderConsole"
    click WinUI3 "https://github.com/damianmorozov/opentgresearcher/tree/main/Presentation/TgDownloaderDesktop"
    click WPF "https://github.com/damianmorozov/opentgresearcher/tree/main/Presentation/TgDownloaderWinDesktopWPF"

    click TgLicenseHelper "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgInfrastructure/Helpers/TgLicenseManagerHelper.cs"
    click TgLicenseAPI "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgInfrastructure/License/TgLicense.cs"

    click Repos "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Contracts/ITgEfRepository.cs"

    click EfBlazor "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Domain/TgEfBlazorContext.cs"
    click EfConsole "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Domain/TgEfConsoleContext.cs"
    click EfDesktop "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Domain/TgEfDesktopContext.cs"
    click EfMemory "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Domain/TgEfMemoryContext.cs"
    click EfTest "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Domain/TgEfTestContext.cs"

    click Migrations "https://github.com/damianmorozov/opentgresearcher/tree/main/Core/TgStorage/Migrations"

    click TgConnectBase "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Connect/TgConnectClientBase.cs"
    click TgConnectBlazor "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Connect/TgConnectClientBlazor.cs"
    click TgConnectConsole "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Connect/TgConnectClientConsole.cs"
    click TgConnectDesktop "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Connect/TgConnectClientDesktop.cs"
    click TgConnectTest "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgStorage/Connect/TgConnectClientTest.cs"

    click FileService "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgDownloaderDesktop.Core/Services/FileService.cs"
    click SampleData "https://github.com/damianmorozov/opentgresearcher/blob/main/Core/TgDownloaderDesktop.Core/Services/SampleDataService.cs"
```
