How dibyajit1234/banking-system works
This repository is a banking backend split into Spring services. The visible user workflow is account creation and lookup, followed by a transfer request that debits the sender, records a transaction, and publishes an initiation event. Fraud checks retrieve the sender balance, apply velocity, amount, and balance rules, then publish a clean or verification event. Account and transaction persistence are visible in source. The tree also contains a gateway, notification, and payment services, but their behavior is not shown; event routing and those services’ roles are therefore left unverified.
Main entry points: TransactionService.java Transfer operations · FraudDetectionService.java Fraud checks · AccountService.java Account operations · AccountController.java Account API
Components 20
API access
- API gateway
backend/api-gateway/src/main/resources/application.yaml
Accounts
- Account API
backend/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java - Account operations
backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java - Account model and DTOs
backend/account-service/src/main/java/com/banking/accountservice/entity/Account.java - Account repository
backend/account-service/src/main/java/com/banking/accountservice/repository/AccountRepository.java - Account event consumer
backend/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java
Transfers
- Transaction API
backend/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java - Transfer operations
backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java - Transaction model and DTOs
backend/transaction-service/src/main/java/com/banking/transactionservice/entity/Transaction.java - Transaction repository
backend/transaction-service/src/main/java/com/banking/transactionservice/repository/TransactionRepository.java - Account service client
backend/transaction-service/src/main/java/com/banking/transactionservice/client/AccountServiceClient.java - Payment service
backend/payment-service/src/main/java/com/banking/paymentservice/PaymentServiceApplication.java
Risk and events
- Fraud event consumer
backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionEventConsumer.java - Fraud checks
backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java - Account service client
backend/fraud-dection/src/main/java/com/banking/frauddection/client/AccountServiceClient.java - Fraud result
backend/fraud-dection/src/main/java/com/banking/frauddection/model/FraudCheckResult.java - Kafka broker
- Fraud counters
- Notification service
backend/notification-service/src/main/java/com/banking/notificationservice/NotificationServiceApplication.java
Other components
- Banking user
Connections 20
- Banking user → API gateway: sends requests
- API gateway → Account API: routes requests
- API gateway → Transaction API: routes requests
- Account API → Account operations: calls
backend/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java - Account operations → Account repository: reads and writes
backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java - Account operations → Account model and DTOs: maps account data
backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java - Transaction API → Transfer operations: calls
backend/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java - Transfer operations → Account service client: deducts balance
backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java - Transfer operations → Transaction repository: saves and reads
backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java - Transfer operations → Transaction model and DTOs: creates transaction
backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java - Transfer operations → Kafka broker: publishes event
backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java - Account service client → Account API: calls account service
- Kafka broker → Fraud event consumer: dispatches event
- Fraud event consumer → Fraud checks: calls
backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionEventConsumer.java - Fraud checks → Account service client: fetches balance
backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java - Fraud checks → Fraud result: produces result
backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java - Fraud checks → Fraud counters: reads and updates
backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java - Fraud checks → Kafka broker: publishes outcomes
backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java - Account service client → Account API: calls account service
- Account event consumer → Account operations: calls
backend/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java