# enescelebii/banking-system-sagapattern-with-fraudservice architecture

> Architecture diagram of the GitHub repository enescelebii/banking-system-sagapattern-with-fraudservice, 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/enescelebii/banking-system-sagapattern-with-fraudservice
- Repository: https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice

## Overview

This is an event-driven banking microservices system. A client enters through the gateway to create accounts, transfer funds, verify suspicious transfers with OTP, or initiate external payments. Transfers debit the sender, undergo fraud checks, then complete or trigger compensating refunds; Kafka events connect these stages to account updates and notifications. The README documents the principal event flows and Redis/MySQL roles; several service internals are unsampled, so unverified implementation links are omitted.

Main entry points: [`transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java) (Saga Orchestrator), [`api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java`](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java) (API Gateway), [`payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java`](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java) (Payment Processing), [`fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java`](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java) (Fraud Checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Client Entry"]
  node_gateway["API Gateway"]
  node_rate["Rate Limiting"]
end

subgraph group_accounts["Account Management"]
  node_account_api["Account API"]
  node_account_logic["Account Operations"]
  node_account_store[("Account Records<br/>[Account.java]")]
  node_account_events["Account Event Consumer"]
  node_mysql[("MySQL")]
end

subgraph group_saga["Transfer Saga"]
  node_transaction_api["Transaction API"]
  node_saga_orchestrator["Saga Orchestrator"]
  node_transaction_store[("Transaction Records<br/>[Transaction.java]")]
  node_transaction_events["Transaction Event Consumer"]
end

subgraph group_payments["External Payments"]
  node_payment_api["Payment API"]
  node_payment_logic["Payment Processing"]
  node_provider_factory["Provider Selection"]
  node_payment_provider["Payment Providers"]
  node_payment_store[("Payment Records<br/>[Payment.java]")]
end

subgraph group_events["Fraud and Events"]
  node_fraud_logic["Fraud Checks"]
  node_notifications["Notifications"]
  node_kafka["Kafka"]
  node_redis[("Redis State")]
end

node_client(("Banking Client"))

node_client -->|"sends requests"| node_gateway
node_gateway -->|"rate limits"| node_rate
node_gateway -->|"routes requests"| node_account_api
node_gateway -->|"routes requests"| node_transaction_api
node_gateway -->|"routes requests"| node_payment_api
node_account_api -->|"delegates to"| node_account_logic
node_account_logic -->|"reads and writes"| node_account_store
node_account_logic -->|"persists accounts"| node_mysql
node_transaction_api -->|"delegates to"| node_saga_orchestrator
node_saga_orchestrator -->|"debits and credits"| node_account_api
node_saga_orchestrator -->|"records transfers"| node_transaction_store
node_saga_orchestrator -->|"publishes events"| node_kafka
node_kafka -->|"delivers initiated"| node_fraud_logic
node_fraud_logic -->|"checks balance"| node_account_api
node_fraud_logic -->|"tracks velocity and average"| node_redis
node_fraud_logic -->|"publishes check result"| node_kafka
node_kafka -->|"delivers fraud results"| node_transaction_events
node_transaction_events -.->|"advances saga"| node_saga_orchestrator
node_saga_orchestrator -->|"publishes completion and compensation"| node_kafka
node_kafka -->|"delivers account events"| node_account_events
node_kafka -->|"delivers alerts and OTP"| node_notifications
node_payment_api -->|"delegates to"| node_payment_logic
node_payment_logic -->|"selects provider"| node_provider_factory
node_provider_factory -.->|"returns provider"| node_payment_provider
node_payment_logic -->|"saves payment"| node_payment_store
node_payment_logic -->|"publishes payment results"| node_kafka
node_payment_store -->|"persists payments"| node_mysql
node_saga_orchestrator -->|"stores OTP"| node_redis
node_kafka -->|"delivers payment events"| node_notifications

click node_gateway "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java"
click node_rate "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/api-gateway/src/main/java/com/banking/apigateway/config/RateLimiterConfig.java"
click node_account_api "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java"
click node_account_logic "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/account-service/src/main/java/com/banking/accountservice/service/AccountService.java"
click node_account_store "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/account-service/src/main/java/com/banking/accountservice/entity/Account.java"
click node_account_events "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java"
click node_transaction_api "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java"
click node_saga_orchestrator "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java"
click node_transaction_store "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/entity/Transaction.java"
click node_transaction_events "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionEventConsumer.java"
click node_payment_api "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java"
click node_payment_logic "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java"
click node_provider_factory "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/config/PaymentProviderFactory.java"
click node_payment_provider "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/provider/PaymentProvider.java"
click node_payment_store "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/entity/Payment.java"
click node_fraud_logic "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java"
click node_notifications "https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/notification-service/src/main/java/com/banking/notificationservice/service/NotificationService.java"

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_gateway,node_rate,node_client toneBlue
class node_account_api,node_account_logic,node_account_store,node_account_events,node_mysql toneAmber
class node_transaction_api,node_saga_orchestrator,node_transaction_store,node_transaction_events toneMint
class node_payment_api,node_payment_logic,node_provider_factory,node_payment_provider,node_payment_store toneRose
class node_fraud_logic,node_notifications,node_kafka,node_redis toneIndigo
```

## Components

### Client Entry

- [API Gateway](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java): `api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java`
- [Rate Limiting](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/api-gateway/src/main/java/com/banking/apigateway/config/RateLimiterConfig.java): `api-gateway/src/main/java/com/banking/apigateway/config/RateLimiterConfig.java`

### Account Management

- [Account API](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java): `account-service/src/main/java/com/banking/accountservice/controller/AccountController.java`
- [Account Operations](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/account-service/src/main/java/com/banking/accountservice/service/AccountService.java): `account-service/src/main/java/com/banking/accountservice/service/AccountService.java`
- [Account Records](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/account-service/src/main/java/com/banking/accountservice/entity/Account.java): `account-service/src/main/java/com/banking/accountservice/entity/Account.java`
- [Account Event Consumer](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java): `account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java`
- **MySQL**

### Transfer Saga

- [Transaction API](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java): `transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java`
- [Saga Orchestrator](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java): `transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`
- [Transaction Records](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/entity/Transaction.java): `transaction-service/src/main/java/com/banking/transactionservice/entity/Transaction.java`
- [Transaction Event Consumer](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionEventConsumer.java): `transaction-service/src/main/java/com/banking/transactionservice/service/TransactionEventConsumer.java`

### External Payments

- [Payment API](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java): `payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java`
- [Payment Processing](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java): `payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java`
- [Provider Selection](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/config/PaymentProviderFactory.java): `payment-service/src/main/java/com/banking/paymentservice/config/PaymentProviderFactory.java`
- [Payment Providers](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/provider/PaymentProvider.java): `payment-service/src/main/java/com/banking/paymentservice/provider/PaymentProvider.java`
- [Payment Records](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/payment-service/src/main/java/com/banking/paymentservice/entity/Payment.java): `payment-service/src/main/java/com/banking/paymentservice/entity/Payment.java`

### Fraud and Events

- [Fraud Checks](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java): `fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java`
- [Notifications](https://github.com/enescelebii/banking-system-sagapattern-with-fraudservice/blob/main/notification-service/src/main/java/com/banking/notificationservice/service/NotificationService.java): `notification-service/src/main/java/com/banking/notificationservice/service/NotificationService.java`
- **Kafka**
- **Redis State**

### Other components

- **Banking Client**

## Connections

- Banking Client → API Gateway: sends requests (evidence: `README.md`)
- API Gateway → Rate Limiting: rate limits (evidence: `README.md`)
- API Gateway → Account API: routes requests (evidence: `README.md`)
- API Gateway → Transaction API: routes requests (evidence: `README.md`)
- API Gateway → Payment API: routes requests (evidence: `README.md`)
- Account API → Account Operations: delegates to (evidence: `account-service/src/main/java/com/banking/accountservice/controller/AccountController.java`)
- Account Operations → Account Records: reads and writes (evidence: `account-service/src/main/java/com/banking/accountservice/service/AccountService.java`)
- Account Operations → MySQL: persists accounts (evidence: `README.md`)
- Transaction API → Saga Orchestrator: delegates to (evidence: `transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java`)
- Saga Orchestrator → Account API: debits and credits (evidence: `account-service/src/main/java/com/banking/accountservice/controller/AccountController.java`)
- Saga Orchestrator → Transaction Records: records transfers (evidence: `transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`)
- Saga Orchestrator → Kafka: publishes events (evidence: `README.md`)
- Kafka → Fraud Checks: delivers initiated (evidence: `README.md`)
- Fraud Checks → Account API: checks balance (evidence: `fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java`)
- Fraud Checks → Redis State: tracks velocity and average (evidence: `README.md`)
- Fraud Checks → Kafka: publishes check result (evidence: `fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java`)
- Kafka → Transaction Event Consumer: delivers fraud results (evidence: `README.md`)
- Transaction Event Consumer → Saga Orchestrator: advances saga
- Saga Orchestrator → Kafka: publishes completion and compensation (evidence: `README.md`)
- Kafka → Account Event Consumer: delivers account events (evidence: `README.md`)
- Kafka → Notifications: delivers alerts and OTP (evidence: `README.md`)
- Payment API → Payment Processing: delegates to (evidence: `payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java`)
- Payment Processing → Provider Selection: selects provider (evidence: `payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java`)
- Provider Selection → Payment Providers: returns provider (evidence: `payment-service/src/main/java/com/banking/paymentservice/config/PaymentProviderFactory.java`)
- Payment Processing → Payment Records: saves payment (evidence: `payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java`)
- Payment Processing → Kafka: publishes payment results (evidence: `payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java`)
- Payment Records → MySQL: persists payments (evidence: `README.md`)
- Saga Orchestrator → Redis State: stores OTP (evidence: `README.md`)
- Kafka → Notifications: delivers payment events (evidence: `README.md`)
