# justeattakeaway/justsaying architecture

> Architecture diagram of the GitHub repository justeattakeaway/justsaying, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/justeattakeaway/justsaying
- Repository: https://github.com/justeattakeaway/justsaying

## Overview

##### Main Components

a) Core Components:
- Message Publishing System
- Message Subscription System
- AWS Integration Layer (SNS/SQS)
- Middleware Pipeline
- Serialization System
- Configuration System

b) Integration Points:
- AWS SNS Topics
- AWS SQS Queues
- Error Queues
- Client Applications

##### Architecture Representation

**[Client Applications Layer]**
- ↕
**[JustSaying Library Layer]**
- Publishing System
- Subscription System
- Middleware Pipeline
- Message Handlers
- Serialization
- ↕
**[AWS Integration Layer]**
- SNS Topics
- SQS Queues

##### Key Elements to Highlight

a) Message Flow:
- Publisher → SNS Topic → SQS Queue(s) → Subscriber(s)
- Error handling paths to error queues
- Middleware pipeline stages

b) Configuration Components:
- Queue/Topic naming conventions
- AWS credentials/region handling
- Message serialization options (Newtonsoft.Json/System.Text.Json)

##### Important Architectural Patterns

- Middleware Pipeline Pattern
- Publisher/Subscriber Pattern
- Message Handler Pattern
- Exactly-Once Processing
- Error Queue Pattern

##### Specific Implementation Details

Specialized components like:
- Message Serialization Registry
- Handler Resolution System
- Monitoring/Logging System
- Queue/Topic Creation/Management

##### Relationships

- Message publishing flow
- Subscription handling
- Error queue relationships
- Middleware chain execution
- AWS service interactions

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client["Client Applications"]
        App[Client Application]:::client
    end

    subgraph Library["JustSaying Library"]
        direction TB
        Config[Configuration System]:::core
        click Config "https://github.com/justeattakeaway/JustSaying/tree/main/src/JustSaying/Fluent/"
        
        subgraph Messaging["Messaging Layer"]
            direction TB
            Publisher[Message Publishing System]:::core
            click Publisher "https://github.com/justeattakeaway/JustSaying/blob/main/src/JustSaying/AwsTools/MessageHandling/SnsMessagePublisher.cs"
            
            Subscriber[Message Subscription System]:::core
            click Subscriber "https://github.com/justeattakeaway/JustSaying/blob/main/src/JustSaying/AwsTools/MessageHandling/SqsQueueReader.cs"
            
            Models[Core Models]:::core
            click Models "https://github.com/justeattakeaway/JustSaying/tree/main/src/JustSaying.Models/"
            
            Handler[Message Handling]:::core
            click Handler "https://github.com/justeattakeaway/JustSaying/tree/main/src/JustSaying/Messaging/MessageHandling/"
            
            Middleware[Middleware Pipeline]:::core
            click Middleware "https://github.com/justeattakeaway/JustSaying/tree/main/src/JustSaying/Messaging/Middleware/"
            
            Serialization[Serialization System]:::core
            click Serialization "https://github.com/justeattakeaway/JustSaying/tree/main/src/JustSaying/Messaging/Serialization/"
        end
        
        AWSIntegration[AWS Integration Layer]:::core
        click AWSIntegration "https://github.com/justeattakeaway/JustSaying/tree/main/src/JustSaying/AwsTools/"
    end

    subgraph AWS["AWS Services"]
        direction TB
        SNS[SNS Topics]:::aws
        SQS[SQS Queues]:::aws
        ErrorQueue[Error Queues]:::error
    end

    %% Relationships
    App --> Publisher
    App --> Subscriber
    
    Publisher --> Middleware
    Subscriber --> Middleware
    
    Middleware --> Handler
    Middleware --> Serialization
    
    Handler --> Models
    
    Publisher --> AWSIntegration
    Subscriber --> AWSIntegration
    
    Config --> Publisher
    Config --> Subscriber
    Config --> AWSIntegration
    
    AWSIntegration --> SNS
    AWSIntegration --> SQS
    
    SNS --> SQS
    SQS --> ErrorQueue
    
    %% Styles
    classDef core fill:#4a90e2,stroke:#2c3e50,color:white
    classDef aws fill:#7ab55c,stroke:#2c3e50,color:white
    classDef client fill:#f1c40f,stroke:#2c3e50,color:white
    classDef error fill:#e74c3c,stroke:#2c3e50,color:white
    
    %% Legend
    subgraph Legend
        L1[JustSaying Core]:::core
        L2[AWS Services]:::aws
        L3[Client Integration]:::client
        L4[Error Handling]:::error
    end
```
