# fcakiroglu16/queue-systems-course-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/fcakiroglu16/queue-systems-course-2026
- Repository: https://github.com/fcakiroglu16/queue-systems-course-2026

## Overview

This course repository contrasts an in-process observer example with a documented HTTP-to-broker queue workflow. The sampled Console.App code shows user creation and observer notification; the sampled Rest.API code only maps a weather forecast endpoint. The README describes publishing, consuming, acknowledgements, retries, and failure handling, but their implementations are not present in the sampled source, so those stages are shown as documented capabilities rather than verified runtime calls.

Main entry points: [`Console.App/UserService.cs`](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/UserService.cs) (User service), [`Console.App/ObserverDesignPattern/UserSubject.cs`](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/ObserverDesignPattern/UserSubject.cs) (Observer subject), [`Rest.API/Program.cs`](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Rest.API/Program.cs) (REST API), [`Console.App/Program.cs`](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Program.cs) (Console entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["In-process baseline"]
  node_console_entry["Console entry<br/>[Program.cs]"]
  node_user_service["User service<br/>[UserService.cs]"]
  node_user_repository["User repository<br/>[UserService.cs]"]
  node_user_subject["Observer subject<br/>[UserSubject.cs]"]
  node_user_event["User-created event<br/>[UserCratedEvent.cs]"]
  node_email_service["Email observer<br/>[EmailService.cs]"]
  node_discount_service["Discount observer<br/>[DiscountService.cs]"]
  node_email_contract["Email contract<br/>[IEmailService.cs]"]
  node_discount_contract["Discount contract"]
end

subgraph group_api["HTTP API"]
  node_rest_api["REST API<br/>[Program.cs]"]
  node_forecast["Forecast endpoint<br/>[Program.cs]"]
end

subgraph group_queue["Queue workflow"]
  node_broker["Message broker"]
  node_queue_consumer["Queue consumer"]
  node_acknowledgement["Acknowledgement"]
  node_retry_failure["Retries and failures"]
end

node_user(("User initiator"))
node_http_client(("HTTP client"))

node_console_entry -->|"attaches observers"| node_user_subject
node_console_entry -->|"creates service"| node_user_service
node_user -.->|"requests creation"| node_user_service
node_user_service -->|"creates user"| node_user_repository
node_user_service -->|"creates event"| node_user_event
node_user_service -->|"notifies"| node_user_subject
node_user_subject -->|"dispatches event"| node_email_service
node_user_subject -->|"dispatches event"| node_discount_service
node_email_service -->|"implements"| node_email_contract
node_discount_service -->|"implements"| node_discount_contract
node_http_client -.->|"sends HTTP"| node_rest_api
node_rest_api -->|"maps endpoint"| node_forecast
node_rest_api -.->|"publishes messages"| node_broker
node_broker -.->|"delivers messages"| node_queue_consumer
node_queue_consumer -.->|"acknowledges messages"| node_acknowledgement
node_queue_consumer -.->|"handles retries"| node_retry_failure

click node_console_entry "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Program.cs"
click node_user_service "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/UserService.cs"
click node_user_repository "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/UserService.cs"
click node_user_subject "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/ObserverDesignPattern/UserSubject.cs"
click node_user_event "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/ObserverDesignPattern/UserCratedEvent.cs"
click node_email_service "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Services/EmailService.cs"
click node_discount_service "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Services/DiscountService.cs"
click node_email_contract "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Services/IEmailService.cs"
click node_discount_contract "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Services/IDiscountService.cs"
click node_rest_api "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Rest.API/Program.cs"
click node_forecast "https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Rest.API/Program.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_console_entry,node_user_service,node_user_repository,node_user_subject,node_user_event,node_email_service,node_discount_service,node_email_contract,node_discount_contract,node_user,node_http_client toneBlue
class node_rest_api,node_forecast toneAmber
class node_broker,node_queue_consumer,node_acknowledgement,node_retry_failure toneMint
```

## Components

### In-process baseline

- [Console entry](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Program.cs): `Console.App/Program.cs`
- [User service](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/UserService.cs): `Console.App/UserService.cs`
- [User repository](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/UserService.cs): `Console.App/UserService.cs`
- [Observer subject](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/ObserverDesignPattern/UserSubject.cs): `Console.App/ObserverDesignPattern/UserSubject.cs`
- [User-created event](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/ObserverDesignPattern/UserCratedEvent.cs): `Console.App/ObserverDesignPattern/UserCratedEvent.cs`
- [Email observer](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Services/EmailService.cs): `Console.App/Services/EmailService.cs`
- [Discount observer](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Services/DiscountService.cs): `Console.App/Services/DiscountService.cs`
- [Email contract](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Services/IEmailService.cs): `Console.App/Services/IEmailService.cs`
- [Discount contract](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Console.App/Services/IDiscountService.cs): `Console.App/Services/IDiscountService.cs`

### HTTP API

- [REST API](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Rest.API/Program.cs): `Rest.API/Program.cs`
- [Forecast endpoint](https://github.com/fcakiroglu16/queue-systems-course-2026/blob/master/Rest.API/Program.cs): `Rest.API/Program.cs`

### Queue workflow

- **Message broker**
- **Queue consumer**
- **Acknowledgement**
- **Retries and failures**

### Other components

- **User initiator**
- **HTTP client**

## Connections

- Console entry → Observer subject: attaches observers (evidence: `Console.App/Program.cs`)
- Console entry → User service: creates service (evidence: `Console.App/Program.cs`)
- User initiator → User service: requests creation
- User service → User repository: creates user (evidence: `Console.App/UserService.cs`)
- User service → User-created event: creates event (evidence: `Console.App/UserService.cs`)
- User service → Observer subject: notifies (evidence: `Console.App/UserService.cs`)
- Observer subject → Email observer: dispatches event (evidence: `Console.App/ObserverDesignPattern/UserSubject.cs`)
- Observer subject → Discount observer: dispatches event (evidence: `Console.App/ObserverDesignPattern/UserSubject.cs`)
- Email observer → Email contract: implements (evidence: `Console.App/Services/EmailService.cs`)
- Discount observer → Discount contract: implements (evidence: `Console.App/Services/DiscountService.cs`)
- HTTP client → REST API: sends HTTP
- REST API → Forecast endpoint: maps endpoint (evidence: `Rest.API/Program.cs`)
- REST API → Message broker: publishes messages (evidence: `README.md`)
- Message broker → Queue consumer: delivers messages (evidence: `README.md`)
- Queue consumer → Acknowledgement: acknowledges messages (evidence: `README.md`)
- Queue consumer → Retries and failures: handles retries (evidence: `README.md`)
