https://github.com/mnzcrsh/microservices-gunstock-processing

Sorrowful attempts at distributed system with event-driven design and plug-in based microservices
https://github.com/mnzcrsh/microservices-gunstock-processing

cqrs event-sourcing kafka postgresql redis-cache saga-pattern

Last synced: about 1 month ago
JSON representation

Sorrowful attempts at distributed system with event-driven design and plug-in based microservices

• Host: GitHub
• URL: https://github.com/mnzcrsh/microservices-gunstock-processing
• Owner: MnzCrsh
• License: mit
• Created: 2025-01-11T17:22:21.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2025-02-17T22:10:45.000Z (over 1 year ago)
• Last Synced: 2025-03-12T09:16:12.533Z (over 1 year ago)
• Topics: cqrs, event-sourcing, kafka, postgresql, redis-cache, saga-pattern
• Language: C#
• Homepage:
• Size: 109 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Microservices Architecture with CQRS, Event Sourcing, and Saga Pattern

[![order-service-pipeline](https://github.com/MnzCrsh/microservices-order-organstock-processing/actions/workflows/order-service-pipeline.yml/badge.svg)](https://github.com/MnzCrsh/microservices-order-organstock-processing/actions/workflows/order-service-pipeline.yml) [![order-service-deployment](https://github.com/MnzCrsh/microservices-order-organstock-processing/actions/workflows/order-service-deployment.yml/badge.svg?branch=master)](https://github.com/MnzCrsh/microservices-order-organstock-processing/actions/workflows/order-service-deployment.yml)

This project demonstrates a microservices architecture using CQRS, Event Sourcing, Apache Kafka, and the Saga pattern. It simulates a simple order processing system with payment handling, event-driven architecture, and compensating transactions in case of failures.

## High-Level Architecture

The diagram below shows the interaction between services in the system:

```mermaid

graph TD

    subgraph Client

        A[Client] -->|Create Order Command| B[Order Service]

        A -->|Fetch Order Query| B

    end

    subgraph Order

        B[Order Service] -->|OrderCreatedEvent| C[Payment Service]

        B -->|OrderPaidEvent| A

    end

    subgraph Payment

        C[Payment Service] -->|Process Payment Command| D[Payment Gateway]

        D[Payment Gateway] -->|PaymentProcessedEvent| C

        C -->|PaymentProcessedEvent| B

    end

    subgraph Saga Orchestrator

        E[Cancel Order Command] -->|OrderCancelledEvent| B

        F[Cancel Payment Command] -->|PaymentCancelledEvent| C

    end

    subgraph Kafka_Event_Bus

        B -.->|OrderCreatedEvent| Kafka[Kafka]

        C -.->|PaymentProcessedEvent| Kafka

        D -.->|PaymentProcessedEvent| Kafka

        Kafka -.->|OrderPaidEvent| A

        Kafka -.->|PaymentCancelledEvent| C

        Kafka -.->|OrderCancelledEvent| B

    end

    subgraph Event storage

        G[Event Store] -->|OrderCreatedEvent| B

        G -->|PaymentProcessedEvent| C

    end

    subgraph Integration

        A -.->|Send Events| Kafka

        Kafka -.->|Events| B

        Kafka -.->|Events| C

    end

    B -.->|Handle Events| E

    C -.->|Handle Events| F

    %% Event refs

    B -->|OrderCreatedEvent| G

    C -->|PaymentProcessedEvent| G

    B -->|OrderPaidEvent| Kafka

    C -->|PaymentProcessedEvent| Kafka