# kristjan-jonsson/topicpubsubpoc architecture

> Architecture diagram of the GitHub repository kristjan-jonsson/topicpubsubpoc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kristjan-jonsson/topicpubsubpoc
- Repository: https://github.com/kristjan-jonsson/topicpubsubpoc

## Overview

This is a small .NET proof of concept for IBM MQ topic publish/subscribe. The principal workflow is to load MQ settings, select publisher or subscriber mode, then publish JSON messages to a configured topic or listen for messages on that topic; the README also describes hierarchical topic strings. The sampled source shows the entry point, configuration loader, publisher, consumer, and message model. The MQ service is external. The appsettings relationship is documented, while runtime behavior beyond the sampled files is not inferred.

Main entry points: [`Program.cs`](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/Program.cs) (Mode dispatcher), [`SimplePublisher.cs`](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/SimplePublisher.cs) (Topic publisher), [`MQConfig.cs`](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/MQConfig.cs) (Config loader), [`SimpleConsumer.cs`](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/SimpleConsumer.cs) (Topic subscriber)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_entry["Mode dispatcher<br/>[Program.cs]"]
  node_settings["MQ settings<br/>[appsettings.json]"]
  node_config["Config loader<br/>[MQConfig.cs]"]
end

subgraph group_messaging["Message handling"]
  node_publisher["Topic publisher<br/>[SimplePublisher.cs]"]
  node_consumer["Topic subscriber<br/>[SimpleConsumer.cs]"]
  node_payload["JSON message<br/>[jsonMessage.cs]"]
end

subgraph group_mq["IBM MQ"]
  node_broker[("MQ topic service")]
end

node_user(("Operator"))

node_user -->|"selects mode"| node_entry
node_settings -->|"provides settings"| node_config
node_entry -->|"loads settings"| node_config
node_config -->|"returns config"| node_entry
node_entry -->|"dispatches publish"| node_publisher
node_entry -->|"dispatches subscribe"| node_consumer
node_publisher -->|"serializes message"| node_payload
node_publisher -->|"publishes topic"| node_broker
node_consumer -->|"subscribes and receives"| node_broker

click node_entry "https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/Program.cs"
click node_settings "https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/appsettings.json"
click node_config "https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/MQConfig.cs"
click node_publisher "https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/SimplePublisher.cs"
click node_consumer "https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/SimpleConsumer.cs"
click node_payload "https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/jsonMessage.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_entry,node_settings,node_config toneBlue
class node_publisher,node_consumer,node_payload toneAmber
class node_broker toneMint
class node_user toneIndigo
```

## Components

### Application runtime

- [Mode dispatcher](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/Program.cs): `Program.cs`
- [MQ settings](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/appsettings.json): `appsettings.json`
- [Config loader](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/MQConfig.cs): `MQConfig.cs`

### Message handling

- [Topic publisher](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/SimplePublisher.cs): `SimplePublisher.cs`
- [Topic subscriber](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/SimpleConsumer.cs): `SimpleConsumer.cs`
- [JSON message](https://github.com/kristjan-jonsson/topicpubsubpoc/blob/main/jsonMessage.cs): `jsonMessage.cs`

### IBM MQ

- **MQ topic service**

### Other components

- **Operator**

## Connections

- Operator → Mode dispatcher: selects mode (evidence: `README.md`)
- MQ settings → Config loader: provides settings (evidence: `README.md`)
- Mode dispatcher → Config loader: loads settings (evidence: `Program.cs`)
- Config loader → Mode dispatcher: returns config (evidence: `Program.cs`)
- Mode dispatcher → Topic publisher: dispatches publish (evidence: `Program.cs`)
- Mode dispatcher → Topic subscriber: dispatches subscribe (evidence: `Program.cs`)
- Topic publisher → JSON message: serializes message (evidence: `SimplePublisher.cs`)
- Topic publisher → MQ topic service: publishes topic (evidence: `SimplePublisher.cs`)
- Topic subscriber → MQ topic service: subscribes and receives (evidence: `SimpleConsumer.cs`)
