# ms-commerce-architecture/saga-orchestrator architecture

> Architecture diagram of the GitHub repository ms-commerce-architecture/saga-orchestrator, 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/ms-commerce-architecture/saga-orchestrator
- Repository: https://github.com/ms-commerce-architecture/saga-orchestrator

## Overview

This repository appears to be a Java saga-orchestrator service: its source tree contains an application entry point, saga state and messaging models, repositories, and a database migration. The tree suggests a workflow involving order, payment, and stock commands, but no README or source excerpts were provided, so the runtime sequence and relationships among these components cannot be verified. The graph therefore maps the identifiable product components without asserting unsupported calls or data flow.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application"]
  node_application["Saga application"]
end

subgraph group_domain["Saga State"]
  node_saga_instance["Saga instance<br/>[SagaInstance.java]"]
  node_saga_status["Saga status<br/>[SagaStatus.java]"]
  node_processed_message["Processed message"]
  node_saga_outbox["Saga outbox<br/>[SagaOutbox.java]"]
end

subgraph group_messaging["Messaging"]
  node_start_request["Start request"]
  node_order_line["Order line<br/>[OrderLine.java]"]
  node_saga_event["Saga event<br/>[SagaEvent.java]"]
  node_confirm_order["Confirm order"]
  node_process_payment["Process payment"]
  node_refund_payment["Refund or void"]
  node_reject_order["Reject order"]
  node_release_stock["Release stock"]
  node_reserve_stock["Reserve stock"]
end

subgraph group_storage["Persistence"]
  node_processed_repo["Processed messages repository"]
  node_saga_repo["Saga repository"]
  node_outbox_repo["Outbox repository"]
  node_saga_schema[("Saga tables")]
end

click node_application "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/SagaOrchestratorApplication.java"
click node_saga_instance "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/domain/SagaInstance.java"
click node_saga_status "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/domain/Enum/SagaStatus.java"
click node_processed_message "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/domain/ProcessedMessage.java"
click node_saga_outbox "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/domain/SagaOutbox.java"
click node_start_request "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/dto/StartSagaRequest.java"
click node_order_line "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/dto/OrderLine.java"
click node_saga_event "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/event/SagaEvent.java"
click node_confirm_order "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/ConfirmOrderCommand.java"
click node_process_payment "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/ProcessPaymentCommand.java"
click node_refund_payment "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/RefundOrVoidPaymentCommand.java"
click node_reject_order "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/RejectOrderCommand.java"
click node_release_stock "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/ReleasesStockCommand.java"
click node_reserve_stock "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/ReserveStockCommand.java"
click node_processed_repo "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/repository/ProcessedMessageRepository.java"
click node_saga_repo "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/repository/SagaInstanceRepository.java"
click node_outbox_repo "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/repository/SagaOutboxRepository.java"
click node_saga_schema "https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/resources/db/migration/V1__create_saga_tables.sql.sql"

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_application toneBlue
class node_saga_instance,node_saga_status,node_processed_message,node_saga_outbox toneAmber
class node_start_request,node_order_line,node_saga_event,node_confirm_order,node_process_payment,node_refund_payment,node_reject_order,node_release_stock,node_reserve_stock toneMint
class node_processed_repo,node_saga_repo,node_outbox_repo,node_saga_schema toneRose
```

## Components

### Application

- [Saga application](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/SagaOrchestratorApplication.java): `src/main/java/com/example/saga/SagaOrchestratorApplication.java`

### Saga State

- [Saga instance](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/domain/SagaInstance.java): `src/main/java/com/example/saga/domain/SagaInstance.java`
- [Saga status](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/domain/Enum/SagaStatus.java): `src/main/java/com/example/saga/domain/Enum/SagaStatus.java`
- [Processed message](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/domain/ProcessedMessage.java): `src/main/java/com/example/saga/domain/ProcessedMessage.java`
- [Saga outbox](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/domain/SagaOutbox.java): `src/main/java/com/example/saga/domain/SagaOutbox.java`

### Messaging

- [Start request](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/dto/StartSagaRequest.java): `src/main/java/com/example/saga/messaging/dto/StartSagaRequest.java`
- [Order line](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/dto/OrderLine.java): `src/main/java/com/example/saga/messaging/dto/OrderLine.java`
- [Saga event](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/event/SagaEvent.java): `src/main/java/com/example/saga/messaging/event/SagaEvent.java`
- [Confirm order](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/ConfirmOrderCommand.java): `src/main/java/com/example/saga/messaging/command/ConfirmOrderCommand.java`
- [Process payment](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/ProcessPaymentCommand.java): `src/main/java/com/example/saga/messaging/command/ProcessPaymentCommand.java`
- [Refund or void](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/RefundOrVoidPaymentCommand.java): `src/main/java/com/example/saga/messaging/command/RefundOrVoidPaymentCommand.java`
- [Reject order](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/RejectOrderCommand.java): `src/main/java/com/example/saga/messaging/command/RejectOrderCommand.java`
- [Release stock](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/ReleasesStockCommand.java): `src/main/java/com/example/saga/messaging/command/ReleasesStockCommand.java`
- [Reserve stock](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/messaging/command/ReserveStockCommand.java): `src/main/java/com/example/saga/messaging/command/ReserveStockCommand.java`

### Persistence

- [Processed messages repository](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/repository/ProcessedMessageRepository.java): `src/main/java/com/example/saga/repository/ProcessedMessageRepository.java`
- [Saga repository](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/repository/SagaInstanceRepository.java): `src/main/java/com/example/saga/repository/SagaInstanceRepository.java`
- [Outbox repository](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/java/com/example/saga/repository/SagaOutboxRepository.java): `src/main/java/com/example/saga/repository/SagaOutboxRepository.java`
- [Saga tables](https://github.com/ms-commerce-architecture/saga-orchestrator/blob/master/src/main/resources/db/migration/V1__create_saga_tables.sql.sql): `src/main/resources/db/migration/V1__create_saga_tables.sql.sql`
