# dibyajit1234/banking-system architecture

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

- Interactive diagram: https://gitdiagram.com/dibyajit1234/banking-system
- Repository: https://github.com/dibyajit1234/banking-system

## Overview

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: [`backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`](https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java) (Transfer operations), [`backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java`](https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java) (Fraud checks), [`backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java`](https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java) (Account operations), [`backend/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java`](https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java) (Account API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["API access"]
  node_gateway["API gateway<br/>[application.yaml]"]
end

subgraph group_accounts["Accounts"]
  node_account_api["Account API"]
  node_account_logic["Account operations"]
  node_account_model["Account model and DTOs<br/>[Account.java]"]
  node_account_repo[("Account repository")]
  node_account_consumer["Account event consumer"]
end

subgraph group_transfers["Transfers"]
  node_transaction_api["Transaction API"]
  node_transaction_logic["Transfer operations"]
  node_transaction_model["Transaction model and DTOs<br/>[Transaction.java]"]
  node_transaction_repo[("Transaction repository")]
  node_account_client_tx["Account service client"]
  node_payment_service["Payment service"]
end

subgraph group_risk["Risk and events"]
  node_fraud_consumer["Fraud event consumer"]
  node_fraud_logic["Fraud checks"]
  node_account_client_fraud["Account service client"]
  node_fraud_result["Fraud result"]
  node_event_broker["Kafka broker"]
  node_fraud_state[("Fraud counters")]
  node_notification_service["Notification service"]
end

node_customer(("Banking user"))

node_customer -.->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_account_api
node_gateway -.->|"routes requests"| node_transaction_api
node_account_api -->|"calls"| node_account_logic
node_account_logic -->|"reads and writes"| node_account_repo
node_account_logic -->|"maps account data"| node_account_model
node_transaction_api -->|"calls"| node_transaction_logic
node_transaction_logic -->|"deducts balance"| node_account_client_tx
node_transaction_logic -->|"saves and reads"| node_transaction_repo
node_transaction_logic -->|"creates transaction"| node_transaction_model
node_transaction_logic -->|"publishes event"| node_event_broker
node_account_client_tx -.->|"calls account service"| node_account_api
node_event_broker -.->|"dispatches event"| node_fraud_consumer
node_fraud_consumer -->|"calls"| node_fraud_logic
node_fraud_logic -->|"fetches balance"| node_account_client_fraud
node_fraud_logic -->|"produces result"| node_fraud_result
node_fraud_logic -->|"reads and updates"| node_fraud_state
node_fraud_logic -->|"publishes outcomes"| node_event_broker
node_account_client_fraud -.->|"calls account service"| node_account_api
node_account_consumer -->|"calls"| node_account_logic

click node_gateway "https://github.com/dibyajit1234/banking-system/blob/main/backend/api-gateway/src/main/resources/application.yaml"
click node_account_api "https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java"
click node_account_logic "https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java"
click node_account_model "https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/entity/Account.java"
click node_account_repo "https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/repository/AccountRepository.java"
click node_transaction_api "https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java"
click node_transaction_logic "https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java"
click node_transaction_model "https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/entity/Transaction.java"
click node_transaction_repo "https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/repository/TransactionRepository.java"
click node_account_client_tx "https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/client/AccountServiceClient.java"
click node_fraud_consumer "https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionEventConsumer.java"
click node_fraud_logic "https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java"
click node_account_client_fraud "https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/client/AccountServiceClient.java"
click node_fraud_result "https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/model/FraudCheckResult.java"
click node_account_consumer "https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java"
click node_notification_service "https://github.com/dibyajit1234/banking-system/blob/main/backend/notification-service/src/main/java/com/banking/notificationservice/NotificationServiceApplication.java"
click node_payment_service "https://github.com/dibyajit1234/banking-system/blob/main/backend/payment-service/src/main/java/com/banking/paymentservice/PaymentServiceApplication.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_customer toneBlue
class node_account_api,node_account_logic,node_account_model,node_account_repo,node_account_consumer toneAmber
class node_transaction_api,node_transaction_logic,node_transaction_model,node_transaction_repo,node_account_client_tx,node_payment_service toneMint
class node_fraud_consumer,node_fraud_logic,node_account_client_fraud,node_fraud_result,node_event_broker,node_fraud_state,node_notification_service toneRose
```

## Components

### API access

- [API gateway](https://github.com/dibyajit1234/banking-system/blob/main/backend/api-gateway/src/main/resources/application.yaml): `backend/api-gateway/src/main/resources/application.yaml`

### Accounts

- [Account API](https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java): `backend/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java`
- [Account operations](https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java): `backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java`
- [Account model and DTOs](https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/entity/Account.java): `backend/account-service/src/main/java/com/banking/accountservice/entity/Account.java`
- [Account repository](https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/repository/AccountRepository.java): `backend/account-service/src/main/java/com/banking/accountservice/repository/AccountRepository.java`
- [Account event consumer](https://github.com/dibyajit1234/banking-system/blob/main/backend/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java): `backend/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java`

### Transfers

- [Transaction API](https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java): `backend/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java`
- [Transfer operations](https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java): `backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`
- [Transaction model and DTOs](https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/entity/Transaction.java): `backend/transaction-service/src/main/java/com/banking/transactionservice/entity/Transaction.java`
- [Transaction repository](https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/repository/TransactionRepository.java): `backend/transaction-service/src/main/java/com/banking/transactionservice/repository/TransactionRepository.java`
- [Account service client](https://github.com/dibyajit1234/banking-system/blob/main/backend/transaction-service/src/main/java/com/banking/transactionservice/client/AccountServiceClient.java): `backend/transaction-service/src/main/java/com/banking/transactionservice/client/AccountServiceClient.java`
- [Payment service](https://github.com/dibyajit1234/banking-system/blob/main/backend/payment-service/src/main/java/com/banking/paymentservice/PaymentServiceApplication.java): `backend/payment-service/src/main/java/com/banking/paymentservice/PaymentServiceApplication.java`

### Risk and events

- [Fraud event consumer](https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionEventConsumer.java): `backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionEventConsumer.java`
- [Fraud checks](https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java): `backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java`
- [Account service client](https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/client/AccountServiceClient.java): `backend/fraud-dection/src/main/java/com/banking/frauddection/client/AccountServiceClient.java`
- [Fraud result](https://github.com/dibyajit1234/banking-system/blob/main/backend/fraud-dection/src/main/java/com/banking/frauddection/model/FraudCheckResult.java): `backend/fraud-dection/src/main/java/com/banking/frauddection/model/FraudCheckResult.java`
- **Kafka broker**
- **Fraud counters**
- [Notification service](https://github.com/dibyajit1234/banking-system/blob/main/backend/notification-service/src/main/java/com/banking/notificationservice/NotificationServiceApplication.java): `backend/notification-service/src/main/java/com/banking/notificationservice/NotificationServiceApplication.java`

### Other components

- **Banking user**

## Connections

- Banking user → API gateway: sends requests
- API gateway → Account API: routes requests
- API gateway → Transaction API: routes requests
- Account API → Account operations: calls (evidence: `backend/account-service/src/main/java/com/banking/accountservice/controller/AccountController.java`)
- Account operations → Account repository: reads and writes (evidence: `backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java`)
- Account operations → Account model and DTOs: maps account data (evidence: `backend/account-service/src/main/java/com/banking/accountservice/service/AccountService.java`)
- Transaction API → Transfer operations: calls (evidence: `backend/transaction-service/src/main/java/com/banking/transactionservice/controller/TransactionController.java`)
- Transfer operations → Account service client: deducts balance (evidence: `backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`)
- Transfer operations → Transaction repository: saves and reads (evidence: `backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`)
- Transfer operations → Transaction model and DTOs: creates transaction (evidence: `backend/transaction-service/src/main/java/com/banking/transactionservice/service/TransactionService.java`)
- Transfer operations → Kafka broker: publishes event (evidence: `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 (evidence: `backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionEventConsumer.java`)
- Fraud checks → Account service client: fetches balance (evidence: `backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java`)
- Fraud checks → Fraud result: produces result (evidence: `backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java`)
- Fraud checks → Fraud counters: reads and updates (evidence: `backend/fraud-dection/src/main/java/com/banking/frauddection/service/FraudDetectionService.java`)
- Fraud checks → Kafka broker: publishes outcomes (evidence: `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 (evidence: `backend/account-service/src/main/java/com/banking/accountservice/service/AccountEventConsumer.java`)
