How enescelebii/banking-system-sagapattern-with-fraudservice works
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: TransactionService.java Saga Orchestrator · ApiGatewayApplication.java API Gateway · PaymentService.java Payment Processing · FraudDetectionService.java Fraud Checks
Components 21
Client Entry
- API Gateway
api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java - Rate Limiting
api-gateway/src/main/java/com/banking/apigateway/config/RateLimiterConfig.java
Account Management
- Account API
account-service/src/main/java/com/banking/accountservice/controller/AccountController.java - Account Operations
account-service/src/main/java/com/banking/accountservice/service/AccountService.java - Account Records
account-service/src/main/java/com/banking/accountservice/entity/Account.java - Account Event Consumer
account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java - MySQL
Transfer Saga
- Transaction API
transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java - Saga Orchestrator
transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java - Transaction Records
transaction-service/src/main/java/com/banking/transactionservice/entity/Transaction.java - Transaction Event Consumer
transaction-service/src/main/java/com/banking/transactionservice/service/TransactionEventConsumer.java
External Payments
- Payment API
payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java - Payment Processing
payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java - Provider Selection
payment-service/src/main/java/com/banking/paymentservice/config/PaymentProviderFactory.java - Payment Providers
payment-service/src/main/java/com/banking/paymentservice/provider/PaymentProvider.java - Payment Records
payment-service/src/main/java/com/banking/paymentservice/entity/Payment.java
Fraud and Events
- Fraud Checks
fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java - Notifications
notification-service/src/main/java/com/banking/notificationservice/service/NotificationService.java - Kafka
- Redis State
Other components
- Banking Client
Connections 29
- Banking Client → API Gateway: sends requests
README.md - API Gateway → Rate Limiting: rate limits
README.md - API Gateway → Account API: routes requests
README.md - API Gateway → Transaction API: routes requests
README.md - API Gateway → Payment API: routes requests
README.md - Account API → Account Operations: delegates to
account-service/src/main/java/com/banking/accountservice/controller/AccountController.java - Account Operations → Account Records: reads and writes
account-service/src/main/java/com/banking/accountservice/service/AccountService.java - Account Operations → MySQL: persists accounts
README.md - Transaction API → Saga Orchestrator: delegates to
transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java - Saga Orchestrator → Account API: debits and credits
account-service/src/main/java/com/banking/accountservice/controller/AccountController.java - Saga Orchestrator → Transaction Records: records transfers
transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java - Saga Orchestrator → Kafka: publishes events
README.md - Kafka → Fraud Checks: delivers initiated
README.md - Fraud Checks → Account API: checks balance
fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java - Fraud Checks → Redis State: tracks velocity and average
README.md - Fraud Checks → Kafka: publishes check result
fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java - Kafka → Transaction Event Consumer: delivers fraud results
README.md - Transaction Event Consumer → Saga Orchestrator: advances saga
- Saga Orchestrator → Kafka: publishes completion and compensation
README.md - Kafka → Account Event Consumer: delivers account events
README.md - Kafka → Notifications: delivers alerts and OTP
README.md - Payment API → Payment Processing: delegates to
payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java - Payment Processing → Provider Selection: selects provider
payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java - Provider Selection → Payment Providers: returns provider
payment-service/src/main/java/com/banking/paymentservice/config/PaymentProviderFactory.java - Payment Processing → Payment Records: saves payment
payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java - Payment Processing → Kafka: publishes payment results
payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java - Payment Records → MySQL: persists payments
README.md - Saga Orchestrator → Redis State: stores OTP
README.md - Kafka → Notifications: delivers payment events
README.md