# kiarashminoo/thunderpropagator.channels architecture

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

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

## Overview

ThunderPropagator.Channels is a .NET collection of real-time channel capabilities, including chat, monitoring, notifications, feeds, and multiplayer games. The chat workflow authenticates a connection, handles user/group/message requests, and persists domain state through a pluggable context; chat events are represented by feeder messages. Tic-tac-toe requests enter through receiver pipelines and are handled by a channel backed by game services. Source excerpts and index references substantiate only selected links; other documented capabilities are shown as subsystems without guessed runtime connections.

Main entry points: [`src/Channels/ThunderPropagator.Channels.Chat/Models/BaseChatContext.cs`](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/BaseChatContext.cs) (Chat context), [`src/Channels/ThunderPropagator.Channels.Chat/Models/Users/UserService.cs`](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Users/UserService.cs) (User service), [`src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/MessageService.cs`](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/MessageService.cs) (Message service), [`src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Groups`](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Groups) (Group requests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chat_api["Chat request handling"]
  node_chat_auth["Session authentication"]
  node_chat_channel["Chat channel<br/>[ChatChannel.cs]"]
  node_chat_users_api["User requests<br/>[Users]"]
  node_chat_groups_api["Group requests<br/>[Groups]"]
  node_chat_messages_api["Message requests<br/>[Messages]"]
end

subgraph group_chat_domain["Chat domain"]
  node_user_service["User service<br/>[UserService.cs]"]
  node_user_entity["User model<br/>[User.cs]"]
  node_group_service["Group service<br/>[GroupService.cs]"]
  node_group_entity["Group model<br/>[Group.cs]"]
  node_message_service["Message service<br/>[MessageService.cs]"]
  node_message_entity["Message model<br/>[Message.cs]"]
  node_session_service["Session service"]
  node_chat_events["Chat feeder events"]
end

subgraph group_chat_storage["Chat persistence"]
  node_chat_context["Chat context<br/>[BaseChatContext.cs]"]
  node_ef_storage["EF Core adapter"]
  node_mongo_storage["MongoDB adapter"]
  node_memory_storage["In-memory adapter"]
end

subgraph group_games["Multiplayer games"]
  node_ttt_pipelines["Tic-tac-toe requests<br/>[Pipelines]"]
  node_ttt_channel["Tic-tac-toe channel"]
  node_ttt_service["Tic-tac-toe service"]
  node_rps_matchmaking["RPS matchmaking"]
end

subgraph group_channels["Other channels"]
  node_clock["Clock feeds"]
  node_network_monitoring["Network monitoring"]
  node_notifications["Notifications"]
  node_resource_monitoring["Resource monitoring"]
  node_throughput["Throughput feeds"]
  node_timezones["Time-zone feeds"]
end

node_chat_client(("Chat client"))
node_game_client(("Game client"))

node_chat_auth -->|"resolves session"| node_chat_channel
node_chat_auth -->|"checks identity"| node_session_service
node_chat_client -.->|"sends requests"| node_chat_auth
node_chat_users_api -->|"invokes"| node_user_service
node_chat_groups_api -->|"invokes"| node_group_service
node_chat_groups_api -->|"resolves users"| node_user_service
node_chat_groups_api -->|"uses service"| node_message_service
node_chat_messages_api -.->|"invokes"| node_message_service
node_user_service -->|"updates model"| node_user_entity
node_group_service -->|"updates model"| node_group_entity
node_message_service -->|"updates model"| node_message_entity
node_user_service -.->|"uses context"| node_chat_context
node_group_service -.->|"uses context"| node_chat_context
node_message_service -.->|"uses context"| node_chat_context
node_chat_context -.->|"implemented by"| node_ef_storage
node_chat_context -.->|"implemented by"| node_mongo_storage
node_chat_context -.->|"implemented by"| node_memory_storage
node_chat_channel -.->|"emits events"| node_chat_events
node_game_client -.->|"sends requests"| node_ttt_pipelines
node_ttt_pipelines -->|"calls channel"| node_ttt_channel
node_ttt_channel -->|"uses service"| node_ttt_service

click node_chat_auth "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/AuthenticatedChatChannelReceiverPipeline.cs"
click node_chat_channel "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Channel/ChatChannel.cs"
click node_chat_users_api "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Users"
click node_chat_groups_api "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Groups"
click node_chat_messages_api "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Messages"
click node_user_service "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Users/UserService.cs"
click node_user_entity "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Users/User.cs"
click node_group_service "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Groups/GroupService.cs"
click node_group_entity "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Groups/Group.cs"
click node_message_service "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/MessageService.cs"
click node_message_entity "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/Message.cs"
click node_session_service "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Sessions/ChatUserSessionService.cs"
click node_chat_events "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Messages/ChatChannelFeederMessage.cs"
click node_chat_context "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/BaseChatContext.cs"
click node_ef_storage "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat.EntityFrameworkCore/Context/EntityFrameworkCoreChatContext.cs"
click node_mongo_storage "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat.MongoDB/Context/MongoDbChatContext.cs"
click node_memory_storage "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat.InMemory/Context/InMemoryChatContext.cs"
click node_ttt_pipelines "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Games/ThunderPropagator.Channels.Games.TicTacToe/Pipelines"
click node_ttt_channel "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Games/ThunderPropagator.Channels.Games.TicTacToe"
click node_ttt_service "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Games/ThunderPropagator.Channels.Games.TicTacToe/Models/TicTacToeGameService.cs"
click node_rps_matchmaking "https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Games/ThunderPropagator.Channels.Games.RockPaperScissors/Models/RockPaperScissorsMatchmakingService.cs"
click node_clock "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Clock"
click node_network_monitoring "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.NetworkMonitoring"
click node_notifications "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Notifications"
click node_resource_monitoring "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.ResourceMonitoring"
click node_throughput "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Throughput"
click node_timezones "https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.TimeZones"

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_chat_auth,node_chat_channel,node_chat_users_api,node_chat_groups_api,node_chat_messages_api,node_chat_client,node_game_client toneBlue
class node_user_service,node_user_entity,node_group_service,node_group_entity,node_message_service,node_message_entity,node_session_service,node_chat_events toneAmber
class node_chat_context,node_ef_storage,node_mongo_storage,node_memory_storage toneMint
class node_ttt_pipelines,node_ttt_channel,node_ttt_service,node_rps_matchmaking toneRose
class node_clock,node_network_monitoring,node_notifications,node_resource_monitoring,node_throughput,node_timezones toneIndigo
```

## Components

### Chat request handling

- [Session authentication](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/AuthenticatedChatChannelReceiverPipeline.cs): `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/AuthenticatedChatChannelReceiverPipeline.cs`
- [Chat channel](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Channel/ChatChannel.cs): `src/Channels/ThunderPropagator.Channels.Chat/Channel/ChatChannel.cs`
- [User requests](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Users): `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Users`
- [Group requests](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Groups): `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Groups`
- [Message requests](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Messages): `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Messages`

### Chat domain

- [User service](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Users/UserService.cs): `src/Channels/ThunderPropagator.Channels.Chat/Models/Users/UserService.cs`
- [User model](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Users/User.cs): `src/Channels/ThunderPropagator.Channels.Chat/Models/Users/User.cs`
- [Group service](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Groups/GroupService.cs): `src/Channels/ThunderPropagator.Channels.Chat/Models/Groups/GroupService.cs`
- [Group model](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Groups/Group.cs): `src/Channels/ThunderPropagator.Channels.Chat/Models/Groups/Group.cs`
- [Message service](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/MessageService.cs): `src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/MessageService.cs`
- [Message model](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/Message.cs): `src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/Message.cs`
- [Session service](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/Sessions/ChatUserSessionService.cs): `src/Channels/ThunderPropagator.Channels.Chat/Models/Sessions/ChatUserSessionService.cs`
- [Chat feeder events](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Messages/ChatChannelFeederMessage.cs): `src/Channels/ThunderPropagator.Channels.Chat/Messages/ChatChannelFeederMessage.cs`

### Chat persistence

- [Chat context](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat/Models/BaseChatContext.cs): `src/Channels/ThunderPropagator.Channels.Chat/Models/BaseChatContext.cs`
- [EF Core adapter](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat.EntityFrameworkCore/Context/EntityFrameworkCoreChatContext.cs): `src/Channels/ThunderPropagator.Channels.Chat.EntityFrameworkCore/Context/EntityFrameworkCoreChatContext.cs`
- [MongoDB adapter](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat.MongoDB/Context/MongoDbChatContext.cs): `src/Channels/ThunderPropagator.Channels.Chat.MongoDB/Context/MongoDbChatContext.cs`
- [In-memory adapter](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Channels/ThunderPropagator.Channels.Chat.InMemory/Context/InMemoryChatContext.cs): `src/Channels/ThunderPropagator.Channels.Chat.InMemory/Context/InMemoryChatContext.cs`

### Multiplayer games

- [Tic-tac-toe requests](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Games/ThunderPropagator.Channels.Games.TicTacToe/Pipelines): `src/Games/ThunderPropagator.Channels.Games.TicTacToe/Pipelines`
- [Tic-tac-toe channel](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Games/ThunderPropagator.Channels.Games.TicTacToe): `src/Games/ThunderPropagator.Channels.Games.TicTacToe`
- [Tic-tac-toe service](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Games/ThunderPropagator.Channels.Games.TicTacToe/Models/TicTacToeGameService.cs): `src/Games/ThunderPropagator.Channels.Games.TicTacToe/Models/TicTacToeGameService.cs`
- [RPS matchmaking](https://github.com/kiarashminoo/thunderpropagator.channels/blob/develop/src/Games/ThunderPropagator.Channels.Games.RockPaperScissors/Models/RockPaperScissorsMatchmakingService.cs): `src/Games/ThunderPropagator.Channels.Games.RockPaperScissors/Models/RockPaperScissorsMatchmakingService.cs`

### Other channels

- [Clock feeds](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Clock): `src/Channels/ThunderPropagator.Channels.Clock`
- [Network monitoring](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.NetworkMonitoring): `src/Channels/ThunderPropagator.Channels.NetworkMonitoring`
- [Notifications](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Notifications): `src/Channels/ThunderPropagator.Channels.Notifications`
- [Resource monitoring](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.ResourceMonitoring): `src/Channels/ThunderPropagator.Channels.ResourceMonitoring`
- [Throughput feeds](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.Throughput): `src/Channels/ThunderPropagator.Channels.Throughput`
- [Time-zone feeds](https://github.com/kiarashminoo/thunderpropagator.channels/tree/develop/src/Channels/ThunderPropagator.Channels.TimeZones): `src/Channels/ThunderPropagator.Channels.TimeZones`

### Other components

- **Chat client**
- **Game client**

## Connections

- Session authentication → Chat channel: resolves session (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/AuthenticatedChatChannelReceiverPipeline.cs`)
- Session authentication → Session service: checks identity
- Chat client → Session authentication: sends requests
- User requests → User service: invokes (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Users/Search/ChatChannelSearchUsersReceiverPipeline.cs`)
- Group requests → Group service: invokes (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Groups/Rename/ChatChannelRenameGroupReceiverPipeline.cs`)
- Group requests → User service: resolves users (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Groups/Rename/ChatChannelRenameGroupReceiverPipeline.cs`)
- Group requests → Message service: uses service (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Pipelines/Groups/Rename/ChatChannelRenameGroupReceiverPipeline.cs`)
- Message requests → Message service: invokes
- User service → User model: updates model (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Models/Users/UserService.cs`)
- Group service → Group model: updates model (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Models/Groups/GroupService.cs`)
- Message service → Message model: updates model (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Models/Messages/MessageService.cs`)
- User service → Chat context: uses context
- Group service → Chat context: uses context
- Message service → Chat context: uses context
- Chat context → EF Core adapter: implemented by
- Chat context → MongoDB adapter: implemented by
- Chat context → In-memory adapter: implemented by
- Chat channel → Chat feeder events: emits events (evidence: `src/Channels/ThunderPropagator.Channels.Chat/Channel/ChatChannel.cs`)
- Game client → Tic-tac-toe requests: sends requests
- Tic-tac-toe requests → Tic-tac-toe channel: calls channel (evidence: `src/Games/ThunderPropagator.Channels.Games.TicTacToe/Pipelines/AddGame/TicTacToeChannelAddGameReceiverPipeline.cs`)
- Tic-tac-toe channel → Tic-tac-toe service: uses service (evidence: `src/Games/ThunderPropagator.Channels.Games.TicTacToe/Channel/TicTacToeChannel.cs`)
