# letsbegincode/banking-system architecture

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

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

## Overview

This is a modular retail-banking application for operators using a guided console or HTTP API. Both entry points drive account creation and maintenance, then deposit, withdrawal, transfer, and interest operations; account history supports statements and analytics, while repositories retain state. The graph preserves the documented authentication, caching, observer, reporting, and storage capabilities. Edges are limited to relationships shown in excerpts or explicitly documented; several API middleware and reporting details are unsampled.

Main entry points: [`src/main/java/banking/service/Bank.java`](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/service/Bank.java) (Bank service), [`src/main/java/banking/transaction/BaseTransaction.java`](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/transaction/BaseTransaction.java) (Transaction history), [`src/main/java/banking/api/BankHttpServer.java`](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/api/BankHttpServer.java) (HTTP API), [`src/main/java/banking/account/Account.java`](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/account/Account.java) (Account types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Operator interfaces"]
  node_console["Console workflows<br/>[ConsoleUI.java]"]
  node_http["HTTP API"]
end

subgraph group_domain["Banking domain"]
  node_bank["Bank service<br/>[Bank.java]"]
  node_accounts["Account types<br/>[Account.java]"]
  node_factory["Account factory"]
  node_operations["Account operations"]
  node_transactions["Transaction history"]
end

subgraph group_insights["Reporting and analytics"]
  node_analytics["Account analytics"]
  node_analytics_range["Range analytics"]
  node_analytics_trend["Trend analytics"]
  node_analytics_anomaly["Anomaly detection"]
  node_reports["Statements and reports"]
end

subgraph group_platform["Security and observability"]
  node_auth["Authentication"]
  node_tokens["Bearer tokens<br/>[TokenService.java]"]
  node_authorization["Authorization"]
  node_observers["Account observers"]
  node_telemetry["Telemetry collection"]
end

subgraph group_storage["Persistence and caching"]
  node_repository[("Account repository")]
  node_memory_repo[("In-memory repository")]
  node_jdbc_repo[("JDBC repository")]
  node_repo_factory["Repository selection"]
  node_cache["Cache providers"]
  node_snapshots["Bank snapshots<br/>[BankSnapshot.java]"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_console
node_operator -->|"calls"| node_http
node_console -->|"issues commands"| node_bank
node_http -->|"routes requests"| node_bank
node_http -->|"checks permissions"| node_authorization
node_auth -->|"issues tokens"| node_tokens
node_http -->|"authenticates"| node_auth
node_bank -->|"manages"| node_accounts
node_bank -->|"creates accounts"| node_factory
node_bank -->|"queues operations"| node_operations
node_accounts -->|"records"| node_transactions
node_accounts -->|"transfers between accounts"| node_transactions
node_bank -->|"persists accounts"| node_repository
node_repository -->|"implemented by"| node_memory_repo
node_repository -->|"implemented by"| node_jdbc_repo
node_repo_factory -->|"selects"| node_jdbc_repo
node_repo_factory -->|"selects"| node_repository
node_bank -->|"caches reads"| node_cache
node_bank -->|"runs analytics"| node_analytics
node_analytics -->|"analyzes history"| node_transactions
node_analytics_range -->|"analyzes history"| node_transactions
node_analytics_trend -->|"analyzes history"| node_transactions
node_analytics_anomaly -->|"detects anomalies"| node_transactions
node_bank -->|"notifies events"| node_observers
node_bank -->|"creates snapshots"| node_snapshots
node_snapshots -->|"serializes account state"| node_accounts

click node_console "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/ui/ConsoleUI.java"
click node_http "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/api/BankHttpServer.java"
click node_bank "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/service/Bank.java"
click node_accounts "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/account/Account.java"
click node_factory "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/account/AccountFactory.java"
click node_operations "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/operation/AccountOperation.java"
click node_transactions "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/transaction/BaseTransaction.java"
click node_analytics "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/AccountAnalyticsService.java"
click node_analytics_range "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/analytics/RangeAnalyticsService.java"
click node_analytics_trend "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/analytics/TrendAnalyticsService.java"
click node_analytics_anomaly "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/analytics/AnomalyDetectionService.java"
click node_reports "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/StatementGenerator.java"
click node_auth "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/security/AuthenticationService.java"
click node_tokens "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/security/TokenService.java"
click node_authorization "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/security/AuthorizationService.java"
click node_observers "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/observer/AccountObserver.java"
click node_telemetry "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/telemetry/TelemetryCollector.java"
click node_repository "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/persistence/AccountRepository.java"
click node_memory_repo "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/persistence/memory/InMemoryAccountRepository.java"
click node_jdbc_repo "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/persistence/jdbc/JdbcAccountRepository.java"
click node_repo_factory "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/persistence/repository/BankRepositoryFactory.java"
click node_cache "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/cache/CacheProviderFactory.java"
click node_snapshots "https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/snapshot/BankSnapshot.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_console,node_http toneBlue
class node_bank,node_accounts,node_factory,node_operations,node_transactions toneAmber
class node_analytics,node_analytics_range,node_analytics_trend,node_analytics_anomaly,node_reports toneMint
class node_auth,node_tokens,node_authorization,node_observers,node_telemetry toneRose
class node_repository,node_memory_repo,node_jdbc_repo,node_repo_factory,node_cache,node_snapshots,node_operator toneIndigo
```

## Components

### Operator interfaces

- [Console workflows](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/ui/ConsoleUI.java): `src/main/java/banking/ui/ConsoleUI.java`
- [HTTP API](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/api/BankHttpServer.java): `src/main/java/banking/api/BankHttpServer.java`

### Banking domain

- [Bank service](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/service/Bank.java): `src/main/java/banking/service/Bank.java`
- [Account types](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/account/Account.java): `src/main/java/banking/account/Account.java`
- [Account factory](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/account/AccountFactory.java): `src/main/java/banking/account/AccountFactory.java`
- [Account operations](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/operation/AccountOperation.java): `src/main/java/banking/operation/AccountOperation.java`
- [Transaction history](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/transaction/BaseTransaction.java): `src/main/java/banking/transaction/BaseTransaction.java`

### Reporting and analytics

- [Account analytics](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/AccountAnalyticsService.java): `src/main/java/banking/report/AccountAnalyticsService.java`
- [Range analytics](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/analytics/RangeAnalyticsService.java): `src/main/java/banking/report/analytics/RangeAnalyticsService.java`
- [Trend analytics](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/analytics/TrendAnalyticsService.java): `src/main/java/banking/report/analytics/TrendAnalyticsService.java`
- [Anomaly detection](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/analytics/AnomalyDetectionService.java): `src/main/java/banking/report/analytics/AnomalyDetectionService.java`
- [Statements and reports](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/report/StatementGenerator.java): `src/main/java/banking/report/StatementGenerator.java`

### Security and observability

- [Authentication](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/security/AuthenticationService.java): `src/main/java/banking/security/AuthenticationService.java`
- [Bearer tokens](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/security/TokenService.java): `src/main/java/banking/security/TokenService.java`
- [Authorization](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/security/AuthorizationService.java): `src/main/java/banking/security/AuthorizationService.java`
- [Account observers](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/observer/AccountObserver.java): `src/main/java/banking/observer/AccountObserver.java`
- [Telemetry collection](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/telemetry/TelemetryCollector.java): `src/main/java/banking/telemetry/TelemetryCollector.java`

### Persistence and caching

- [Account repository](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/persistence/AccountRepository.java): `src/main/java/banking/persistence/AccountRepository.java`
- [In-memory repository](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/persistence/memory/InMemoryAccountRepository.java): `src/main/java/banking/persistence/memory/InMemoryAccountRepository.java`
- [JDBC repository](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/persistence/jdbc/JdbcAccountRepository.java): `src/main/java/banking/persistence/jdbc/JdbcAccountRepository.java`
- [Repository selection](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/persistence/repository/BankRepositoryFactory.java): `src/main/java/banking/persistence/repository/BankRepositoryFactory.java`
- [Cache providers](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/cache/CacheProviderFactory.java): `src/main/java/banking/cache/CacheProviderFactory.java`
- [Bank snapshots](https://github.com/letsbegincode/banking-system/blob/main/src/main/java/banking/snapshot/BankSnapshot.java): `src/main/java/banking/snapshot/BankSnapshot.java`

### Other components

- **Operator**

## Connections

- Operator → Console workflows: uses (evidence: `README.md`)
- Operator → HTTP API: calls (evidence: `README.md`)
- Console workflows → Bank service: issues commands (evidence: `README.md`)
- HTTP API → Bank service: routes requests (evidence: `src/main/java/banking/api/BankHttpServer.java`)
- HTTP API → Authorization: checks permissions (evidence: `src/main/java/banking/api/BankHttpServer.java`)
- Authentication → Bearer tokens: issues tokens (evidence: `src/main/java/banking/security/AuthenticationService.java`)
- HTTP API → Authentication: authenticates (evidence: `src/main/java/banking/api/BankHttpServer.java`)
- Bank service → Account types: manages (evidence: `README.md`)
- Bank service → Account factory: creates accounts (evidence: `README.md`)
- Bank service → Account operations: queues operations (evidence: `src/main/java/banking/service/Bank.java`)
- Account types → Transaction history: records (evidence: `src/main/java/banking/account/Account.java`)
- Account types → Transaction history: transfers between accounts (evidence: `src/main/java/banking/account/Account.java`)
- Bank service → Account repository: persists accounts (evidence: `README.md`)
- Account repository → In-memory repository: implemented by (evidence: `src/main/java/banking/persistence/memory/InMemoryAccountRepository.java`)
- Account repository → JDBC repository: implemented by (evidence: `src/main/java/banking/persistence/jdbc/JdbcAccountRepository.java`)
- Repository selection → JDBC repository: selects (evidence: `src/main/java/banking/persistence/repository/BankRepositoryFactory.java`)
- Repository selection → Account repository: selects (evidence: `src/main/java/banking/persistence/repository/BankRepositoryFactory.java`)
- Bank service → Cache providers: caches reads (evidence: `README.md`)
- Bank service → Account analytics: runs analytics (evidence: `src/main/java/banking/service/Bank.java`)
- Account analytics → Transaction history: analyzes history (evidence: `src/main/java/banking/report/AccountAnalyticsService.java`)
- Range analytics → Transaction history: analyzes history (evidence: `src/main/java/banking/report/analytics/RangeAnalyticsService.java`)
- Trend analytics → Transaction history: analyzes history (evidence: `src/main/java/banking/report/analytics/TrendAnalyticsService.java`)
- Anomaly detection → Transaction history: detects anomalies (evidence: `src/main/java/banking/report/analytics/AnomalyDetectionService.java`)
- Bank service → Account observers: notifies events (evidence: `README.md`)
- Bank service → Bank snapshots: creates snapshots (evidence: `src/main/java/banking/service/Bank.java`)
- Bank snapshots → Account types: serializes account state
