# it-nilesh/signalynx architecture

> Architecture diagram of the GitHub repository it-nilesh/signalynx, 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/it-nilesh/signalynx
- Repository: https://github.com/it-nilesh/signalynx

## Overview

Signalynx is a .NET mediator/CQRS runtime with a separate durable-messaging layer. The principal local workflow is application dispatch through a mediator, dispatcher, pipeline behaviors, and a typed handler; publishing and bulk processing are parallel local capabilities. The messaging workflow enqueues or schedules messages, relays them through an outbox worker and transport, then receives them with inbox deduplication, retries, and dead-letter handling. The README supplies several subsystem relationships; unsampled implementation details are represented only where documented.

Main entry points: [`src/Signalynx.Messaging/OutboxWorker.cs`](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/OutboxWorker.cs) (Outbox worker), [`src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs`](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs) (DI registration), [`src/Signalynx.Messaging/ReceiverWorker.cs`](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/ReceiverWorker.cs) (Receiver worker), [`src/Signalynx.Core/SignalynxDispatcher.cs`](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxDispatcher.cs) (Request dispatcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_local["Local mediator"]
  node_mediator["Mediator API"]
  node_dispatcher["Request dispatcher"]
  node_pipeline["Pipeline executor"]
  node_handlers["Typed handlers<br/>[Handlers.cs]"]
  node_publishers["Notification publishers<br/>[Publishers.cs]"]
  node_bulk["Bulk processor"]
end

subgraph group_setup["Registration and behaviors"]
  node_registry["Handler registry<br/>[HandlerRegistry.cs]"]
  node_di["DI registration"]
  node_options["Runtime options"]
  node_validation["Validation behavior"]
  node_logging["Logging behavior"]
  node_generation["Source registration generator"]
end

subgraph group_messaging["Durable messaging"]
  node_bus["Message bus"]
  node_operations["Message operations"]
  node_outbox["Outbox worker<br/>[OutboxWorker.cs]"]
  node_receiver["Receiver worker<br/>[ReceiverWorker.cs]"]
  node_retry["Retry policy<br/>[RetryPolicy.cs]"]
  node_serializer["Message serialization<br/>[Serialization.cs]"]
end

subgraph group_adapters["Stores and transports"]
  node_stores[("SQL message stores")]
  node_postgres[("PostgreSQL message store")]
  node_memory[("In-memory stores")]
  node_memorytransport["In-memory transport"]
  node_brokertransports["Broker transports"]
  node_azure["Azure Service Bus adapter"]
  node_sqs["Amazon SQS adapter"]
  node_kafka["Kafka adapter<br/>[KafkaTransport.cs]"]
end

node_application(("Application"))
node_externalbroker(("Message broker"))

node_application -->|"dispatches"| node_mediator
node_mediator -->|"delegates to"| node_dispatcher
node_dispatcher -->|"executes through"| node_pipeline
node_pipeline -->|"invokes"| node_handlers
node_dispatcher -->|"resolves"| node_handlers
node_application -->|"publishes events"| node_publishers
node_application -->|"submits batches"| node_bulk
node_di -->|"constructs"| node_registry
node_di -->|"configures"| node_options
node_di -->|"registers"| node_dispatcher
node_di -->|"registers"| node_pipeline
node_options -->|"configures optionally"| node_validation
node_options -->|"configures optionally"| node_logging
node_generation -->|"generates registration"| node_options
node_application -->|"enqueues or schedules"| node_bus
node_bus -->|"exposes operations"| node_operations
node_outbox -.->|"reads and updates"| node_stores
node_outbox -.->|"reads and updates"| node_memory
node_outbox -.->|"sends messages"| node_memorytransport
node_outbox -->|"consults"| node_retry
node_receiver -->|"receives deliveries"| node_memorytransport
node_receiver -.->|"uses inbox and dead letters"| node_memory
node_receiver -->|"consults"| node_retry
node_receiver -->|"invokes registered message handler"| node_handlers
node_bus -.->|"serializes messages"| node_serializer
node_stores -.->|"provides durable storage"| node_outbox
node_postgres -.->|"provides durable storage"| node_outbox
node_memorytransport -.->|"in-process delivery"| node_externalbroker
node_brokertransports -.->|"transports messages"| node_externalbroker
node_azure -.->|"transports messages"| node_externalbroker
node_sqs -.->|"transports messages"| node_externalbroker
node_kafka -.->|"transports messages"| node_externalbroker

click node_mediator "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxMediator.cs"
click node_dispatcher "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxDispatcher.cs"
click node_pipeline "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/PipelineExecutor.cs"
click node_handlers "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Abstractions/Handlers.cs"
click node_publishers "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/Publishers.cs"
click node_bulk "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxBulkProcessor.cs"
click node_registry "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/HandlerRegistry.cs"
click node_di "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs"
click node_options "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxOptions.cs"
click node_validation "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Validation/ValidationBehaviors.cs"
click node_logging "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Logging/LoggingBehaviors.cs"
click node_generation "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.SourceGeneration/SignalynxGenerator.cs"
click node_bus "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/SignalynxMessageBus.cs"
click node_operations "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/MessageOperations.cs"
click node_outbox "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/OutboxWorker.cs"
click node_receiver "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/ReceiverWorker.cs"
click node_retry "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/RetryPolicy.cs"
click node_serializer "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/Serialization.cs"
click node_stores "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Stores.SqlServer/SqlServerMessageStore.cs"
click node_postgres "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Stores.PostgreSql/PostgreSqlMessageStore.cs"
click node_memory "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.InMemory/InMemoryMessageStore.cs"
click node_memorytransport "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.InMemory/InMemoryMessageTransport.cs"
click node_brokertransports "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.RabbitMQ/RabbitMqTransport.cs"
click node_azure "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.AzureServiceBus/AzureServiceBusTransport.cs"
click node_sqs "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.AmazonSqs/AmazonSqsTransport.cs"
click node_kafka "https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.Kafka/KafkaTransport.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_mediator,node_dispatcher,node_pipeline,node_handlers,node_publishers,node_bulk toneBlue
class node_registry,node_di,node_options,node_validation,node_logging,node_generation toneAmber
class node_bus,node_operations,node_outbox,node_receiver,node_retry,node_serializer toneMint
class node_stores,node_postgres,node_memory,node_memorytransport,node_brokertransports,node_azure,node_sqs,node_kafka toneRose
class node_application,node_externalbroker toneIndigo
```

## Components

### Local mediator

- [Mediator API](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxMediator.cs): `src/Signalynx.Core/SignalynxMediator.cs`
- [Request dispatcher](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxDispatcher.cs): `src/Signalynx.Core/SignalynxDispatcher.cs`
- [Pipeline executor](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/PipelineExecutor.cs): `src/Signalynx.Core/PipelineExecutor.cs`
- [Typed handlers](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Abstractions/Handlers.cs): `src/Signalynx.Abstractions/Handlers.cs`
- [Notification publishers](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/Publishers.cs): `src/Signalynx.Core/Publishers.cs`
- [Bulk processor](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxBulkProcessor.cs): `src/Signalynx.Core/SignalynxBulkProcessor.cs`

### Registration and behaviors

- [Handler registry](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/HandlerRegistry.cs): `src/Signalynx.Core/HandlerRegistry.cs`
- [DI registration](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs): `src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs`
- [Runtime options](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Core/SignalynxOptions.cs): `src/Signalynx.Core/SignalynxOptions.cs`
- [Validation behavior](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Validation/ValidationBehaviors.cs): `src/Signalynx.Validation/ValidationBehaviors.cs`
- [Logging behavior](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Logging/LoggingBehaviors.cs): `src/Signalynx.Logging/LoggingBehaviors.cs`
- [Source registration generator](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.SourceGeneration/SignalynxGenerator.cs): `src/Signalynx.SourceGeneration/SignalynxGenerator.cs`

### Durable messaging

- [Message bus](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/SignalynxMessageBus.cs): `src/Signalynx.Messaging/SignalynxMessageBus.cs`
- [Message operations](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/MessageOperations.cs): `src/Signalynx.Messaging/MessageOperations.cs`
- [Outbox worker](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/OutboxWorker.cs): `src/Signalynx.Messaging/OutboxWorker.cs`
- [Receiver worker](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/ReceiverWorker.cs): `src/Signalynx.Messaging/ReceiverWorker.cs`
- [Retry policy](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/RetryPolicy.cs): `src/Signalynx.Messaging/RetryPolicy.cs`
- [Message serialization](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Messaging/Serialization.cs): `src/Signalynx.Messaging/Serialization.cs`

### Stores and transports

- [SQL message stores](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Stores.SqlServer/SqlServerMessageStore.cs): `src/Signalynx.Stores.SqlServer/SqlServerMessageStore.cs`
- [PostgreSQL message store](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Stores.PostgreSql/PostgreSqlMessageStore.cs): `src/Signalynx.Stores.PostgreSql/PostgreSqlMessageStore.cs`
- [In-memory stores](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.InMemory/InMemoryMessageStore.cs): `src/Signalynx.Transports.InMemory/InMemoryMessageStore.cs`
- [In-memory transport](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.InMemory/InMemoryMessageTransport.cs): `src/Signalynx.Transports.InMemory/InMemoryMessageTransport.cs`
- [Broker transports](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.RabbitMQ/RabbitMqTransport.cs): `src/Signalynx.Transports.RabbitMQ/RabbitMqTransport.cs`
- [Azure Service Bus adapter](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.AzureServiceBus/AzureServiceBusTransport.cs): `src/Signalynx.Transports.AzureServiceBus/AzureServiceBusTransport.cs`
- [Amazon SQS adapter](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.AmazonSqs/AmazonSqsTransport.cs): `src/Signalynx.Transports.AmazonSqs/AmazonSqsTransport.cs`
- [Kafka adapter](https://github.com/it-nilesh/signalynx/blob/main/src/Signalynx.Transports.Kafka/KafkaTransport.cs): `src/Signalynx.Transports.Kafka/KafkaTransport.cs`

### Other components

- **Application**
- **Message broker**

## Connections

- Application → Mediator API: dispatches (evidence: `README.md`)
- Mediator API → Request dispatcher: delegates to (evidence: `src/Signalynx.Core/SignalynxMediator.cs`)
- Request dispatcher → Pipeline executor: executes through (evidence: `src/Signalynx.Core/SignalynxDispatcher.cs`)
- Pipeline executor → Typed handlers: invokes (evidence: `src/Signalynx.Core/PipelineExecutor.cs`)
- Request dispatcher → Typed handlers: resolves (evidence: `src/Signalynx.Core/SignalynxDispatcher.cs`)
- Application → Notification publishers: publishes events (evidence: `README.md`)
- Application → Bulk processor: submits batches (evidence: `README.md`)
- DI registration → Handler registry: constructs (evidence: `src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs`)
- DI registration → Runtime options: configures (evidence: `src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs`)
- DI registration → Request dispatcher: registers (evidence: `src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs`)
- DI registration → Pipeline executor: registers (evidence: `src/Signalynx.DependencyInjection/ServiceCollectionExtensions.cs`)
- Runtime options → Validation behavior: configures optionally (evidence: `README.md`)
- Runtime options → Logging behavior: configures optionally (evidence: `README.md`)
- Source registration generator → Runtime options: generates registration (evidence: `src/Signalynx.SourceGeneration/SignalynxGenerator.cs`)
- Application → Message bus: enqueues or schedules (evidence: `README.md`)
- Message bus → Message operations: exposes operations (evidence: `src/Signalynx.Messaging/ServiceCollectionExtensions.cs`)
- Outbox worker → SQL message stores: reads and updates
- Outbox worker → In-memory stores: reads and updates
- Outbox worker → In-memory transport: sends messages
- Outbox worker → Retry policy: consults (evidence: `src/Signalynx.Messaging/OutboxWorker.cs`)
- Receiver worker → In-memory transport: receives deliveries (evidence: `src/Signalynx.Messaging/ReceiverWorker.cs`)
- Receiver worker → In-memory stores: uses inbox and dead letters
- Receiver worker → Retry policy: consults (evidence: `src/Signalynx.Messaging/ReceiverWorker.cs`)
- Receiver worker → Typed handlers: invokes registered message handler (evidence: `src/Signalynx.Messaging/ReceiverWorker.cs`)
- Message bus → Message serialization: serializes messages
- SQL message stores → Outbox worker: provides durable storage
- PostgreSQL message store → Outbox worker: provides durable storage
- In-memory transport → Message broker: in-process delivery
- Broker transports → Message broker: transports messages
- Azure Service Bus adapter → Message broker: transports messages
- Amazon SQS adapter → Message broker: transports messages
- Kafka adapter → Message broker: transports messages
