# riipal/spring-boot-microservices-banking-application architecture

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

- Interactive diagram: https://gitdiagram.com/riipal/spring-boot-microservices-banking-application
- Repository: https://github.com/riipal/spring-boot-microservices-banking-application

## Overview

This is a Spring Boot microservices banking application. Users enter through the API Gateway; the services provide user and account management, transfers, and transaction operations. The README also documents service discovery, centralized authentication/authorization, and a database per service. The transaction implementation explicitly reads and updates accounts through the Account service and persists transactions. Other cross-service calls and detailed persistence flows are not established by the sampled source, so they are omitted. Major service capabilities are taken from the README.

Main entry points: [`API-Gateway/src/main/java/org/training/api/gateway/ApiGatewayApplication.java`](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/API-Gateway/src/main/java/org/training/api/gateway/ApiGatewayApplication.java) (API Gateway), [`User-Service/src/main/java/org/training/user/service/service/implementation/UserServiceImpl.java`](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/User-Service/src/main/java/org/training/user/service/service/implementation/UserServiceImpl.java) (User Management), [`Transaction-Service/src/main/java/org/training/transactions/service/implementation/TransactionServiceImpl.java`](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Transaction-Service/src/main/java/org/training/transactions/service/implementation/TransactionServiceImpl.java) (Transaction Operations), [`Account-Service/src/main/java/org/training/account/service/controller/AccountController.java`](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Account-Service/src/main/java/org/training/account/service/controller/AccountController.java) (Account API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Discovery"]
  node_gateway["API Gateway"]
  node_security["Gateway Security"]
  node_registry["Service Registry"]
end

subgraph group_identity["User Management"]
  node_user_api["User API"]
  node_user_logic["User Management"]
  node_user_auth["Authentication Service"]
  node_user_store[("User Database")]
end

subgraph group_accounts["Accounts"]
  node_account_api["Account API"]
  node_account_logic["Account Management"]
  node_account_store[("Account Database")]
end

subgraph group_money["Money Operations"]
  node_transfer_api["Transfer API"]
  node_transfer_logic["Transfer Operations"]
  node_transfer_store[("Transfer Database")]
  node_transaction_api["Transaction API"]
  node_transaction_logic["Transaction Operations"]
  node_transaction_store[("Transaction Database")]
end

subgraph group_sequence["Account Numbering"]
  node_sequence_api["Sequence API"]
  node_sequence_logic["Sequence Generation"]
  node_sequence_store[("Sequence Database")]
end

node_customer(("Banking User"))
node_keycloak["Keycloak"]

node_customer -->|"enters through"| node_gateway
node_gateway -->|"routes requests"| node_user_api
node_gateway -->|"routes requests"| node_account_api
node_gateway -->|"routes requests"| node_transfer_api
node_gateway -->|"routes requests"| node_transaction_api
node_security -->|"authenticates users"| node_keycloak
node_user_api -->|"delegates to"| node_user_logic
node_user_logic -.->|"uses authentication"| node_user_auth
node_user_logic -.->|"persists user data"| node_user_store
node_account_api -->|"delegates to"| node_account_logic
node_account_logic -.->|"persists account data"| node_account_store
node_transfer_api -->|"delegates to"| node_transfer_logic
node_transfer_logic -.->|"persists transfer data"| node_transfer_store
node_transaction_api -->|"delegates to"| node_transaction_logic
node_transaction_logic -->|"reads and updates accounts"| node_account_api
node_transaction_logic -->|"reads and saves transactions"| node_transaction_store
node_sequence_api -->|"delegates to"| node_sequence_logic
node_sequence_logic -.->|"generates sequence"| node_sequence_store
node_registry -->|"supports discovery"| node_gateway

click node_gateway "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/API-Gateway/src/main/java/org/training/api/gateway/ApiGatewayApplication.java"
click node_security "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/API-Gateway/src/main/java/org/training/api/gateway/config/SecurityConfig.java"
click node_registry "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Service-Registry/src/main/java/org/training/service/registry/ServiceRegistryApplication.java"
click node_user_api "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/User-Service/src/main/java/org/training/user/service/controller/UserController.java"
click node_user_logic "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/User-Service/src/main/java/org/training/user/service/service/implementation/UserServiceImpl.java"
click node_user_auth "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/User-Service/src/main/java/org/training/user/service/service/implementation/KeycloakServiceImpl.java"
click node_account_api "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Account-Service/src/main/java/org/training/account/service/controller/AccountController.java"
click node_account_logic "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Account-Service/src/main/java/org/training/account/service/service/implementation/AccountServiceImpl.java"
click node_transfer_api "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Fund-Transfer/src/main/java/org/training/fundtransfer/controller/FundTransferController.java"
click node_transfer_logic "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Fund-Transfer/src/main/java/org/training/fundtransfer/service/implementation/FundTransferServiceImpl.java"
click node_transaction_api "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Transaction-Service/src/main/java/org/training/transactions/controller/TransactionController.java"
click node_transaction_logic "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Transaction-Service/src/main/java/org/training/transactions/service/implementation/TransactionServiceImpl.java"
click node_sequence_api "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Sequence-Generator/src/main/java/org/training/sequence/generator/controller/SequenceController.java"
click node_sequence_logic "https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Sequence-Generator/src/main/java/org/training/sequence/generator/service/implementation/SequenceServiceImpl.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_security,node_registry,node_customer toneBlue
class node_user_api,node_user_logic,node_user_auth,node_user_store toneAmber
class node_account_api,node_account_logic,node_account_store toneMint
class node_transfer_api,node_transfer_logic,node_transfer_store,node_transaction_api,node_transaction_logic,node_transaction_store toneRose
class node_sequence_api,node_sequence_logic,node_sequence_store,node_keycloak toneIndigo
```

## Components

### Entry and Discovery

- [API Gateway](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/API-Gateway/src/main/java/org/training/api/gateway/ApiGatewayApplication.java): `API-Gateway/src/main/java/org/training/api/gateway/ApiGatewayApplication.java`
- [Gateway Security](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/API-Gateway/src/main/java/org/training/api/gateway/config/SecurityConfig.java): `API-Gateway/src/main/java/org/training/api/gateway/config/SecurityConfig.java`
- [Service Registry](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Service-Registry/src/main/java/org/training/service/registry/ServiceRegistryApplication.java): `Service-Registry/src/main/java/org/training/service/registry/ServiceRegistryApplication.java`

### User Management

- [User API](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/User-Service/src/main/java/org/training/user/service/controller/UserController.java): `User-Service/src/main/java/org/training/user/service/controller/UserController.java`
- [User Management](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/User-Service/src/main/java/org/training/user/service/service/implementation/UserServiceImpl.java): `User-Service/src/main/java/org/training/user/service/service/implementation/UserServiceImpl.java`
- [Authentication Service](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/User-Service/src/main/java/org/training/user/service/service/implementation/KeycloakServiceImpl.java): `User-Service/src/main/java/org/training/user/service/service/implementation/KeycloakServiceImpl.java`
- **User Database**

### Accounts

- [Account API](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Account-Service/src/main/java/org/training/account/service/controller/AccountController.java): `Account-Service/src/main/java/org/training/account/service/controller/AccountController.java`
- [Account Management](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Account-Service/src/main/java/org/training/account/service/service/implementation/AccountServiceImpl.java): `Account-Service/src/main/java/org/training/account/service/service/implementation/AccountServiceImpl.java`
- **Account Database**

### Money Operations

- [Transfer API](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Fund-Transfer/src/main/java/org/training/fundtransfer/controller/FundTransferController.java): `Fund-Transfer/src/main/java/org/training/fundtransfer/controller/FundTransferController.java`
- [Transfer Operations](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Fund-Transfer/src/main/java/org/training/fundtransfer/service/implementation/FundTransferServiceImpl.java): `Fund-Transfer/src/main/java/org/training/fundtransfer/service/implementation/FundTransferServiceImpl.java`
- **Transfer Database**
- [Transaction API](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Transaction-Service/src/main/java/org/training/transactions/controller/TransactionController.java): `Transaction-Service/src/main/java/org/training/transactions/controller/TransactionController.java`
- [Transaction Operations](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Transaction-Service/src/main/java/org/training/transactions/service/implementation/TransactionServiceImpl.java): `Transaction-Service/src/main/java/org/training/transactions/service/implementation/TransactionServiceImpl.java`
- **Transaction Database**

### Account Numbering

- [Sequence API](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Sequence-Generator/src/main/java/org/training/sequence/generator/controller/SequenceController.java): `Sequence-Generator/src/main/java/org/training/sequence/generator/controller/SequenceController.java`
- [Sequence Generation](https://github.com/riipal/spring-boot-microservices-banking-application/blob/main/Sequence-Generator/src/main/java/org/training/sequence/generator/service/implementation/SequenceServiceImpl.java): `Sequence-Generator/src/main/java/org/training/sequence/generator/service/implementation/SequenceServiceImpl.java`
- **Sequence Database**

### Other components

- **Banking User**
- **Keycloak**

## Connections

- Banking User → API Gateway: enters through (evidence: `README.md`)
- API Gateway → User API: routes requests (evidence: `README.md`)
- API Gateway → Account API: routes requests (evidence: `README.md`)
- API Gateway → Transfer API: routes requests (evidence: `README.md`)
- API Gateway → Transaction API: routes requests (evidence: `README.md`)
- Gateway Security → Keycloak: authenticates users (evidence: `README.md`)
- User API → User Management: delegates to (evidence: `User-Service/src/main/java/org/training/user/service/controller/UserController.java`)
- User Management → Authentication Service: uses authentication
- User Management → User Database: persists user data (evidence: `README.md`)
- Account API → Account Management: delegates to (evidence: `Account-Service/src/main/java/org/training/account/service/controller/AccountController.java`)
- Account Management → Account Database: persists account data (evidence: `README.md`)
- Transfer API → Transfer Operations: delegates to (evidence: `Fund-Transfer/src/main/java/org/training/fundtransfer/controller/FundTransferController.java`)
- Transfer Operations → Transfer Database: persists transfer data (evidence: `README.md`)
- Transaction API → Transaction Operations: delegates to (evidence: `Transaction-Service/src/main/java/org/training/transactions/controller/TransactionController.java`)
- Transaction Operations → Account API: reads and updates accounts (evidence: `Transaction-Service/src/main/java/org/training/transactions/service/implementation/TransactionServiceImpl.java`)
- Transaction Operations → Transaction Database: reads and saves transactions (evidence: `Transaction-Service/src/main/java/org/training/transactions/service/implementation/TransactionServiceImpl.java`)
- Sequence API → Sequence Generation: delegates to (evidence: `Sequence-Generator/src/main/java/org/training/sequence/generator/controller/SequenceController.java`)
- Sequence Generation → Sequence Database: generates sequence
- Service Registry → API Gateway: supports discovery (evidence: `README.md`)
