# yannkosal/spring-dbs architecture

> Architecture diagram of the GitHub repository yannkosal/spring-dbs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yannkosal/spring-dbs
- Repository: https://github.com/yannkosal/spring-dbs

## Overview

Spring DBS is a banking backend composed of independently running services. The principal workflow enters through the API gateway and reaches account, transfer, or payment APIs; the transaction service coordinates transfer events, while payment orders integrate with Razorpay. Account, transaction, and payment data use MySQL; Redis supports rate limiting and fraud-related operations. Kafka carries event-driven work, including fraud checks and notifications. Edges reflect README-documented routes and responsibilities; source was not available to verify finer-grained calls or event wiring.

Main entry points: [`api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java`](https://github.com/yannkosal/spring-dbs/blob/main/api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java) (API gateway), [`fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionEventConsumer.java`](https://github.com/yannkosal/spring-dbs/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionEventConsumer.java) (Fraud event consumer), [`fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java`](https://github.com/yannkosal/spring-dbs/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java) (Fraud checks), [`payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java`](https://github.com/yannkosal/spring-dbs/blob/main/payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java) (Payment API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_gateway["API gateway"]
  node_rate["Rate limiting"]
end

subgraph group_banking["Banking services"]
  node_account_api["Account API"]
  node_account_logic["Account management"]
  node_transaction_api["Transaction API"]
  node_transaction_logic["Transfer coordination"]
  node_account_client["Account client"]
  node_payment_api["Payment API"]
  node_payment_logic["Payment orders"]
end

subgraph group_events["Event services"]
  node_fraud_consumer["Fraud event consumer"]
  node_fraud_logic["Fraud checks"]
  node_fraud_account_client["Fraud account client"]
  node_account_consumer["Account event consumer"]
  node_transaction_consumer["Transaction event consumer"]
  node_notification["Notifications"]
end

subgraph group_state["Data and integrations"]
  node_account_store[("Account records")]
  node_transaction_store[("Transaction history")]
  node_payment_store[("Payment records")]
  node_kafka["Kafka"]
  node_mysql[("MySQL")]
  node_redis[("Redis")]
end

node_user(("API client"))
node_razorpay["Razorpay"]

node_user -->|"sends requests"| node_gateway
node_gateway -->|"routes accounts"| node_account_api
node_gateway -->|"routes transactions"| node_transaction_api
node_gateway -->|"routes payments"| node_payment_api
node_transaction_logic -->|"coordinates events"| node_kafka
node_kafka -->|"delivers transaction events"| node_fraud_consumer
node_fraud_consumer -.->|"triggers checks"| node_fraud_logic
node_kafka -->|"delivers account, transaction, fraud, and payment events"| node_notification
node_payment_logic -->|"creates orders"| node_razorpay
node_razorpay -->|"sends webhooks"| node_payment_api
node_account_store -->|"stores account data"| node_mysql
node_transaction_store -->|"stores transaction data"| node_mysql
node_payment_store -->|"stores payment data"| node_mysql
node_gateway -.->|"supports rate limiting"| node_redis
node_fraud_logic -.->|"supports fraud operations"| node_redis

click node_gateway "https://github.com/yannkosal/spring-dbs/blob/main/api-gateway/src/main/java/com/banking/apigateway/ApiGatewayApplication.java"
click node_rate "https://github.com/yannkosal/spring-dbs/blob/main/api-gateway/src/main/java/com/banking/apigateway/config/RateLimiterConfig.java"
click node_account_api "https://github.com/yannkosal/spring-dbs/blob/main/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java"
click node_account_logic "https://github.com/yannkosal/spring-dbs/blob/main/account-service/src/main/java/com/banking/accountservice/service/AccountService.java"
click node_account_store "https://github.com/yannkosal/spring-dbs/blob/main/account-service/src/main/java/com/banking/accountservice/repository/AccountRepository.java"
click node_transaction_api "https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java"
click node_transaction_logic "https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java"
click node_transaction_store "https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/repository/TransactionRepository.java"
click node_account_client "https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/client/AccountServiceClient.java"
click node_payment_api "https://github.com/yannkosal/spring-dbs/blob/main/payment-service/src/main/java/com/banking/paymentservice/controller/PaymentController.java"
click node_payment_logic "https://github.com/yannkosal/spring-dbs/blob/main/payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java"
click node_payment_store "https://github.com/yannkosal/spring-dbs/blob/main/payment-service/src/main/java/com/banking/paymentservice/repository/PaymentRepository.java"
click node_fraud_consumer "https://github.com/yannkosal/spring-dbs/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionEventConsumer.java"
click node_fraud_logic "https://github.com/yannkosal/spring-dbs/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionService.java"
click node_fraud_account_client "https://github.com/yannkosal/spring-dbs/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/client/AccountServiceClient.java"
click node_account_consumer "https://github.com/yannkosal/spring-dbs/blob/main/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java"
click node_transaction_consumer "https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionEventConsumer.java"
click node_notification "https://github.com/yannkosal/spring-dbs/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_user toneBlue
class node_account_api,node_account_logic,node_transaction_api,node_transaction_logic,node_account_client,node_payment_api,node_payment_logic toneAmber
class node_fraud_consumer,node_fraud_logic,node_fraud_account_client,node_account_consumer,node_transaction_consumer,node_notification toneMint
class node_account_store,node_transaction_store,node_payment_store,node_kafka,node_mysql,node_redis toneRose
class node_razorpay toneIndigo
```

## Components

### API entry

- [API gateway](https://github.com/yannkosal/spring-dbs/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/yannkosal/spring-dbs/blob/main/api-gateway/src/main/java/com/banking/apigateway/config/RateLimiterConfig.java): `api-gateway/src/main/java/com/banking/apigateway/config/RateLimiterConfig.java`

### Banking services

- [Account API](https://github.com/yannkosal/spring-dbs/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 management](https://github.com/yannkosal/spring-dbs/blob/main/account-service/src/main/java/com/banking/accountservice/service/AccountService.java): `account-service/src/main/java/com/banking/accountservice/service/AccountService.java`
- [Transaction API](https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java): `transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java`
- [Transfer coordination](https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java): `transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`
- [Account client](https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/client/AccountServiceClient.java): `transaction-service/src/main/java/com/banking/transactionservice/client/AccountServiceClient.java`
- [Payment API](https://github.com/yannkosal/spring-dbs/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 orders](https://github.com/yannkosal/spring-dbs/blob/main/payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java): `payment-service/src/main/java/com/banking/paymentservice/service/PaymentService.java`

### Event services

- [Fraud event consumer](https://github.com/yannkosal/spring-dbs/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionEventConsumer.java): `fraud-detection-service/src/main/java/com/banking/frauddetectionservice/service/FraudDetectionEventConsumer.java`
- [Fraud checks](https://github.com/yannkosal/spring-dbs/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`
- [Fraud account client](https://github.com/yannkosal/spring-dbs/blob/main/fraud-detection-service/src/main/java/com/banking/frauddetectionservice/client/AccountServiceClient.java): `fraud-detection-service/src/main/java/com/banking/frauddetectionservice/client/AccountServiceClient.java`
- [Account event consumer](https://github.com/yannkosal/spring-dbs/blob/main/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java): `account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java`
- [Transaction event consumer](https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionEventConsumer.java): `transaction-service/src/main/java/com/banking/transactionservice/service/TransactionEventConsumer.java`
- [Notifications](https://github.com/yannkosal/spring-dbs/blob/main/notification-service/src/main/java/com/banking/notificationservice/service/NotificationService.java): `notification-service/src/main/java/com/banking/notificationservice/service/NotificationService.java`

### Data and integrations

- [Account records](https://github.com/yannkosal/spring-dbs/blob/main/account-service/src/main/java/com/banking/accountservice/repository/AccountRepository.java): `account-service/src/main/java/com/banking/accountservice/repository/AccountRepository.java`
- [Transaction history](https://github.com/yannkosal/spring-dbs/blob/main/transaction-service/src/main/java/com/banking/transactionservice/repository/TransactionRepository.java): `transaction-service/src/main/java/com/banking/transactionservice/repository/TransactionRepository.java`
- [Payment records](https://github.com/yannkosal/spring-dbs/blob/main/payment-service/src/main/java/com/banking/paymentservice/repository/PaymentRepository.java): `payment-service/src/main/java/com/banking/paymentservice/repository/PaymentRepository.java`
- **Kafka**
- **MySQL**
- **Redis**

### Other components

- **API client**
- **Razorpay**

## Connections

- API client → API gateway: sends requests (evidence: `README.md`)
- API gateway → Account API: routes accounts (evidence: `README.md`)
- API gateway → Transaction API: routes transactions (evidence: `README.md`)
- API gateway → Payment API: routes payments (evidence: `README.md`)
- Transfer coordination → Kafka: coordinates events (evidence: `README.md`)
- Kafka → Fraud event consumer: delivers transaction events (evidence: `README.md`)
- Fraud event consumer → Fraud checks: triggers checks
- Kafka → Notifications: delivers account, transaction, fraud, and payment events (evidence: `README.md`)
- Payment orders → Razorpay: creates orders (evidence: `README.md`)
- Razorpay → Payment API: sends webhooks (evidence: `README.md`)
- Account records → MySQL: stores account data (evidence: `README.md`)
- Transaction history → MySQL: stores transaction data (evidence: `README.md`)
- Payment records → MySQL: stores payment data (evidence: `README.md`)
- API gateway → Redis: supports rate limiting (evidence: `README.md`)
- Fraud checks → Redis: supports fraud operations (evidence: `README.md`)
