# cbarkinozer/onlinebankingrestapi architecture

> Architecture diagram of the GitHub repository cbarkinozer/onlinebankingrestapi, 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/cbarkinozer/onlinebankingrestapi
- Repository: https://github.com/cbarkinozer/onlinebankingrestapi

## Overview

This is a Spring Boot online-banking REST API. Customers register or log in, then use banking endpoints to manage accounts, move money, use credit cards, and apply for or repay loans; results are persisted as domain records and returned through REST. The README also documents JWT security and an optional Kafka producer/consumer flow that imitates SMS notifications. Several controller and service implementations were not sampled, so those product branches are retained from the README and tree, while unverified internal call chains are omitted.

Main entry points: [`src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/service/AuthenticationService.java`](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/service/AuthenticationService.java) (Authentication), [`src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/service/CusCustomerService.java`](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/service/CusCustomerService.java) (Customer Service), [`src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/controller/AccAccountController.java`](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/controller/AccAccountController.java) (Account API), [`src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountActivityService.java`](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountActivityService.java) (Account Activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and API"]
  node_customer["Customer API"]
  node_auth["Authentication"]
  node_jwt["JWT Security"]
  node_customer_service["Customer Service"]
  node_customer_entity["Customer Record<br/>[CusCustomer.java]"]
end

subgraph group_accounts["Accounts and Transfers"]
  node_account_api["Account API"]
  node_account_activity["Account Activity"]
  node_account_validation["Account Validation"]
  node_account_store["Account Records<br/>[AccAccount.java]"]
end

subgraph group_credit["Credit and Loans"]
  node_credit_api["Credit Card API"]
  node_credit_service["Card Operations"]
  node_credit_store["Card Records<br/>[CrdCreditCard.java]"]
  node_loan_api["Loan API"]
  node_loan_service["Loan Operations"]
  node_loan_store["Loan Records<br/>[LoaLoan.java]"]
end

subgraph group_shared["Shared Persistence"]
  node_base_service["Entity Service"]
  node_postgres[("PostgreSQL")]
end

subgraph group_messaging["Messaging and Logs"]
  node_kafka_producer["Message Producer"]
  node_kafka_consumer["Message Consumer"]
  node_log["Log Service<br/>[LogService.java]"]
end

node_bank_user(("Banking User"))
node_rest_client(("REST Client"))
node_kafka["Kafka Broker"]

node_bank_user -->|"registers or logs in"| node_auth
node_auth -->|"registers customer"| node_customer_service
node_auth -->|"issues token"| node_jwt
node_customer_service -->|"maps customer"| node_customer_entity
node_customer_service -->|"uses entity service"| node_base_service
node_rest_client -->|"calls REST API"| node_customer
node_rest_client -->|"calls REST API"| node_account_api
node_account_activity -->|"validates activity"| node_account_validation
node_account_activity -->|"updates balance"| node_account_store
node_account_api -.->|"handles transactions"| node_account_activity
node_account_api -.->|"manages accounts"| node_account_store
node_rest_client -->|"calls REST API"| node_credit_api
node_credit_api -.->|"handles card actions"| node_credit_service
node_credit_service -->|"saves card state"| node_credit_store
node_rest_client -->|"calls REST API"| node_loan_api
node_loan_api -.->|"handles loan actions"| node_loan_service
node_loan_service -->|"updates loan"| node_loan_store
node_base_service -.->|"persists entities"| node_postgres
node_bank_user -->|"requests message"| node_kafka_producer
node_kafka_producer -->|"publishes message"| node_kafka
node_kafka -->|"delivers message"| node_kafka_consumer
node_kafka_consumer -->|"records message"| node_log

click node_customer "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/controller/CusCustomerController.java"
click node_auth "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/service/AuthenticationService.java"
click node_jwt "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/security/JwtAuthenticationFilter.java"
click node_customer_service "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/service/CusCustomerService.java"
click node_customer_entity "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/entity/CusCustomer.java"
click node_account_api "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/controller/AccAccountController.java"
click node_account_activity "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountActivityService.java"
click node_account_validation "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountValidationService.java"
click node_account_store "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/entity/AccAccount.java"
click node_credit_api "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/controller/CrdCreditCardController.java"
click node_credit_service "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/service/CrdCreditCardService.java"
click node_credit_store "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/entity/CrdCreditCard.java"
click node_loan_api "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/controller/LoaLoanController.java"
click node_loan_service "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/service/LoaLoanService.java"
click node_loan_store "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/entity/LoaLoan.java"
click node_base_service "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/gen/service/BaseEntityService.java"
click node_kafka_producer "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/kafka/producer/KafkaMessageController.java"
click node_kafka_consumer "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/kafka/consumer/KafkaListenerService.java"
click node_log "https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/log/service/LogService.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_customer,node_auth,node_jwt,node_customer_service,node_customer_entity,node_bank_user,node_rest_client toneBlue
class node_account_api,node_account_activity,node_account_validation,node_account_store toneAmber
class node_credit_api,node_credit_service,node_credit_store,node_loan_api,node_loan_service,node_loan_store toneMint
class node_base_service,node_postgres toneRose
class node_kafka_producer,node_kafka_consumer,node_log,node_kafka toneIndigo
```

## Components

### Identity and API

- [Customer API](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/controller/CusCustomerController.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/controller/CusCustomerController.java`
- [Authentication](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/service/AuthenticationService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/service/AuthenticationService.java`
- [JWT Security](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/security/JwtAuthenticationFilter.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/security/JwtAuthenticationFilter.java`
- [Customer Service](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/service/CusCustomerService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/service/CusCustomerService.java`
- [Customer Record](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/entity/CusCustomer.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/entity/CusCustomer.java`

### Accounts and Transfers

- [Account API](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/controller/AccAccountController.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/controller/AccAccountController.java`
- [Account Activity](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountActivityService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountActivityService.java`
- [Account Validation](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountValidationService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountValidationService.java`
- [Account Records](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/entity/AccAccount.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/entity/AccAccount.java`

### Credit and Loans

- [Credit Card API](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/controller/CrdCreditCardController.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/controller/CrdCreditCardController.java`
- [Card Operations](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/service/CrdCreditCardService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/service/CrdCreditCardService.java`
- [Card Records](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/entity/CrdCreditCard.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/entity/CrdCreditCard.java`
- [Loan API](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/controller/LoaLoanController.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/controller/LoaLoanController.java`
- [Loan Operations](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/service/LoaLoanService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/service/LoaLoanService.java`
- [Loan Records](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/entity/LoaLoan.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/entity/LoaLoan.java`

### Shared Persistence

- [Entity Service](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/gen/service/BaseEntityService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/gen/service/BaseEntityService.java`
- **PostgreSQL**

### Messaging and Logs

- [Message Producer](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/kafka/producer/KafkaMessageController.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/kafka/producer/KafkaMessageController.java`
- [Message Consumer](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/kafka/consumer/KafkaListenerService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/kafka/consumer/KafkaListenerService.java`
- [Log Service](https://github.com/cbarkinozer/onlinebankingrestapi/blob/main/src/main/java/com/cbarkinozer/onlinebankingrestapi/app/log/service/LogService.java): `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/log/service/LogService.java`

### Other components

- **Banking User**
- **REST Client**
- **Kafka Broker**

## Connections

- Banking User → Authentication: registers or logs in (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/service/AuthenticationService.java`)
- Authentication → Customer Service: registers customer (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/service/AuthenticationService.java`)
- Authentication → JWT Security: issues token (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/sec/service/AuthenticationService.java`)
- Customer Service → Customer Record: maps customer (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/cus/service/CusCustomerService.java`)
- Customer Service → Entity Service: uses entity service
- REST Client → Customer API: calls REST API
- REST Client → Account API: calls REST API
- Account Activity → Account Validation: validates activity (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountActivityService.java`)
- Account Activity → Account Records: updates balance (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/service/AccAccountActivityService.java`)
- Account API → Account Activity: handles transactions (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/acc/controller/AccAccountController.java`)
- Account API → Account Records: manages accounts
- REST Client → Credit Card API: calls REST API
- Credit Card API → Card Operations: handles card actions (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/controller/CrdCreditCardController.java`)
- Card Operations → Card Records: saves card state (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/crd/service/CrdCreditCardService.java`)
- REST Client → Loan API: calls REST API
- Loan API → Loan Operations: handles loan actions
- Loan Operations → Loan Records: updates loan (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/loa/service/LoaLoanService.java`)
- Entity Service → PostgreSQL: persists entities
- Banking User → Message Producer: requests message
- Message Producer → Kafka Broker: publishes message
- Kafka Broker → Message Consumer: delivers message
- Message Consumer → Log Service: records message (evidence: `src/main/java/com/cbarkinozer/onlinebankingrestapi/app/kafka/consumer/KafkaListenerService.java`)
