Skip to content

README.md

Latest commit

 

History

History
106 lines (77 loc) · 2.22 KB

README.md

File metadata and controls

106 lines (77 loc) · 2.22 KB

NBP Currency Converter

Java Spring Boot PostgreSQL Docker JUnit

Prosta aplikacja w Spring Boot, która przelicza ceny komputerów z USD na PLN przy użyciu oficjalnego API NBP.
Dane są zapisywane w bazie PostgreSQL oraz mogą zostać wyeksportowane do pliku XML.

Funkcjonalności

  • pobieranie kursu USD z API NBP dla podanej daty
  • przeliczanie wartości USD → PLN
  • zapis danych w bazie PostgreSQL
  • generowanie faktury w formacie XML
  • wyszukiwanie komputerów po fragmencie nazwy
  • wyszukiwanie po dacie księgowania
  • sortowanie po nazwie i dacie

Technologie

  • Java 21
  • Spring Boot
  • Spring Web
  • Spring Data JPA
  • PostgreSQL
  • Flyway
  • Jackson XML
  • Docker
  • JUnit 5 / Mockito

Uruchomienie aplikacji

  1. Uruchom bazę PostgreSQL
  2. Skonfiguruj dane w application.properties
  3. Uruchom aplikację:
./gradlew bootRun

Endpointy API

Inicjalizacja przykładowych danych

POST /computers/init

Dodanie komputera

POST /computers

Przykładowy request:

{
  "name": "ACER Aspire",
  "usdCost": 345,
  "date": "2026-01-05"
}

Lista komputerów

GET /computers

Wyszukiwanie po nazwie

GET /computers/search?name=acer

Wyszukiwanie po dacie

GET /computers/by-date?date=2026-01-05

Sortowanie

GET /computers/sorted?sort=name
GET /computers/sorted?sort=accountingDate

Generowanie faktury XML

POST /computers/invoice

Cel projektu

Projekt został przygotowany jako aplikacja demonstracyjna backendu w Javie. Pokazuje integrację z zewnętrznym API (NBP), pracę z bazą danych, generowanie XML oraz testowanie aplikacji Spring Boot.

Autor

Dominik Suliga (dominiks8318@gmail.com)