# wakelawn/currency-converter architecture

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

- Interactive diagram: https://gitdiagram.com/wakelawn/currency-converter
- Repository: https://github.com/wakelawn/currency-converter

## Overview

This Spring Boot API authenticates requests with an API key, validates conversion input, fetches live rates, returns conversions, and stores conversion history in H2. A separate rate-lookup endpoint and history retrieval/deletion are also documented capabilities. The graph follows shown controller/service calls and service/repository interactions; API authentication and external-rate relationships are supported by excerpts, while some configuration-wired relationships are omitted where their wiring was not shown.

Main entry points: [`src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java`](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java) (Currency Service), [`src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java`](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java) (Currency Endpoints), [`src/main/java/com/javaproj/currencyConverter/repository/ConversionHistoryRepository.java`](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/repository/ConversionHistoryRepository.java) (History Repository), [`src/main/java/com/javaproj/currencyConverter/service/HistoryService.java`](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/service/HistoryService.java) (History Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_currency_controller["Currency Endpoints"]
  node_history_controller["History Endpoints"]
  node_conversion_request["Validated Request"]
  node_conversion_response["Conversion Result"]
  node_rate_response["Rate Data"]
end

subgraph group_conversion["Currency Conversion"]
  node_currency_service["Currency Service"]
  node_exchange_api{{"ExchangeRate-API"}}
end

subgraph group_history["History"]
  node_history_entity["Conversion Record"]
  node_history_service["History Service"]
  node_history_repository["History Repository"]
  node_h2[("H2 Database")]
end

subgraph group_identity["API-Key Security"]
  node_api_filter["API-Key Filter"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_user_repository["User Repository"]
  node_user_entity["User Account<br/>[User.java]"]
  node_security_config["Security Configuration"]
  node_data_initializer["User Initialization"]
end

subgraph group_platform["Configuration and Errors"]
  node_error_handler["Global Error Handler"]
  node_currency_error["Unsupported Currency"]
  node_history_error["Missing History"]
  node_webclient_config["WebClient Configuration"]
  node_openapi_config["OpenAPI Configuration<br/>[OpenApiConfig.java]"]
end

node_client(("API Client"))

node_client -->|"calls"| node_currency_controller
node_client -.->|"calls"| node_history_controller
node_currency_controller -->|"delegates"| node_currency_service
node_currency_controller -->|"accepts"| node_conversion_request
node_currency_controller -->|"returns"| node_conversion_response
node_currency_controller -->|"returns"| node_rate_response
node_currency_service -->|"requests rates"| node_exchange_api
node_currency_service -->|"saves conversion"| node_history_repository
node_currency_service -->|"creates record"| node_history_entity
node_history_controller -->|"delegates"| node_history_service
node_history_service -->|"queries and deletes"| node_history_repository
node_history_repository -->|"manages"| node_history_entity
node_history_repository -.->|"persists records"| node_h2
node_api_filter -->|"looks up key"| node_user_service
node_user_service -->|"queries"| node_user_repository
node_user_repository -->|"manages"| node_user_entity
node_security_config -->|"registers filter"| node_api_filter
node_data_initializer -->|"initializes users"| node_user_repository
node_error_handler -->|"handles"| node_currency_error
node_error_handler -->|"handles"| node_history_error
node_currency_service -->|"throws"| node_currency_error
node_history_service -->|"throws"| node_history_error
node_currency_service -.->|"uses client"| node_webclient_config
node_client -.->|"explores API"| node_openapi_config

click node_currency_controller "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java"
click node_history_controller "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/controller/HistoryController.java"
click node_conversion_request "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/dto/ConversionRequest.java"
click node_conversion_response "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/dto/ConversionResponse.java"
click node_rate_response "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/dto/ExchangeRateResponse.java"
click node_currency_service "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java"
click node_history_entity "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/model/ConversionHistory.java"
click node_history_service "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/service/HistoryService.java"
click node_history_repository "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/repository/ConversionHistoryRepository.java"
click node_api_filter "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/ApiKeyAuthenticationFilter.java"
click node_user_service "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/service/UserService.java"
click node_user_repository "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/repository/UserRepository.java"
click node_user_entity "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/model/User.java"
click node_security_config "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/SecurityConfig.java"
click node_data_initializer "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/DataInitializer.java"
click node_error_handler "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/exception/GlobalExceptionHandler.java"
click node_currency_error "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/exception/CurrencyNotFoundException.java"
click node_history_error "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/exception/HistoryNotFoundException.java"
click node_webclient_config "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/WebClientConfig.java"
click node_openapi_config "https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/OpenApiConfig.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_currency_controller,node_history_controller,node_conversion_request,node_conversion_response,node_rate_response,node_client toneBlue
class node_currency_service,node_exchange_api toneAmber
class node_history_entity,node_history_service,node_history_repository,node_h2 toneMint
class node_api_filter,node_user_service,node_user_repository,node_user_entity,node_security_config,node_data_initializer toneRose
class node_error_handler,node_currency_error,node_history_error,node_webclient_config,node_openapi_config toneIndigo
```

## Components

### REST API

- [Currency Endpoints](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java): `src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java`
- [History Endpoints](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/controller/HistoryController.java): `src/main/java/com/javaproj/currencyConverter/controller/HistoryController.java`
- [Validated Request](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/dto/ConversionRequest.java): `src/main/java/com/javaproj/currencyConverter/dto/ConversionRequest.java`
- [Conversion Result](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/dto/ConversionResponse.java): `src/main/java/com/javaproj/currencyConverter/dto/ConversionResponse.java`
- [Rate Data](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/dto/ExchangeRateResponse.java): `src/main/java/com/javaproj/currencyConverter/dto/ExchangeRateResponse.java`

### Currency Conversion

- [Currency Service](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java): `src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java`
- **ExchangeRate-API**

### History

- [Conversion Record](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/model/ConversionHistory.java): `src/main/java/com/javaproj/currencyConverter/model/ConversionHistory.java`
- [History Service](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/service/HistoryService.java): `src/main/java/com/javaproj/currencyConverter/service/HistoryService.java`
- [History Repository](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/repository/ConversionHistoryRepository.java): `src/main/java/com/javaproj/currencyConverter/repository/ConversionHistoryRepository.java`
- **H2 Database**

### API-Key Security

- [API-Key Filter](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/ApiKeyAuthenticationFilter.java): `src/main/java/com/javaproj/currencyConverter/config/ApiKeyAuthenticationFilter.java`
- [User Service](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/service/UserService.java): `src/main/java/com/javaproj/currencyConverter/service/UserService.java`
- [User Repository](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/repository/UserRepository.java): `src/main/java/com/javaproj/currencyConverter/repository/UserRepository.java`
- [User Account](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/model/User.java): `src/main/java/com/javaproj/currencyConverter/model/User.java`
- [Security Configuration](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/SecurityConfig.java): `src/main/java/com/javaproj/currencyConverter/config/SecurityConfig.java`
- [User Initialization](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/DataInitializer.java): `src/main/java/com/javaproj/currencyConverter/config/DataInitializer.java`

### Configuration and Errors

- [Global Error Handler](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/exception/GlobalExceptionHandler.java): `src/main/java/com/javaproj/currencyConverter/exception/GlobalExceptionHandler.java`
- [Unsupported Currency](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/exception/CurrencyNotFoundException.java): `src/main/java/com/javaproj/currencyConverter/exception/CurrencyNotFoundException.java`
- [Missing History](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/exception/HistoryNotFoundException.java): `src/main/java/com/javaproj/currencyConverter/exception/HistoryNotFoundException.java`
- [WebClient Configuration](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/WebClientConfig.java): `src/main/java/com/javaproj/currencyConverter/config/WebClientConfig.java`
- [OpenAPI Configuration](https://github.com/wakelawn/currency-converter/blob/main/src/main/java/com/javaproj/currencyConverter/config/OpenApiConfig.java): `src/main/java/com/javaproj/currencyConverter/config/OpenApiConfig.java`

### Other components

- **API Client**

## Connections

- API Client → Currency Endpoints: calls (evidence: `src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java`)
- API Client → History Endpoints: calls (evidence: `README.md`)
- Currency Endpoints → Currency Service: delegates (evidence: `src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java`)
- Currency Endpoints → Validated Request: accepts (evidence: `src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java`)
- Currency Endpoints → Conversion Result: returns (evidence: `src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java`)
- Currency Endpoints → Rate Data: returns (evidence: `src/main/java/com/javaproj/currencyConverter/controller/CurrencyController.java`)
- Currency Service → ExchangeRate-API: requests rates (evidence: `src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java`)
- Currency Service → History Repository: saves conversion (evidence: `src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java`)
- Currency Service → Conversion Record: creates record (evidence: `src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java`)
- History Endpoints → History Service: delegates (evidence: `src/main/java/com/javaproj/currencyConverter/controller/HistoryController.java`)
- History Service → History Repository: queries and deletes (evidence: `src/main/java/com/javaproj/currencyConverter/service/HistoryService.java`)
- History Repository → Conversion Record: manages (evidence: `src/main/java/com/javaproj/currencyConverter/repository/ConversionHistoryRepository.java`)
- History Repository → H2 Database: persists records (evidence: `README.md`)
- API-Key Filter → User Service: looks up key (evidence: `src/main/java/com/javaproj/currencyConverter/config/ApiKeyAuthenticationFilter.java`)
- User Service → User Repository: queries (evidence: `src/main/java/com/javaproj/currencyConverter/service/UserService.java`)
- User Repository → User Account: manages (evidence: `src/main/java/com/javaproj/currencyConverter/repository/UserRepository.java`)
- Security Configuration → API-Key Filter: registers filter (evidence: `src/main/java/com/javaproj/currencyConverter/config/SecurityConfig.java`)
- User Initialization → User Repository: initializes users (evidence: `src/main/java/com/javaproj/currencyConverter/config/DataInitializer.java`)
- Global Error Handler → Unsupported Currency: handles (evidence: `src/main/java/com/javaproj/currencyConverter/exception/GlobalExceptionHandler.java`)
- Global Error Handler → Missing History: handles (evidence: `src/main/java/com/javaproj/currencyConverter/exception/GlobalExceptionHandler.java`)
- Currency Service → Unsupported Currency: throws (evidence: `src/main/java/com/javaproj/currencyConverter/service/CurrencyService.java`)
- History Service → Missing History: throws (evidence: `src/main/java/com/javaproj/currencyConverter/service/HistoryService.java`)
- Currency Service → WebClient Configuration: uses client
- API Client → OpenAPI Configuration: explores API (evidence: `README.md`)
