# kiarashminoo/thunderpropagator.buildingblocks architecture

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

- Interactive diagram: https://gitdiagram.com/kiarashminoo/thunderpropagator.buildingblocks
- Repository: https://github.com/kiarashminoo/thunderpropagator.buildingblocks

## Overview

ThunderPropagator.BuildingBlocks is a reusable .NET library for the wider real-time streaming ecosystem, not a standalone streaming application. Its user workflow is consumers calling application abstractions for messages, configuration, serialization, security, change tracking, and shared utilities; infrastructure extensions also expose health checks and system-resource metrics. The resource-monitor registration method connects consumers to platform-specific metric clients. Relationships are limited to those visible in excerpts, the SOURCE INDEX, or README; several README capabilities have no sampled call flow.

Main entry points: [`src/ThunderPropagator.BuildingBlocks.Application/ServiceConfiguration.cs`](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/ServiceConfiguration.cs) (Service Configuration), [`src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/SystemResourceMonitorExtensions.cs`](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/SystemResourceMonitorExtensions.cs) (Monitor Registration), [`src/ThunderPropagator.BuildingBlocks.Application/ChangeTrackingItems/ChangeTrackingItem.cs`](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/ChangeTrackingItems/ChangeTrackingItem.cs) (Change Tracking), [`src/ThunderPropagator.BuildingBlocks.Application/Collections/BindingDictionary.cs`](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Collections/BindingDictionary.cs) (Collections)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application Building Blocks"]
  node_messages["Feeder Messages<br/>[FeederMessage.cs]"]
  node_telemetry["Telemetry<br/>[Telemetry.cs]"]
  node_change_tracking["Change Tracking"]
  node_collections["Collections"]
  node_serialization["Serialization"]
end

subgraph group_security["Security and Configuration"]
  node_attributes["Attributes"]
  node_ciphering["Ciphering"]
  node_sensitive_encryption["Sensitive Data Encryption"]
  node_service_configuration["Service Configuration"]
  node_certificate["Certificate Model"]
  node_identity["Identity Settings"]
end

subgraph group_infrastructure["Infrastructure Monitoring"]
  node_resource_registration["Monitor Registration"]
  node_resource_monitor["Resource Monitor"]
  node_metric_clients["Metric Clients<br/>[IMetricsClient.cs]"]
  node_metric_types["Metric Types<br/>[IMetrics.cs]"]
  node_network_reporter["Network Reporter"]
  node_network_data["Network Data"]
  node_activemq_health["ActiveMQ Health Check"]
end

subgraph group_runtime["Runtime Utilities"]
  node_correlation["Correlation IDs"]
  node_helpers["Helpers and Enums<br/>[Helpers]"]
  node_objects["Object Primitives"]
end

node_consumer(("Library Consumer"))

node_consumer -->|"uses"| node_messages
node_consumer -->|"uses"| node_telemetry
node_consumer -->|"uses"| node_change_tracking
node_consumer -->|"uses"| node_collections
node_consumer -->|"uses"| node_serialization
node_consumer -->|"uses"| node_ciphering
node_consumer -->|"uses"| node_correlation
node_consumer -->|"registers"| node_resource_registration
node_consumer -->|"uses"| node_activemq_health
node_collections -->|"uses"| node_change_tracking
node_change_tracking -->|"adapts"| node_objects
node_service_configuration -->|"reads"| node_attributes
node_service_configuration -->|"encrypts"| node_sensitive_encryption
node_service_configuration -->|"uses converter"| node_serialization
node_resource_registration -->|"registers"| node_resource_monitor
node_resource_registration -->|"registers clients"| node_metric_clients
node_metric_clients -->|"returns metrics"| node_metric_types
node_network_reporter -->|"produces"| node_network_data
node_activemq_health -->|"configures options"| node_helpers

click node_messages "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/FeederMessage.cs"
click node_telemetry "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Telemetry.cs"
click node_change_tracking "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/ChangeTrackingItems/ChangeTrackingItem.cs"
click node_collections "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Collections/BindingDictionary.cs"
click node_serialization "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Serializations/FormatSerializerRegistry.cs"
click node_attributes "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Attributes/SensitiveDataAttribute.cs"
click node_ciphering "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Ciphering/EncryptionService.cs"
click node_sensitive_encryption "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/SensitiveDataEncryption.cs"
click node_service_configuration "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/ServiceConfiguration.cs"
click node_certificate "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Certificate/CertificateModel.cs"
click node_identity "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Identity/JwtConfiguration.cs"
click node_correlation "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/CorrelationId/CorrelationIdProvider.cs"
click node_helpers "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/tree/develop/src/ThunderPropagator.BuildingBlocks.Application/Helpers"
click node_objects "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Objects/DisposableObject.cs"
click node_resource_registration "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/SystemResourceMonitorExtensions.cs"
click node_resource_monitor "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/ISystemResourceMonitor.cs"
click node_metric_clients "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/Metrics/IMetricsClient.cs"
click node_metric_types "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/Metrics/IMetrics.cs"
click node_network_reporter "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/System/Network/NetworkPerformanceReporter.cs"
click node_network_data "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/System/Network/NetworkPerformanceData.cs"
click node_activemq_health "https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/HealthChecks/ActiveMQHealthCheck.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_messages,node_telemetry,node_change_tracking,node_collections,node_serialization toneBlue
class node_attributes,node_ciphering,node_sensitive_encryption,node_service_configuration,node_certificate,node_identity toneAmber
class node_resource_registration,node_resource_monitor,node_metric_clients,node_metric_types,node_network_reporter,node_network_data,node_activemq_health toneMint
class node_correlation,node_helpers,node_objects toneRose
class node_consumer toneIndigo
```

## Components

### Application Building Blocks

- [Feeder Messages](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/FeederMessage.cs): `src/ThunderPropagator.BuildingBlocks.Application/FeederMessage.cs`
- [Telemetry](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Telemetry.cs): `src/ThunderPropagator.BuildingBlocks.Application/Telemetry.cs`
- [Change Tracking](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/ChangeTrackingItems/ChangeTrackingItem.cs): `src/ThunderPropagator.BuildingBlocks.Application/ChangeTrackingItems/ChangeTrackingItem.cs`
- [Collections](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Collections/BindingDictionary.cs): `src/ThunderPropagator.BuildingBlocks.Application/Collections/BindingDictionary.cs`
- [Serialization](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Serializations/FormatSerializerRegistry.cs): `src/ThunderPropagator.BuildingBlocks.Application/Serializations/FormatSerializerRegistry.cs`

### Security and Configuration

- [Attributes](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Attributes/SensitiveDataAttribute.cs): `src/ThunderPropagator.BuildingBlocks.Application/Attributes/SensitiveDataAttribute.cs`
- [Ciphering](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Ciphering/EncryptionService.cs): `src/ThunderPropagator.BuildingBlocks.Application/Ciphering/EncryptionService.cs`
- [Sensitive Data Encryption](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/SensitiveDataEncryption.cs): `src/ThunderPropagator.BuildingBlocks.Application/SensitiveDataEncryption.cs`
- [Service Configuration](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/ServiceConfiguration.cs): `src/ThunderPropagator.BuildingBlocks.Application/ServiceConfiguration.cs`
- [Certificate Model](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Certificate/CertificateModel.cs): `src/ThunderPropagator.BuildingBlocks.Application/Certificate/CertificateModel.cs`
- [Identity Settings](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Identity/JwtConfiguration.cs): `src/ThunderPropagator.BuildingBlocks.Application/Identity/JwtConfiguration.cs`

### Infrastructure Monitoring

- [Monitor Registration](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/SystemResourceMonitorExtensions.cs): `src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/SystemResourceMonitorExtensions.cs`
- [Resource Monitor](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/ISystemResourceMonitor.cs): `src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/ISystemResourceMonitor.cs`
- [Metric Clients](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/Metrics/IMetricsClient.cs): `src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/Metrics/IMetricsClient.cs`
- [Metric Types](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/Metrics/IMetrics.cs): `src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/Metrics/IMetrics.cs`
- [Network Reporter](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/System/Network/NetworkPerformanceReporter.cs): `src/ThunderPropagator.BuildingBlocks.Infrastructure/System/Network/NetworkPerformanceReporter.cs`
- [Network Data](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/System/Network/NetworkPerformanceData.cs): `src/ThunderPropagator.BuildingBlocks.Infrastructure/System/Network/NetworkPerformanceData.cs`
- [ActiveMQ Health Check](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Infrastructure/HealthChecks/ActiveMQHealthCheck.cs): `src/ThunderPropagator.BuildingBlocks.Infrastructure/HealthChecks/ActiveMQHealthCheck.cs`

### Runtime Utilities

- [Correlation IDs](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/CorrelationId/CorrelationIdProvider.cs): `src/ThunderPropagator.BuildingBlocks.Application/CorrelationId/CorrelationIdProvider.cs`
- [Helpers and Enums](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/tree/develop/src/ThunderPropagator.BuildingBlocks.Application/Helpers): `src/ThunderPropagator.BuildingBlocks.Application/Helpers`
- [Object Primitives](https://github.com/kiarashminoo/thunderpropagator.buildingblocks/blob/develop/src/ThunderPropagator.BuildingBlocks.Application/Objects/DisposableObject.cs): `src/ThunderPropagator.BuildingBlocks.Application/Objects/DisposableObject.cs`

### Other components

- **Library Consumer**

## Connections

- Library Consumer → Feeder Messages: uses (evidence: `README.md`)
- Library Consumer → Telemetry: uses (evidence: `README.md`)
- Library Consumer → Change Tracking: uses (evidence: `README.md`)
- Library Consumer → Collections: uses (evidence: `README.md`)
- Library Consumer → Serialization: uses (evidence: `README.md`)
- Library Consumer → Ciphering: uses (evidence: `README.md`)
- Library Consumer → Correlation IDs: uses (evidence: `README.md`)
- Library Consumer → Monitor Registration: registers (evidence: `README.md`)
- Library Consumer → ActiveMQ Health Check: uses (evidence: `README.md`)
- Collections → Change Tracking: uses (evidence: `src/ThunderPropagator.BuildingBlocks.Application/Collections/BindingDictionary.cs`)
- Change Tracking → Object Primitives: adapts
- Service Configuration → Attributes: reads (evidence: `src/ThunderPropagator.BuildingBlocks.Application/ServiceConfiguration.cs`)
- Service Configuration → Sensitive Data Encryption: encrypts (evidence: `src/ThunderPropagator.BuildingBlocks.Application/ServiceConfiguration.cs`)
- Service Configuration → Serialization: uses converter (evidence: `src/ThunderPropagator.BuildingBlocks.Application/ServiceConfiguration.cs`)
- Monitor Registration → Resource Monitor: registers (evidence: `src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/SystemResourceMonitorExtensions.cs`)
- Monitor Registration → Metric Clients: registers clients (evidence: `src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/SystemResourceMonitorExtensions.cs`)
- Metric Clients → Metric Types: returns metrics (evidence: `src/ThunderPropagator.BuildingBlocks.Infrastructure/SystemResourceMonitor/Metrics/IMetricsClient.cs`)
- Network Reporter → Network Data: produces (evidence: `src/ThunderPropagator.BuildingBlocks.Infrastructure/System/Network/NetworkPerformanceReporter.cs`)
- ActiveMQ Health Check → Helpers and Enums: configures options (evidence: `src/ThunderPropagator.BuildingBlocks.Infrastructure/HealthChecks/ActiveMQHealthCheck.cs`)
