# nickmaels/currency-list-application architecture

> Architecture diagram of the GitHub repository nickmaels/currency-list-application, 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/nickmaels/currency-list-application
- Repository: https://github.com/nickmaels/currency-list-application

## Overview

Currency-List is a Spring web application that fetches Moldovan bank exchange rates, displays current lists, saves daily rates, and serves historical records. The main flow runs from a browser request through a controller and bank-specific parser to a rendered page; saving is a separate service-owned operation that persists parsed rates. History requests query stored rates and render the history view. The README names five supported banks, while sampled parser code covers only some; unsampled bank implementations are represented by their exact tree paths. Arrows reflect excerpts or README evidence; omitted implementation details are not inferred.

Main entry points: [`src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java`](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java) (Parser selector), [`src/main/java/com/currency/price/controllers/UniversalController.java`](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/controllers/UniversalController.java) (Current rates), [`src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java`](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java) (Currency service), [`src/main/java/com/currency/price/controllers/HistoryController.java`](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/controllers/HistoryController.java) (History requests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web pages"]
  node_current["Current rates"]
  node_history["History requests"]
  node_currentview["Current view<br/>[currencyPage.html]"]
  node_homeview["Home view<br/>[home.html]"]
  node_historyview["History view<br/>[historyPage.html]"]
end

subgraph group_parsing["Rate parsing"]
  node_factory["Parser selector"]
  node_strategy["Parser contract"]
  node_micb["MICB parser<br/>[MICBParser.java]"]
  node_nbm["NBM parser<br/>[NBMParser.java]"]
  node_victoria["Victoriabank parser"]
  node_universal["Default parser"]
  node_otherbanks["Other bank parsers"]
end

subgraph group_history["Storage and history"]
  node_service["Currency service"]
  node_repository["Currency repository"]
  node_currency["Currency record<br/>[Currency.java]"]
  node_database[("H2 database")]
end

subgraph group_config["Bank configuration"]
  node_bankprops["Bank properties"]
end

node_browser(("Browser user"))
node_bankwebsites["Bank websites"]

node_browser -->|"requests rates"| node_current
node_browser -->|"requests history"| node_history
node_current -->|"selects parser"| node_factory
node_current -->|"reads bank config"| node_bankprops
node_current -->|"saves daily rates"| node_service
node_current -->|"renders"| node_currentview
node_current -->|"renders"| node_homeview
node_history -->|"reads bank config"| node_bankprops
node_history -->|"queries dates and rates"| node_service
node_history -->|"renders"| node_historyview
node_factory -->|"returns strategy"| node_strategy
node_factory -->|"registers strategy"| node_micb
node_factory -->|"registers strategy"| node_nbm
node_factory -->|"registers strategy"| node_victoria
node_factory -->|"registers fallback"| node_universal
node_micb -->|"fetches page"| node_bankwebsites
node_victoria -->|"fetches page"| node_bankwebsites
node_universal -->|"fetches page"| node_bankwebsites
node_service -->|"checks and saves"| node_repository
node_service -->|"reads bank config"| node_bankprops
node_service -->|"selects parser"| node_factory
node_service -->|"sets bank and date"| node_currency
node_repository -->|"stores records"| node_currency
node_repository -.->|"queries records"| node_database
node_otherbanks -.->|"implements contract"| node_strategy

click node_current "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/controllers/UniversalController.java"
click node_history "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/controllers/HistoryController.java"
click node_currentview "https://github.com/nickmaels/currency-list-application/blob/master/src/main/resources/templates/currencyPage.html"
click node_homeview "https://github.com/nickmaels/currency-list-application/blob/master/src/main/resources/templates/home.html"
click node_historyview "https://github.com/nickmaels/currency-list-application/blob/master/src/main/resources/templates/historyPage.html"
click node_factory "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java"
click node_strategy "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/strategy/StrategyParser.java"
click node_micb "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/MICBParser.java"
click node_nbm "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/NBMParser.java"
click node_victoria "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/VictoriabankParser.java"
click node_universal "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/UniversalParser.java"
click node_otherbanks "https://github.com/nickmaels/currency-list-application/tree/master/src/main/java/com/currency/price/parsers"
click node_bankprops "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/properties/BankProperties.java"
click node_service "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java"
click node_repository "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/repositories/CurrencyRepository.java"
click node_currency "https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/model/Currency.java"
click node_database "https://github.com/nickmaels/currency-list-application/blob/master/src/main/resources/db/migration/V1__create_table_currency.sql"

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_current,node_history,node_currentview,node_homeview,node_historyview,node_browser toneBlue
class node_factory,node_strategy,node_micb,node_nbm,node_victoria,node_universal,node_otherbanks toneAmber
class node_service,node_repository,node_currency,node_database toneMint
class node_bankprops toneRose
class node_bankwebsites toneIndigo
```

## Components

### Web pages

- [Current rates](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/controllers/UniversalController.java): `src/main/java/com/currency/price/controllers/UniversalController.java`
- [History requests](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/controllers/HistoryController.java): `src/main/java/com/currency/price/controllers/HistoryController.java`
- [Current view](https://github.com/nickmaels/currency-list-application/blob/master/src/main/resources/templates/currencyPage.html): `src/main/resources/templates/currencyPage.html`
- [Home view](https://github.com/nickmaels/currency-list-application/blob/master/src/main/resources/templates/home.html): `src/main/resources/templates/home.html`
- [History view](https://github.com/nickmaels/currency-list-application/blob/master/src/main/resources/templates/historyPage.html): `src/main/resources/templates/historyPage.html`

### Rate parsing

- [Parser selector](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java): `src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java`
- [Parser contract](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/strategy/StrategyParser.java): `src/main/java/com/currency/price/parsers/strategy/StrategyParser.java`
- [MICB parser](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/MICBParser.java): `src/main/java/com/currency/price/parsers/MICBParser.java`
- [NBM parser](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/NBMParser.java): `src/main/java/com/currency/price/parsers/NBMParser.java`
- [Victoriabank parser](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/VictoriabankParser.java): `src/main/java/com/currency/price/parsers/VictoriabankParser.java`
- [Default parser](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/parsers/UniversalParser.java): `src/main/java/com/currency/price/parsers/UniversalParser.java`
- [Other bank parsers](https://github.com/nickmaels/currency-list-application/tree/master/src/main/java/com/currency/price/parsers): `src/main/java/com/currency/price/parsers`

### Storage and history

- [Currency service](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java): `src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java`
- [Currency repository](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/repositories/CurrencyRepository.java): `src/main/java/com/currency/price/repositories/CurrencyRepository.java`
- [Currency record](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/model/Currency.java): `src/main/java/com/currency/price/model/Currency.java`
- [H2 database](https://github.com/nickmaels/currency-list-application/blob/master/src/main/resources/db/migration/V1__create_table_currency.sql): `src/main/resources/db/migration/V1__create_table_currency.sql`

### Bank configuration

- [Bank properties](https://github.com/nickmaels/currency-list-application/blob/master/src/main/java/com/currency/price/properties/BankProperties.java): `src/main/java/com/currency/price/properties/BankProperties.java`

### Other components

- **Browser user**
- **Bank websites**

## Connections

- Browser user → Current rates: requests rates (evidence: `src/main/java/com/currency/price/controllers/UniversalController.java`)
- Browser user → History requests: requests history (evidence: `src/main/java/com/currency/price/controllers/HistoryController.java`)
- Current rates → Parser selector: selects parser (evidence: `src/main/java/com/currency/price/controllers/UniversalController.java`)
- Current rates → Bank properties: reads bank config (evidence: `src/main/java/com/currency/price/controllers/UniversalController.java`)
- Current rates → Currency service: saves daily rates (evidence: `src/main/java/com/currency/price/controllers/UniversalController.java`)
- Current rates → Current view: renders (evidence: `src/main/java/com/currency/price/controllers/UniversalController.java`)
- Current rates → Home view: renders (evidence: `src/main/java/com/currency/price/controllers/UniversalController.java`)
- History requests → Bank properties: reads bank config (evidence: `src/main/java/com/currency/price/controllers/HistoryController.java`)
- History requests → Currency service: queries dates and rates (evidence: `src/main/java/com/currency/price/controllers/HistoryController.java`)
- History requests → History view: renders (evidence: `src/main/java/com/currency/price/controllers/HistoryController.java`)
- Parser selector → Parser contract: returns strategy (evidence: `src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java`)
- Parser selector → MICB parser: registers strategy (evidence: `src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java`)
- Parser selector → NBM parser: registers strategy (evidence: `src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java`)
- Parser selector → Victoriabank parser: registers strategy (evidence: `src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java`)
- Parser selector → Default parser: registers fallback (evidence: `src/main/java/com/currency/price/parsers/strategy/StrategyFactory.java`)
- MICB parser → Bank websites: fetches page (evidence: `src/main/java/com/currency/price/parsers/MICBParser.java`)
- Victoriabank parser → Bank websites: fetches page (evidence: `src/main/java/com/currency/price/parsers/VictoriabankParser.java`)
- Default parser → Bank websites: fetches page (evidence: `src/main/java/com/currency/price/parsers/UniversalParser.java`)
- Currency service → Currency repository: checks and saves (evidence: `src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java`)
- Currency service → Bank properties: reads bank config (evidence: `src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java`)
- Currency service → Parser selector: selects parser (evidence: `src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java`)
- Currency service → Currency record: sets bank and date (evidence: `src/main/java/com/currency/price/services/Impl/CurrencyServiceImpl.java`)
- Currency repository → Currency record: stores records (evidence: `src/main/java/com/currency/price/repositories/CurrencyRepository.java`)
- Currency repository → H2 database: queries records
- Other bank parsers → Parser contract: implements contract (evidence: `src/main/java/com/currency/price/parsers/MICBParser.java`)
