# javatodev-com/internet-banking-concept-microservices architecture

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

- Interactive diagram: https://gitdiagram.com/javatodev-com/internet-banking-concept-microservices
- Repository: https://github.com/javatodev-com/internet-banking-concept-microservices

## Overview

This repository implements an internet-banking REST API as microservices. Users register and manage accounts through the gateway; user registration checks a banking-core record and coordinates local user data with Keycloak. Fund transfers and utility payments are handled by dedicated services, which call the banking core to process transactions and retain service-side records. The core provides user/account lookups and transaction processing. The README also documents gateway security, centralized configuration, and service discovery. Several cross-service links are documented rather than visible in sampled callers; those edges cite the README.

Main entry points: [`internet-banking-api-gateway/src/main/java/com/javatodev/finance/configuration/GatewayConfiguration.java`](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-api-gateway/src/main/java/com/javatodev/finance/configuration/GatewayConfiguration.java) (API gateway), [`internet-banking-user-service/src/main/java/com/javatodev/finance/service/UserService.java`](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/service/UserService.java) (User management), [`internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/service/FundTransferService.java`](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/service/FundTransferService.java) (Transfer processing), [`internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/service/UtilityPaymentService.java`](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/service/UtilityPaymentService.java) (Utility payments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_gateway["API gateway"]
  node_security["Gateway security"]
end

subgraph group_identity["User identity"]
  node_user_api["User endpoints"]
  node_user_service["User management<br/>[UserService.java]"]
  node_keycloak_service["Identity management"]
  node_keycloak_manager["Keycloak client"]
  node_keycloak["Keycloak"]
  node_user_store[("User database")]
end

subgraph group_payments["Banking operations"]
  node_transfer_api["Transfer endpoints"]
  node_transfer_service["Transfer processing"]
  node_transfer_store[("Transfer records")]
  node_payment_api["Payment endpoints"]
  node_payment_service["Utility payments"]
  node_payment_store[("Payment records")]
end

subgraph group_core["Banking core"]
  node_core_api["Core endpoints"]
  node_core_users["Core user lookup<br/>[UserService.java]"]
  node_account_service["Account lookup"]
  node_transaction_service["Transaction processing"]
  node_core_store[("Core banking data")]
end

subgraph group_platform["Service platform"]
  node_config["Config server"]
  node_registry["Service registry"]
end

node_customer(("Banking user"))

node_customer -->|"sends requests"| node_gateway
node_gateway -.->|"secures access"| node_security
node_gateway -.->|"routes requests"| node_user_api
node_gateway -.->|"routes requests"| node_transfer_api
node_gateway -.->|"routes requests"| node_payment_api
node_user_api -->|"delegates to"| node_user_service
node_user_service -->|"manages identity"| node_keycloak_service
node_keycloak_service -->|"gets realm client"| node_keycloak_manager
node_keycloak_manager -->|"accesses realm"| node_keycloak
node_user_service -->|"reads and writes"| node_user_store
node_user_service -->|"checks banking user"| node_core_users
node_transfer_api -->|"delegates to"| node_transfer_service
node_transfer_service -->|"saves records"| node_transfer_store
node_transfer_service -.->|"requests transfer"| node_core_api
node_payment_api -.->|"delegates to"| node_payment_service
node_payment_service -->|"saves records"| node_payment_store
node_payment_service -.->|"requests payment"| node_core_api
node_core_api -.->|"processes transactions"| node_transaction_service
node_transaction_service -->|"reads accounts"| node_account_service
node_transaction_service -->|"updates balances"| node_core_store
node_account_service -->|"reads accounts"| node_core_store
node_core_users -.->|"reads user data"| node_core_store
node_config -.->|"configures services"| node_gateway
node_registry -.->|"supports discovery"| node_gateway

click node_gateway "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-api-gateway/src/main/java/com/javatodev/finance/configuration/GatewayConfiguration.java"
click node_security "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-api-gateway/src/main/java/com/javatodev/finance/configuration/security/SecurityConfiguration.java"
click node_user_api "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/controller/UserController.java"
click node_user_service "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/service/UserService.java"
click node_keycloak_service "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/service/KeycloakUserService.java"
click node_keycloak_manager "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/configuration/keycloak/KeycloakManager.java"
click node_user_store "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/model/repository/UserRepository.java"
click node_transfer_api "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/controller/FundTransferController.java"
click node_transfer_service "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/service/FundTransferService.java"
click node_transfer_store "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/model/repository/FundTransferRepository.java"
click node_payment_api "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/controller/UtilityPaymentController.java"
click node_payment_service "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/service/UtilityPaymentService.java"
click node_payment_store "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/repository/UtilityPaymentRepository.java"
click node_core_api "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/controller/TransactionController.java"
click node_core_users "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/service/UserService.java"
click node_account_service "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/service/AccountService.java"
click node_transaction_service "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/service/TransactionService.java"
click node_core_store "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/model/entity/BankAccountEntity.java"
click node_config "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-config-server/src/main/java/com/javatodev/finance/InternetBankingConfigServerApplication.java"
click node_registry "https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-service-registry/src/main/java/com/javatodev/finance/InternetBankingServiceRegistryApplication.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_customer toneBlue
class node_user_api,node_user_service,node_keycloak_service,node_keycloak_manager,node_keycloak,node_user_store toneAmber
class node_transfer_api,node_transfer_service,node_transfer_store,node_payment_api,node_payment_service,node_payment_store toneMint
class node_core_api,node_core_users,node_account_service,node_transaction_service,node_core_store toneRose
class node_config,node_registry toneIndigo
```

## Components

### API entry

- [API gateway](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-api-gateway/src/main/java/com/javatodev/finance/configuration/GatewayConfiguration.java): `internet-banking-api-gateway/src/main/java/com/javatodev/finance/configuration/GatewayConfiguration.java`
- [Gateway security](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-api-gateway/src/main/java/com/javatodev/finance/configuration/security/SecurityConfiguration.java): `internet-banking-api-gateway/src/main/java/com/javatodev/finance/configuration/security/SecurityConfiguration.java`

### User identity

- [User endpoints](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/controller/UserController.java): `internet-banking-user-service/src/main/java/com/javatodev/finance/controller/UserController.java`
- [User management](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/service/UserService.java): `internet-banking-user-service/src/main/java/com/javatodev/finance/service/UserService.java`
- [Identity management](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/service/KeycloakUserService.java): `internet-banking-user-service/src/main/java/com/javatodev/finance/service/KeycloakUserService.java`
- [Keycloak client](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/configuration/keycloak/KeycloakManager.java): `internet-banking-user-service/src/main/java/com/javatodev/finance/configuration/keycloak/KeycloakManager.java`
- **Keycloak**
- [User database](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-user-service/src/main/java/com/javatodev/finance/model/repository/UserRepository.java): `internet-banking-user-service/src/main/java/com/javatodev/finance/model/repository/UserRepository.java`

### Banking operations

- [Transfer endpoints](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/controller/FundTransferController.java): `internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/controller/FundTransferController.java`
- [Transfer processing](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/service/FundTransferService.java): `internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/service/FundTransferService.java`
- [Transfer records](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/model/repository/FundTransferRepository.java): `internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/model/repository/FundTransferRepository.java`
- [Payment endpoints](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/controller/UtilityPaymentController.java): `internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/controller/UtilityPaymentController.java`
- [Utility payments](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/service/UtilityPaymentService.java): `internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/service/UtilityPaymentService.java`
- [Payment records](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/repository/UtilityPaymentRepository.java): `internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/repository/UtilityPaymentRepository.java`

### Banking core

- [Core endpoints](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/controller/TransactionController.java): `core-banking-service/src/main/java/com/javatodev/finance/controller/TransactionController.java`
- [Core user lookup](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/service/UserService.java): `core-banking-service/src/main/java/com/javatodev/finance/service/UserService.java`
- [Account lookup](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/service/AccountService.java): `core-banking-service/src/main/java/com/javatodev/finance/service/AccountService.java`
- [Transaction processing](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/service/TransactionService.java): `core-banking-service/src/main/java/com/javatodev/finance/service/TransactionService.java`
- [Core banking data](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/core-banking-service/src/main/java/com/javatodev/finance/model/entity/BankAccountEntity.java): `core-banking-service/src/main/java/com/javatodev/finance/model/entity/BankAccountEntity.java`

### Service platform

- [Config server](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-config-server/src/main/java/com/javatodev/finance/InternetBankingConfigServerApplication.java): `internet-banking-config-server/src/main/java/com/javatodev/finance/InternetBankingConfigServerApplication.java`
- [Service registry](https://github.com/javatodev-com/internet-banking-concept-microservices/blob/main/internet-banking-service-registry/src/main/java/com/javatodev/finance/InternetBankingServiceRegistryApplication.java): `internet-banking-service-registry/src/main/java/com/javatodev/finance/InternetBankingServiceRegistryApplication.java`

### Other components

- **Banking user**

## Connections

- Banking user → API gateway: sends requests (evidence: `README.md`)
- API gateway → Gateway security: secures access
- API gateway → User endpoints: routes requests (evidence: `README.md`)
- API gateway → Transfer endpoints: routes requests (evidence: `README.md`)
- API gateway → Payment endpoints: routes requests (evidence: `README.md`)
- User endpoints → User management: delegates to (evidence: `internet-banking-user-service/src/main/java/com/javatodev/finance/controller/UserController.java`)
- User management → Identity management: manages identity (evidence: `internet-banking-user-service/src/main/java/com/javatodev/finance/service/UserService.java`)
- Identity management → Keycloak client: gets realm client (evidence: `internet-banking-user-service/src/main/java/com/javatodev/finance/service/KeycloakUserService.java`)
- Keycloak client → Keycloak: accesses realm (evidence: `internet-banking-user-service/src/main/java/com/javatodev/finance/configuration/keycloak/KeycloakManager.java`)
- User management → User database: reads and writes (evidence: `internet-banking-user-service/src/main/java/com/javatodev/finance/service/UserService.java`)
- User management → Core user lookup: checks banking user (evidence: `internet-banking-user-service/src/main/java/com/javatodev/finance/service/UserService.java`)
- Transfer endpoints → Transfer processing: delegates to (evidence: `internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/controller/FundTransferController.java`)
- Transfer processing → Transfer records: saves records (evidence: `internet-banking-fund-transfer-service/src/main/java/com/javatodev/finance/service/FundTransferService.java`)
- Transfer processing → Core endpoints: requests transfer (evidence: `README.md`)
- Payment endpoints → Utility payments: delegates to (evidence: `internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/controller/UtilityPaymentController.java`)
- Utility payments → Payment records: saves records (evidence: `internet-banking-utility-payment-service/src/main/java/com/javatodev/finance/service/UtilityPaymentService.java`)
- Utility payments → Core endpoints: requests payment (evidence: `README.md`)
- Core endpoints → Transaction processing: processes transactions (evidence: `core-banking-service/src/main/java/com/javatodev/finance/controller/TransactionController.java`)
- Transaction processing → Account lookup: reads accounts (evidence: `core-banking-service/src/main/java/com/javatodev/finance/service/TransactionService.java`)
- Transaction processing → Core banking data: updates balances (evidence: `core-banking-service/src/main/java/com/javatodev/finance/service/TransactionService.java`)
- Account lookup → Core banking data: reads accounts (evidence: `core-banking-service/src/main/java/com/javatodev/finance/service/AccountService.java`)
- Core user lookup → Core banking data: reads user data
- Config server → API gateway: configures services (evidence: `README.md`)
- Service registry → API gateway: supports discovery (evidence: `README.md`)
