# boskod/adomonitor architecture

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

- Interactive diagram: https://gitdiagram.com/boskod/adomonitor
- Repository: https://github.com/boskod/adomonitor

## Overview

##### Project type and purpose
- This is a .NET console application (“Azure DevOps console client”) whose sole responsibility is to call the Azure DevOps Services REST API, deserialize responses into C# models, and print or process information in the console.
- It retrieves build information, release information, and service‐health status from Azure DevOps using the REST API endpoints.

##### File structure
- Top level contains:
- ADOMonitor.sln – the Visual Studio solution
- .github/workflows/dotnet.yml – CI pipeline definition
- ADOMonitor/ADOMonitor.csproj – project file
- README.md
- Inside ADOMonitor/:
- Program.cs – the entry point with Main(), orchestrating calls
- Models/ – namespaces broken out by API area:
– ADOBuilds (all types under Builds endpoints)
– ADOReleases (all types under Releases endpoints)
– ADOServiceHealth (types under Service Health endpoints)

##### README for additional insights
- The README confirms it’s purely a REST‐API client with no UI; it’s intended to demonstrate or automate Azure DevOps data retrieval.
- It links to the official REST API docs, implying the code wraps those endpoints.

##### Elements
- From CLI → API Connector → HTTP Client → Azure DevOps REST API
- Responses return in reverse direction through the same path
- CI/CD → builds/tests project

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline"
        GitHubActions["GitHub Actions\ndotnet.yml"]:::ci
        click GitHubActions "https://github.com/boskod/adomonitor/blob/master/.github/workflows/dotnet.yml"
    end
    GitHubActions -->|"build & test"| ADOMonitorCSProj

    %% Project & Documentation
    ADOMonitorCSProj["ADOMonitor.csproj"]:::internal
    click ADOMonitorCSProj "https://github.com/boskod/adomonitor/blob/master/ADOMonitor/ADOMonitor.csproj"
    ADOMonitorCSProj -->|"included in"| Solution
    Solution["ADOMonitor.sln"]:::internal
    click Solution "https://github.com/boskod/adomonitor/blob/master/ADOMonitor.sln"
    Solution --> Docs
    Docs["README.md"]:::internal
    click Docs "https://github.com/boskod/adomonitor/blob/master/README.md"

    %% Application Layers
    subgraph "Application"
        direction TB
        CLI["CLI Layer\nProgram.cs"]:::internal
        click CLI "https://github.com/boskod/adomonitor/blob/master/ADOMonitor/Program.cs"

        subgraph "Connector Modules"
            BuildsClient["BuildsClient"]:::internal
            ReleasesClient["ReleasesClient"]:::internal
            ServiceHealthClient["ServiceHealthClient"]:::internal
        end

        HttpClient["HTTP Client\nSystem.Net.Http.HttpClient"]:::internal

        subgraph "Data Model Layer"
            ADOBuilds["ADOBuilds Models"]:::internal
            click ADOBuilds "https://github.com/boskod/adomonitor/tree/master/ADOMonitor/Models/ADOBuilds/"
            ADOReleases["ADOReleases Models"]:::internal
            click ADOReleases "https://github.com/boskod/adomonitor/tree/master/ADOMonitor/Models/ADOReleases/"
            ADOServiceHealth["ADOServiceHealth Models"]:::internal
            click ADOServiceHealth "https://github.com/boskod/adomonitor/tree/master/ADOMonitor/Models/ADOServiceHealth/"
        end
    end

    %% External System
    AzureAPI["Azure DevOps REST API"]:::external

    %% Data Flow
    ADOMonitorCSProj --> CLI
    CLI -->|"invokes"| BuildsClient
    CLI -->|"invokes"| ReleasesClient
    CLI -->|"invokes"| ServiceHealthClient

    BuildsClient -->|"uses"| HttpClient
    ReleasesClient -->|"uses"| HttpClient
    ServiceHealthClient -->|"uses"| HttpClient

    HttpClient -->|"sends JSON over HTTP"| AzureAPI
    AzureAPI -->|"returns JSON"| HttpClient

    HttpClient -->|"deserializes into"| ADOBuilds
    HttpClient -->|"deserializes into"| ADOReleases
    HttpClient -->|"deserializes into"| ADOServiceHealth

    BuildsClient -->|"returns models"| CLI
    ReleasesClient -->|"returns models"| CLI
    ServiceHealthClient -->|"returns models"| CLI

    %% Styles
    classDef internal fill:#D5E8D4,stroke:#82B366,color:#275A28;
    classDef external fill:#FFF2CC,stroke:#D6A900,color:#613A00;
    classDef ci fill:#DAE8FC,stroke:#6C8EBF,color:#1A3E6E;
```
