# mehandihasan2023/digital-banking-platform architecture

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

- Interactive diagram: https://gitdiagram.com/mehandihasan2023/digital-banking-platform
- Repository: https://github.com/mehandihasan2023/digital-banking-platform

## Overview

This is a Java/Spring microservices digital banking backend. A client enters through the API gateway, authenticates with the auth service, then uses customer and account APIs; transactions are handled synchronously by the transaction service, which coordinates balance changes with the account service. Transaction events are published asynchronously through Kafka for notification and audit processing. The README documents the principal service routes, isolated schemas, and event flow; sampled service code confirms transaction orchestration, account locking, and consumer-side deduplication. Other wiring is not inferred from filenames alone.

Main entry points: [`api-gateway/src/main/java/com/banking/gateway/ApiGatewayApplication.java`](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/api-gateway/src/main/java/com/banking/gateway/ApiGatewayApplication.java) (API gateway), [`transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java`](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java) (Transaction service), [`notification-service/src/main/java/com/banking/notification/consumer/NotificationKafkaConsumer.java`](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/notification-service/src/main/java/com/banking/notification/consumer/NotificationKafkaConsumer.java) (Notification consumer and service), [`audit-service/src/main/java/com/banking/audit/consumer/AuditKafkaConsumer.java`](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/audit-service/src/main/java/com/banking/audit/consumer/AuditKafkaConsumer.java) (Audit consumer and service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_gateway["API gateway"]
end

subgraph group_identity["Identity and profiles"]
  node_auth["Auth service<br/>[AuthService.java]"]
  node_authdb[("Auth schema")]
  node_customer["Customer profiles"]
  node_customerdb[("Customer schema")]
end

subgraph group_money["Accounts and transactions"]
  node_account["Account service"]
  node_accountdb[("Account schema")]
  node_transaction["Transaction service"]
  node_idempotency["Idempotency"]
  node_txdb[("Transaction schema")]
end

subgraph group_events["Events and side effects"]
  node_outbox["Outbox publisher"]
  node_kafka["Kafka broker"]
  node_notification["Notification consumer and service"]
  node_notificationdb[("Notification schema")]
  node_audit["Audit consumer and service"]
  node_auditdb[("Audit schema")]
end

subgraph group_shared["Shared contracts"]
  node_contracts["Shared events and API types"]
end

node_client(("Banking client"))

node_client -->|"sends requests"| node_gateway
node_gateway -->|"routes auth"| node_auth
node_gateway -->|"routes profiles"| node_customer
node_gateway -->|"routes accounts"| node_account
node_gateway -->|"routes transactions"| node_transaction
node_gateway -->|"routes notifications"| node_notification
node_gateway -->|"routes audit"| node_audit
node_auth -.->|"reads and writes"| node_authdb
node_customer -->|"reads and writes"| node_customerdb
node_account -->|"reads and locks"| node_accountdb
node_transaction -->|"checks keys"| node_idempotency
node_transaction -->|"requests balance changes"| node_account
node_transaction -.->|"records transactions"| node_txdb
node_transaction -->|"records events"| node_outbox
node_outbox -->|"publishes events"| node_kafka
node_kafka -->|"dispatches events"| node_notification
node_kafka -->|"dispatches events"| node_audit
node_notification -->|"saves notices"| node_notificationdb
node_audit -->|"saves audit logs"| node_auditdb
node_transaction -->|"uses event contract"| node_contracts
node_notification -.->|"uses event contract"| node_contracts
node_audit -.->|"uses event contract"| node_contracts

click node_gateway "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/api-gateway/src/main/java/com/banking/gateway/ApiGatewayApplication.java"
click node_auth "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/auth-service/src/main/java/com/banking/auth/service/AuthService.java"
click node_authdb "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/auth-service/src/main/java/com/banking/auth/repository/UserRepository.java"
click node_customer "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/customer-service/src/main/java/com/banking/customer/service/CustomerService.java"
click node_customerdb "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/customer-service/src/main/java/com/banking/customer/repository/CustomerRepository.java"
click node_account "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/account-service/src/main/java/com/banking/account/service/AccountService.java"
click node_accountdb "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/account-service/src/main/java/com/banking/account/repository/AccountRepository.java"
click node_transaction "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java"
click node_idempotency "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/service/IdempotencyService.java"
click node_txdb "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/repository/TransactionRepository.java"
click node_outbox "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/publisher/OutboxPublisher.java"
click node_notification "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/notification-service/src/main/java/com/banking/notification/consumer/NotificationKafkaConsumer.java"
click node_notificationdb "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/notification-service/src/main/java/com/banking/notification/repository/NotificationRepository.java"
click node_audit "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/audit-service/src/main/java/com/banking/audit/consumer/AuditKafkaConsumer.java"
click node_auditdb "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/audit-service/src/main/java/com/banking/audit/repository/AuditLogRepository.java"
click node_contracts "https://github.com/mehandihasan2023/digital-banking-platform/blob/main/banking-common/src/main/java/com/banking/common/event/TransactionEvent.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_client toneBlue
class node_auth,node_authdb,node_customer,node_customerdb toneAmber
class node_account,node_accountdb,node_transaction,node_idempotency,node_txdb toneMint
class node_outbox,node_kafka,node_notification,node_notificationdb,node_audit,node_auditdb toneRose
class node_contracts toneIndigo
```

## Components

### API entry

- [API gateway](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/api-gateway/src/main/java/com/banking/gateway/ApiGatewayApplication.java): `api-gateway/src/main/java/com/banking/gateway/ApiGatewayApplication.java`

### Identity and profiles

- [Auth service](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/auth-service/src/main/java/com/banking/auth/service/AuthService.java): `auth-service/src/main/java/com/banking/auth/service/AuthService.java`
- [Auth schema](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/auth-service/src/main/java/com/banking/auth/repository/UserRepository.java): `auth-service/src/main/java/com/banking/auth/repository/UserRepository.java`
- [Customer profiles](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/customer-service/src/main/java/com/banking/customer/service/CustomerService.java): `customer-service/src/main/java/com/banking/customer/service/CustomerService.java`
- [Customer schema](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/customer-service/src/main/java/com/banking/customer/repository/CustomerRepository.java): `customer-service/src/main/java/com/banking/customer/repository/CustomerRepository.java`

### Accounts and transactions

- [Account service](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/account-service/src/main/java/com/banking/account/service/AccountService.java): `account-service/src/main/java/com/banking/account/service/AccountService.java`
- [Account schema](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/account-service/src/main/java/com/banking/account/repository/AccountRepository.java): `account-service/src/main/java/com/banking/account/repository/AccountRepository.java`
- [Transaction service](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java): `transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java`
- [Idempotency](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/service/IdempotencyService.java): `transaction-service/src/main/java/com/banking/transaction/service/IdempotencyService.java`
- [Transaction schema](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/repository/TransactionRepository.java): `transaction-service/src/main/java/com/banking/transaction/repository/TransactionRepository.java`

### Events and side effects

- [Outbox publisher](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/transaction-service/src/main/java/com/banking/transaction/publisher/OutboxPublisher.java): `transaction-service/src/main/java/com/banking/transaction/publisher/OutboxPublisher.java`
- **Kafka broker**
- [Notification consumer and service](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/notification-service/src/main/java/com/banking/notification/consumer/NotificationKafkaConsumer.java): `notification-service/src/main/java/com/banking/notification/consumer/NotificationKafkaConsumer.java`
- [Notification schema](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/notification-service/src/main/java/com/banking/notification/repository/NotificationRepository.java): `notification-service/src/main/java/com/banking/notification/repository/NotificationRepository.java`
- [Audit consumer and service](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/audit-service/src/main/java/com/banking/audit/consumer/AuditKafkaConsumer.java): `audit-service/src/main/java/com/banking/audit/consumer/AuditKafkaConsumer.java`
- [Audit schema](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/audit-service/src/main/java/com/banking/audit/repository/AuditLogRepository.java): `audit-service/src/main/java/com/banking/audit/repository/AuditLogRepository.java`

### Shared contracts

- [Shared events and API types](https://github.com/mehandihasan2023/digital-banking-platform/blob/main/banking-common/src/main/java/com/banking/common/event/TransactionEvent.java): `banking-common/src/main/java/com/banking/common/event/TransactionEvent.java`

### Other components

- **Banking client**

## Connections

- Banking client → API gateway: sends requests (evidence: `README.md`)
- API gateway → Auth service: routes auth (evidence: `README.md`)
- API gateway → Customer profiles: routes profiles (evidence: `README.md`)
- API gateway → Account service: routes accounts (evidence: `README.md`)
- API gateway → Transaction service: routes transactions (evidence: `README.md`)
- API gateway → Notification consumer and service: routes notifications (evidence: `README.md`)
- API gateway → Audit consumer and service: routes audit (evidence: `README.md`)
- Auth service → Auth schema: reads and writes (evidence: `auth-service/src/main/java/com/banking/auth/service/AuthService.java`)
- Customer profiles → Customer schema: reads and writes (evidence: `customer-service/src/main/java/com/banking/customer/service/CustomerService.java`)
- Account service → Account schema: reads and locks (evidence: `account-service/src/main/java/com/banking/account/service/AccountService.java`)
- Transaction service → Idempotency: checks keys (evidence: `transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java`)
- Transaction service → Account service: requests balance changes (evidence: `README.md`)
- Transaction service → Transaction schema: records transactions (evidence: `transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java`)
- Transaction service → Outbox publisher: records events (evidence: `README.md`)
- Outbox publisher → Kafka broker: publishes events (evidence: `README.md`)
- Kafka broker → Notification consumer and service: dispatches events (evidence: `README.md`)
- Kafka broker → Audit consumer and service: dispatches events (evidence: `README.md`)
- Notification consumer and service → Notification schema: saves notices
- Audit consumer and service → Audit schema: saves audit logs
- Transaction service → Shared events and API types: uses event contract (evidence: `transaction-service/src/main/java/com/banking/transaction/service/TransactionService.java`)
- Notification consumer and service → Shared events and API types: uses event contract
- Audit consumer and service → Shared events and API types: uses event contract
